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

# エージェント実行中のアクセス権限を管理する

> Sessionのアクセス権限とMachineの上限を設定し、tool呼出が拒否される条件を確認します。

ユーザーが操作するSessionで要求できるネイティブアクセスを選び、Machineごとにユーザー開始時と自律実行時の上限を設定します。Sessionの選択とMachineの上限が異なる場合、Cognoはより制限の強い設定を適用します。

## ユーザーが操作するSessionのアクセス権限を選ぶ

Composerの横にある盾のメニューで、Sessionのアクセスレベルを選びます。

| 選択肢 | 許可される操作 |
| - | - |
| **確認** | ワークスペース内で作業し、承認が必要な操作の前に確認します。 |
| **自動** | ワークスペース内では承認待ちで止まらずに作業し、ワークスペース外へのアクセスは制限します。 |
| **フルアクセス** | 承認なしで実行し、ワークスペース外のファイルや認証情報にもアクセスできます。 |

初回のSessionは、Machineの上限がより低い場合を除き、**自動**から始まります。別のレベルを選ぶと、Cognoは同じMachineでの選択をこのブラウザに記憶します。次にSessionを開いたときにMachineの上限が保存済みの選択より低い場合、保存済みの高い設定ではなく現在の上限から始めます。

> [!NOTE]
>
> Machineの上限は既定値ではありません。上限を**フルアクセス**へ上げても、新しいSessionが**自動**から自動的に引き上げられることはありません。

## エージェントの作業中にアクセス権限を変更する

更新済みのEngineでは、エージェントの作業中もComposerから別のアクセスレベルを選べます。Cognoは実行中の作業を停止・再起動せずに選択を保存します。

Claude Codeの一部の変更は、実行中のprocessが新しい設定に対応していれば、以後のtool要求に反映できます。Codexの変更、**フルアクセス**への変更と解除、processの設定変更が必要なその他の変更は、次のターンから適用します。すでに実行中のtoolは現在の権限を維持し、待機中の承認カードには引き続き回答が必要です。

選択できる権限はMachineの上限に従います。古いEngineでは実行中のターンのアクセス変更は利用できません。この操作を使うにはEngineを更新してください。

モバイルではEngineの更新後にアクセスメニューを開き直してください。メニューを開くと、選択中の権限を変更せずに利用可能なアクセス操作を再取得します。

## 会話で承認を判断する

自分が開始したSessionで操作に承認が必要になると、許可カードは**承認**または**拒否**を選ぶまで待機します。要求した操作はその判断を待ちます。未承認の結果を返してエージェントが先へ進むことはなく、エージェント自身が待機中のカードを承認することもできません。

**自動**はSessionのアクセス権限です。自分のMachineの会話を**自動**で実行した場合も、操作に承認が必要になるとカードの判断を待ちます。**自動**を選んでも自律実行は始まりません。

カードにタイムアウトはありません。新しいメッセージの送信、再接続、古い会話履歴の省略では回答済みになりません。ターンの停止、要求した操作の取り消し、Engineの再起動では、待機中の要求を明示的にキャンセルします。

自律実行では、Cognoは依頼元の会話で確認し、回答を待つ間も独立した作業を続けられます。要求した操作を承認なしで実行できるわけではありません。

自分で開始したローカルのTask Sessionで、元の呼出が終了した後にカードへ回答すると、Engineは判断を保存してから受け付けます。Sessionの登録中や、現在のターンがまだ通知を受け取れない場合は、Engineを再起動しても同じSessionへの通知を保持し、届けられるようになったら自動で再試行します。判断の保存だけでは、エージェントが通知を受け取ったことまでは確認できません。この回復処理は、キャンセル済みのネイティブ要求を再開したり、Sessionの継続に対する拒否を無視したりしません。

## Machineのアクセス上限を設定する

**1. Machine設定を開く**

**設定 → マシン一覧**を開き、上限を変更するMachineを探します。

**2. ユーザー開始時の上限を設定する**

**既定のアクセス権限**で、そのMachine上でユーザーが開始または継続するSessionに選べる最高レベルを指定します。

**3. 自律実行のアクセス権限を設定する**

