# 标签

Python

共 144 篇文章

Code

11 Claude Agent SDK 对比

手写 Agent 的零件已经齐全,现在请出官方选手。本文是「从零手写 Agent」系列第 11 篇:认识 Claude Agent SDK——Claude Code 整套打包成库——并拿它与手写版逐项对账,看清框架替你做…

41
Code

10 结构化输出与评估

模型回你一段"课程已完成前五课",程序没法用——数据库要的是结构化字段;你改了一版提示词,效果变好了吗——"感觉"不算数。本文是「从零手写 Agent」系列第 10 篇,两个工程化硬需求一次讲完:结构化输出让模型的结果可…

39
Code

09 RAG 最小实现

问模型一个你私有代码库的问题,它只能瞎编或认怂——参数化知识覆盖不到你的数据。本文是「从零手写 Agent」系列第 9 篇:手写最小 RAG 管线,全程只靠 numpy,把"回答前先查资料"的完整链路走一遍,并实测玩具向…

65
Code

08 子 Agent 派工

多 Agent 听起来像"人多力量大",真实动机却朴素得多:上下文隔离。本文是「从零手写 Agent」系列第 8 篇,用三十行代码给 Agent 装上子 Agent,让脏活的 token 留在分身的上下文里陪葬,主线只收…

50
Code

07 Agent 上下文管理

Agent 干得越久,历史越肥:一次读文件就是几千 token 进历史,而循环的每一轮都要全量重发。第 6 篇装上的读文件工具正是头号推手——单次调用几千 token,读三个文件历史就破万。本文是「从零手写 Agent」…

44
Code

06 给 Agent 装上真实工具

算数工具算错了无非答案错,文件工具写错了你的代码就没了。本文是「从零手写 Agent」系列第 6 篇:给 Agent 装上读文件、写文件、搜代码、跑 Python 的真实工具,同时把安全边界画好。系列第 5 篇的循环五件…

48
Code

05 Agent Loop 手写实现

上一篇文章走完了一次工具调用往返,但一次往返只能干一步的活。本文是「从零手写 Agent」系列第 5 篇:把往返套进循环,让模型基于中间结果连续决策直到任务完成。这三行循环是 LangGraph、Claude Code …

41
Code

04 工具调用原理

前三篇里模型只有嘴:能说不能做。本文是「从零手写 Agent」系列第 4 篇,也是全系列的转折点——给模型一份"工具菜单",看它如何发出结构化的调用请求,你的代码如何执行并回传结果。模型的嘴与手在这一刻连通,Agent …

47
Code

03 流式输出原理

所有正式的大模型产品都是逐字往外蹦回答的,这不是前端动画,而是协议层真实发生的事。本文是「从零手写 Agent」系列第 3 篇,拆开流式输出:请求体里一个字段的差别,如何让响应从"憋十五秒一次性给"变成"边生成边推送",…

50
Code

02 对话记忆的真相

聊天机器人记得你三句话之前说过什么,这个体验太自然,以至于很多人没想过:服务器到底把对话存哪了?答案是没存。本文是「从零手写 Agent」系列第 2 篇,用官方 SDK 把多轮对话跑起来,看着一个 Python 列表如何…

44
Code

01 大模型 API 的真相

SDK 三行代码就能调起大模型,这层便利同时也挡住了视线:请求体里有什么、响应结构长什么样、错误时服务器说了什么,很多写过一阵子大模型应用的人也答不上来。本文是「从零手写 Agent」系列第 1 篇,丢开 SDK,用 h…

38
Code

00 从零手写 Agent 路线图

Agent 框架两年里冒了一茬又一茬:LangGraph、Claude Agent SDK、AutoGen……选型对比看多了,一个朴素的事实反而被盖住——Agent 的核心不依赖任何框架。一个模型 API、一份工具清单、…

48
Code

Python 三元表达式详解:条件为何放在中间

从 Java 转到 Python 的人,大概率会把 max = a > b ? a : b 的习惯带过来,然后在 a if a > b else b 面前停住:功能明明一样,真值和条件的顺序怎么整个反了?条件表达式(conditional expressions,俗称三元表达式)是三门语言都有的东西,却长出了三副完全不同的面孔。 顺序差异不是随手为之。Python 这副"真值在前"的面孔,出自一场…

41
Code

Python 运算符详解:从整除到海象运算符

在 Java 里,// 开头是注释;在 Python 里它是一个会返回值的运算符。第一次见到 len(s) // 2 这种写法的 Java 开发者,多半会先愣一下,再发现这个符号背后牵出一整串运算符语义差异:除法怎么分了三种、自增自减去哪了、and or 为什么能当默认值用。 运算符是肌肉记忆最深的部分,也最容易把 Java 的习惯错带进 Python。本文按"全景速览 → 除法语义 → 自增自减…

48
Python 字符与字节详解:len 背后的三套账
Code

Python 字符与字节详解:len 背后的三套账

len("ab你好") 等于 4——一个字母算一个,一个汉字也算一个。这个答案本身没错,但它只是表面:Python 的文本世界里其实并存着好几套"账",len 数的是码点,编码后数的是字节,用户眼睛看到的是字素,而从 Java 过来的人还得先把 Java 的 UTF-16 计数习惯拆掉。不搞清这几套账的边界,截断、限长、传输时会接连踩坑。 本文按"len 与码点 → 字节账本 → 字素陷阱 → 平…

38