2026年11月的文章 第21页
章末自测
题目 1:为什么第一版 Agent API 使用 POST,而不是 GET? 请结合请求体、任务语义和后续扩展说明,并解释为什么 message 更适合放 JSON Body。 Agent Chat 表示向服务端提交一个需要...
案例分析二:Data Analysis Agent 被另一个后端服务调用,为什么 run_id 从第一版接口就值得保留?
这一节里 run_id 看起来只是多返回了一个字段,但它背后其实对应的是一个非常重要的分离:会话连续性和单次执行生命周期,不应该混为一谈。先配合下面这张图理解一下,会更顺。 如图能一眼看...
案例分析一:Coding Agent 从 CLI 迁移到 Web 页面,API 怎么设计才不会推翻原来的 Engine?
这个案例本质上在回答一个很实际的问题:原来 CLI 跑得好好的能力,怎么接进 Web,而又不把底层 Engine 搞乱。光靠文字说有时候不够直观,先看一张“错误做法 vs 正确方案”的对比图。 左边那两...
小节五:怎么测试这个 Agent API——不要只在浏览器里看“能不能打开”
一个 POST API,直接浏览器输入 URL 通常不是正确测试方式。 你需要真实发请求。 先用 Flask Test Client 做自动测试 手动 curl 能确认网络链路,自动测试则能把合同固定下来。应用工厂让我们无...
小节四:如何让这个 API 真正调用前面已经实现的 Agent Harness?
到了这里,问题已经不是“API 能不能回一段字符串”,而是“这套 API 能不能真正接上你前面已经写好的 Harness”。如果只盯着当前这个 Flask Route,你很容易把视角放窄;从更大的接入关系看,...
小节三:Route 为什么只做参数校验,不应该直接实现 Agent Main Loop?
多同学在这里最容易犯的毛病,就是觉得既然 Route 已经拿到了请求,那索性把主逻辑也一口气写进去。但从长期维护看,这么做几乎一定会越写越乱。先看一张分层图,脑子里有了结构,再去读代码会...
小节二:实现第一个完整 Flask Agent API——真正跑通 POST /api/v1/chat
这一节可以理解成:我们开始把原来只能在本地 agent.run() 跑起来的能力,往“别人也能稳定调用”的方向推进。下面这张图把这条演进路径拆成了 7 步,看起来会特别顺。 图里最值得记住的一点...
小节一:先设计 API Contract——不要一上来就写 Route
先看一张总览图会更容易进入状态。它把“调用方 → API Contract → Flask Route → AgentService / AgentEngine”这条链路直接摊开了。你会发现,真正应该先稳定下来的,不是某一段 Flask 代码...
用 Flask 封装第一个 Agent API
上一节,我们已经回答了一个很重要的问题,为什么 Agent 不能永远停留在 agent.run('分析这个项目') 这种本地 Python 调用里? 因为真实系统的调用方可能是: Frontend App 飞书 其他...
章末自测
题目 1:为什么 agent.run('分析这个项目') 适合作为开发入口,却不适合作为真实 Web 产品唯一入口? 请从调用环境、协议、多调用方、长任务与多用户五个角度解释。 agent.run() ...










