ページの一覧

ドキュメント

エージェントのツールの設定

会話中に AI が自社やほかの会社の API を呼び出す「ツール」を、管理画面のエージェント設定で追加し、保存の前に試す手順。署名シークレットの確認と再発行も扱います。

Markdown で見る

ツールは、AI が会話中に呼び出す API です。予約の空きの確認や顧客の検索などに使います。エージェントの画面の[ツール]で、開発者以上のロールで設定します。仕組みと自社の API の作り方は、会話中のツールを参照してください。

ツールを追加する#

  1. エージェントの画面の[ツール]で[+ ツールを追加]を押します(10 個まで)。
  2. 次の項目を入力します。
  3. 画面の下の[保存(バージョン〇になります)]を押します。
項目 内容
ツール名 半角英小文字・数字・_ の 40 文字以内(英字で始める)
説明 何をするツールか、いつ使うか。AI が使うかどうかを判断する手がかりです(500 文字以内)
URL https で始まる URL
メソッド GET か POST
署名を付ける voicast の署名(Standard Webhooks)を付けて、ツール名・引数・会話の情報を JSON で POST します。自社の API で使います
認証 認証なしか API キー。API キーを付けるヘッダーは Authorization(Bearer)かその他
引数 AI が会話から聞き取って渡す値。名前・説明・必須(20 個まで)
確認してから使う 使う前に内容を読み上げて相手の同意を得ます。予約の作成や取り消しなど、データを変更するツールに付けます
確認の文・完了の文 確認してから使うときの読み上げの文(200 文字以内)。{引数の名前} で値を差し込めます
前置きを話させない ツールの応答の say の文だけを言わせるときに付けます
相手の言葉を付けて送る 相手が直前に言ったこと(最大 5 つ)を本文の heard に付けます(署名付きのときだけ)

API キーは暗号化して保存し、保存したあとは表示しません。エージェントのバージョンにも残りません。変更するときだけ入力します。

ツールを試す#

保存の前でも、フォームの内容でツールを 1 回呼び出せます。

  1. ツールの[試す]を押します。
  2. 引数の値を入力して、[試す]を押します。
  3. 試した結果(成功か失敗・状態コード・処理時間・本文)を確認します。

試す呼び出しに会話の料金はかからず、会話の履歴にも残りません。データを変更するツールは、実際に変更されます。API が 8 秒以内に応答しないと、時間切れになります。

署名シークレットを確認する#

署名付きのツールの呼び出しは、環境ごとの署名シークレットで署名します。自社のサーバーでは、このシークレットで webhook-signature を検証します(会話中のツール)。管理者以上のロールで操作します。

  1. 左のメニューの[環境の設定]を開きます。
  2. [ツールの署名シークレット]の[表示]で値を確認するか、[コピー]でコピーします。

署名シークレットを再発行する#

シークレットが漏れた可能性があるときは再発行します。

  1. [ツールの署名シークレット]の[再発行]を押します。
  2. 確認の画面で[再発行]を押します。

再発行から 24 時間は、古いシークレットによる署名も並べて送信します。そのあいだに、自社のサーバーのシークレットを新しいものに変更してください。

本番環境とテスト環境のシークレットは別です。