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

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

Source: https://voicast.jp/docs/dashboard-agent-tools

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

## ツールを追加する

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` を検証します（[会話中のツール](https://voicast.jp/docs/tools.md#署名の検証)）。管理者以上のロールで操作します。

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

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

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

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

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

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