エージェントを構築する

エージェントの振る舞いはPlaygroundで制御します — 左側の設定パネルにはシステムプロンプト、応答言語、ナレッジベースの設定があり、右側にはライブチャットのサンドボックスがあり、公開前に変更内容をテストできます。本ページでは、指示と人格、応答言語、モデル選択、過去の会話の確認方法について説明します。

Playgroundを開く

1. 左サイドバーのAgentsグループを開き、スイッチャーからエージェントを選択します。
2. Playgroundタブを選択します（ルート/agents/<agentId>/playground）。

エージェントの指示と人格を変更する

System Promptは、エージェントの人格、トーン、振る舞いのガイドラインを定義します。

1. Playground内のSystem Promptテキストエリアを見つけます。
2. 指示を記述または編集します。より広い編集画面が必要な場合は拡大コントロールを使用するか、プロンプト例を確認するにはTemplate Referenceを開きます。
3. 右側のサンドボックスチャットで変更内容をテストします — サンドボックスには常に現在の下書き（公開済みの内容ではなく）が反映されます。
4. 満足したら、下書きステータスバーのPublishをクリックして変更を反映します。直前の公開バージョンに戻したい場合は、代わりにDiscardをクリックします。

プロンプトの編集内容は下書きとしてバッファリングされます。入力内容は自動的に保存されますが、Publishをクリックするまで実際のユーザーには反映されません。未反映の変更がなくなると、ヘッダーに「All changes published」という表示が出ます。

エージェントの応答言語を設定する

デフォルトでは、エージェントは文脈から応答言語を自動判定します。

1. Playgroundの設定パネルでResponse Languageのコンボボックスを見つけます。
2. 言語を選択して固定するか、デフォルトのautoのままにします。
3. Publishをクリックして変更を反映します。

選択可能な言語: auto（自動判定）、英語（en）、繁体字中国語（zh-Hant）、簡体字中国語（zh-Hans）、日本語（ja）、韓国語（ko）。

システムプロンプトと同様、この設定も下書きとしてバッファリングされます — Publishするまでライブの会話には反映されません。

エージェントのAIモデルを選択する

モデルの選択はエージェントごとに設定するものではありません — 使用されるAIモデルはOmago側で管理されており、利用可能な具体的なモデルはワークスペースのプラン階層によって異なる場合があります。

ご自身のプランに含まれる内容は、Settings → Billingでご確認いただけます。応答のランダム性（temperature）や最大返信長（max tokens）もプラン階層単位で設定されており、エージェントごとに編集することはできません。

エージェントの会話履歴を確認する

Logsタブには、エージェントが行った実際の会話履歴がすべて記録されており、検索・全文閲覧が可能です。

1. エージェントを開き、Logsタブを選択します（ルート/agents/<agentId>/logs）。
2. 左側の会話一覧を閲覧または検索します（訪問者の名前またはメールアドレスで検索可能）。一覧には1ページあたり20件の会話が表示されます。
3. 会話を選択すると、中央パネルに全文のトランスクリプトが表示されます。Copy transcriptでプレーンテキストとしてコピーできます。
4. 右側の訪問者情報パネルでは、身元情報（名前、メールアドレス、電話番号）、チャネル（widget、WhatsApp、Messenger、Instagram、Telegram）、紐づくリードのステータス、同一訪問者による関連会話を確認できます。

誤った回答を修正する

エージェントが不適切な回答をした場合、トランスクリプトから直接修正できます。

1. Logsで該当の会話を開きます。
2. アシスタントのメッセージにある編集コントロールをクリックします。
3. 表示されたダイアログに修正後の回答を入力し、送信します。

修正内容は保存され、訂正情報（corrections source）としてエージェントのナレッジに反映されるため、以降同じトピックについての回答が改善されます。

Playgroundでのサンドボックスチャットは、Logsには一切記録されません — デプロイ済みのチャネルからの実際の会話のみがLogsに表示されます。