01 大模型 API 的真相
SDK 三行代码就能调起大模型,这层便利同时也挡住了视线:请求体里有什么、响应结构长什么样、错误时服务器说了什么,很多写过一阵子大模型应用的人也答不上来。本文是「从零手写 Agent」系列第 1 篇,丢开 SDK,用 h…
分类
通用编程语言与工程实践:Java 进阶(Optional、CompletableFuture、Guava、Joda-Time)、C# 深入(事件机制、dynamic、LINQ、WCF、JSON 序列化)、Python 爬虫(Scrapy)、新世代工具链(Bun)与 Linux 常用命令。跨语言的语法特性、标准库与三方库横向对照。
共 161 篇文章
SDK 三行代码就能调起大模型,这层便利同时也挡住了视线:请求体里有什么、响应结构长什么样、错误时服务器说了什么,很多写过一阵子大模型应用的人也答不上来。本文是「从零手写 Agent」系列第 1 篇,丢开 SDK,用 h…
Agent 框架两年里冒了一茬又一茬:LangGraph、Claude Agent SDK、AutoGen……选型对比看多了,一个朴素的事实反而被盖住——Agent 的核心不依赖任何框架。一个模型 API、一份工具清单、…
从 Java 转到 Python 的人,大概率会把 max = a > b ? a : b 的习惯带过来,然后在 a if a > b else b 面前停住:功能明明一样,真值和条件的顺序怎么整个反了?条件表达式(conditional expressions,俗称三元表达式)是三门语言都有的东西,却长出了三副完全不同的面孔。 顺序差异不是随手为之。Python 这副"真值在前"的面孔,出自一场…
在 Java 里,// 开头是注释;在 Python 里它是一个会返回值的运算符。第一次见到 len(s) // 2 这种写法的 Java 开发者,多半会先愣一下,再发现这个符号背后牵出一整串运算符语义差异:除法怎么分了三种、自增自减去哪了、and or 为什么能当默认值用。 运算符是肌肉记忆最深的部分,也最容易把 Java 的习惯错带进 Python。本文按"全景速览 → 除法语义 → 自增自减…
len("ab你好") 等于 4——一个字母算一个,一个汉字也算一个。这个答案本身没错,但它只是表面:Python 的文本世界里其实并存着好几套"账",len 数的是码点,编码后数的是字节,用户眼睛看到的是字素,而从 Java 过来的人还得先把 Java 的 UTF-16 计数习惯拆掉。不搞清这几套账的边界,截断、限长、传输时会接连踩坑。 本文按"len 与码点 → 字节账本 → 字素陷阱 → 平…
聊天界面里的打字机效果,不是模型"打字快",而是一条 HTTP 长连接上持续到达的事件流。模型边生成边推送,客户端边收边渲染——这套机制的协议,就是流式输出事件。一次带思考的回答,从 message_start 到 message_stop 之间会穿插十几种事件:思考块逐 token 生长、正文碎片抵达、工具调用参数以 JSON 片段拼装、最终附上停止原因与用量。 本文给全这套事件词表:先看 SS…
翻开任何一个 agent 的 Python 代码,最先撞见的八成是这一行:messages.append({"role": "assistant", "content": reply})。再往下看,工具定义是字典,usage 统计是字典,配置合并还是字典——agent 开发的数据骨架,几乎全由字典搭成。它不是 Python 里可有可无的一个类型,而是这门语言里最接近 JSON、最擅长"结构固定但字…
从 Java 或 Kotlin 转到 Python 的开发者,几乎都会在同一个地方愣住:每个方法的第一个参数都叫 self,而且非写不可。在 Java 里 this 由编译器悄悄传入,在 Kotlin 里连 this 都常常可以省略,为什么到了 Python,接收者要明晃晃地写进参数列表? 答案一句话就能说完:self 就是显式化的 this,而 obj.method(x) 只是 Class.me…
《TypeScript Agent 开发(Mastra)》写到第 14 篇/post/1561,收官。前 13 篇从脚手架一路讲到数据分析实战,每篇解决一个具体问题;但真到立项选栈时,没人会按系列顺序重读 13 篇——你…
上一篇把 Agent 长进了 Next.js:一个仓库、一次部署、类型从 schema 穿到浏览器。零件至此备齐,收官实战把它们拼成一台完整的机器:数据分析 Agent。它的需求规格书不在本系列手里——《AI Agent…
上一篇把 Mastra 打成 Docker 镜像送进了生产。但很多场景里,Agent 只是 Web 产品的一个能力位——智能搜索、客服入口、摘要生成——为它单独立服务、立域名、立 CI,成本全在胶水上。这一篇讲 Mast…
前 10 篇的 Agent 都活在 mastra dev 里:改代码热重载,Studio 里点一点就能验证。可 Agent 迟早要见真实用户——挂到公网、接上前端、扛住流量,这一步在框架教程里往往是空白。Python 版…
RAG 的方法论,《AI Agent 开发》系列 14~18 篇已经用 Python 栈讲透了:从 Chroma 向量库起步,经切分、嵌入、混合检索,到第 17 篇的 Agentic RAG 与第 18 篇的 Graph…
前八篇里你已经用 Mastra 把 Agent、工具、工作流、记忆、MCP、评测各写了一遍;《AI Agent 开发》系列第 6~13 篇里,同一批任务你在 Python 栈用 LangGraph 也深潜过。两边都用过之…
第 2 篇/post/1637搭环境时,我们在 pnpm dev 起的本地工作台里初见过 4111 端口:左侧选 Agent、右侧聊天、每轮回答带一条 Trace,当时只当它是"能看日志的聊天窗"。这篇把它正儿八经当调试…