如何基于Pi开发自己的Agent项目00篇
大家好，我是居丽叶。
从这篇开始，我会连载一个新系列——《如何基于 Pi 开发自己的 Agent 项目》，也会在github的juliye2025/pi-agent-notes中更新。总共五篇：
00 序篇：Pi Harness 怎样让 Agent 跑起来
01 看懂 Pi：选对开发层，跑通第一个 Agent
02 组装 Pi：Tool、Context 与输出合约
03 组织 Pi：Router、Workers 与 Verifier
04 交付 Pi：从一次真实请求走到 Trace 与降级

本篇是序篇，会从包结构、一次请求的 body、上下文、Agent Loop 这几个角度，回答一个问题：Pi 是怎么把一个只能一问一答的大模型，变成一个能读文件、能跑命令、能改代码的 Agent 的？

先简单交代一下背景。Pi 是一个开源 Coding Agent，TypeScript 写的，在 GitHub 上拿了 10 万 Star。它能接市面上几乎所有主流模型，把 Agent 最核心的 Loop 封装成一个最小可运行的 Harness。它也在很多爆火产品中得到了应用，比如 2026 年初的现象级开源 Agent —— OpenClaw，它在底层也是依赖 Pi 作为自己的 Agent 核心。

它的设计思想可以概括成：如无必要，勿增实体。

如果你想找一个已经实现好的、可以直接写在简历上的、基于pi agent开发的自进化multi-agent项目，可以用我做的行政Agent。
项目的详细介绍见引用笔记。

本系列后面四篇，我们要做的事就是：取 Pi 它的 pi-agent-core + pi-ai 两层，嵌进自己的产品里。

howto入门vibecoding howto入门codex 大模型 互联网大厂 agent开发 算法工程师 agent工程师