A2A智能体卡片核验工作流

A2A智能体卡片核验工作流

4个实用技能 · 4步完成 · 每一步都能单独使用

把 A2A Agent Card 中的能力、接口、协议版本、认证方案、扩展、缓存和签名元数据整理成可回读合同，审计卡片声明是否自洽、是否泄露不应公开的信息、是否可能被陈旧缓存或未验证签名误导，最后生成默认不放行的人工发现复核单。套餐只处理买家提供的脱敏 JSON，不抓取线上 Agent Card、不连接远端服务。

4个可下载技能 · 每个技能可单独运行

4步自动化工作流

🔵 1 A2A智能体卡片整理

技能文件：a2a-agent-card-normalizer

解决什么： Agent Card 同时描述名称、版本、技能、接口、传输、认证和扩展，原始 JSON 不统一时很难比较不同环境或不同发布版本。

你会得到： READY/REVIEW、规范化名称与版本、能力清单、接口清单、安全方案、扩展清单和 agent_card_contract_hash。

↓ 本步结果自动进入下一步

🟢 2 A2A智能体卡片声明审计

技能文件：a2a-agent-card-claim-auditor

解决什么： 卡片可能宣称支持某协议却缺少对应接口，声明的技能、认证方案和传输不一致，或把内部 URL、令牌样式和敏感实现细节暴露给发现方。

你会得到： PASS/REVIEW/CARD_RISK、逐项声明检查、接口与协议差异、敏感披露命中、认证缺口和 card_claim_audit_hash。

↓ 本步结果自动进入下一步

🟠 3 A2A智能体卡片缓存签名审计

技能文件：a2a-agent-card-cache-signature-auditor

解决什么： 卡片变更后如果 version、ETag、max-age 或扩展卡片会话范围不清，客户端可能继续使用旧能力；存在签名字段却未标明算法、JWKS 或验证状态时，也不能把卡片当作可信身份。

你会得到： CLEAR/REVIEW/STALE_CARD、版本与 ETag 对照、缓存策略、签名元数据、扩展卡片访问范围、过期原因和 card_cache_audit_hash。

↓ 本步结果自动进入下一步

🟣 4 A2A智能体发现发布门禁

技能文件：a2a-agent-card-discovery-gate

解决什么： 卡片字段通过静态检查，不等于可以把远端智能体加入发现目录或允许委派；团队还需要一份明确的人工复核入口来处理身份、证书、认证、来源和缓存证据。

你会得到： READY_FOR_HUMAN_REVIEW/HOLD、风险原因、待补证据、human_decision=PENDING、discovery_allowed=false 和 agent_card_gate_hash；这是最终交付。

↓ 本步结果形成最终交付

实际示例

脱敏样例模拟一个公开 Agent Card：它声明 HTTP+JSON 和 JSON-RPC 两个接口，却只列出一个接口；同时将内部域名放入扩展字段，版本更新但 ETag 未变化，签名元数据缺少 JWKS。第一步整理出卡片合同；第二步标记接口与传输矛盾及敏感披露；第三步标记 STALE_CARD 和 UNVERIFIABLE_SIGNATURE；第四步生成 HOLD 复核单。示例只验证本地规则，不冒充真实卡片、证书或远端身份验证。

适合谁

• 使用 A2A Agent Card、Agent Registry 或多智能体发现目录的工程团队

• 维护跨框架 Agent 接口、认证方案、技能声明和扩展版本的开发者

• 负责远端 Agent 委派前风险评估、身份、缓存和安全证据的安全与平台团队

• 需要在加入 Agent 目录前保留卡片差异、签名和人工批准记录的服务商与 QA 人员

买家只需提供

• 已脱敏的 Agent Card JSON、目标协议版本、接口与传输规则

• 组织允许公开的技能、URL、认证方案、扩展和敏感字段白名单

• 版本、ETag、Cache-Control、签名算法、JWKS 引用、扩展卡片会话范围和人工责任人

使用方式

1. 使用 Python 3.10 或更高版本，将卡片和缓存签名元数据写成 UTF-8 JSON；不要放入密码、Cookie、Token、私有域名或真实证书私钥。

2. 依次运行卡片整理、声明审计、缓存签名审计和发现发布门禁，也可以单独运行任一步。

3. 在隔离测试环境查看结果，由有权限的负责人决定是否把复核结果接入 Agent Registry 或发现流程；套餐本身不会抓取、批准或委派远端 Agent。

交付与验收

• 四个独立技能目录，每个包含元数据、技能说明、标准库执行器、文档和脱敏样例。

• 四步可重复运行：卡片合同、声明审计、缓存签名审计、人工发现门禁；每个技能也能单独使用。

• 缺少名称/版本/接口、协议与传输矛盾、认证声明不完整、敏感披露、版本与 ETag 不一致、签名不可验证或证据不完整时，输出明确的 REVIEW、CARD_RISK、STALE_CARD 或 HOLD 分支。

• 正常样例保留 human_decision=PENDING、discovery_allowed=false 和 external_action_executed=false；不替代 TLS、OAuth、JWS、JWKS、注册中心或真实端到端测试。

服务说明

脚本只处理买家有权使用且已经脱敏的本地 JSON，不连接 A2A、Agent Registry、DNS、TLS、OAuth、数据库或远程 API，不读取凭据，不验证远程证书，不发送委派请求，也不改变外部状态。静态字段检查不能证明远端 Agent 身份、证书链、认证配置、能力真实可用或服务安全；缓存策略和签名结果依赖买家提供的元数据。A2A 协议和扩展会变化，正式使用前必须由协议、平台和安全负责人复核。本套餐不承诺绝对可信、零伪造、零过期、固定兼容或固定节省比例。