> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/voice.md).

# 音声カスタマーサービス：導入から公開まで

音声サポートを一から公開するまでの手順を説明します。組織で音声が有効になっていることの確認、まずテキストで Agent が正しく回答できる状態にすること、音声アシスタントの有効化、ウェブでの試し話し、電話回線の接続とテスト通話による確認の順に進めます。各ステップから MaiAgent Build の設定ページへ移動できます。

音声サポートでは、Agent が「聞く」「話す」ことでお客様に対応します。入口は 2 つあり、どちらも同じ Agent と同じ音声設定を使用します。

* **ウェブ音声**：お客様が Web Chat の入力バーにあるヘッドセットアイコンをクリックすると、Agent と直接音声で会話できます。
* **電話**：通信事業者または自社 PBX の SIP 回線をコールセンターに接続し、サポート専用番号にかかってきた電話に Agent が応答します。

このページでは、公開までの順にステップを紹介します。各ステップの操作の詳細は、MaiAgent Build の機能ページをご覧ください。

## 始める前の確認 <a href="#before-you-start" id="before-you-start"></a>

| 項目     | 説明                                                                                                                                                                                                                                                                                                                          |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| デプロイ形態 | MaiAgent クラウド（SaaS）で利用できます。プライベートクラウドではデプロイ設定で有効にし、リアルタイム音声コンポーネントをデプロイする必要があります。オンプレミスデプロイでは、音声アシスタントとコールセンターは提供されません。デプロイ形態ごとの機能比較は、技術マニュアルの[デプロイ形態と機能比較](https://docs.maiagent.ai/tech/platform-development/onprem-deployment-types#feature-availability)をご覧ください。                                                        |
| 組織の機能  | [組織の概要](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/organization-overview.md#advanced-features)の <mark style="color:blue;">高度な機能</mark> で <mark style="color:blue;">AI 音声アシスタント</mark> が有効になっている必要があります。電話に応答するには、さらに <mark style="color:blue;">コールセンター</mark> も必要です。有効になっていない場合は、MaiAgent の担当窓口までご連絡ください。 |
| 権限     | 音声を有効にするには、この Agent を編集できる権限が必要です。電話回線を設定するには、コールセンターの <mark style="color:blue;">着信設定</mark> 権限が必要です。詳しくは [電話サポート（コールセンター）](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/call-center.md#permissions)をご覧ください。                                                                                        |

## 公開までの流れ <a href="#setup-flow" id="setup-flow"></a>

{% stepper %}
{% step %}

### 質問に答えられる Agent を準備する <a href="#prepare-agent" id="prepare-agent"></a>

まずテキストでロール指示とナレッジベースを調整し、回答が正しいことを確認してから、音声を追加します。手順は [テキストサポート：一から公開まで](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/text-service.md) のステップ 1～2 をご覧ください。
{% endstep %}

{% step %}

### 音声を有効にする <a href="#enable-voice" id="enable-voice"></a>

Agent 設定の <mark style="color:blue;">回答モード設定</mark> にある <mark style="color:blue;">音声アシスタント設定</mark> で、<mark style="color:blue;">音声アシスタントを有効にする</mark> をオンにし、<mark style="color:blue;">音声アシスタントモード</mark> とプロバイダーを選択します。3 つのモードの違い、割り込み制御、ツールの制限については、[音声アシスタント（Voice Agent）](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/voice-agent.md)をご覧ください。
{% endstep %}

{% step %}

### 音声ウェルカムメッセージを設定する <a href="#set-voice-greeting" id="set-voice-greeting"></a>

対話プラットフォームの[インタラクション設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/interaction-settings.md#voice-greeting)で <mark style="color:blue;">音声ウェルカムメッセージ</mark> を設定します。ウェブ音声は、お客様が利用しているウェブプラットフォームの設定を使用します。電話は、この Agent の API 対話プラットフォームのデフォルトのウェルカムメッセージを使用します。
{% endstep %}

{% step %}

### ウェブで試し話しをする <a href="#test-on-web" id="test-on-web"></a>

音声を有効にすると、ウェブプラットフォームの[基本設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/basic-settings.md#public-url-and-embed)にある公開アクセス URL の下に <mark style="color:blue;">音声モード</mark> ボタンが表示され、そのまま音声会話を開始できます。ウェブサイトに埋め込んだ Web Chat の入力バーにも、ヘッドセットアイコンが表示されます。Agent が話を聞き取れているか、正しく答えているか、話す速さや口調が適切かを確認してください。
{% endstep %}

{% step %}

### 電話回線を接続する <a href="#connect-phone-line" id="connect-phone-line"></a>

ウェブ音声のみを提供する場合は、このステップを省略できます。<mark style="color:blue;">コールセンター</mark> で SIP トランクと番号を追加し、番号をこの Agent にバインドして、<mark style="color:blue;">同期ステータス</mark> が <mark style="color:blue;">同期済み</mark> になるまで待ちます。詳しくは [電話サポート（コールセンター）](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/call-center.md#setup-flow)をご覧ください。
{% endstep %}

{% step %}

### テスト通話で確認する <a href="#test-call" id="test-call"></a>

携帯電話からその番号にかけ、Agent が応答して正しく答えることを確認します。その後、<mark style="color:blue;">通話履歴</mark> でこの通話の記録と音声の文字起こしを確認します。詳しくは [通話履歴](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/call-center.md#call-history)をご覧ください。
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
コールセンターには、現在のところ有人や内線への転送設定はありません。通話を既存のコンタクトセンターシステムに転送する必要がある場合は、MaiAgent の担当窓口までご連絡ください。連携方法を検討します。
{% endhint %}

## 公開後 <a href="#after-launch" id="after-launch"></a>

* **通話の確認**：通話の記録とステータスは[通話履歴](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/call-center.md#call-history)で確認できます。各通話は 1 件の会話でもあるため、[すべての会話](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply.md)でも確認できます。
* **利用量の確認**：STT の秒数、TTS の文字数、音声モデルのトークン数は、[利用統計](https://docs.maiagent.ai/maiagent-user-guide/ja/others/usage-statistics.md#tabs)の <mark style="color:blue;">音声アシスタント</mark> タブで確認できます。
* **話し方の調整**：返信が長すぎる、またはよく割り込まれる場合は、[音声アシスタント（Voice Agent）](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/voice-agent.md)に戻って、インタラクションモードと割り込み制御を調整してください。

## 活用事例 <a href="#use-cases" id="use-cases"></a>

IVR の意図認識、通話の要約、通話品質検査など、音声データのそのほかの活用方法については、[活用事例：音声サポート](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/voicecs.md)をご覧ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/serve/voice.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
