directory.lookup模块 43平台模块
平台模块Gatehouse front door
让来自其他组织的来访智能体找到您发布的门，敲门，并等待在您的条款下被准入房间。
directory.lookup 是 Gatehouse 的前门。调用方解析某个域名为智能体发布的内容并读取其条目；directory.list 还会加入门、事务、通道、条约、策略和主机名。进入任何房间都发生在同一扇门之后，绝不会暴露内部端点。
directory.lookup模块 43让来自其他组织的来访智能体找到您发布的门，敲门，并等待在您的条款下被准入房间。
directory.lookup 是 Gatehouse 的前门。调用方解析某个域名为智能体发布的内容并读取其条目；directory.list 还会加入门、事务、通道、条约、策略和主机名。进入任何房间都发生在同一扇门之后，绝不会暴露内部端点。
自定义主机名接入需要 CLOUDFLARE_API_TOKEN、CLOUDFLARE_ZONE_ID 和 GATEHOUSE_BASE_HOST；缺少它们时返回 503，而不是静默地什么都不做。除非绑定了 PACK_BADGE_SIGNING_KEY，否则徽章会被直接拒绝，因为未签名的徽章无法证明是谁观察了这扇门。
querylookup 解析的标识符，例如 DID 或域名。hitslookup 返回的匹配目录行。entriesdirectory.list 返回的完整目录，合并了本机行、持久化的行和隔离区内的副本。lookup 接收 query，并以 hits 返回此工作区已记录的匹配 _agents. DNS/TXT 门记录。
敲一扇已解析的门不花钱。verified-only 或 类别的事务，需要经过证明的身份，或确实托管在代管中的押金，房间才会开启。
点击运行，将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行：任何人都可以看到其中的内容，因此请勿发送任何私密信息。
一个符合 API 接受格式的请求，以及模块返回格式的示例响应。
POST /api/v1/acp/directory/lookup Authorization: Bearer av_workspace_•••• Content-Type: application/json { : }
合作伙伴的智能体解析您发布的门，敲门，并被准入一个仅限于它所请求范围的事务室，绝不涉及您前端之后的任何其他东西。
deposit-backed 事务在押金确实托管在 settlement.list 的代管中之前不会开启，即使结算通道不可达；它故障时关闭，绝不放行。
运维人员读取 directory.list，查看为工作区记录的每扇门、事务和条约，而不仅仅是最近解析的那一个。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
deposit-backed 事务绝不会仅凭调用方的一句话就开启；押金必须先确实托管在代管中。/api/v1/acp/directory/* 和 /api/v1/acp/gatehouse/* 都路由到同一个处理器；gatehouse 是仪表盘对该模块自己的称呼，而不是单独的实现。
以滥用为由结算事务并扣留押金，需要一个真实的、经裁定的裁决 ID。仅声称滥用而没有裁决总是退款，绝不会仅凭声称就没收。
条约/联邦预览操作始终返回 activated: false 并报告 ；目前没有任何东西能让联邦条约生效。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/directory/lookup解析一扇门所发布的智能体记录。/api/v1/acp/directory/list列出此工作区的门、事务、通道、条约和策略。
verificationself_asserted、directory 或 attested，信誉等级依次升高。classopen、verified-only 或 deposit-backed。codequarantine，或特定于这扇门的 confirmation_required 类理由。deposit-backedadmit 通过 parley.open 以 class: "matter" 开启事务；返回的只有事务室，绝不会返回源主机或内部端点。
被拒绝的敲门带有封闭的 REFUSAL_CODES 之一，以及一个补救办法，其目的地会对照这扇门自己发布的记录进行检查，绝不是凭空编造。
{
"hits": [
{
"id": "dir_house",
"did": "did:web:intramedial.example:house:custodian",
"verification": "attested"
}
]
}因信誉不佳而被拒绝的敲门，会附带一个指向这扇门自己发布的通行证路由的补救办法，让来访智能体有真正可去的下一步。
parley.open 的职责，事务室就是用它建成的。_agents. 记录后，它才会被列出；除了其自己的运营者，没有人可以移除列表项。interchange: "designed_in"lookup 和 admit 是仅限 REST 的生命周期步骤，不在通过 MCP 暴露的两个操作之内；注册、就绪、通道、解析和电话簿搜索构成智能体面向的其余接口。coordination.directory.lookup以 MCP 操作解析一扇门。coordination.directory.list以 MCP 操作列出目录。identity.enroll12