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