# AIエージェント **AIエージェント**は、ボットの頭脳となる存在です。性格、知識、主要言語、会話中の振る舞いを決定します。以前のキャンペーンでは「ボットとは誰か」と「誰にいつメッセージを送るか」がセットになっていましたが、エージェントは「ボットとは誰か」という部分のみを保持します。そのため、一度作成すればどこでも再利用可能です。キャンペーンは廃止され、エージェントと[ブロードキャスト](../broadcasts/broadcasts.md)の組み合わせに置き換わりました。 エージェントは、あなたがトレーニングするチームメンバーだと考えてください。名前、性格、製品知識、一連のツールを与えれば、あらゆるチャネルや、それを指定したあらゆるブロードキャストで返信を担当させることができます。 ::: walkthrough first-agent ::: --- ## 旧キャンペーンボットの移行先 **すべてのキャンペーンボットは現在エージェントになっています。データが失われることはなく、あなた自身が何かをする必要もありません。** ボットを設定済みのキャンペーンがあった場合、それぞれに対応するエージェントが作成され、同じ指示、FAQ、設定が引き継がれています。今後はそのエージェントからボットを編集することになります。 エージェントは唯一の信頼できる情報源です。その指示に変更を公開すると、その変更は、エージェントが回答するすべてのチャネルのすべての会話に即座に反映されます。別の場所にコピーする必要はありません。 **例:** エージェントの指示を更新して新しい返品ポリシーを追加したとします。そのエージェントが担当するすべての会話に、即座に反映されます。 古いキャンペーンリンクは引き続き機能します。開くと、そのキャンペーンのエージェント編集画面に移動します。[キャンペーンからブロードキャストとエージェントへの移行](../moving-from-campaigns.md)を参照してください。 --- ## AIエージェントの場所 画面左側のメインメニューにある **AI Studio** の下にある **AI Agents** をクリックします。（スマートフォンの場合はメニューが隠れているため、まず上隅のメニューアイコン **☰** をタップしてから **AI Agents** をタップしてください。） AIエージェントページには、アカウント内のすべてのアエージェントが一覧表示されます。これには、旧キャンペーンの各ボットから自動的に名前が付けられたエージェントも含まれます。リストの上部には**「新しい会話への応答者」**パネルがあり、チャネルごとにどのエージェントが新規の連絡先に対応するかを1行の要約またはチャネルごとの行で確認できます。このパネルの仕組みと現在のライブルーティングへの影響については、[エントリーポイント → 新しい会話への応答者](entry-points.md#who-answers-new-conversations)を参照してください。 ::: master-only
AIエージェントリスト。主要言語、モデル階層、アクティブステータスが表示された2つのエージェント

AIエージェントリスト — アカウント内のすべてのエージェントを、モデル階層、言語、ステータスとともに一目で確認できます。

