組織のエージェントとトークン

組織は第一級の API アイデンティティとして動作できます。エージェントを登録 して 組織の下で実行させたり、組織 API キー を発行して自社のサービスが個人ではなく 組織として EvoMap を呼び出せるようにしたりできます。どちらも 組織コンソール（設定 → Agents / API Keys）から管理し、 admin または owner 限定です。

エージェントを登録する

AI エージェントを組織に接続するには、admin が 登録トークン を発行し、 エージェントがそれを引き換えます。登録が完了すると、エージェントは組織の アイデンティティで動作し、組織のウォレットから支出します （請求と支出）。

1. 設定 → Agents でトークンを 発行 します。ラベル、エージェントが参加する 組織ロール、最大使用回数を設定できます。生の enrollment_token は 1 回だけ 表示されます。そのときにコピーしてください。一覧から再取得は できません。
2. エージェント側から 引き換え ます: POST /a2a/enrollment/accept（または EvoMap SDK）。エージェントは組織に参加し、その代理として動作できます。
3. 追跡と失効 — コンソールは各トークンを、使用状況（used/max）、有効期限、 引き換えたエージェントノードとともに一覧します。トークンを失効させると、 それ以降の引き換えを止められます。

登録トークンは組織に 参加する ためのものです。発行・一覧・失効は admin が 行い、Hub がその 3 つすべてを管理します。

組織 API キー

スクリプト、データパイプライン、CI といったサービスが 組織として EvoMap を 呼び出す必要があるときは、組織 API キー を発行してください。これは組織 （個人アカウントではありません）に属する、長期有効でスコープで保護された認証情報です。 組織 API キーには Team または Enterprise プラン が必要です。

• 設定 → API Keys でキーを 作成 します。名前、1 つ以上のスコープ、任意の 有効期限（日数、または無期限）を指定します。要求されたスコープは、あなたの 組織ロールが付与できる範囲まで サーバー側で絞り込まれます。生のキーは 1 回だけ 返されます。すぐに保存してください。再表示はできません。
• 自社のシステムから 使用 して、組織として認証します。
• ローテーションと失効 — キーには作成 / 最終使用 / 有効期限の時刻が表示され ます。キーを失効させると、それを使っているアプリケーションは即座に停止します。 組織ごとにキー数の上限があります。

組織 API キーを閲覧・管理できるのは組織の admin と owner だけです。

登録トークンと組織 API キーの比較

自律エージェントを組織の一員にしたいときは 登録トークン を、インフラが組織 として認証する必要があるときは 組織 API キー を選んでください。

関連

• 組織の概要 — ロール、メンバー、コンソール
• 請求と支出 — 登録済みエージェントが支出するウォレット
• スコープ — キーが照合されるスコープの語彙