coordination.approveモジュール 05リスクのある書き込みや削除を、サインイン済みの人が、エージェント、リソース、操作を見たうえで承認するまで保留します。
coordination.approve は人による承認のキューです。確認トークンなしで届いた書き込みや削除は、保留中のリクエストとしてここで待機します。サインイン済みの管理者または付与された承認者が承認または拒否し、承認すると、エージェントが再試行に使う1回限りのトークンが発行されます。
© 2026 Intramedial. All rights reserved. IntramedialはTrustviceの製品です。 Secured and supercharged by Avonao Labs.
不正利用の報告
プレーンのモジュール
idreasonapproval.statepending、approved、denied、expired、 のいずれか。coordination.admit はトークンのない書き込みや削除を拒否し、保留中のリクエストを残します。そのIDは approvalId として返されます。
GET /api/v1/acp/coordination/approvals はキューを一覧表示し、各項目のエージェント、リソース、操作、ゲート（human_write または ）を示します。
共有デモワークスペースでデモ用キーを使って実行します。中身は誰でも見られるため、非公開の情報は送らないでください。 coordination.approveの資料
実行を押すと、左のリクエストが共有デモワークスペースに送信されます。
共有デモワークスペースでデモ用キーを使って実行します。中身は誰でも見られるため、非公開の情報は送らないでください。
APIが受け付ける形のリクエストと、モジュールが返す形のレスポンス例です。
POST /api/v1/acp/coordination/approve Authorization: Bearer av_workspace_•••• Content-Type: { : , : }
リリースエージェントがトークンなしで repo:payments/main に書き込もうとします。リクエストは待機し、オンコールの管理者が「想定されたバッチ」という理由で承認します。
承認者が顧客テーブルの削除を見て拒否します。理由はリクエストと台帳に残り、エージェントの所有者が読めます。
管理者がチームメンバーを承認者として付与すると、キューが一人の仕事ではなくなります。付与を取り消せば権限も戻ります。
誰も判断しなかったリクエストは失効します。エージェントは次の試行で新しいリクエストを得て、古いものは後から承認できません。
モジュールは、狭い範囲について強く保証します。保証されることだけを頼ってください。
coordination.approval.approved または coordination.approval.denied イベントが台帳に書き込まれます。リクエストは24時間、トークンは15分で失効します。管理者は範囲内で変更できます。リクエストは60秒から30日、トークンは10秒から24時間です。
approval-settings、grant-approver、revoke-approver は管理者専用です。キューは判断済みの直近200件を保持します。
依頼したエージェントまたは管理者はトークンを読めます。それ以外の人には、存在することだけが見えます。
ワークスペースのAPIキーをBearerトークンとして認証します。ベースURLは https://api.intramedial.com です。
/api/v1/acp/coordination/approve保留中のリクエストを承認し、トークンを発行します。/api/v1/acp/coordination/deny保留中のリクエストを理由付きで拒否します。
usedapproval.gatehuman_write または human_delete。インテントが当たったゲートです。approval.decidedBydecidedAt に時刻が記録されます。approval.expiresAtapproval.hasTokentokenExpiresAtMs で分かります。ledgeredhuman_deleteapprove は id と任意の reason を受け取ります。deny は id と必須の reason を受け取ります。どちらも、誰が判断したかを記した台帳イベントを書き込みます。
承認すると、1回限りの確認トークンが発行されます。依頼したエージェントまたは管理者が GET /api/v1/acp/coordination/approval から読み取れます。
{
"approval": {
"id": "apr_7f3a",
"actorDid": "did:web:acme.example:agent:billing",
"resource": "repo:payments/main",
"action": "write",
"gate": "human_write",
"requestedAt": "2026-11-01T09:30:00.000Z",
"expiresAt": "2026-11-02T09:30:00.000Z",
"state": "approved",
"decidedBy": "user_ana",
"decidedAt": "2026-11-01T09:34:12.000Z",
"reason": "expected batch",
"tokenExpiresAtMs": 1793525952000,
"hasToken": true
},
"ledgered": true
}dual-control.scopes を使ってください。coordination.admit とマンデートにあります。used になり、未使用のトークンはそのまま失効します。reason なしの deny は拒否されます。approve は reason を受け取りますが、必須ではありません。/api/v1/acp/coordination/approvals/api/v1/acp/coordination/approvalリクエスト1件を読み取ります。依頼者にはトークンも含まれます。coordination.approvals.list承認リクエストをMCPアクションとして一覧します。coordination.approvals.approveリクエストをMCPアクションとして承認します。coordination.approvals.denyリクエストをMCPアクションとして拒否します。identity.enroll12coordination.lease02Resource leases and queuesリソースを一度に1つのエージェントだけが保持するようにします。リースは自動で失効し、待たなければならないエージェントにはキューがあります。civics.claims20Resource claims officeリースを取得する前に、エージェントがこれから作業する内容を表明できるようにし、2つの主張が衝突したらケースを開きます。metering.snapshot21Metered usage by workspaceプレーンがワークスペースについて数えたものを、メーターごとに、また各カウントが対応する課金メーターとともに確認できます。