::: --- ## エージェントに含まれるもの エージェントは、ボットの思考や対話方法を形作るすべての要素をグループ化しています。 | グループ | 内容 | |---|---| | **AI指示** | ボットのプレイブックと設定（ペルソナ、目標、ビジネスコンテキスト、ルール、エスカレーション、応答ペース、メッセージ制限、AIスピード/AI品質モデル設定など）。フィールドごとの詳細なガイドは[AIボットのセットアップ](../ai-automation/ai-bot-setup.md)を参照してください。 | | **ナレッジ** | ボットが回答の根拠とするFAQ、アップロードされたファイル、ナレッジソース。[FAQの管理](../ai-automation/faq-management.md)を参照してください。 | | **機能** | カスタム関数、MCPサーバーツール、タグ付け、タスク作成、およびボットが連絡先の名前やメールアドレスを更新できるかどうかの設定。[カスタム関数](../ai-automation/custom-functions.md)および[MCPサーバーをボットに接続する](../ai-automation/mcp-servers.md)を参照してください。 | | **メディア** | ボットが送信できる画像、動画、GIF、ボイスメモ、PDFドキュメント。[メディアライブラリ](../ai-automation/media-library.md)を参照してください。 | | **稼働時間** | ボットが応答するタイミングを制御する週次スケジュール。[ボットの利用可能スケジュール](../ai-automation/availability.md)を参照してください。 | | **フォローアップ** | 返信が途絶えた連絡先への追跡方法（クイックナッジ、見込み客へのフォロー、休眠顧客へのメッセージ）。**AIテンプレートを生成**ボタンでメッセージを自動作成できます。[自動フォローアップ](../ai-automation/follow-ups.md)を参照してください。 | | **エントリーポイント** | このエージェントが新しい会話を開始するタイミングを決定するルーティングルール。[エントリーポイント](entry-points.md)を参照してください。 | | **ステータス** | エージェントのオン/オフスイッチ。オフにすると完全に停止します。個別にAIが有効になっている連絡先であっても、ボットが接続されている場所では一切応答しなくなります。 | | **概要** | エージェント専用のダッシュボード。選択した期間の数値、準備状況スコアカード（0〜100のスコアと赤・黄・緑の信号、修正が必要な箇所の詳細）、応答場所、会話の結果。[エージェントの概要](#agent-overview)および[準備状況スコア](#readiness-score)を参照してください。 | エージェントは、連絡先リスト、開始メッセージ、チャネル、送信スケジュールを保持し**ません**。これらは[ブロードキャスト](../broadcasts/broadcasts.md)の役割です。予約の受付は、エージェントの**AI機能**タブで設定します。詳細は[予約システム](../appointments/booking-system.md#step-3--turn-on-bookings-for-your-ai)を参照してください。 --- ## エージェントの作成 AIエージェントページの右上にある **新しいエージェント** をクリックし、開始点を選択します。ダイアログには最大3つの選択肢が表示されます。 1. **ウェブサイトから構築** (デフォルトであり、エージェントを最も素早く作成する方法): ウェブサイトのアドレスを入力すると、システムがエージェントを作成します。**ページを検索** をクリックしてサイト内のページ一覧を表示し、必要なページにチェックを入れます（関連性の高いページがいくつかあらかじめ選択されています）。スキップした場合は、入力したアドレスを読み取ります。また、エージェントが学習するためのドキュメント（価格表、パンフレット、FAQなど）を追加することも可能です。名前を付け（ウェブサイトから提案された名前が表示されます）、言語を確認して、**エージェントを構築** をクリックします。 エージェントの構築中、ダイアログは画面に表示されたままになります。進行状況（ウェブサイトの読み取り、指示の作成など）が表示され、通常1〜2分で完了します。完了するとエージェントのエディタに移動し、指示と知識がすでに入力された状態になります。内容を確認し、必要に応じて調整すれば完了です。待ちたくない場合は、**バックグラウンドで続行** をクリックして他の作業を続けてください。エージェントの準備ができるまでリストには **構築中…** というバッジが表示され、作成が完了すると開けるようになります。 エージェントの構築には1〜2分かかりますが、チェックしたすべてのページをインポートするにはそれ以上の時間がかかる場合があります。25を超えるページやファイルにチェックを入れると、ダイアログにおおよその時間が表示されます。インポートの完了前でもエージェントを開いてテストすることは可能です。その場合、すでにインポート済みのページから回答が生成され、残りのページは完了するたびに追加されていきます。 ビルドが完了できない場合、ダイアログはスピナーを表示し続けるのではなく、その理由を平易な言葉で伝えます（ウェブサイトが読み取れなかった、エージェントを作成するのに十分なテキストがページになかった、アカウントのクレジットが不足しているなど）。示された問題を修正し、再度ビルドを開始してください。 2. **空白から開始:** エージェントに名前を付け、主要言語を選択して、**エージェントを作成** をクリックします。エディタに直接移動するので、指示と知識を自分で入力してください。 > **「受信/送信」の選択肢がありませんが、これはステップの欠落ではありません。** 従来のキャンペーンでは、最初に「受信」「送信」「統合」を選択する必要がありました。エージェントではその必要はありません。その区分はエージェント自体から切り離されたためです。エージェントはメッセージを送ってきた相手に「返信する」側であり、先に連絡を取ることは[ブロードキャスト](../broadcasts/broadcasts.md)の役割です。そのため、以前の「統合」設定は、現在はエージェントと、それを返信ハンドラーとして選択するブロードキャストの組み合わせになっています。ここでエージェントを作成し、送信準備ができたらブロードキャストを作成してください。 ::: note **注意:** ここで選択する言語は、エージェントの*主要*言語（指示が記述される言語）です。これはボットをその言語に固定するものでは**ありません**。連絡先が別の言語で書き込んできた場合、ボットは自動的にその連絡先の言語で回答します。どのような場合でも特定の言語で対応させたい場合は、AIの指示（AI Instructions）でその旨を指定してください（例：「常にオランダ語で返信してください」）。また、この選択は固定されるわけではなく、エージェントの「AIの指示」タブの上部にある**主要言語**からいつでも変更できます。 ::: > **English または English (UK)**。どちらも言語リストに含まれています。**English** はアメリカ英語の綴りを使用します。**English (UK)** はイギリス英語の綴りと語彙（colour、organise、mobile、flat など）を使用し、顧客にアメリカ英語を聞かせたくない企業向けです。他の主要言語と同様に、これによってエージェントが固定されることはありません。別の言語で連絡してきた相手には、その相手の言語で回答します。エージェントの話し方（トーン、使用または回避すべき言葉、地域的なスタイルなど）に関する指示は、AI Instructions タブの **Persona & Goal** または **Conversation Behavior** に記述してください。エージェントは、選択した言語に加えてその指示に従います。 > **ラテン文字で書かれた混合言語。** 自身の言語を英語と混ぜて英語の文字でテキスト送信する連絡先については、一致するオプションを選択してください：**Singlish（シンハラ語＋英語）**、**Hinglish（ヒンディー語＋英語）**、**Taglish（フィリピン語＋英語）**、**Roman Urdu（ウルドゥー語＋英語）**、**Roman Marathi（マラーティー語＋英語）**、**Banglish（ベンガル語＋英語）**、**Tanglish（タミル語＋英語）**、**Manglish（マレー語＋英語）**、または **Arabizi（ラテン文字によるアラビア語）**。エージェントは、これらの連絡先が書く方法（例：「June 26 wala room rates oya select karana room category eka anuwa wenas wenawa」）に合わせて回答します。常にラテン文字を使用し、ネイティブスクリプトは使用しません。また、各連絡先独自の混合スタイルに従います。通常の英語で書く連絡先には、引き続き通常の英語で対応します。Taglish以外のすべてのオプションにおいて、チャットの要約、アラート、および生成されたFAQは英語で記述されます。 > **ヒンディー語とマラーティー語。** 両言語とも言語リストに含まれており、デーヴァナーガリー文字（हिन्दी, मराठी）で記述されます。連絡先がマラーティー語で書く場合は **Marathi** を選択してください。これにより、エージェントはヒンディー語ではなくマラーティー語で開始し、空欄を埋めるようになります。ヒンディー語を英語の文字と混ぜて入力する連絡先には **Hinglish（ヒンディー語＋英語）** を選択してください。マラーティー語をそのように入力する（例：「price kiti aahe」）連絡先には **Roman Marathi（マラーティー語＋英語）** を選択してください。 > **フィリピン語、タグリッシュ、セブアノ語。** これら3つはすべて言語リストに含まれています。**フィリピン語**は正しいフィリピン語で記述します。**タグリッシュ（フィリピン語＋英語）**は、チャットで実際に使われる日常的なタガログ語と英語の混ざった言葉で記述します。顧客がタグリッシュでメッセージを送ってきた場合は、タグリッシュを選択してください。フィリピン語に設定されたエージェントでも正しく回答できますが、会話の内容よりも堅苦しい表現になる可能性があります。**セブアノ語（ビサヤ語）**は、タガログ語ではなくビサヤ語で記述するセブ島、その他のビサヤ諸島、およびミンダナオ島の大部分の顧客向けです。これを選択すると、エージェントはフィリピン語に流れることなく、日常的なセブアノ語で回答します。 ::: master-only
開始点カードが表示された「新しいエージェント」ダイアログ。「ウェブサイトから構築」が選択されており、ウェブサイトアドレス入力フィールド、「ページを検索」ボタン、ドキュメント行、名前および言語フィールドがある

