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. 流式传输与多轮对话