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。
商家与集成方定价
认领与基础智能体卡片免费；线上认证免费；账号套餐自基础版 HK$300／年起；深度 GEO 与定制官网可咨询开通；企业版定制。
登记库认领 & 智能体卡片
免费
免费 · 公开读有 IP 限流
线上认证
免费
账号套餐（基础版／年）
HK$300
深度 GEO（起 HK$39,800／年）
HK$39,800
企业版（定制）
咨询开通
Agent Trust Stack（开源）
Trusgent 在产 dogfood 四套开放协议 — AgentID、AgentCert、AgentLedger、trusgent-mcp。我们是参考签发方；请验签 VC，不要只信 HTML。
npm：@trusgent/agentcert-verify
香港官方登记库
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（如有）与带出处的第三方。返回 dossierLayers、citationPolicy、trustBreakdown 与 recommendedUse，便于 Agent 判断哪些字段可引用。
字段来源分层
分层建档：官方登记最高权重；本人认领的结构化字段可追责；带出处的第三方须含来源 URL 与抓取时间；评论只作辅助。Trust Score 是身份核验 + 官方记录 + 资料完整度 + 来源一致性，不是全网感觉分。不做无授权的全网评论仓库。
服务端配置 GOOGLE_PLACES_API_KEY 后启用真实 Places enrichment；香港商户仅拉取电话 / 营业时间 / 评分 / Maps URL，按 place_id 缓存，页面与 MCP 读取不实时打 API。未配置时使用 demo 数据。
默认对接路径（香港登记库）
伙伴 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",
"layer": "THIRD_PARTY_CITED",
"fetchedAt": "2026-08-24T00:00:00.000Z",
"fields": {
"hours": {
"verificationLevel": "INFERRED",
"source": "google_places",
"fetchedAt": "2026-08-24T00:00:00.000Z",
"layer": "THIRD_PARTY_CITED"
}
}
},
"dossierLayers": [
{
"layer": "OFFICIAL_REGISTRY",
"weight": "highest",
"present": true
}
],
"trustBreakdown": {
"officialRegistry": 40,
"merchantClaim": 0,
"enrichmentConfirmed": 2,
"totalHint": 42,
"auxiliaryReviews": 0,
"formulaVersion": "2026-08-24"
},
"recommendedUse": {
"identity": "safe_to_cite",
"hours": "cite_with_caution",
"contact": "do_not_cite"
},
"crossValidation": {
"crossValidationCount": 2,
"conflictStatus": "partial",
"fields": [
{
"field": "name",
"status": "match",
"sources": [
"official_registry",
"enrichment"
]
},
{
"field": "phone",
"status": "conflict",
"sources": [
"official_registry",
"enrichment"
]
}
]
},
"fieldEvidence": {
"official": {
"name": {
"value": "Good Day Cafe",
"layer": "OFFICIAL_REGISTRY",
"source": "FEHD",
"sourceUrl": "https://www.fehd.gov.hk",
"verifiedAt": "2026-08-24T00:00:00.000Z",
"verificationLevel": "OFFICIAL",
"method": "SYNC"
}
},
"enrichment": {
"hours": {
"value": "Mon–Sun 11:00–23:00",
"layer": "THIRD_PARTY_CITED",
"source": "google_places",
"verifiedAt": "2026-08-24T00:00:00.000Z",
"verificationLevel": "INFERRED",
"method": "google_places"
}
}
}
}打开 Agent Card 契约: docs/agent-card.md · MCP 指南: docs/mcp.md · Quickstart 指南: docs/agent-trust-stack-quickstart.md