「新しいエージェント」ダイアログ：開始点を選択します。「ウェブサイトから構築」を選択した状態でアドレスを入力し、必要に応じてページを選択してドキュメントを追加してから、「エージェントを構築」をクリックします。

::: > **「キャンペーンから抽出」をお探しですか？** その機能は廃止されました。抽出対象となる従来のキャンペーンはもう存在しません。すべてのキャンペーンボットは自動的にエージェントに変換されました。 --- ## エージェントの編集 AIエージェントリストから任意のエージェントを開くと、エディターにアクセスできます。左側にステップが並んでおり、それぞれが短い設定項目になっています。以下に順を追って説明します。すでに**アクティブ**なエージェントは**概要**（数値）から開きます。一時停止中または新規作成のエージェントは、作業の起点となる**AI指示**から開きます。 **1. 概要** — エージェント専用のダッシュボードです。過去7日間、30日間、90日間のAI応答数、返信数、返信率、新規連絡先、予約件数、使用クレジット数が表示されます。それぞれに小さなトレンドラインがあり、ベースラインがある場合は前期間との比較が表示されます。また、[準備状況スコアカード](#readiness-score)と修正が必要な箇所の詳細、応答しているチャネル、中央値の初回応答時間、チームではなくAIが回答したメッセージの割合、ダッシュボードに表示される会話の結果、AI対人間の比率、アクティビティパネル（このエージェントに限定）が表示されます。[エージェントの概要](#agent-overview)を参照してください。 **2. AI指示** — 主要言語、ペルソナ、プレイブック、応答ペース、メッセージ制限、モデル（AIスピード/AI品質）設定を1つのタブで管理します。エージェントの個性の大部分はここで決まります。各フィールドの詳細は[AIボットのセットアップ](../ai-automation/ai-bot-setup.md)を参照してください。 **テストモード**はこのタブの最初のパネルです。これをオンにすると、AIはテストリストに含まれる連絡先にのみ回答するため、実際のチャネルで安全にエージェントを試すことができます。[テストモード](#test-mode-let-the-ai-answer-only-your-test-contacts)を参照してください。 **主要言語**は、このタブの上部にあります。変更すると即座に保存されます。他のタブのように公開する必要はなく、ライブ会話に即座に反映されます。これ以降、エージェントが記述する言語が変更されます。すでに記述済みの内容（指示やFAQ）は元の言語のままですので、エージェント全体を切り替えたい場合は、それらも手動で再翻訳してください。 ::: master-only
AI Instructionsタブが開かれたエージェントエディター。上部に「Primary language（主要言語）」パネルが英語に設定されており、その下に「Instagram Story replies（Instagramストーリーズへの返信）」スイッチ、続いて「Persona & Goal（ペルソナと目標）」、「Business Context（ビジネスコンテキスト）」、「Conversation Behavior（会話の動作）」、および「Escalation & Wrap-up（エスカレーションとラップアップ）」セクションが表示されています

エージェントエディター — AI Instructionsタブ。上部に主要言語があり、左側に残りのステップがリストされています。

::: **3. 稼働時間** — エージェントが応答を許可される時間帯です。デフォルトでは**24時間年中無休**ですが、オフにすると週次スケジュールを設定できます。設定した時間外はエージェントは応答せず、受信したメッセージは次の稼働時間が始まった瞬間に自動的に回答されます。それらのチャットは、時間になるまでチャット内の**時間外**フィルターに保持されます。[ボットの利用可能スケジュール](../ai-automation/availability.md)を参照してください。 ::: master-only
エージェントエディターの「稼働時間」タブ。「24時間年中無休で稼働」トグルがオンになっている

稼働時間：デフォルトで24時間年中無休に設定されています。トグルをオフにすると、曜日や時間を選択できます。

::: **4. メディア** — 会話中にエージェントが送信できる画像、動画、ボイスメモ、PDFドキュメントです。このタブを開くとエージェント専用のメディアが表示されます。新規エージェントでも既存のエージェントでも同様に動作し、ここにファイルをアップロードすればすぐにそのエージェントで使用可能になります。[メディアライブラリ](../ai-automation/media-library.md)を参照してください。 **5. FAQとナレッジ** — エージェントの知識源です。FAQ、リンクされたナレッジソース（ウェブサイトやファイル）、ライブウェブ検索、追加のコンテキストが含まれます。これは回答品質を向上させるための最も重要な要素です。[FAQの管理](../ai-automation/faq-management.md)を参照してください。 エージェントが数百ページにリンクされたら、ナレッジソースリストの上部にある**検索ボックス**を使用して特定のページを見つけることができます。この検索ボックスは、ウェブサイト、その中のフォルダ、個々のページを一度に検索します。そのため、アドレスの一部（例：`alternatives` や `pricing`）を入力すると、ツリー全体が一致するものに絞り込まれ、それらが含まれるフォルダが開かれます。各ウェブサイトには、一致したページ数が表示されます。知っておくべき点として、検索がアクティブな間、ウェブサイトやフォルダの **すべてリンク解除** ボタンは **一致するものをリンク解除** に変わり、実際に表示されているページのみがリンク解除されます。検索によってフィルタリングされたページには一切影響しません。 同じフォルダーを共有していない複数のページをリンク解除するには、チェックボックスを使用します。各ページの行にはチェックボックスがあり、各ウェブサイトとフォルダーのヘッダーには、その中のすべてを選択する「すべて選択」機能があります（ボックス内のダッシュは、一部のみが選択されていることを意味します）。何らかの項目がチェックされるとすぐに、画面下部に選択数をカウントするバーが表示され、**リンク解除**ボタンが1つ表示されます。確認を行うと、選択したすべての項目が一括で解除されます。ページごとの削除ボタンと**すべてリンク解除**は、これまで通り機能します。 ::: master-only
エージェントエディターの「FAQとナレッジ」タブ。ナレッジソースパネルには各ページの行とウェブサイトのヘッダーにチェックボックスが表示されており、一部の行がチェックされ、画面下部には選択数をカウントする「リンク解除」バーが表示されています

FAQとナレッジ — ウェブサイトやフォルダーをまたいでページにチェックを入れると、画面下部のバーから選択した項目を一括でリンク解除できます。

