A2A（Agent2Agent）是一种用于 Agent 之间通信的开放协议。通过 A2A，不同 Agent 可以相互发现能力、发送消息并返回执行结果。A2A Debugger 是用于调试 A2A Agent 的可视化工具。你可以连接一个 A2A Agent，发送测试消息，查看 Agent 的返回内容、执行状态和调试日志，帮助开发者快速排查 Agent 接入、消息传递和返回结果中的问题。查看 Agent 的名称、描述、能力和 Skills
向 Agent 发送文本或附件，验证 Agent 的响应结果
建议使用 Apifox 最新客户端，以体验 AI Agent Debugger 的完整功能。
连接 A2A Agent#
在页面顶部输入 Agent Card URL，然后点击连接。连接成功后，顶部状态会显示为已连接。此时你可以查看 Agent 信息并开始发送消息。如果需要切换到其他 Agent，可以点击断开连接后重新输入 Agent Card URL。编写测试消息#
在 消息 标签页中编写要发送给 Agent 的测试输入。左侧：填写消息文本、上传附件、配置 Metadata
发送消息#
如果当前尚未连接 Agent，A2A Debugger 会先尝试连接；连接成功后再发送消息。发送后，你可以在消息区域看到用户消息和 Agent 返回内容。查看回复消息#
消息区域会展示当前会话中的用户消息和 Agent 回复。Agent 返回的内容可能是普通文本，也可能包含任务状态、执行结果或生成的产物。你可以通过消息展示区快速判断 Agent 是否正确理解并处理了请求。点击任意一条调试消息，可以在右侧查看详情。详情面板支持三种视图：查看 Agent Card#
调试面板的 Agent Card 标签页用于查看当前连接 Agent 的能力说明。Agent 支持的能力，例如是否支持流式响应、推送通知、状态历史等
添加附件#
如果当前 Agent 支持文件输入，可以点击消息输入区下方的附件按钮上传文件。A2A Debugger 会根据 Agent 声明的输入类型判断是否允许上传附件：如果 Agent 只支持特定文件类型，只能上传匹配类型的文件
如果 Agent 支持任意文件类型，则可以上传任意文件
配置认证#
如果 A2A Agent 需要认证，可以在 认证 标签页中配置认证方式。| 认证方式 | 说明 |
|---|
| 无 | 不添加认证信息 |
| Bearer Token | 使用 Token 进行认证 |
| Basic Auth | 使用用户名和密码进行认证 |
| API Key | 使用指定 Header 传递 API Key |
如果发送消息时返回未授权错误，请检查认证方式、Token、用户名密码或 API Key 是否正确。在 Header 标签页中，可以添加自定义请求 Header。Header 标签上的数字表示当前已配置的有效 Header 数量。在消息编辑区下方展开 Metadata，可以为本次消息添加自定义键值对。Metadata 适用于传递上下文标识、业务参数或调试标记。例如你可以添加环境名称、用户 ID 或请求来源等信息。常见问题#
连接失败怎么办？#
1.
Agent Card URL 是否正确，并且可以从当前环境访问。
3.
如果需要认证，是否已在 认证 标签页中配置正确的认证信息。
4.
是否需要额外 Header，例如租户 ID、环境标识或网关认证信息。
5.
Agent Card 返回内容是否为合法 JSON。
连接成功后无法上传附件？#
这通常是因为当前 Agent 没有声明支持文件输入，或只允许上传特定类型的文件。请在 Agent Card 标签页中查看 Agent 支持的输入类型，并确认上传文件的类型是否匹配。如何查看完整请求和响应？#
在调试面板的 消息 标签页中点击对应的请求或响应日志，然后切换到原始数据视图，即可查看完整 JSON。Agent 返回的内容显示异常怎么办？#
1.
查看调试消息中的预览内容，确认 Agent 是否有返回结果。
3.
检查 Agent Card 中声明的输入类型、输出类型和 Skills 是否符合预期。