**自律実行のアクセス権限**で、そのMachine上でCognoが自分で始める作業のレベルを指定します。新しく追加したMachineは**フルアクセス**から始まり、それ以前からあるMachineは**代わりに承認**のままです。

設定を保存できない場合、ページにはエラーと**もう一度試す**が表示されます。

## Machineごとにフルアクセスを一度確認する

このブラウザでMachineに初めて**フルアクセス**を選ぶときは、警告を確認して承諾します。CognoはそのMachineでの確認を記憶するため、後からSessionまたはMachine設定を**フルアクセス**へ変更しても、同じダイアログは再表示されません。

ブラウザの保存データを消去した場合や、コンピュータを新しいMachineとして登録し直した場合は、記憶した確認もなくなります。次に**フルアクセス**を選ぶと、Cognoがもう一度確認します。

> [!WARNING]
>
> **フルアクセス**ではネイティブ操作の承認保護がなくなります。エージェントはコマンドを実行し、ワークスペース外のファイルを変更し、OSアカウントから利用できる認証情報にアクセスする可能性があります。

**フルアクセス**にはEngine protocol 3以降が必要です。古いEngineでは選択肢が無効になり、Machine設定にEngineの更新が必要な理由を表示します。

## Toolアクセスが停止する条件を確認する

Cognoは現在の[ワークスペース](/docs/ja/concepts.md)、Project、Machine、runに基づいてtoolアクセスを検査します。以前に発行されたtokenがあっても、関係が変わった後のアクセスは維持されません。

| 変更 | 結果 |
| - | - |
| Memberの所属解除、profile削除、Projectのarchive | 以後のtool呼出は拒否されます。 |
| Taskの別Projectへの移動、Environment変更、既知のSession終了 | 古い実行contextでは呼出を認可できなくなります。 |
| Taskを持たないProject Run中のProject owner変更 | 元ownerのrunは古いcontextを使い続けられません。 |
| Machine credentialの失効またはMachine削除 | 古いrun tokenではアクセスを復活できません。 |
| Queue runの終了または新しい再試行の開始 | 以前の試行のtokenは拒否されます。 |
| 認可を検査できない | アクセス可能と仮定せず、呼出を拒否します。 |

Toolアクセスには、操作に必要なMemberの現在の権限も必要です。Catalogにtoolがあることは実行許可ではありません。外部Integrationには接続とprovider側の権限検査も必要です。

## 利用可能なProject sourceを確認する

Source探索は同じresource IDを含む接続も区別し、選択済みかつその接続の現在のcatalogに存在する対象だけを返します。個人接続は、認証された実行actorが本人の場合だけ表示します。Actorがない探索は共有接続だけを返します。探索結果は、toolがsourceを読む際の権限検査を置き換えるものではありません。

## 実行に関わるアプリを更新する

Queue claimとユーザーが操作するrunのtoken取得には、execution policyへの明示的なacknowledgementが必要です。古いEngineのMachineには、新しいqueue runのclaimやtoken発行より前に`execution_policy_upgrade_required`が返ります。実行側とWeb・Desktopアプリを協調して更新してください。互換性を戻すためにアクセス検査を無効化しないでください。

> [!WARNING]
>
> Cloudでの拒否は、コンピュータ上ですでに動いているコーディングエージェントprocessを停止しません。古いDesktopとEngineの組合せは、token取得に失敗してもlocalのユーザー操作による実行を続ける場合があります。Cloudだけを更新しても、古いlocal processが停止したことや保存policyを強制することは保証できません。

## 正しいrunの中で再試行する

ユーザー操作によるwriteにはEngineが渡す実行turnの識別子が必要です。Session登録前のreadは可能ですが、turnの識別子がないままwriteを許可することはありません。Transportのrequest番号が初期化されても、次の明示的なturnには別の識別子を使います。

Queueの再試行は同じ論理workの識別子を維持します。新しいrequest識別子を指定することは新しい権限ではなく、結果不明の外部操作を安全に再送できる根拠にもなりません。

## 関連ドキュメント

* [エージェントにTaskを実行させる](/docs/ja/agents.md)
* [Machineを設定する](/docs/ja/machines.md)
* [Projectsを扱う](/docs/ja/projects.md)
* [トラブルシューティング](/docs/ja/troubleshooting.md)


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