5. 启动服务器

5. 启动服务器

当你准备好 AgentCard 与 AgentExecutor 后，就可以启动一个符合 A2A 的 HTTP 服务端。

在官方 Python SDK 示例里，服务端通常由两部分组成：

• 请求处理器：把 JSON-RPC 方法路由到你的 executor，并依赖 TaskStore 管理任务状态；
• HTTP 应用：暴露 A2A 相关端点，并在 well-known 路径提供 AgentCard。

HelloWorld 例子里你会看到什么

在 a2a-samples 仓库中，HelloWorld 的入口文件展示了如何组装：

• DefaultRequestHandler：负责把协议调用转给 executor，并用 TaskStore 记录任务状态；
• A2AStarletteApplication（或类似构建器）：提供 A2A HTTP 端点并对外提供 AgentCard；
• uvicorn：运行 ASGI 应用。

运行示例

在 a2a-samples 仓库根目录（并激活虚拟环境）执行：

python samples/python/agents/helloworld/__main__.py

看到服务开始监听的日志即表示启动成功（端口应与 AgentCard 的 url 一致）。

下一章我们会用测试客户端向服务端发送请求。