アシスタント

アシスタントは、Echolotに組み込まれたAIエージェントです。「Create orderが失敗するのはなぜ？」「このリクエストのチェックを書いて」のように普通の言葉で頼むと、 外部エージェントと同じツールを使ってワークスペースを扱います。リクエストの一覧表示と読み取り、送信、レスポンスの読み取り、チェックの作成、 仕様の編集、モックの開始、フローの実行ができます。実行した呼び出しはパネルにその場で表示され、データを変更する可能性のある操作は、先にあなたに確認します。

アシスタントを開くCopy Anchor Link

アシスタントは、すべてのページの右側にドッキングされたパネルです。次のいずれかで開閉できます。

• ⌘ J
• 表示 › アシスタントを表示（またはアシスタントを非表示）
• ページヘッダーの最後にある、杖のボタン

アシスタントはウインドウごとに独立していて、そのウインドウのワークスペースで動作します。

パネルを広げるには、左端を左へドラッグします。ページの最小幅まで、ページから幅を譲り受けます。右へドラッグすると狭くなり、端をダブルクリックすると 通常の幅に戻ります。

モデルプロバイダを選ぶCopy Anchor Link

パネルを初めて開くと、モデルを選択と表示されます。アシスタント設定を開く…を選ぶか、設定 › アシスタントを開いて、プロバイダを追加の下でプロバイダを追加します。

追加を選びます。Echolotがプロバイダのモデルを読み込み、最初のモデルを選択します。別のモデルにするには、アカウントのモデルメニューで選ぶか、 モデルを読み込むでリストを取得し直します。プロバイダがモデルの一覧を返さない場合は、モデルフィールドにモデル名を入力します。

アシスタントを無料かつオフラインで試すには、Ollamaでモデルを動かし、デフォルトのアドレスのままOpenAI互換プロバイダとして追加します。

キーはキーチェーンに保存されるCopy Anchor Link

APIキーは、このMacのログインキーチェーンに保存されます。ワークスペースには保存されず、送信先はプロバイダ自身のアドレスだけです。アカウントの横の削除…を押すと、 そのキーがキーチェーンから削除されます。

プロバイダを切り替えるCopy Anchor Link

プロバイダが複数ある場合、設定 › アシスタント › プロバイダでチェックが付いているものが、アシスタントが使うプロバイダです。パネルからも切り替えられます。 パネルのヘッダーにあるモデルメニューには、すべてのアカウントがプロバイダ · モデルの形式で並び、その一番下のアシスタント設定…で設定を開けます。

ローカルのコーディングエージェント（CLIエージェント）Copy Anchor Link

CLIエージェントは、独自のモデルとサインインを持ち込みます。Echolotはワークスペースのフォルダでエージェントを起動し、EcholotのMCPサーバを通じてワークスペースを渡します。 そのため、先に設定 › エージェント › 開いているワークスペースの使用をエージェントに許可をオンにしてください （外部エージェントを参照）。プロバイダにCLIエージェント（ACP）を選び、次にエージェントを選びます。

コマンドは、あとからアカウントのコマンドフィールドで変更できます。会話ごとに専用のエージェントプロセスが起動し、ウインドウを閉じると終了します。 エージェント自身の権限リクエストも、あなたに確認されます。

初回の許可Copy Anchor Link

プロバイダへの最初のメッセージを送る前に、Echolotが確認します：プロバイダに送信しますか？ 確認の内容には、送信されるもの （あなたのメッセージ、アシスタントが読み取るワークスペースのデータ、ツールの結果）、送信先、そしてシークレットの値は送信されないことが書かれています。 キャンセルがデフォルトのボタンなので、↩を押しても誤って送信されることはありません。続けるには許可を選びます。

確認はプロバイダごとに1回です。Anthropic、OpenAI、Geminiで各1回、OpenAI互換サーバはサーバ（ホスト）ごとに1回、CLIエージェントはエージェントごとに1回です。 このMac上のサーバ（localhost、127.0.0.1、::1）は、Macの外に何も出ないため確認されません。ネットワーク上のほかの場所にあるサーバは確認されます。

設定 › アシスタント › データの受け取りを許可には、許可したすべてのプロバイダが一覧表示されます。許可を取り消すを押すと許可が取り消され、 次のメッセージでもう一度確認されます。

質問するCopy Anchor Link

