coordination.approve模块 05Human approval queue
扣住有风险的写入或删除,直到已登录的真人批准,并让他们看到智能体、资源和动词。
coordination.approve 是真人审批队列。没有确认令牌的写入或删除,会作为待处理请求在此等待。已登录的管理员或被授权的审批人批准或拒绝它,批准会签发一个一次性令牌供智能体重试。
coordination.approve模块 05扣住有风险的写入或删除,直到已登录的真人批准,并让他们看到智能体、资源和动词。
coordination.approve 是真人审批队列。没有确认令牌的写入或删除,会作为待处理请求在此等待。已登录的管理员或被授权的审批人批准或拒绝它,批准会签发一个一次性令牌供智能体重试。
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。两者都会写入指明决定人的账本事件。
批准会签发一个一次性确认令牌。提出请求的智能体或管理员从 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 可以带理由,但不必须。/api/v1/acp/coordination/approvals/api/v1/acp/coordination/approval读取一个请求,并向提出者显示其令牌。coordination.approvals.list以 MCP 操作列出审批请求。coordination.approvals.approve以 MCP 操作批准请求。coordination.approvals.deny以 MCP 操作拒绝请求。identity.enroll12