A2A 流式传输与 Agent Card 发现
Agent 网关设置指南使用官方 A2A Go SDK 客户端,通过 AISIX 发送非流式消息。本指南在已验证的路径上继续接收流式任务,并解析 AISIX 为客户端重写的 Agent Card。
这两项测试验证直接 JSON-RPC 请求之外的客户端行为。SDK 解析每个流式任务事件,并在发现过程中从返回的卡片中选择网关服务 URL,不会获知上游 Agent 的 URL 或凭证。
流式传输测试可在本地快速入门网络中运行。端到端的 Agent Card 解析需要客户端可访问的网关源地址;本指南使用公共 HTTPS 源地址。 如果尚未配置该地址,请先完成流式传输测试,待部署后再返回发现部分。
前置条件
开始之前,请完成设置 Agent 网关,并保留以下资源:
- AISIX 网关、
aisix-a2a-echo容器和aisix-a2aDocker 网络。 AISIX_GATEWAY_CONTAINER、AISIX_A2A_URL和AISIX_A2A_KEY环境变量。echo-agent注册信息和调用方授权。
设置过程会在 echo-agent 容器中下载并编译固定的 SDK 版本。客户端命令复用同一个版本及容器构建缓存。
验证流式传输
设置指南保留了 AISIX_A2A_URL,客户端容器通过该地址访问网关。通过此端点发送流式消息:
docker exec aisix-a2a-echo \
go run github.com/a2aproject/a2a-go/v2/cmd/a2a@v2.5.0 \
send "$AISIX_A2A_URL" "Stream through AISIX" \
--transport jsonrpc \
--stream \
--auth "Bearer $AISIX_A2A_KEY" \
--output json
客户端在事件到达时逐个输出。echo Agent 依次生成以下事件:
- 已提交的任务。
- 任务状态更新为处理中。
- 包含
Stream through AISIX的产物更新。 - 任务状态更新为已完成。
这验证了 AISIX 会中继 A2A 事件流,而非将整个事件流缓冲后合并为一个响应。
验证 Agent Card 发现
设置指南启动的 echo 服务器会发布同时兼容 A2A 0.3 和 1.0 的卡片。AISIX 在以下路径提供面向客户端的版本:
<gateway-origin>/a2a/echo-agent/.well-known/agent-card.json
AISIX 从 Host 确定公布的主机和端口,从 X-Forwarded-Proto 确定 URL 协议;未提供转发协议时,默认使用 https。AISIX 读取逗号分隔列表的第一个值,不区分大小写,并忽略 http 和 https 以外的值,此时同样使用 https。因此,通过纯 HTTP 直接访问的网关会公布 https,除非调用方发送 X-Forwarded-Proto: http