パネル下部のアシスタントに質問…に入力します。↩で送信、⇧↩で改行、⌘.でアシスタントの動作を停止します。

新しい会話では、表示中のページに合わせた候補が表示されます。クリックすると、テキストフィールドに入力されます。

開いているものも一緒に送られるCopy Anchor Link

テキストフィールドの上のチップには、開いているものが表示されます：開いているリクエスト、テストページとその失敗したチェック、ランナーの前回の実行、 開いている仕様、モック、フロー、MCPサーバ。各チップはメッセージとともに送られるので、「このリクエスト」や「前回の実行」と言えば通じます。 チップをクリックすると、次のメッセージから外せます。もう一度クリックすると戻ります。チップにポインタを重ねると、モデルが受け取る文が表示されます。

アシスタントにできることCopy Anchor Link

アシスタントは、外部エージェントに与えられるすべてのツールグループを持っています。設定 › エージェントでオンにしているかどうかは関係ありません。 リクエストとレスポンス、チェック付きのフォルダの実行、履歴、環境、ワークスペースのフォルダと変数、仕様、モック、MCPサーバ、フローです。 そのすべてに、承認の仕組みが引き続き適用されます。

エージェントのポリシー、プロキシ、証明書、ワークスペースの認証、スクリプトを変更するツールは、アシスタントには提供されません。

ツール呼び出しは、入力と結果とともにカードとして会話に表示され、実行中、完了、失敗のどれかも示されます。テキストフィールドの下の行には、 これまでに使ったトークン数と、モデルの料金がわかる場合はおおよその費用が表示されます。

変更を承認するCopy Anchor Link

ポリシーで確認が必要な操作をアシスタントが行おうとすると、ウインドウにシートが表示されます：エージェントがデータを変更する可能性のあるリクエストを送信しようとしています。 呼び出しの内容と、送信されるとおりのリクエストが表示され、シークレットの値はマスクされます。

• 1回だけ許可は、この呼び出しだけを実行します。
• このセッションでは許可は、この呼び出しと、同様の呼び出しを、ウインドウを閉じるまで確認なしで実行します。ワークスペースへのすべての変更が対象で、 どのツールによるものかは問いません（リクエストの作成、フォルダの認証の保存、環境など）。送信の場合は、同じホストへの同じメソッドが対象です （demo.echolot.dev へのすべてのGETなど）。削除は引き続き確認され、保護された環境、新しいホスト、通常の変更より限定的なもの（フローのバージョンなど）も同様です。 これらについては、同じ呼び出しだけが対象になります。対象の範囲はシートに表示されます。
• 変更と送信の前に確認しないは、変更と、データを変更する送信のシートにあるチェックボックスです。チェックを付けて許可すると、下記の 設定 › アシスタント › 確認するタイミングがオンになります。削除、新しいホスト、保護された環境では表示されません。
• 拒否は操作を拒否し、アシスタントにもその旨が伝えられます。

新しいホストへの送信、保護された環境への送信、削除では、1回だけ許可がデフォルトのボタンではないため、↩では承認できません。5分以内に誰も答えなかった確認は 拒否されます。複数の呼び出しが待機しているときは、シートに残りの数が表示されます。

何を確認するかは、ワークスペースのエージェントのルールで決まります。ルールがない場合は次のとおりです。

確認を減らすCopy Anchor Link

設定 › アシスタント › 確認するタイミング › 削除、新しいホスト、保護された環境の前にのみ確認をオンにすると、送信と変更についての確認がなくなります。 アシスタントは、リクエスト、環境、仕様、モック、フローを作成し、POST、PUT、DELETEのリクエストを、確認なしで送信します。すべての呼び出しは引き続き会話に表示されます。 ゴミ箱への移動、アシスタントの開始時にワークスペースが使っていなかったホスト、保護された環境は引き続き確認され、エージェント向けに公開されていないフローの実行も同様です。 オンにするまではオフで、対象はアシスタントだけです。外部エージェントはワークスペースのルールに従います。

これらを緩めたり厳しくしたり、ホストや送信を制限したりするには、ワークスペース設定 › エージェントを使います。 エージェントのワークスペースのルールを参照してください。同じルールが外部エージェントにも適用されます。 そこでエージェントにこのワークスペースの使用を許可がオフの場合、アシスタントもそのワークスペースでは動作しません。

保護された環境Copy Anchor Link

