A2A协议代理验证工具

a2a代理验证器

端到端验证A2A协议代理卡。获取众所周知的端点，根据A2A规范验证卡结构，对功能进行分类，包括 谷歌AP2（代理支付协议） 并返回一个包含16个布尔类别和17个条目字段的结构化快照。兼容 erc8004-registry-parser 作为验证插件。

快速入门

git clone https://github.com/agentprobe/a2a-agent-validator.git
cd a2a-agent-validator
npm i

import { A2aAgentValidator } from 'a2a-agent-validator'

const { status, findings, categories, entries } = await A2aAgentValidator.start( {
    endpoint: 'https://agent.example.com',
    timeout: 15000
} )

特性

• 从获取代理卡 /.well-known/agent-card.json （A2A规范标准）
• 验证卡片结构：必填字段、接口、技能、提供者
• 对16个布尔类别进行分类（可达、技能、流、JSONRPC、GRPC、安全、AP2、x402、嵌入式流、ERC-8004）
• 发现 AP2（代理支付协议） 通过 capabilities.extensions 阵列和 X-A2A-Extensions HTTP标头--提取版本和角色
• 发现 x402 付款扩展和版本
• 发现 嵌入式流 （AP2+x402组合）
• 发现 ERC-8004 代理卡中的服务链接
• 提取17个输入字段（姓名、版本、技能、协议、提供者、AP2版本/角色、x402版本、扩展名）
• 比较两个快照并生成结构化差异
• 连接失败时返回包含所有错误类别的空快照
• 兼容 erc8004-registry-parser 通过 .validate() 方法

建筑学

验证管道分四个顺序步骤处理A2A代理卡：

flowchart LR
    A[endpoint] --> B[A2aConnector.fetch]
    B -->|agent card + X-A2A-Extensions header| C[CardStructureValidator.validate]
    C --> D[CapabilityClassifier.classify]
    D -->|AP2 / x402 / ERC-8004 detection| E[SnapshotBuilder.build]

方法

所有方法都是静态的，并使用对象参数和对象返回。

.validate( { endpoint } )

与兼容的简单验证 erc8004-registry-parser。仅返回状态和结果。

方法

.validate( { endpoint } )

退货

{ status: true, findings: [] }

.start( { endpoint, timeout } )

对类别和条目进行全面验证。

方法

.start( { endpoint, timeout } )

退货

{ status: true, findings: [], categories: { ... }, entries: { ... } }

.compare( { before, after } )

比较两个快照并返回结构化差异。

方法

.compare( { before, after } )

退货

{ status: true, findings: [], hasChanges: false, diff: { ... } }

类别（16个布尔标志）

条目（17个数据字段）

验证码

结果以结构化对象的形式发布 { code, severity, location, message } 符合 AgentProbe查找对象规范。 severity 小写(error / warning / info).这 VAL-1xx 和 CON-1xx 波段是a2a拥有的波段（百位数 1); CSV-* 代码是 已经是全球唯一的，并保留其号码。

VAL——输入验证（带 VAL-1xx)

CON-A2A连接（频带 CON-1xx)

CSV——卡片结构验证

CMP——比较

CMP-* 代码由发出 .compare() 作为结构化查找对象 { code, severity, location: 'compare', message } 在其 findings 阵列——均匀 start(). 这 diff 和 hasChanges 是结构化的，从不在代码上。

许可证

麻省理工学院