SYSTEM NOTES / GROK VOICE ORDER DEMO
お客様の言葉を受け取るGrok Voiceと、商品検索・顧客照合・注文検証を行うブラウザ内のツール。その間を流れるデータを、現在のデモ実装に沿って説明します。
01 / REQUEST PATH
入力欄の文章が、ブラウザからGrokのリアルタイム接続へ渡ります。音声認識の精度は、このデモの評価範囲に含まれません。
Grokが商品や顧客を調べると判断すると、ブラウザ内のツールが固定データを検索し、その結果を会話へ返します。
注文確定の指示だけでは登録しません。商品・数量・届け先・本人確認・最終承諾をツールが確認します。
Grokの返答は文字と24kHzのPCM音声で届きます。音声は到着したチャンクから再生します。
02 / DATA SOURCES
商品コード、名称、読み、別名、価格、販売状態、容量や入数などを保持します。検索では完全一致を優先し、その後に語句と文字の近さから候補を返します。
app/(demos)/demos/order/product-catalog.ts会員番号、氏名、電話番号、登録住所を持つ評価用レコードです。検索結果では候補氏名までを返し、住所は確認後にツールが返します。
app/(demos)/demos/order/demo-customer-store.tsこのモードは4つの郵便番号だけを地域名へ変換します。会員データ内にもこの表にない住所があり、そのままでは注文登録の検証を通りません。
app/(demos)/demos/order/grok/page.tsx質問順は固定せず、不足項目だけを尋ねるよう指示します。商品と価格の推測を避け、最終復唱・承諾・ツール成功後に注文完了を伝えるルールです。
lib/voice-order-grok-instructions.mjs画面内の商品マスタから表示。価格と販売状態は会話中にツール結果として渡されます。
EC-001海の幸 人気詰合せ4,320円販売中EC-002ふるさとの味 詰合せ4,860円販売中EC-003季節の彩り 小箱1,620円販売中03 / TOOL CONTRACT
search_products商品名・別名・特徴から候補を探す商品カタログ最大6件の候補と価格・販売状態get_product商品コードで詳細を読む商品カタログ該当商品の詳細lookup_customer会員番号・電話番号・氏名で候補を探すデモ顧客候補の会員番号と氏名confirm_customer候補氏名への返答を確認するデモ顧客確認後に登録住所を返すlookup_postal_code郵便番号から地域を照合する固定の4地域一致した地域名submit_order最終承諾と注文項目を検証する会話状態・商品・顧客ブラウザ内の評価用注文handoff人の確認が必要な理由を返す会話内容評価用の実行結果04 / ORDER GATE
submit_order が次の項目を再確認します。商品コードが存在し、販売中である
1〜99の整数である
7桁の郵便番号が固定表にあり、住所詳細がある
会員は候補氏名の確認済み、ゲストは氏名と電話番号がある
カード・代金引換・コンビニ／郵便局前払いのいずれか
直前の復唱とお客様の明確な承諾があり、重複登録ではない
05 / SCOPE
入力お客様役は文字を入力します。マイク、電話回線、音声認識、騒音下の聞き取りは対象外です。
本人確認候補氏名への返答を発話パターンで照合する評価用ロジックです。実際の本人認証や権限確認の代わりにはなりません。
料金・配送送料、到着日、のし対応可否を確定する外部APIはありません。Grokには推測しないよう指示します。
接続本番デモは1日20通話、1通話3分までです。サーバーが短命トークンを発行し、入力文とツール結果はブラウザからxAIへ送られます。