保護された環境が有効な間は、メソッドやルールにかかわらず、アシスタントのすべての送信が事前に確認されます。 このセッションでは許可を選んでも、対象はその同じ呼び出しだけです。

モデルに見えないものCopy Anchor Link

• シークレットの値。 Echolotは、モデルに何かを渡す前に、すべてのシークレット変数の値を置き換えます。メッセージ、ツールの結果、エラーのどれでも同様です。 モデルに見えるのは、シークレットの名前だけです。
• 独自のパターン。 設定 › アシスタント › モデルに見せないには、1行につき1つの正規表現を入力します。ツールが返す内容のうち一致した部分は、 モデルに見える前に [hidden] に置き換えられます。シークレット変数ではないデータ、たとえば顧客IDやメールアドレスに使えます。 正規表現として正しくない行は赤く表示され、除外されます。
• レスポンスボディ全体。 レスポンスは、要約（ステータス、ヘッダー、所要時間、概要、ボディの先頭部分、チェックの結果）とハンドルとして モデルに渡されます。ボディの続きは、そのハンドルを通じて、JSONPathや検索によって少しずつ読み取られます。

次のメッセージとともに送られる内容を正確に確認するには、パネルのヘッダーにある目のボタン、モデルに見える内容を選びます。指示、ツール、会話、コンテキストが、 トークン数の見積もりとともに表示されます。

会話を保存するCopy Anchor Link

会話はこのMac上に、ワークスペースごとに保存されます。パネルのヘッダーには次のボタンがあります。

• 新規会話（鉛筆）は、新しい会話を始めます。
• 以前の会話（時計）は、このMac上の会話と、このワークスペースで共有された会話を一覧表示します。クリックすると開きます。
• 保存メニュー（矢印付きのトレイ）は、会話を残るものに変えます。

テストとして保存とフローとして保存は、会話でリクエストを1回送信したあとに使えます。

このMacのApple IntelligenceCopy Anchor Link

macOS 26でApple Intelligenceがオンの場合、Echolotは、Appleのオンデバイスモデルも小さな作業に使います。Macの外に出ることはなく、プロバイダも許可も必要ありません。

• レスポンスペインのApple Intelligenceメニュー：レスポンスを要約、エラーを説明（エラーのレスポンス用）、チェックを提案 （Echolotが実行できるチェックを追加するボタン付き）、名前を提案（リクエストの名前を変更するボタン付き）。
• 失敗したフロー実行の失敗の理由を説明と、実行中のモックのログのログを要約。
• オンにしたときのEchoのコメント。

回答にはそれぞれこのMacで回答しました。どこにも何も送信されていません。と表示されます。モデルが使えない場合、これらのボタンは表示されません。 アシスタントパネル自体は、常に設定 › アシスタントのプロバイダを使います。

サーバのツールをモデルで試すCopy Anchor Link

MCPサーバページのモデルで試すカードでは、サーバのどのツールをモデルが選ぶかを確認できます。 このサーバを使って、エージェントにどんなことを頼みますか？に、エージェントに頼みそうなことを入力して、試すを選びます。設定 › アシスタントで選んだモデルが サーバのツールを見て、どれをどんな引数で呼び出すかを答えます。実際には何も呼び出されません。ツールの入力スキーマに合わない呼び出しは、何が問題かが表示されます。 ツール名や説明がわかりにくいと、そこに表れます。

プロバイダでの最初の試行では、アシスタントと同じ初回の許可が確認されます。CLIエージェントはここでは使われません。

トラブルシューティングCopy Anchor Link

• 「まず「設定 › アシスタント」でモデルプロバイダを選択してください。」 チェックされているプロバイダがありません。プロバイダを追加するか、 設定 › アシスタント › プロバイダでチェックを付けてください。
• 「このワークスペースではエージェントがオフです」：ワークスペース設定 › エージェント › エージェントにこのワークスペースの使用を許可がオフです （workspace.toml の [agents] enabled = false）。アシスタントを使うにはオンにしてください。
• 追加やモデルの読み込みのあとにプロバイダにエラーが表示される。 キーを確認してください。OpenAI互換サーバの場合は、そのアドレスでサーバが動作していることも確認してください。 メッセージには、プロバイダ名と問題の内容が表示されます。
• CLIエージェントが起動しない。 コマンドがターミナルで実行できることと、設定 › エージェント › 開いているワークスペースの使用をエージェントに許可がオンであることを確認してください。