> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.
# 会話を始める
## 概要
ElevenAgentsでは、多くの場所からElevenAgents Architectを開けます。会話を開始する場所によって、Architectが最初のメッセージから持つコンテキストが決まります。失敗したテストから開いた会話では、どのテストが失敗したかをすでに把握しています。Spotlightアラートから開いた会話では、どのアラートが発生したかをすでに把握しています。
Architectは次の2つの場所で利用できます。
* **サイドバー**：ElevenLabsアプリ全体で利用できるパネルです。表示中のページを確認し、そのページ内の操作をサポートします。
* **Architectタブ**：単一のエージェント用（**Agents** > 自分のエージェント > **Architect**）またはワークスペース全体用（左側のナビゲーションで**Agents** > **Architect**）のフルスクリーンビューです。
どちらでも同じエージェント構築ツールを利用できます。サイドバーでは、閲覧中のページのスナップショットもArchitectに送信されます。フルスクリーンタブでは、[Plan mode](/docs/ja/eleven-agents/operate/architect/how-it-works#plan-mode)を使用するとライブプランパネルが追加されます。
## 一般的な起動方法
現在表示しているページ以外の特定のコンテキストなしでArchitectを開きます。
| 起動方法 | 場所 | 渡される内容 |
| ----------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Architect**ボタン | ElevenAgents全体のページヘッダー、および会話、ツール、ナレッジベース項目の詳細パネルのヘッダー | サイドバーを開くか、現在のチャットを再開します。サイドバーでは、Architectは表示中のページを確認できます。 |
| **Ask Architect** | デスクトップ版ElevenAgentsページ下部のフローティングコンポーザー | 入力したメッセージと`@`参照。現在のページ向けの質問候補も表示され、ワンクリックで送信できます。 |
| Architectタブ | **Agents** > 自分のエージェント > **Architect** | そのエージェントに限定したメッセージ。プロンプト候補は、エージェント、手順、ツール、ナレッジベース、テスト、分析、ガードレールごとに分類されます。 |
| ワークスペースArchitect | 左側のナビゲーションで**Agents** > **Architect** | 特定のエージェントではなく、ワークスペース全体に限定したメッセージ。 |
| コマンドパレット | Cmd+K（macOS）またはCtrl+K（WindowsとLinux）を押し、リクエストを入力して**Ask "…"** を選択 | 入力したテキストを最初のメッセージとして送信します。エージェントを開いている場合、パレットにはそのエージェントのプロンプト候補も表示されます。 |
| チャット履歴 | サイドバーの履歴リスト | メッセージ履歴を含む以前のチャットを再開します。 |
| **Troubleshoot** | エラー通知のボタン | エラーメッセージと、それを解決するための支援リクエスト。 |
## コンテキスト付きの起動方法
これらの起動方法では、準備済みの最初のメッセージと非表示のコンテキストを含む新しい会話が始まるため、状況を説明する必要はありません。
### 失敗したテスト
テスト実行に失敗がある場合、テスト実行の詳細と失敗したテストグループの横に**Fix with Architect**が表示されます。次の3つのオプションがあります。
* **Explain why this test failed**（複数の場合は**Summarize why these tests failed**）。
* **Suggest fixes to pass the test**（または**Suggest fixes to address the failures**）。Architectは根本原因ごとに修正案をまとめます。
* コンテキストなしで**Start a new conversation**。
Architectは、テスト実行の呼び出しIDと失敗したテストの名前を受け取ります。テストツールを使って失敗の詳細、トランスクリプト、評価結果を自ら読み取るため、回答には実行全体が反映されます。
### Spotlight
エージェントの概要ページである[Spotlight](/docs/ja/eleven-agents/dashboard/spotlight)では、複数のカードから調査結果をArchitectに渡せます。
| カード | ボタン | Architectが受け取る内容 |
| ---------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| 週間サマリー | **Analyze**、または完全なサマリー内の**Analyze with Architect** | サマリーテキストとその対象期間。Architectには、変更を提案する前にまず実際の会話に照らしてサマリーの主張を検証し、影響を受けるブランチを特定するよう指示されます。 |
| 次のステップの候補 | 各候補の**Open in Architect** | その調査候補、Spotlightが収集したコンテキスト、週間サマリー。 |
| リアルタイムアラート | **Investigate with Architect**、または**Investigate & fix** | アラートのIDと監視対象。Architectはアラートを読み取り、ノイズかどうかを確認し、修正案を提案する前に影響を受けるブランチを特定します。 |
| テストが未設定 | **Add tests** | エージェントの最初のテストを設定するリクエスト。 |
| 手順に変換 | **Convert** | エージェントのシステムプロンプトを[手順](/docs/ja/eleven-agents/customization/procedures)に変換するリクエスト。 |
Spotlightのグラフやメトリクスタイルには、専用のArchitectボタンはありません。特定のグラフについて質問するには、ページヘッダーからArchitectを開いてください。サイドバーでは、Architectが画面上の値を読み取れます。
### トリアージチケット
[トリアージチケット](/docs/ja/eleven-agents/operate/triage)で**Discuss with Architect**を選択します。Architectは会話ID、フラグが付いた問題またはレビューコメント、特定のターンに対するコメント、チケットのディスカッションスレッドを受け取ります。トランスクリプトを読み取り、問題の原因を説明し、修正案を提示します。また、完了時にはチケットへのコメントと解決済みへの変更も提案します。
チケットには、そこから開始されたすべてのArchitectチャットが記録されます。一度開始すると、ボタンは**Continue in Architect**と**New Architect chat**に変わります。チャットは開始した本人だけが閲覧できます。トリアージリストでは、Architectチャットがあるチケットに、Architectを起動した人が表示されます。
### 会話のトランスクリプト
会話のトランスクリプトで、エージェントメッセージの**Analyze**、または履歴ビューの**Analyze with Architect**アイコンを選択します。Architectは会話IDとそのメッセージのテキストを受け取り、エージェントがそのように応答した理由を説明します。
### エージェントの構築
* 新しいエージェント作成フローの**Create with Architect**では、ガイド付きの会話を開始します。Architectがエージェントの業務について一度に1つずつ質問し、その後エージェントを構築して[エージェントコンテキスト](/docs/ja/eleven-agents/operate/architect/customization#agent-context)を作成します。
* 手順ページの**Add**メニューにある**Draft with Architect**では、空の手順を作成し、Architectにその内容を書くよう依頼します。
* Architectタブのデプロイチェックリストの各項目にある**Complete with Architect**では、「ガードレールの設定を手伝って」などのリクエストを送信します。
* エージェントコンテキストと設定のエディターにある**Set up with Architect**では、`/start`コマンドを実行します。
* [プロンプトライブラリ](/docs/ja/eleven-agents/operate/architect/customization#prompt-library)に保存したプロンプトの**Run**では、そのプロンプトで会話を開始します。
### 操作後の提案
テストやツールを手動で作成した後など、一部の操作後にはArchitectへの関連リクエストが通知で提案されることがあります。たとえば「エージェントを確認して、必要な最も重要なテストを3つ提案し、それを書いてください。」などです。**Try Architect**を選択して送信します。提案を非表示にするには閉じてください。
## リソースとコマンドの参照
* コンポーザーで`@`を入力すると、特定のエージェント、ツール、テスト、手順、またはナレッジベースのトピックを参照できます。Architectは検索する代わりに、参照されたリソースを直接受け取ります。
* `/`を入力すると、`/debug`、`/test`、`/review`、`/dashboard`などのスラッシュコマンドが表示されます。完全なリストは[How Architect works](/docs/ja/eleven-agents/operate/architect/how-it-works#slash-commands)を参照してください。
* **+** > **Use a saved prompt**を選択すると、ライブラリからプロンプトを挿入できます。
## キーボードショートカット
| ショートカット | 操作 |
| ---------------------------------------------------- | -------------------------------------- |
| Cmd/Ctrl+K | コマンドパレットを開いてArchitectに質問します。 |
| Cmd/Ctrl+.を長押し | メッセージを音声入力します。離すと停止します。 |
| 空のコンポーザーでSpaceを長押し | メッセージを音声入力します。 |
| Shift+Tab | 承認モードを切り替えます：承認が必要、自動承認、プラン。 |
| Enter / Shift+Enter | 送信／改行を挿入します。 |
| Esc | 送信前の音声入力メッセージをキャンセルするか、コンポーザーを折りたたみます。 |
## ElevenAgents Architectとの会話
Architectでは、次の2つの方法で音声を使用できます。
* **音声入力**：任意のArchitectコンポーザーでマイクを選択するか、Cmd/Ctrl+.を長押しします。音声はコンポーザーに文字起こしされ、短いカウントダウン後に自動送信されます。Escでキャンセルできます。
* **音声会話**：空のコンポーザーがある開いたチャットでは、送信ボタンが**Talk to agent**と表示されたオーディオボタンに変わります。選択すると、Architectと声で会話できます。Architectは音声で応答し、引き続きツールを使用します。**End conversation**を選択するとテキストに戻ります。
音声会話は、開いているサイドバーまたはフルスクリーンチャットで利用できます。フローティングコンポーザーとArchitectタブのホームページでは、音声入力のみ利用できます。