6. 与服务器交互
当 HelloWorld 服务端启动后,建议在新终端用测试客户端做端到端验证。
本节验证目标
- 能从 well-known 端点拉取 AgentCard。
message/send能返回有效响应。message/stream能返回流事件并正确结束。
运行测试客户端
激活虚拟环境后执行:
python samples/python/agents/helloworld/test_client.py预期输出形态
通常会看到:
- 一条非流式响应(常见为
Message)。 - 一组流式响应事件(数量取决于智能体行为)。
示例:
// 非流式响应
{"jsonrpc":"2.0","id":"xxxxxxxx","result":{"type":"message","role":"agent","parts":[{"type":"text","text":"Hello World"}],"messageId":"yyyyyyyy"}}
// 流式响应
{"jsonrpc":"2.0","id":"zzzzzzzz","result":{"type":"message","role":"agent","parts":[{"type":"text","text":"Hello World"}],"messageId":"wwwwwwww"}}
常见排查点
- 无响应:确认服务端进程和端口。
- 认证失败:确认客户端使用的环境变量和凭证。
- 流不结束:检查任务是否进入终态或中断态。
下一步
继续阅读 7. 流式传输与多轮对话 。