ブログ · · 約 6 分で
通話中に AI が API を呼ぶ Function Calling:ツールの設計と待ち時間
電話の
要点
- 会話中の
ツールは、 AI が 説明文を 読んで 「いつ 使うか」 を 決めるので、 名前と 説明に 使う 場面と 使わない 場面を はっきり 書きます。 - 電話では
相手が 黙って 待つ 時間が 長いと 不安に なる ため、 ツールの 応答は 短く、 返す JSON も AI が 話す分だけに 絞ります。 - 予約を
作るなどの 書き換えは 読み上げて 同意を 得てから 使い、 同じ 呼び出しが 2 回届いても 1 回分に なる 作りにします。
会話中に
ツールの呼び出しの流れ
ツールは、
- 相手が
「来週の 火曜は 空いてますか」 と 話す。 - AI が
ツールの 説明を 読み、 空きを 探すツールを 使うと 決め、 引数 (日付など) を 作る。 - 基盤が
ツールの URL を 呼ぶ。 その あいだ AI は 「お調べしますので、 少々 お待ちください」 と つなぐ。 - API が
JSON を 返す。 - AI が
結果を 読んで、 「火曜は 午前 10 時と 午後 2 時が 空いています」 と 話す。
AI が
名前と説明の書き方
AI が
| 項目 | よくない |
よい |
|---|---|---|
| 名前 | api1 |
find_free_slots |
| 説明 | 予約の |
予約の |
| 引数の |
date | 探す日 |
引数は
ツールの
読み取りと書き換えの分け方
ツールは、
- 読み取り: 間
違って 呼んでも 害が 小さいので、 AI の 判断で 呼ばせます。 - 書き換え: 呼ぶ前に、
内容を 読み上げて 相手の 「はい」 を 得ます。 聞き間違いの まま 予約が 入ると、 取り消しの 手間が 大きいからです。
書き換えの
待ち時間の扱い
電話の
- 重い
集計や 外部への 連絡は、 会話の あとの Webhook で 行う。 - 応答の
JSON は、 AI が 話すのに 要る 項目だけに 絞る。 長い 一覧を 返すと、 AI が 読むのにも 時間が かかる。 - 空き枠などは、
電話で 伝えられる 数 (2〜3 個) に 絞って返す。
基盤には
失敗の返し方
| 状況 | 返し方 | AI の |
|---|---|---|
| 空きが |
2xx と{ "slots": [] , "message": "その日は空きがありません" } |
別の |
| 顧客が |
2xx と{ "found": false } |
名前を |
| 予約システムが |
5xx | おわびして |
業務と
安全のための確かめ
ツールの
- 署名を
確かめる : 基盤からの呼び出しだけを 受ける ため、 署名を 確かめます (Standard Webhooks の 署名の )記事 。 - テナントを
引数から : どの取らない 会社の 予約を 扱うかは、 署名付きの 本文に 入っている テナントの ID から 決めます。 AI の 作った 引数に テナントを 入れると、 会話の 内容しだいで 別の 会社の データに 触れてしまう おそれが あります。 - 返す内容を
絞る : AI に渡した ものは、 相手に 話される 可能性が あります。 生年月日などは 返さず、 確かめた 結果だけを 返します。
voicast での会話中のツール
voicast では、tools にurl に
{
"tools": [
{
"name": "find_free_slots",
"description": "予約の空き時間を探す。相手が日付や曜日を言って空きを聞いたときに使う。",
"url": "https://api.example.com/voicast/find-free-slots",
"parameters": {
"properties": {
"date": { "type": "string", "description": "探す日(YYYY-MM-DD)" },
"period": { "type": "string", "enum": ["morning", "afternoon"], "description": "午前か午後" }
},
"required": ["date"]
}
}
]
}受け口には{ type: 'tool.call', tool, tool_call_id, arguments, call: { id, channel, provider_call_id, from, tenant: { id, external_id } } } がcall.tenant.external_id でtool_call_ididempotency-key とconfirm: true を
よくある質問
ツールはいくつまで渡せますか。
voicast のtools は
ツールの名前の付け方に決まりはありますか。
voicast では_ のfinish は
ツールの応答が 8 秒を超えそうなときはどうしますか。
会話中には