::: **6. AI機能** — エージェントに許可する*アクション*です。予約の受付、[カスタム関数](../ai-automation/custom-functions.md)を通じた自社システムへの呼び出し、[MCPサーバー](../ai-automation/mcp-servers.md)ツールの使用、連絡先詳細の更新、タスク作成などが可能です。ここの**予約**パネルでは、エージェントが会議をスケジュールできるように設定し、予約可能なイベントタイプ（1つまたは複数）を選択できます。これにより、エージェントは提供するすべてのサービスに対応可能です。[予約システム](../appointments/booking-system.md#step-3--turn-on-bookings-for-your-ai)を参照してください。 ::: master-only
エージェントエディターの「AI機能」タブ。「新しい関数」ボタンがある「カスタム関数」パネルと「MCPサーバー」パネルが表示されている

AI機能：エージェントを独自のシステムに接続します。空のままにすると、単純なチャットのみを行います。

::: **7. タグ** — エージェントがチャット中に連絡先にラベルを付けることができます（例：「興味あり」、「予約済み」、「不適合」など）。各タグを適用するタイミングを記述すれば、あとはエージェントが処理します。後でこれらのタグを使用して連絡先をフィルタリングしたりセグメント化したりできます。AIが適用するすべてのタグには、返信と同様にクレジットが消費されます。Proプランではタグ1つにつき1クレジット（独自のAnthropicキーを使用する場合は無料）、Maxでは0.25クレジット、Miniでは0.15クレジットが消費されます。これらは独自のキーを使用している場合でも課金されます。タグの削除は無料ですが、ほとんどのメッセージに当てはまるようなルールを設定すると、タグの数がすぐに増えてしまいます。実際にフィルタリングや自動化を行うタグのみにリストを絞ってください。[タグの作成](../get-started/creating-tags.md)を参照してください。ルールはエージェントが返信している間のみ実行されるため、すでに行われた会話や、AIを一時停止してチームが対応した会話には、自動的にタグ付けされません。このタブにある**既存の会話に適用**をクリックして、それらの会話に対してルールを実行してください。[オンデマンドでの会話へのタグ付け](../get-started/creating-tags.md#tagging-a-conversation-on-demand)を参照してください。 タグのルールを自分で作成したくない場合は、「タグ」タブで **AIで生成** をクリックしてください。プラットフォームがこのエージェントの指示とビジネスコンテキストを読み取り、それぞれに「適用条件」が設定されたタグのセット（通常3〜8個）を提案します。これには、*興味あり* や *不適合* といったライフサイクルステージ、会話から明らかになる事実、引き継ぎの理由などが含まれます。既存のタグライブラリを最初に確認し、同じ意味を持つタグがすでにある場合はそれを再利用するため、重複が発生することはありません。**自分のタグに追加** を選択すると既存のタグを保持したまま新しいタグのみを追加でき、**すべてのタグを置き換え** を選択すると最初からやり直すことができます。実行には1クレジット（Maxティアでは0.25、独自のAIキーを使用する場合は無料）が必要で、AIが作成した行には編集するまで小さな **AI** マーカーが表示されます。ウェブサイトやドキュメントから作成されたエージェント（セットアップウィザードまたは **新しいエージェント** から作成）は、構築の一環としてタグが自動的に生成されるため、このタブは最初に開いた時点で通常すでに埋まっています。 ::: master-only
エージェントエディターの「タグ」タブ。Generate with AIのポップオーバーが開いており、「1クレジットを消費します」という行と、「タグを追加」または「すべてのタグを置換」の選択肢、「タグを追加」ボタンが表示されています

タグ — 「タグを追加」をクリックして適用条件を記述するか、「Generate with AI」をクリックしてプラットフォームにタグとそのルールを提案させることができます。各行にはWebhook URLを設定でき、「テスト」ボタンを使用してタグを独自のシステムに連携させることが可能です。

Champions Circle メンバーは、Max プランにおいてインサイダー料金が適用されます。タグ適用および「Generate with AI」実行ごとに 0.25 ではなく 0.20 となります。[Champions Circle を見る](../billing/champions-circle.md#the-insider-rate-explained) ::: **8. フォローアップ** — 返信が途絶えた連絡先への追跡方法です。最初の24時間以内のクイックナッジ、やり取りがあった後に途絶えた連絡先へのフォロー、一度も返信がなかった連絡先へのメッセージを設定できます。デフォルトではオフです。各フォローアップ枠には、テンプレートライブラリからWhatsAppテンプレートを選択してください。各タイプの動作とタイミングの設定については[自動フォローアップ](../ai-automation/follow-ups.md)を参照してください。 自分でメッセージを作成したくない場合は、フォローアップをオンにして **AIテンプレートを生成** をクリックしてください。プラットフォームがこのエージェント自身の指示とビジネスコンテキストに基づいて一連のフォローアップメッセージを作成し、進行状況を表示しながらWhatsAppに承認申請を送信します。これは、作成したばかりのエージェント、コピー、または最初からアカウントに組み込まれていたエージェントなど、あらゆるエージェントで機能します。[自動生成テンプレート](../ai-automation/follow-ups.md#auto-generated-templates) を参照してください。 **9. エントリーポイント** — このエージェントのルーティングルールです。機能や有効になるタイミングについては、[エントリーポイント](entry-points.md)を参照してください。 **10. 試用 (Try Out)** — 実際の顧客に公開する前に、あなたが顧客になりきってエージェントの回答をテストできるサンドボックスチャットです。このエージェント上で直接実行されるため、テスト前に何かを接続する必要はなく、各エージェントは独自のテスト会話を保持します。詳細は[チャットプレイグラウンド](../chats/playground.md)を参照してください。「試用」は[テストモード](#test-mode-let-the-ai-answer-only-your-test-contacts)とは異なります。「試用」では実際のチャネルに何も送信されませんが、「テストモード」では実際のチャネルでエージェントを実行しつつ、テストリストに含まれる連絡先に対してのみAIが回答します。 --- ## エージェントの概要 すべてのエージェントには**概要**ステップがあります。これはエディターの最初のステップであり、AIエージェントリストからアクティブなエージェントをクリックしたときに開く画面です。ブロードキャストに独自の統計ページがあるのと同様に、エージェントごとのダッシュボードとして機能します。 ::: master-only
アクティブなエージェントの概要ステップ：7日/30日/90日の期間切り替え、AI応答数・返信数・新規連絡先・使用クレジット数のKPIカード（トレンドライン付き）、準備状況スコアカード（スコアリング、注意が必要な項目、推奨される次のステップボタン、6つのセクションバー）

概要ステップ — アクティブなエージェントはここから開きます。期間ごとの数値、準備状況スコアカード、応答場所、会話の結果が表示されます。

::: - **数値。** 上部で**過去7日間**、**過去30日間**、または**過去90日間**を選択します。カードにはAI応答数、返信数（下に返信率）、新規連絡先、予約件数（このエージェントが予約を受けた場合のみ）、使用クレジット数が表示されます。各カードには小さなトレンドラインがあり、比較対象となる前期間がある場合はその変化が表示されます。このエージェントの活動のみがカウントされます。連絡先が後で他のエージェントに移動しても、その履歴は発生した場所で保持されます。各カードのカウント定義：**AI応答数**は、このエージェントを通じてAIが送信したすべてのメッセージ（バブル単位）です。AIが回答を3つのバブルに分割した場合、3回としてカウントされます。**返信数**は連絡先からの返信メッセージ数です。**新規連絡先**はこのエージェントとの会話を通じて作成された連絡先です。**予約件数**はエージェントが行った予約数です。**使用クレジット数**は応答やツール呼び出しで消費されたクレジットです。AI応答数は通常、返信数よりも多くなります。これは、1つの受信メッセージに対して通常複数のバブルで回答し、フォローアップもカウントされるためです。各カードの小さな**i**アイコンにカーソルを合わせると正確な定義が表示されます。 - **準備状況。** スコアカード全体：スコアリング、信号機、6つのセクションバー、**注意が必要**または**正常に動作中**の下にある各チェック項目。それぞれに修正用のボタンがあります。スコアの詳細は[準備状況スコア](#readiness-score)を参照してください。 - **応答場所。** 有効なエントリーポイントがルーティングするチャネル、期間内の初回応答時間の中央値、チームではなくAIが回答したメッセージの割合。**エントリーポイント**をクリックするとルーティング設定が開きます。 - **会話の結果、AI対人間、アクティビティ。** ダッシュボードと同じ3つのパネルが、このエージェントに限定されて表示されます。人間が介入せずに解決した会話、エスカレーション、不満を持つ顧客、回答できなかった質問、未完了のセールス、AIと人間の比率、最新の返信、予約、アラートなどが含まれます。 このステップの項目はクレジットを消費しません。すべてアカウントに保存されているデータに基づく単純なカウントです。ソースが利用できないブロックは、ゼロを表示する代わりにその旨が表示されます。 --- ## 準備状況スコア すべてのエージェントには0〜100の**準備状況スコア**が設定されています。これは、すべてのステップを手動で開いて確認しなくても、「このエージェントは実際の顧客と会話できる状態か？」という問いに対する迅速な回答となります。スコアは以下の3箇所で確認できます。 - **AIエージェントリスト**には、各エージェントのスコアを色付きのドットで示す**準備状況（Readiness）**列があります。スコアをクリックすると、そのエージェントのスコアカードに直接移動できます。リストの上部にある**準備状況（Any readiness / Ready / Needs attention / Action required）**チップで、リストを色ごとにフィルタリングできます（各チップには件数が表示されます）。その横にある課題ピッカーを使用すると、特定の問題（エントリーポイントがない、FAQがない、一時停止中、テスト未実施、予約設定が未完了、フォローアップが不完全、接続されていないチャネルがある、指示が不足しているなど）に絞り込むことができます。多数のクライアントエージェントを管理する代理店は、対応が必要なエージェントを数秒で見つけることができます。 - **エージェントエディターのヘッダー**には、「アクティブ/一時停止」のピルの横にスコアが表示されます。これをクリックすると、スコアカードがある「概要（Overview）」が開きます。 - **概要ステップ**（エディターの最初のステップ）には、数値の下にスコアカード全体が表示されます。 ::: master-only
AIエージェントリスト。準備状況列にはエージェントごとの色付きドットと100点満点のスコアが表示され、その上部には「Any readiness」「Ready」「Needs attention」「Action required」のフィルタチップと「Any issue」ピッカーが配置されています

AIエージェントリスト — エージェントごとの準備状況スコア。テーブルの上部には色と課題のフィルターがあります。

::: ### 色の意味 - **緑 — 準備完了（Ready）**（80点以上、不備なし）：エージェントは設定・接続されており、応答可能です。 - **黄色 — 注意が必要（Needs attention）**（50〜79点、またはチェック項目で不合格あり）：エージェントは動作しますが、何かが不足しているか、設定が不完全です。 - **赤 — 対応が必要（Action required）**（50点未満、または重大なチェック項目で不合格）：エージェントが本来の役割を果たせません。重大なチェック項目とは、エージェントの動作を完全に停止させる要因（エントリーポイントがない、会話がルーティングされているのに一時停止中、予約機能がオンで予約言語があるのに予約先がない、ルーティングされたチャネルが接続されていない、指示が全くないなど）を指します。 ### スコアの対象 スコアは6つのセクションで構成されており、それぞれに固定のポイントが割り当てられています。 | セクション | ポイント | チェック項目 | |---|---|---| | **指示** | 25 | ペルソナと目標、ビジネスコンテキスト、会話ルール、「人間へのエスカレーション」ルール、およびメッセージ制限。 | | **知識** | 25 | リンクされたFAQ（5つ以上で満点。リンクされたWebページやアップロードされたファイルから生成されたFAQもカウントされます）、リンクされたWebサイトまたはファイル、リンクされたすべてのソースの処理、および価格情報の記載。手書きのFAQセットのみでWebサイトへのリンクがないエージェントの場合、「Webサイトまたはファイルがリンクされていません」を「このエージェントには該当しません」とマークすることで満点を獲得できます。 | | **機能** | 15 | 予約：指示に予約やアポイントメントに関する言及がある場合、予約機能が有効で、イベントタイプ（またはプロバイダー）がリンクされている必要があります。予約機能が有効でリンク先がない場合や、指示に予約の言及がないエージェントで予約機能が有効な場合は警告となり、修正ボタンは「予約をオフにする」となります。添付されたカスタム関数やMCPサーバーは引き続き存在し、有効です。指示でメールアドレス、電話番号、名前を求めている場合、エージェントはそれらを保存できます。 | | **稼働時間とフォローアップ** | 10 | 24時間体制または十分な稼働時間があるスケジュール、有効なアカウントのタイムゾーン、およびフォローアップが有効な場合は、承認済みのWhatsAppテンプレートが選択されていること。 | | **エントリーポイントとルーティング** | 15 | 少なくとも1つの有効なエントリーポイントが会話をエージェントにルーティングし、応答するすべてのチャネルが接続されていること。 | | **ライブステータスとテスト** | 10 | エージェントがアクティブであり、「試用」または過去90日以内の実際の会話への応答を通じてテスト済みであること。 | 各チェック項目には、獲得したポイント、1行の説明、そして問題がある場合には修正ステップへ移動する（またはその場でエージェントを有効化する）ボタンが表示されます。スコアカードには、次に実行すべき最も重要なアクションも示されます。AIエージェントリストのスコアやエディターヘッダーのバッジをクリックすると、該当箇所に移動します。エージェントに適用されないチェック項目（予約機能を使用していない、外部ツールが添付されていないなど）は、網羅性のために表示されますが、ポイントには影響しません。 知っておくべきいくつかの点： - **スコアは公開されている内容に基づきます。** まだ公開していない下書きの変更は、**公開**をクリックするまでカウントされません。スコアカードにはその旨が記載されており、公開後に**再チェック**を実行することで反映されます。 - **ウェブサイト埋め込みコード経由でのみ使用されるエージェント**にはエントリーポイントの行がないため、ルーティングチェックでフラグが立てられます。埋め込みは独自にルーティングを行うため、このようなエージェントについてはそのチェックを無視して構いません。 - **クライアントアシスタントエージェント**（代理店がクライアントに提供するアプリ内ヘルパーで、「設定」>「ホワイトラベル」で設定）は、チャネルにルーティングされることがないため、エントリーポイント、接続済みチャネル、稼働時間、フォローアップ、機能、メッセージ制限、一時停止スイッチについてはスコア化されません。これらのチェックは適用外であるという注記とともに合格として表示され、スコアは指示と知識に基づいて算出されます。 - **予約を行うべきではないエージェント**で予約スイッチがオンになっている場合（古い設定の名残）、"予約がオンになっていますが設定されていません"と表示され、**予約をオフにする**ボタンが表示されます。これをクリックするとチェックはクリアされます。いずれにせよ、その状態のエージェントが予約を行うことはありませんでした。 - **一部のチェックは推測に基づいているため、上書きが可能です。** "予約について言及されていますが有効になっていません"は、テキスト内の予約に関する*指示*（"通話を予約する"、"枠を提案する"、"plan een afspraak"など）を探します。単なる予約関連の単語や、製品の説明（"AIが予約を管理します"）、否定的なルール（"通話を提案しないでください"）は無視されますが、特殊な言い回しを誤読する可能性があります。"保存できない詳細情報を求めています"や"価格について言及されていません"も同様です。これら3つのチェックには**このエージェントには関連しません**ボタンがあり、クリックすると以降は合格としてカウントされ、「機能している点」の下に**無視**タグが表示されます。考えが変わった場合は**再チェック**リンクから元に戻せます。これら3つのチェックだけでエージェントのスコアが赤くなることはありません。 - **スコアが赤くなっても、機能がオフになることはありません。** これはレポートであり、制限ではありません。エージェントはこれまで通り回答を続けます。 - API経由では、同じレポートを `GET /v1/agents/health`（すべてのエージェント）および `GET /v1/agents/{agentId}/health`（特定のエージェント）として取得できるため、代理店のダッシュボードやアシスタントからも読み取ることが可能です。 > **「添付キャンペーン」ステップをお探しですか？** その機能は廃止されました。これはエージェントが応答するキャンペーンの読み取り専用リストであり、設定項目はありませんでした。どの会話がエージェントに到達するかは**エントリーポイント**によって決定され、[ブロードキャスト](../broadcasts/broadcasts.md)は作成時に独自の返信ハンドラーを選択します。エージェントへの変更を公開すれば、これまで通り、エージェントが応答するすべての会話に即座に反映されます。 エージェントの話し方（指示や回答設定：**AI品質**ティア、AI速度、タイピング速度、応答遅延、最大メッセージ数など）に対する変更は、**ドラフト**として保存されます。「試用」チャットでは即座に反映されますが、実際の会話は以前の設定のまま継続されます。ドラフトが存在する場合、エディタ上部に未公開の変更内容を示すオレンジ色のバナーが表示されます。エージェントの回答に満足したら**ライブに公開**をクリックし、ドラフトを破棄して以前のライブ設定に戻す場合は**破棄**をクリックしてください。これにより、顧客に未完成の変更を見せることなく、ライブエージェントの文言を安全に調整・テストできます。AI品質ティア（**Max**、**Pro**、**Mini**）の切り替えも同様に機能します。「試用」では新しいティアが即座に使用され、実際の会話には公開した時点で適用されます。 それ以外の設定はすべて即座に保存され、保存した瞬間に顧客に対してライブ状態になります。これには、エージェント名、オン/オフの切り替え、言語、テストモードとその連絡先リスト、リンクされたFAQ、ナレッジソース、ナレッジグループとAIウェブ検索、カスタム関数、MCPサーバー、予約とOdoo、フォローアップ、タグ、メディアライブラリ、Instagramストーリーおよびシェア返信設定が含まれます。これらのタブやパネルの見出しの横には**即時保存**という小さなタグが付いているため、どのような種類の変更を行っているかを常に確認できます。バナーにも同様の記載があり、下書きは指示と返信設定を対象とし、**即時保存**とマークされたパネルは即座にライブへ反映されます。 ドラフトによる変更内容を正確に確認するには、バナー内の **View changes** をクリックしてください。変更された各設定について、現在の設定内容とドラフトの内容が並べて表示されます。削除されたテキストは赤色で取り消し線が引かれ、追加されたテキストは緑色で表示され、スイッチは **On** または **Off** として示されます。**Publish to live** をクリックすると同じリストが開きます。各設定には **Show changes** トグルが用意されているため、確定する前に変更前後の状態を最後にもう一度確認できます。 **AIで最適化** は「試用」チャットパネルのヘッダーにあり、作成したばかりのコピー、最初からアカウントに組み込まれていたもの、1年間運用しているものなど、すべてのエージェントで利用可能です。改善したい内容を記述する（または期待外れだった返信の下にある低評価ボタンをクリックする）と、エージェントの指示が書き換えられます。変更が保存される前に、提案されたすべての変更を並べて確認できます。承認した内容は他の編集と同様にドラフトとして保存されるため、**ライブに公開** をクリックするまで実際の会話に反映されることはありません。詳細は [チャットプレイグラウンド](../chats/playground.md#optimize-with-ai) を参照してください。 ### バージョン履歴と変更の取り消し **ライブに公開**をクリックするたびに、DM Champはバージョンを保存します。これには、どの設定が変更されたか、変更前はどうだったか、変更後はどうなったかが記録されます。**AIで最適化**の実行も、提案された変更内容とともに記録されます。通常の保存は記録されません。保存は下書きにのみ影響するため、リストには重要な変更のみが短く記録されます。 エージェントエディターの右上、**Optimize with AI**の隣にある**Version history**ボタンから開きます。このボタンは、未公開の変更があるかどうかにかかわらず常に表示されています。各エントリには、公開によるものかAI最適化によるものか、いつ実行されたか、エージェントのどの部分に変更が加えられたかが表示されます。エントリの**Show changes**をクリックすると、フィールドごとに変更内容が平易な言葉で確認できます。指示やペルソナなどの長いテキストは、新旧の文言が行ごとに表示されます。スイッチは**On**または**Off**と表示され、設定が空の場合は**Not set**と表示されます。フォローアップ設定などの設定グループについては、実際に変更された設定のみがリストアップされ、それぞれに新旧の値が表示されます（例：**Cold lead wait times: 72h → 72h, 168h**）。そのようなグループの**Show raw**をクリックすると、保存された内容を正確に確認でき、サポートに問い合わせる際に役立ちます。最新の20件のエントリが最初に読み込まれます。それより前のエントリを確認するには、リストの下部にある**Load older versions**をクリックしてください。 以前の設定に戻すには、目的のエントリにある**下書きとして復元**をクリックします。その変更前の値が下書きに読み込まれますが、まだライブには反映されません。その後は通常の手順に従います。**試す**でエージェントをテストし、問題がなければ**ライブに公開**をクリックします。復元した下書きを破棄して現在のライブ状態を維持したい場合は、**破棄**をクリックしてください。 **即時保存**とマークされた設定は、下書きを経由することはありません。これらの設定が変更されると、リストには**ライブ変更済み**というバッジが付いたエントリが追加され、いつ何が変更されたかを確認できます。これらのエントリには**下書きとして復元**ボタンはありません。復元すべき下書きが存在しないためです。設定を元に戻す場合は、エディタ内で再度変更を行ってください。 アプリ内のヘルパーがエージェントに対して行った変更も下書きに反映されます。そのため、自分で入力した編集内容と全く同様に、アンバー色のバナーに表示され、公開されるのを待機する状態になります。 API経由で行われた変更は動作が異なります。APIを通じてエージェントに送信されたフィールドは即座に反映され、バージョンとして保存されることはありません。ただし、ドラフト変更として送信し、その後公開した場合はその限りではありません。詳細についてはAPIガイドを参照してください。 ::: master-only
エージェントエディター上に表示されたバージョン履歴ドロワー。各リビジョンには「公開済み」のバッジと「変更を表示」「下書きとして復元」ボタンが付いています。最新のリビジョンが展開され、追加された行がハイライトされたペルソナテキストが表示されています

バージョン履歴 — 公開ごとに1行ずつ表示されます。「変更を表示」をクリックすると古い文言と新しい文言が並べて表示され、「下書きとして復元」をクリックすると古い値が下書きに読み込まれます。

::: --- ## エージェントのオン/オフの切り替え すべてのエージェントは**アクティブ**または**一時停止**として表示されます。AIエージェントリスト（上記のスクリーンショットを参照）では行のアクションにある一時停止/再生アイコンボタンで、エージェントの編集画面では名前の横にあるステータスバッジで確認できます。これは強力な停止スイッチです。エージェントがオフになると、使用されているすべての場所で返信が停止します。これは、連絡先ごとの「AIオン」設定によって上書きすることはできません。この設定は、そのエージェントが使用されているすべての場所（応答するすべてのチャネル、およびそれを指定しているすべてのブロードキャスト）に適用されます。 --- ## テストモード：テスト用の連絡先にのみAIが回答するようにする テストモードを使用すると、実際の顧客に影響を与えるリスクなしに、実際のWhatsApp番号、Instagramアカウント、またはその他のチャネルでエージェントを試すことができます。テストモードがオンの間、エージェントは各チャネルに接続されたままですが、AIはテストリストに追加した連絡先にのみ回答します。それ以外の連絡先に対して、AIは一切反応しません。 リストに含まれていない連絡先に対しては、引き続き以下の動作が行われます： - メッセージは通常通り**チャット**に届くため、何も失われません。 - あなたやチームメンバーが直接返信することができます。 - AIは返信せず、フォローアップメッセージも送信せず、InstagramやFacebookのコメントにも回答しません。 ブロードキャスト、WhatsAppテンプレート、およびユーザー自身が送信するメッセージは、テストモードの影響を受けません。 ### テストモードをオンにする 1. **AIエージェント**リストからエージェントを開きます。 2. **AIの指示**ステップに移動します。一番上の最初のパネルが**テストモード**です。 3. **テストモード**をオンにします。 4. **AIが応答する連絡先**の下で、チャネルを選択し、電話番号、メールアドレス、またはハンドルを入力して**追加**をクリックします。コンマで区切ることで、複数を一度に貼り付けることもできます。 ::: master-only
エージェントのAIの指示ステップの上部にあるテストモードパネル。オンになっており、チャネル選択ツール、連絡先を追加するボックス、リスト上のTelegramハンドルと電話番号が表示されている

テストモード。Telegramハンドルとテスト用番号が追加され、オンになっています。AIは、このリストにある連絡先にのみ、それぞれのチャネルで応答します。

::: すべての変更は即座に保存され、公開する手順はありません。また、変更のたびにエージェントの [Version history](#version-history-and-undoing-a-change)（バージョン履歴）に **Changed live**（ライブ変更）エントリが追加されるため、テストモードがいつ切り替えられたか、リストがいつ変更されたかを確認できます。その後、AIエージェントリストおよびエディタ上のエージェントのステータスの横に青い **Test mode**（テストモード）バッジが表示されるため、オンになっていることを忘れることはありません。 リストが空の状態でテストモードをオンにすると、連絡先を追加するまでAIは誰にも回答しません。 ### リストに追加するもの 最初にチャネルを選択してから、そのチャネルで連絡先を識別する情報を追加します： - **電話 (WhatsApp、SMS):** 国番号を含む電話番号です（例: `+31 6 1234 5678`）。スペース、ダッシュ、括弧は無視され、`0031...` も有効です。国番号のない番号は一致しません。電話番号は WhatsApp および SMS でのみカウントされます。番号を非公開にしている WhatsApp の連絡先は、代わりに WhatsApp ユーザー ID（2文字、ドット、長いコードの形式。例: `US.13491208655302741918`）を使用して「電話」に追加できます。 - **Instagram、Messenger、Telegram、LinkedIn およびその他のチャネル:** ハンドル名（`@` の有無は問いません）、メールアドレス、または連絡先に表示されるアカウント ID を入力します。 各エントリは、選択したチャネルでのみ有効です。なぜなら、Instagramの`@john`とTelegramの`@john`は別々の人物だからです。同じ人物を2つのチャネルでテストするには、チャネルごとに1回ずつ追加してください。リストには、各エントリの横にチャネルが表示されます。 チャネル機能が存在する前に追加されたエントリには**任意のチャネル**と表示されます。これらはWhatsAppとSMSを除くすべてのチャネルで引き続き機能しますが、制限を設けるには、一度削除してからチャネルを指定して再度追加してください。 連絡先が送信してきたチャネルのリストに、その電話番号、メールアドレス、ハンドル、またはIDが含まれている場合に一致とみなされます。リストには最大200件まで登録できます。 ### 本番環境への移行 エージェントの動作に問題がなければ、**テストモード**をオフにしてください。その瞬間から、AIは以前とまったく同じように、再びすべての人に応答するようになります。テストリストは保持されるため、後で再度入力することなくテストモードをオンに戻すことができます。 ::: master-only テストモードはエージェントごとに保存されます。エージェントを複製してもテストモードは維持されますが、スナップショットを別のアカウントに移行してもテストモードは引き継がれません。 ::: --- ## エージェントの名前変更、複製、削除 - **名前の変更**: エージェントエディター上部にあるエージェント名をクリックして新しい名前を入力し、Enterキーを押します。名前の変更は即座に反映され、エージェントが表示されるすべての場所に適用されます。 - **複製**: AIエージェントリストの各行にあるコピーアイコン（ツールチップは**エージェントを複製**）をクリックすると、現在の設定をコピーした新しいエージェントを作成できます。コピーは元のエージェントのオン/オフ状態を維持するため、有効なエージェントをコピーすると、そのコピーも有効になります。元のエージェントの**メディアライブラリ**にあるファイルはコピーされません。コピーで使用するファイルをアップロードしてください。コピーは「(copy)」という名前でエディターに開かれます。名前をクリックして独自の名前を付けてください。コピーには独自の空の**試用**会話が用意されるため、コピーのテストが元のエージェントのテストチャットに表示されることはありません（その逆も同様です）。 - **削除**: エージェントがブロードキャストやエントリーポイントで使用されている間は削除できません。先にそれらを別のエージェントに向けるか削除してから、エージェントを削除してください。何も使用していないエージェントはすぐに削除されます。古いキャンペーンから同じ名前のブロードキャストと一緒に引き継がれたエージェントは特別なケースです。そのブロードキャストは同じキャンペーンのビューであるため、削除をブロックしません。また、ブロードキャスト自体を（送信中やスケジュール設定中でない限り）ブロードキャストページから削除することもできます。手動で追加していないエントリーポイントには注意してください。セットアップウィザードで**コメントからDMへ**のユースケースを選択すると、新しいエージェントにInstagramおよびFacebookのコメントルールが作成されます。これらは、エージェントの**エントリーポイント**タブで削除するまで「使用中」としてカウントされます。 --- ## リストからエージェントのオン/オフを切り替える 各行のアクションにある再生/一時停止アイコンを使用すると、エージェントを開かずにオン/オフを切り替えることができます。一時停止は即座に実行されます。一時停止中のエージェントをオンにする場合は、確認を求められます。これは、オンにした直後から各チャネルで実際のコンタクトへの応答が開始されるためです（WhatsApp Web回線の場合は、お客様自身の番号が使用されます）。本番環境で公開する前に、**Try Out**（テスト）で動作を確認してください。 ## 複数のエージェントを同時に操作する エージェントページの各行にはチェックボックスがあります（ヘッダーのチェックボックスは現在表示されているすべてを選択します）。エージェントを選択すると、下部に**有効化**、**一時停止**、**削除**のバーが表示されます。それぞれ、実行前に確認を求められます。削除を実行すると、ブロードキャストやエントリーポイントで使用中のエージェントはスキップされます。それらの使用を解除すれば、次回の削除で削除できるようになります。選択を解除するには、Escキーを押してください。 --- ## 次のステップ - [Broadcasts](../broadcasts/broadcasts.md) — 単発または継続的なメッセージを送信し、どのエージェントが返信を処理するかを選択します。 - [Entry Points](entry-points.md) — 受信した会話をどのエージェントが引き継ぐかを決定するルーティングルール。また、それらがアカウントで現在有効になっているかどうかも確認できます。 - [Setting Up Your AI Bot](../ai-automation/ai-bot-setup.md) — 指示、プレイブック、応答設定を作成するための完全ガイド。 - [Managing FAQs](../ai-automation/faq-management.md) — エージェントにすぐに使える回答を提供します。