会話の設定

会話の設定（agent）は、AI が何を話し、何を聞き取り、いつ人に渡すかを決めるものです。1 つの設定を複数のテナントで使えます。管理画面の「会話の設定」か、API（POST /v1/agents）・MCP（create_agent）で作ります。

全体の形#

{
  "name": "歯科医院の受付",
  "config": {
    "greeting": "お電話ありがとうございます。さくら歯科です。ご用件をお話しください。",
    "persona": "落ち着いた丁寧な受付。1 回の発話は 2 文まで",
    "fields": [
      { "key": "name", "label": "お名前", "required": true },
      { "key": "phone", "label": "折り返しの電話番号", "required": true, "type": "phone" },
      { "key": "purpose", "label": "ご用件", "required": true }
    ],
    "handoff_when": ["人と話したいと言われた", "急な痛みや腫れがある"],
    "closing": "承知しました。担当者から折り返しご連絡します。",
    "closing_answered": "ほかにご不明な点があれば、またお電話ください。",
    "faq": [
      { "q": "診療時間は", "a": "平日は 9 時から 18 時、土曜は 13 時までです。日曜・祝日は休みです。" }
    ],
    "domain": "歯科医院",
    "vocabulary": ["インプラント", "ホワイトニング", "定期検診"],
    "voice": "Kore",
    "speaking_rate": 1.15
  }
}

項目#

知らない項目は保存しません。誤りがあると 422 invalid_config で、details に項目ごとの誤りが並びます。

聞き取る項目（fields）#

{ "key": "phone", "label": "折り返しの電話番号", "required": true, "type": "phone" }

名前と電話番号は、AI が聞き取った内容を復唱して確かめます。電話番号は 3 つに区切って読み上げます。

人に引き継ぐ条件（handoff_when）#

当てはまったら、AI は名前などを聞かずにすぐ会話を終え、結果を handoff にします。電話なら、そのあと人に転送します（電話でつなぐ）。

"handoff_when": ["人と話したいと言われた", "怒っている", "急な痛みや腫れがある", "聞き取れない状態が 2 回続いた"]

条件は普通の文で書きます。広すぎる条件（「質問された」など）は、ほとんどの通話が引き継ぎになるので避けます。

よくある質問（faq）#

聞かれたら、AI はこの答えだけを使って答えます。書いていないことは推測せず、担当者からの折り返しにします。質問に答えて用が済んだら、結果は answered になり、closing_answered で締めます。

通話の結果#

AI が会話を終えると、通話の outcome が決まります。

声（voice）#

Google の Chirp 3 HD の日本語の声から、名前で選びます。管理画面の「会話の設定」で試聴できます。

話す速さ（speaking_rate）#

1.0 がふつうの速さです。電話では少し遅く感じるので、既定は 1.15 です。次の数から選びます。

言語#

今は日本語の会話に対応しています。ほかの言語は今後対応します。

版#

会話の設定を変える（PUT /v1/agents/{id}）と、新しい版になります。進行中の通話は始まったときの版のまま続き、次の通話から新しい版を使います。通話の記録には使った版（agent.version）が残り、GET /v1/agents/{id}?version= で当時の中身を見られます。

PUT では config を全体で渡します（一部だけの変更はできません）。

テナントへの割り当て#

テナントの agent_id が、そのテナントの通話の既定の設定です。電話では <Parameter name="agent">、Web・アプリでは POST /v1/sessions の agent_id で、通話ごとに別の設定を使えます。

使っているテナントがある設定は消せません（409 in_use）。先にテナントの agent_id を替えます。

書き方のこつ#

• persona に「1 回の発話は 2 文まで」と書くと、電話で聞きやすくなります。
• 聞き取る項目は少なくします。必須の項目が多いと通話が長くなります。
• 業界の用語・商品名・地名は vocabulary に入れると、聞き取りが安定します。
• 試すときはテストの環境で、Web・アプリから話すのが手早い方法です。