mcp.shadow模块 13平台模块
平台模块Shadow agent discovery
列出 MCP 网关见过的工具调用及其背后的智能体，让无人登记的调用方与已登记的并列显示。
mcp.shadow 返回 MCP 网关记录的最新事件：谁调用、调用哪个工具、处于哪种模式。每次 observe 和 enforce 调用都会无论调用方是否已登记，都向账本写入一条 mcp.shadow。将调用方与身份列表比较，就能看出无人登记的那些。
mcp.shadow模块 13列出 MCP 网关见过的工具调用及其背后的智能体，让无人登记的调用方与已登记的并列显示。
mcp.shadow 返回 MCP 网关记录的最新事件：谁调用、调用哪个工具、处于哪种模式。每次 observe 和 enforce 调用都会无论调用方是否已登记，都向账本写入一条 mcp.shadow。将调用方与身份列表比较，就能看出无人登记的那些。
该路由列出网关事件。它不会把调用方标记为未知，也不存储批准决定。控制台将调用方与注册表比较，登记某个 DID 是唯一保留的决定。
eventsmcp.shadow 事件，按读取顺序排列。atevent.actorDidevent.toolMCP 网关处的 observe 或 enforce 调用会追加一个 mcp.shadow 事件，带有 actorDid、tool、mode，以及给出时的 resource。
点击运行，将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行：任何人都可以看到其中的内容，因此请勿发送任何私密信息。
一个符合 API 接受格式的请求，以及模块返回格式的示例响应。
GET /api/v1/acp/mcp/shadow Authorization: Bearer av_workspace_•••• → 200 { events, kind, protocolVersion }
工程师把一个脚本接到网关上。它的 DID 出现在列表中，却没有注册条目，不必有人先问它是谁。
在 observe 下网关只记录。一周的事件会显示开启 enforce 之前，它会遇到哪些智能体和工具。
用 shadow: true 登记的智能体保持被标记，团队可以逐一查看自己跟踪的内容，并批准要保留的那些。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
observe 或 enforce 调用都会留下一个 mcp.shadow 事件，带有它所指名的 DID。ledger/append 的请求可以写入 mcp.shadow 事件；该类型由平台自己写入。事件不会说明其调用方是否已登记。这种比较在读取时对照身份列表进行。
模式默认为 observe，网关记录并放行调用。advise 增加分类器的建议，只有 enforce 才能拒绝。
用 shadow: true 登记 DID 会在其注册记录上设置一个标志。它不授予也不拒绝任何东西；准入仍需要许可项。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/mcp/shadow列出记录为影子调用的最新 MCP 网关事件。coordination.mcp.shadow
event.modeobserve、advise 或 enforce。event.resourcekindregistry.shadow。protocolVersionGET /api/v1/acp/mcp/shadow 将工作区的 mcp.shadow 账本事件合并到列表中，并返回最新的 50 条，每条带有时间。
Shadow 控制台还会读取 identity/list。在网关见过但不在注册表中的 DID 显示为未知，并附其调用次数、最后一次出现的时间和工具。
用 shadow: true 登记该 DID 即为跟踪它，不带则为批准它。这里没有任何操作会阻止调用方；不去管它的仍会保留在列表中。
{
"events": [
{
"at": "2026-11-01T09:14:02.118Z",
"event": {
"actorDid": "did:web:acme.example:agent:support",
"tool": "fs.write",
"mode": "observe",
"resource": "repo:payments/main"
}
}
],
"kind": "registry.shadow",
"protocolVersion": "2026-07-28"
}按 tool 筛选事件，查看到达它的每个调用方及其模式。
mcp.enforce 把网关设为 enforce，或用 coordination.quarantine 停止指名的 DID。mcp.call；该列表只包含影子事件。mcp.shadow 账本事件合并到列表中，因此由其他 Worker 实例写入的事件也会出现。observe 和 enforce 调用，而且列表只显示最新的 50 条。coordination.quarantine32coordination.fleetmap11Fleet Map一次调用读取工作区中每个智能体的许可项、租约、等待者和隔离，取材于平台已准入的内容。civics.presence14Agent presence让智能体看到哪些同伴在线以及各自持有什么，这样沉默的智能体就不会被误认为敌对的智能体。trust.get15Trust scores and autonomy读取智能体的信任分及其赢得的自主等级，使自主权跟随平台实际见到的行为。worldmodel.graph16World model graph查看您的工作区所知道的每个智能体、代码库、租约和具名资源以及它们如何连接，无需先绘制地图。cartographer.map17Cartographer edge review把资源之间的连接放在您掌控的地图上：制图员提出，真人或您编写的边界批准。tenancy.tree18Tenant tree and reach把经销商及其客户建模为一棵树，并根据委托计算谁能到达各个分支，而不是存储它。