店舗資料の検索と顧客記憶を接客へつなぎ管理画面でプレビューする by ReoHakase · Pull Request #454 · kit-codex-hack-fes-2026/tablecast-poc · GitHub
Skip to content

店舗資料の検索と顧客記憶を接客へつなぎ管理画面でプレビューする - #454

Draft
ReoHakase wants to merge 1 commit into
stagingfrom
codex/452-store-knowledge-memory
Draft

ReoHakase wants to merge 1 commit into
stagingfrom
codex/452-store-knowledge-memory

Conversation

@ReoHakase

Copy link
Copy Markdown
Contributor

変更内容

接客が店舗固有の質問へ答える資料取得経路と、直近の一覧にない顧客記憶の検索を追加する。複数ファイルのSkillを既存の店舗設定に保存し、MCPで下書きへ反映、人が公開した版を接客から検索・読取できる。管理画面はファイル一覧、Markdownプレビューと原文編集を備える。

店舗資料のプレビュー
こもれびseedの営業時間・アクセス資料を選び、日本語・英語の本文を管理画面の実部品で表示した。HTMLと外部画像は実行・取得しない。

  • cast.skillsへSKILL.mdと任意の参照テキストを原文保持する。最大8 Skill・各30ファイル・各32,000文字・合計256,000文字。相対パス、重複、必須ファイルと店舗境界を検証し、保存済み資料を省略する旧形式の更新を拒否する。全削除は空配列で明示する。
  • searchStoreKnowledgeは最大5件の抜粋と出典位置、readStoreKnowledgeは最大4,000文字の原文と続きを返す。公開版を照合し、デモは取り込んだ設定版を読む。未公開下書きが通常接客へ混入しない。
  • searchCustomerMemoriesは現在の対象と同意を最終SQLでも検証し、本文・出所・本人編集・更新日時を8件ずつ取得する。古い記憶、削除、撤回、同時失効を実D1で確認した。個人記憶の包括閲覧をMCPへ追加しない。
  • 既存の標準web_searchを維持し、店舗資料・業務API・個人記憶・外部情報の使い分けをLiveと委任先のプロンプトへ追加する。資料内の命令・コードを実行せず、外部検索へ個人情報を送らない。
  • こもれびは六角aceの公開店舗情報を情報項目の参考に、9ファイルの日英資料を持つ。営業時間、予約、設備、会計、料理、日本酒、会員、周辺案内を含む。架空店舗を維持し、実在店の住所・電話番号・系列関係は転用しない。

意思決定と最小実装

既存configurationの下書き・差分・検証・明示公開・履歴、MCPの管理者認可とread/write scope、顧客文脈の失効、既存Markdown表示を再利用する。新しい資料テーブル・migration・外部索引の同期処理は不要。

店舗資料は導入済みFuse.jsで短い日英キーワードを検索し、必要な原文だけを取得する。embeddingによる意味検索は含めない。価格・在庫・食事対応・プランは現在の業務APIを正本とする。MCP JSON Schemaは同じリスト要素の定義を標準参照へまとめ、入力制約を変えず既存25,000文字予算内の24,613文字に収めた。

通常の再seedは既存の店舗設定を保つ。今回の資料追加を理由に既存の営業DBをリセットしない。

テスト戦略と確認結果

対象commit: 3878c4aa971ff60e78cb270da62d1df0ffded5a4。Bun 1.4.3、Vitest 5.0.5。通常の固定応答と隔離local D1で検証した。

  • API unit 48件: パスと上限、日英検索、原文位置、ページング、多数資料、既存注文計算・schema予算・接客文書の互換性。
  • API bindings 39件: 実OAuth/MCPからの保存・公開後取得、read scope、他店舗、版競合、顧客記憶の検索・編集・削除・同意撤回と競合、既存下書き・履歴・音声設定。
  • scripts unit 12件、隔離D1 seed-template bindings 1件: こもれび資料の7種類の検索と、既存seed投入・保持。
  • Chromium Browser 17件、Storybook 3件: 日英・画面幅・ファイル選択・原文保持・安全なプレビュー・追加削除と既存編集・保存フロー。
  • 全体format・lint・typecheck・fallow、差分audit、commit hooks成功。Fallowには既存の依存分類・複雑度等の警告があるが、全体検査の終了コードは0。
  • 評価datasetは合計22ケース。店舗情報、未登録連絡先、古い好み、訂正、食事対応、最新Web情報の日英12ケースを追加し、draft読込を確認した。期待動作の記述は実モデルの合格証拠ではない。

実モデル・実音声・実iPad・外部MCPクライアント・全構成E2E・公開配備は未実施。Storybookの公開previewはCI待ちで未配備、配備SHAとAccess認証は未確認。対象Story IDは 店舗-店舗資料--preview、店舗-店舗資料--editing、店舗-店舗資料--empty。

関連Issue

Closes #452

Store multi-file restaurant skills in the existing versioned configuration
and expose bounded search and source reads to the service agent. Preserve
consent and tenant boundaries when searching older customer memories.

Add an administrative file preview and editor, MCP configuration guidance,
realistic bilingual Komorebi seed documents and retrieval evaluation cases.
@ReoHakase ReoHakase added the feat 利用者向け機能・作業手順の追加 label Oct 29, 2026
@ReoHakase ReoHakase self-assigned this Oct 29, 2026
@github-actions

Copy link
Copy Markdown

@github-actions

Copy link
Copy Markdown

🔒 PR #454 · 3878c4a · CI ↗

プレビュービルド・デプロイデプロイ日時 (JST)
🍽️ TableCast
—
❌ 失敗—
📚 Storybook
—
  • 🚀 実行
—
✉️ React Email
—
  • 🚀 実行
—

This branch had an error being deployed

1 failed deployment
preview — 3878c4aa Deployed Oct 29, 2026 by ReoHakase via PRプレビュー配備 #1248
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feat 利用者向け機能・作業手順の追加

Projects

None yet

Development

Successfully merging this pull request may close these issues.

店舗資料の検索と顧客記憶を接客に結びMCPと管理画面で設定する

1 participant