identity.enroll模块 12Agent identity registry
在每个智能体行动之前赋予它自己的身份,使每个被准入的动作都可追溯到一个智能体,而绝不是共享账户。
identity.enroll 按 DID、显示名称和类型,把智能体登记在工作区注册表中。绑定了身份运行时的地方,它还会签发智能体自己的 DID,每个智能体从基线分 50 的信任档案开始。SPIFFE ID 和 SCIM 用户附着于同一注册表。
identity.enroll模块 12在每个智能体行动之前赋予它自己的身份,使每个被准入的动作都可追溯到一个智能体,而绝不是共享账户。
identity.enroll 按 DID、显示名称和类型,把智能体登记在工作区注册表中。绑定了身份运行时的地方,它还会签发智能体自己的 DID,每个智能体从基线分 50 的信任档案开始。SPIFFE ID 和 SCIM 用户附着于同一注册表。
diddisplayNamekindhouse、customer 或 partner。默认为 customer。发送 did 和 displayName。kind 为 customer、partner 或 house,默认为 customer。owner 指明智能体信任等级变化时要通知的账户。
点击运行,将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行:任何人都可以看到其中的内容,因此请勿发送任何私密信息。
一个符合 API 接受格式的请求,以及模块返回格式的示例响应。
POST /api/v1/acp/identity/enroll Authorization: Bearer av_workspace_•••• Content-Type: application/json { : , : , : }
计费智能体登记一次。之后的每次准入、租约和审批都写明它的 DID,绝不是共享的服务账户。
SCIM 资源会成为客户智能体。带 active: false 的取消配置会移除关联的智能体并收回其签发的 DID。
新的 DID 就是新的智能体,即使代码相同。它有自己的信任分,不继承任何历史。
在 MCP 网关处见过但从未登记的智能体,可以用 shadow: true 登记来跟踪它,或不带该参数登记来批准它。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
登记需要 agents.create 权限。权限矩阵把它授予所有者和管理员,令牌只有在其范围包含它时才携带。
当组织已持有其套餐所含的智能体数量时,身份运行时会以 402 拒绝该 DID,登记也随之被拒绝。
如果身份运行时在 SCIM 取消配置中漏掉了一步,请求会失败且所有智能体仍保持登记。每一步都是幂等的,因此身份提供方的重试会完成它。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/identity/enroll登记一个智能体并返回其记录。/api/v1/acp/identity/list列出工作区已登记的智能体。issuedDidspiffeIdidentity/spiffe 绑定的 SPIFFE ID(绑定之后)。ownerenrolledAtshadowtrue,即 mcp.shadow 提供的标记。skippedtrue,仅发生在没有身份运行时的 Worker 上。绑定了身份运行时时,它会为智能体签发 DID,以 issuedDid 返回。如果运行时拒绝或无法连接,登记会被拒绝,且不会记录任何东西。
智能体加入工作区注册表,其 DID 和签发的 DID 各自获得分数为 50 的信任档案。
SPIFFE ID 通过 identity/spiffe 绑定,SCIM 用户通过 identity/scim 到达,A2A 受信任的根和委托则通过 identity/a2a。
{
"agent": {
"did": "did:web:acme.example:agent:billing",
"displayName": "Billing agent",
"kind": "customer",
"enrolledAt": "2026-11-01T09:12:44.000Z",
"issuedDid": "did:web:id.example:agent:billing",
"workspaceId": "ws_acme"
},
"skipped": false
}mandates.compile 中编译的授权。trust.get 显示它现在的位置。onramp.sources 一次性规划并应用许多智能体。owner 是登记者指名的任何账户,而且是可选的。identity_active_agents 计量。displayName 必填,MCP 操作将其限制为 200 个字符。coordination.identity.enroll以 MCP 操作登记一个智能体。coordination.identity.list以 MCP 操作列出工作区已登记的智能体。trust.get15coordination.fleetmap11Fleet Map一次调用读取工作区中每个智能体的许可项、租约、等待者和隔离,取材于平台已准入的内容。civics.presence14Agent presence让智能体看到哪些同伴在线以及各自持有什么,这样沉默的智能体就不会被误认为敌对的智能体。worldmodel.graph16World model graph查看您的工作区所知道的每个智能体、代码库、租约和具名资源以及它们如何连接,无需先绘制地图。cartographer.map17Cartographer edge review把资源之间的连接放在您掌控的地图上:制图员提出,真人或您编写的边界批准。tenancy.tree18Tenant tree and reach把经销商及其客户建模为一棵树,并根据委托计算谁能到达各个分支,而不是存储它。