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