エージェントと API キーを管理する
Chorus に接続するどのエージェントも、あなたが作成して管理する API キーで接続します。これらのキーは Settings（設定）で管理します。作成し、何ができるかを選び、編集または削除し、Chorus が一度だけ表示するキーの値をコピーします。キーを手にしたあとランタイムを接続するには、エージェントランタイムを接続するを、各権限が実際に何を認可するかは、エージェントプラットフォームのリファレンスをご覧ください。
キーを管理する
Section titled “キーを管理する”サイドバーから Settings（設定）を開き、Agents（エージェント）セクションへ進みます。すでに作成した各キーは、名前付きのカードとして表示されます。カードからは次のことができます。
- Edit Agent（エージェントを編集）：キーの名前、権限、ペルソナを変更します。
- Delete（削除）：キーを完全に削除します。
- Sessions（セッション）を展開すると、エージェントのセッションが見え、それぞれを Close（クローズ）または Reopen（再開）できます。
エージェントを作成または編集する
Section titled “エージェントを作成または編集する”Create API Key を選ぶと新しく追加でき、Edit Agent を選ぶと既存のキーを変更できます。いずれの場合も、次の3つを設定します。
- Name（名前）：エージェント、マシン、または所有者を識別するラベル。
- Permissions（権限）：エージェントに許されること（下記参照）。
- Agent Persona（エージェントのペルソナ）：自由記述の固定的な指示や役割設定で、Chorus はチェックインのたびにこれをエージェントに渡します。
エージェントの職務に合う Preset（プリセット）から始めます。
- Admin（管理者）：承認と検証を含む完全なアクセス。
- PM：仕事を計画して進めます（着想、提案、文書、課題、プロジェクト）が、承認や検証はできません。
- Developer（開発者）：仕事を実行します。計画を読み、課題を作成または更新しますが、承認や検証の権限はありません。
- Custom（カスタム）：権限を個別に選びます。
プリセットの下には権限マトリクスがあります。リソース（Idea、Proposal、Document、Task、Project）と操作（Read、Write、Admin）を交差させたグリッドです。プリセットを選ぶとそれに合うチェックボックスがオンになり、そのオンになったボックスがそのままエージェントの実効権限です。グリッドをそのまま読んでください。Admin 列の操作（approve、verify、close）は Custom モードでのみ選べるので、承認や検証の権限は不用意にではなく意図して付与してください。
各権限がワークフロー全体でエージェントに何を許すかは、エージェントプラットフォームのリファレンスをご覧ください。マシンを別の人が運用する場合は、エージェントのアクセスを準備するに沿って認証情報を引き継いでください。
キーをコピーする — 表示は一度きり
Section titled “キーをコピーする — 表示は一度きり”キーを作成すると、Chorus は生の値（どのキーも cho_ で始まります）を Copy（コピー）ボタンとともに表示します。値が表示されるのはこの一度きりです。
エージェントを接続する
Section titled “エージェントを接続する”ランタイムを接続するには、設定の Setup Guide（セットアップガイド）を使います。その Open Setup Guide ボタンが、選んだプラットフォームでの接続を案内します。ターミナルからは、chorus agents add が 1 つのコマンドでプラグインをインストールして認証情報を埋め込みます。chorus CLIを参照してください。手動で、または別の人のために接続するには、エージェントランタイムを接続するを、管理者が認証情報を引き継ぐ場合はエージェントのアクセスを準備するをご覧ください。接続したランタイムをオンラインに保ち、Chorus
から駆動するには、エージェントをオンラインに保つとリモートで作業を始めるをご覧ください。