# エージェントの作成と編集

> 管理画面でエージェント（AI が何を話し、何を聞き取るか）をテンプレートから作成し、あいさつ・聞き取る項目・よくある質問・声などを編集する手順。

Source: https://voicast.jp/docs/dashboard-agents

エージェントは、電話に出た AI が何をどう話し、何を聞き取るかを決める設定です。左のメニューの［エージェント］で、今の環境のエージェントを一覧できます。作成と編集は、開発者以上のロールで操作します。

設定の各項目の詳しい意味と API での書き方は、[エージェント設定](https://voicast.jp/docs/agents.md)を参照してください。

## テンプレートから作成する

1. ［エージェント］で［+ エージェントを作成］を押します（エージェントがまだ無いときは、一覧の画面にテンプレートが並びます）。
2. 用途に近いテンプレートの［選択］を押します。テンプレートを使わないときは［はじめから作成］を押します。
3. ［名前］を入力します。管理用の名前で、電話の相手には聞こえません。
4. 画面の上の案内に並ぶ「〇〇歯科」などの箇所を、お使いの名前や内容に書き換えます（案内の箇所を押すと、その欄に移ります）。残っていると作成できません。
5. 必要に応じてほかの項目を変更し、［作成］を押します。

| テンプレート | 聞き取る内容の例 |
| --- | --- |
| 歯科医院の電話予約 | 用件・初めての来院か・希望の日時・名前・電話番号 |
| 飲食店の予約 | 希望の日時・人数・名前・電話番号・席や料理の希望 |
| 問い合わせの受付 | 用件・会社名・名前・折り返しの電話番号 |
| 不在時の伝言 | 誰あての伝言か・伝言の内容・会社名・名前・折り返しの電話番号 |
| 整備工場・タイヤショップの予約 | 用件・希望の作業・車種・希望の日時・名前・電話番号 |

テンプレートの中身は日本語の電話応対です。作成の画面で［テンプレートを選び直す］を押すと、別のテンプレートに替えられます。

作成すると、そのエージェントの画面が開きます。続けて[ブラウザーで試す](https://voicast.jp/docs/dashboard-agent-trial.md)で話してみてください。エージェントを電話で使うには、[テナント](https://voicast.jp/docs/dashboard-tenants.md)でこのエージェントを選びます。

## 編集する

1. ［エージェント］の一覧で、エージェントの名前を押します。
2. 項目を変更します。
3. 画面の下の［保存（バージョン〇になります）］を押します。

保存するたびに新しいバージョンになります。会話は、開始した時点の最新のバージョンで進みます（[エージェントのバージョン](https://voicast.jp/docs/dashboard-agent-versions.md)）。保存せずにページを離れようとすると、変更を破棄するかの確認が出ます。

## 項目

フォームは次の順に並んでいます。各項目の「?」を押すと、説明が出ます。

| まとまり | 項目 | 上限など |
| --- | --- | --- |
| あいさつと話し方 | 会話の言語（日本語・English・中文・한국어・相手に合わせる） | 既定は日本語 |
| | あいさつ（電話がつながった直後に読み上げる言葉） | 必須・300 文字以内 |
| | 話し方（AI の役割と話し方の指示） | 必須・1,000 文字以内 |
| 録音 | ［録音する］ | 録音するときは、あいさつで相手に知らせます |
| 会話の長さ | 会話の長さの上限（5・10・15・30・60 分） | 既定は 30 分 |
| 聞き取る項目 | キー・名前・種類（テキスト・電話番号）・必須 | 1 つ以上・20 個まで |
| 担当者に転送するとき | 条件 | 20 個まで |
| 締めの言葉 | 聞き取りが終わったとき | 必須・300 文字以内 |
| | よくある質問への回答で用件が済んだとき | 300 文字以内 |
| よくある質問 | 質問と回答 | 50 個まで |
| 音声認識と声 | 業種・用語 | 用語は 1 つ 50 文字以内で 200 個まで |
| | 声（［試聴］で聞き比べ）・話す速さ | |
| 読み方 | 書き方と読み（ひらがなかカタカナ） | 100 個まで |
| ツール | 会話中に呼び出す API | 10 個まで（[ツールの設定](https://voicast.jp/docs/dashboard-agent-tools.md)） |
| 連携 | 会話中に使う連携先と操作 | [連携](https://voicast.jp/docs/dashboard-connections.md)でつないだもの |

［聞き取る項目］の［必須］の項目がすべてそろうと、AI は締めの言葉を言って会話を終えます。［担当者に転送するとき］の条件に当てはまると、会話の結果が［担当者に転送］になります。担当者の電話への転送は、この結果をもとにお使いのシステムで行います（[電話でつなぐ](https://voicast.jp/docs/phone.md#引き継ぎ)）。

## JSON で編集する

フォームの上の［JSON］のタブでは、API の `config` と同じ形式で編集できます（開発者向け）。保存するとサーバーで形式を確認し、誤りがあれば修正する項目を表示します。［フォーム］のタブに戻ると、JSON で変えた内容がフォームに反映されます。JSON として読み取れないときは、フォームに戻れません。

閲覧者のロールでは、どの項目も表示だけになります。

## 削除する

開発者以上のロールで操作します。元に戻せません。

1. エージェントの画面の上の［削除］を押します。
2. 確認の画面で［削除］を押します。

テナントか SIP の接続情報が使っているエージェントは削除できません。確認の画面に、使っているテナントと SIP の接続情報の件数が出ます。次のどちらも済ませてから、もう一度削除してください。

- テナント: ［テナント］の［編集］で、別のエージェントに変更します（[テナント](https://voicast.jp/docs/dashboard-tenants.md#テナントを編集する)）。
- SIP の接続情報: 同じ編集の画面の［SIP の接続情報］で［編集］を押してエージェントを変更するか、接続情報を削除します（[電話番号と SIP](https://voicast.jp/docs/dashboard-sip.md#接続情報を変更する)）。

削除しても、これまでの会話記録は残ります。
