Trust Layer

开发者 — Trust Layer API 与 MCP

把智能体卡片接入你的大模型、Agent 运行时或垂直助手：搜索、查证、调用真实商家。

智能体卡片（Agent Card）

机读身份单元。/t 与 /b 共用同一 ID。API 版本 2026-08-21。

MCP 工具

POST /api/mcp 的 JSON-RPC：search_agents、get_agent、verify_agent、get_business_facade、search_registry、get_merged_profile（香港登记库首选）。

HTTP v1

GET /api/v1/search · /api/v1/t/{id} · /api/v1/verify · /api/v1/b/{handle} · /api/v1/registry/{id}/merged

API Key

公开读有 IP 限流。更高量请在 Dashboard 创建 Bearer Key。

香港官方登记库

6 万+ 条结构化登记记录——食肆、诊所、律师、保险等。每条登记页链接官方 JSON；有 enrichment 时还可读取合并档案。

HTTP

GET /api/v1/registry/{registryId} · GET /api/v1/registry/{registryId}/merged · GET /api/v1/registry/search

MCP：get_registry · search_registry · get_merged_profile

合并档案（Merged Profile）

合并官方登记字段、已认领 Agent Card（如有）与外部 enrichment。返回 trustBreakdown 与 recommendedUse，便于 Agent 判断哪些字段可引用。

字段来源分层

官方登记字段为 REGISTRY_OFFICIAL。Enrichment 为 INFERRED（如 Google Places 匹配）或 MERCHANT_CONFIRMED（Dashboard 确认后）。引用营业时间或联系方式时，优先遵循 recommendedUse，而非直接引用推断字段。

服务端配置 GOOGLE_PLACES_API_KEY 后启用真实 Places enrichment；未配置时使用 demo 数据做 POC。

默认对接路径（香港登记库）

伙伴 Agent 在 search_registry 之后，应默认调用 get_merged_profile（或 GET /api/v1/registry/{registryId}/merged）。仅当需要纯官方字段、不含 enrichment 与认领上下文时，才用 get_registry。

search_registry — 按名称、地址或牌照编号搜索
get_merged_profile — 读取官方 + 认领 + enrichment，并获取 recommendedUse
若 claimed.trusgentId 存在：推荐前调用 verify_agent；可选 get_business_facade
recommendedUse.identity 为 safe_to_cite 时可引用身份；hours/contact 按 recommendedUse 分级引用

合并档案示例

{
  "kind": "MergedRegistryProfile",
  "apiVersion": "2026-05-01",
  "registryId": "fehd-3715038328",
  "official": {
    "verification": {
      "level": "REGISTRY_OFFICIAL"
    }
  },
  "claimed": null,
  "enrichment": {
    "status": "PENDING_REVIEW",
    "fields": {
      "hours": {
        "verificationLevel": "INFERRED",
        "source": "google_places"
      }
    }
  },
  "trustBreakdown": {
    "officialRegistry": 40,
    "merchantClaim": 0,
    "enrichmentConfirmed": 2,
    "totalHint": 42
  },
  "recommendedUse": {
    "identity": "safe_to_cite",
    "hours": "cite_with_caution",
    "contact": "do_not_cite"
  }
}

登记库索引搜索全部记录阅读集成指南

创建 API Key 查看 MCP 端点 OpenAPI JSON 伙伴 / BD

打开 Agent Card 契约: docs/agent-card.md · MCP 指南: docs/mcp.md