> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 対応が必要：コマンドの承認、質問への回答、シークレットの提供、手動での対応

> エージェントがあなたを待って一時停止したときに表示されるリクエストを説明します。コマンドの承認、質問への回答、シークレットの追加、自分で行う手順、機密の場所へのアクセスリクエスト、メール送信前の確認、セッションを開いていないときの通知を扱います。

**対応が必要**とは、セッションの実行中にエージェントが一時停止し、あなたの判断や情報の提供を待っている状態です。たとえば、コマンドの承認、質問への回答、シークレットの提供が必要な場合や、サインインなどエージェントが代わりに行えない操作をあなたに完了してもらう必要がある場合です。あなたが応答すると、セッションは自動で続行します。

## 対応環境

| 形態 | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | セッションがこのコンピューター上で実行される場合、機密の場所へのアクセスリクエストもこのコンピューターにポップアップ表示されます |
| Web アプリ | 対応 | |
| モバイル Web | 対応 | |

## リクエストが表示される場所

* **対応カード**：セッションページのメッセージボックスのすぐ上にあるカードです。すべてのリクエストがここに表示されます。複数ある場合は、同じカード内でページを切り替えます。
* **タイムライン**：コマンドの承認を除き、リクエストは発生した位置に **Waiting for your reply** · **Respond** などの 1 行を残します。**Respond** をクリックすると対応カードが展開されます。リクエストの処理後、タイムラインに記録行が残ります。
* \*\*メール送信前の確認（Gmail）\*\*は例外で、確認カードがタイムラインに直接表示されます。下記を参照してください。

## 対応カードの共通操作

| 操作 | 方法 |
| - | - |
| 送信 / 許可 | カード右下のメインボタン、または `⌘Enter`（Windows は `Ctrl+Enter`） |
| 拒否 / スキップ / 今はしない | カード下部のサブボタン |
| 後で対応 | カード右上の ×、または `Esc`。カードは「Needs your input · N pending」に折りたたまれます。クリックすると再び展開します |
| 項目の切り替え | カードヘッダーの **Previous request** と **Next request**。項目はどの順番でも処理でき、すべて処理されて初めてセッションが続行します |

* 返信が届かない場合は **Reply timed out. You can retry.** と表示されます。項目がすでに別のデバイスで処理されている場合は **Handled on another device** と表示されます。
* **Full access** に切り替えても、すでに待機中のリクエストは自動で承認されません。1 件ずつ処理する必要があります。

### キーボード

フォーカスがメッセージボックスにない場合、現在の項目をキーボードで直接処理できます。

| リクエスト | キー |
| - | - |
| コマンドの承認 | `Enter` または `1` で許可、`2` でこのタスクで許可、`Esc` または `3` で拒否 |
| 質問と選択 | `1`〜`9` で N 番目の選択肢を選択、`Enter` で送信または続行、`Esc` でカード全体をスキップ |

## リクエストの種類

| 種類 | カードのタイトル | メインボタン | その他のボタン |
| - | - | - | - |
| コマンドの承認 | **Approval** | **Allow** | **Deny**、**Allow for this task**、**Something else…** フィールド |
| 自由回答 | **Question** | **Submit** | **Skip** |
| 選択 | **Choose an option** | **Submit**（質問が複数ある場合は **Continue**） | **Skip**、**Previous** |
| シークレットの追加 | **Add secret** | **Submit** | **Skip** |
| 自分で対応する必要がある | **Needs your input** | **Done** | **Not now**、**View cloud server**、**Take control** |
| アクセスリクエスト | **Access request** | **Allow once** | **Deny** |

### コマンドの承認

権限が **Ask for approval** の場合、または **Approve for me** が安全でない可能性のある操作を検出した場合、エージェントは実行前にあなたの承認を求めます。カードには実行するコマンドが表示されます。

* **Allow**：今回のみ承認します。
* **Allow for this task**：今回を承認し、このセッションで以後の同様の操作は自動的に許可されます。
* **Deny**：コマンドは実行されず、エージェントは別の方法で続行しようとします。
* **Something else…**：要望を入力して `Enter` を押します。コマンドは拒否され、あなたの要望がエージェントに伝えられます。

権限の選び方については、[新しいセッション](https://docs.aihubmix.com/jp/cloud/sessions/new-session.md) を参照してください。

### 質問と選択に回答する

エージェントは情報が足りない場合、あなたに直接質問します。プランを選んでもらう必要がある場合は、選択肢を提示します。

* 1 枚のカードに複数の質問が含まれる場合があります。一度に 1 問ずつ表示され、**Previous** をクリックして見直すことができます。
* 選んでも自動では送信されません。各質問で **Continue** をクリックし、最後の質問で **Submit** をクリックします。
* 質問で許可されている場合、選択肢の最後に **Other…** があり、独自の回答を書くことができます。
* 機密性が必要な質問はパスワードフィールドを使い、送信後は回答がページに残りません。

### シークレットを追加する

エージェントにシークレット（たとえば `SENTRY_AUTH_TOKEN`）が不足している場合、提供を求めます。カードには理由、シークレット名、フィールドが表示され、**Used only for this task. Its value won’t appear in the chat.** と注記されます。カードを折りたたんだり別のリクエストに切り替えたりした場合は、再度入力する必要があります。長期的に必要なシークレットは、設定のシークレットページに保存してください。

### 自分で対応する必要がある

サインインや 2 要素認証コードの入力など、エージェントが代わりに完了できない手順があります。カードにはあなたが行う内容が記載されます。

1. クラウドサーバー上のセッションの場合：**View cloud server** または **Take control** をクリックしてクラウドサーバーの画面を開きます。デバイス上で実行するセッションの場合：そのコンピューター上で直接操作します。
2. 操作を完了します。あなたがクラウドサーバーを操作している間も、エージェントは一時停止しません。[クラウドサーバーのデスクトップ](https://docs.aihubmix.com/jp/cloud/cloud-host/desktop.md) を参照してください。
3. カードに戻り、**Done** をクリックします。エージェントが続行します。

その手順が不要な場合は **Not now** をクリックすると、エージェントは別の方法で続行しようとします。

### 機密の場所へのアクセスリクエスト

セッションがあなたのデバイス上で実行され、そのデバイスの **Sensitive locations** が毎回確認する設定になっている場合、エージェントはそのような場所（SSH、キーチェーン、システム設定など）にアクセスする前にあなたに確認します。

* カードには理由とパス、有効期限のカウントダウンが表示されます。
* **Allow once** は今回のアクセスのみを許可し、デバイスの権限設定は変わりません。アクセスを行うデバイス上で許可した場合、システムがもう一度確認を求めます。
* 応答する前に期限が切れると、拒否として処理され、タイムラインには **Access request expired; access was not granted** と記録されます。必要な場合は、再度メッセージを送信してエージェントに再試行を依頼してください。
* Web アプリや他のデバイスからも応答できます。アクセスを行うデバイスのデスクトップアプリにも同時に確認が表示され、最初の回答が適用されます。

デバイスの **Sensitive locations** の設定については、[実行環境](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md) を参照してください。

### メール送信前の確認（Gmail）

Gmail を接続すると、エージェントはメールを送信する前に必ずあなたに確認を求めます。タイムラインに **Confirm before sending** カードが表示され、送信者、宛先、CC、BCC、件名、本文の要約が示されます。**Send** をクリックしたときのみメールが送信されます。**Don’t send** をクリックすると送信されません。Gmail の接続については、[コネクタ](https://docs.aihubmix.com/jp/cloud/integrations/connectors.md) を参照してください。

## Composer と停止との関係

* リクエストがあなたを待っている間も、メッセージボックスは通常どおり使えます。[Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md) を参照してください。
* エージェントがあなた自身による手順の対応を待っている間にキュー内のメッセージの **Steer** をクリックすると、まずリクエストが **Not now** として終了し、その後メッセージが差し込まれます。
* **Stop this turn** をクリックすると、まだ待機中のリクエストはキャンセルされます。

## セッションを開いていないときの通知

| 場所 | 表示 |
| - | - |
| サイドバー | セッション行の末尾に **Needs your input** ラベルが表示されます。折りたたまれたプロジェクトのタイトルの右にも表示されます |
| ショートカット | `⌥⌘A`（Windows は `Ctrl+Alt+A`）で、あなたを待っている次のセッションに移動します |
| システム通知 | **Approval needed**、**Input needed**、**Action needed**。[通知](https://docs.aihubmix.com/jp/cloud/settings/notifications.md) を参照してください |

通知を確認してもリクエストは処理されません。セッションに戻って処理する必要があります。

## よくある質問

### 対応カードを折りたたんでしまいました。元に戻すには？

メッセージボックスの上の「Needs your input · N pending」をクリックするか、タイムラインのその行の **Respond** をクリックしてください。

### Allow と Allow for this task の違いは何ですか？

**Allow** は今回のみ承認します。**Allow for this task** は、このセッションで以後の同様の操作も自動的に許可します。適用されるのは現在のセッションのみです。

### 拒否するとセッションは失敗しますか？

必ずしもそうではありません。エージェントは別の方法でタスクを完了しようとします。どうしても続行できない場合は、返信で説明します。エージェントにどうしてほしいかを伝えるには、**Something else…** を使ってください。

### 入力したシークレットはチャット履歴に表示されますか？

表示されません。チャットには「secret name provided. The value stays out of the chat.」のみが記録されます。

## 関連

* [新しいセッション](https://docs.aihubmix.com/jp/cloud/sessions/new-session.md)
* [Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md)
* [エラーと復旧](https://docs.aihubmix.com/jp/cloud/sessions/errors-and-recovery.md)
* [実行環境](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md)
* [クラウドサーバーのデスクトップ](https://docs.aihubmix.com/jp/cloud/cloud-host/desktop.md)
* [通知](https://docs.aihubmix.com/jp/cloud/settings/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.