<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
	<channel>
		<title>pi示例 on Programmer.ie：现代 AI 编程</title>
		<link>http://programmer.ie/zh-cn/examples/pi/</link>
		<description>Recent content in pi示例 on Programmer.ie：现代 AI 编程</description>
		<generator>Hugo</generator>
		<language>zh-CN</language>
		
		
		
		
			<atom:link href="http://programmer.ie/zh-cn/examples/pi/index.xml" rel="self" type="application/rss+xml" />
			<item>
				<title>看智能体循环调用一个工具</title>
				<link>http://programmer.ie/zh-cn/examples/pi/01-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/01-chapter/</guid>
				<description>&lt;p&gt;没有凭据你也可以观察这个循环。provider 脚本化助手的响应；&lt;strong&gt;真正的 Agent&lt;/strong&gt; 执行工具并发出事件。这证明的是编排（orchestration），而不是真实模型对工具的选择或对其结果的解释。&lt;/p&gt;</description>
			</item>
			<item>
				<title>按优先级顺序解析一条 provider 凭据</title>
				<link>http://programmer.ie/zh-cn/examples/pi/03-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/03-chapter/</guid>
				<description>&lt;p&gt;Pi 从四个来源解析一条 provider 凭据，并使用&lt;strong&gt;第一个产出值的那个&lt;/strong&gt;：一个运行时&#xA;API 密钥、一条已存储的 &lt;code&gt;auth.json&lt;/code&gt; 凭据、&lt;code&gt;models.json&lt;/code&gt; 里的一个 &lt;code&gt;apiKey&lt;/code&gt;，然后&#xA;是该 provider 的环境变量。这是对第 3 章那些测试的一次配置与决策表走查；下面的&#xA;每个密钥都是占位值，它不解析任何真实凭据。&lt;/p&gt;</description>
			</item>
			<item>
				<title>计算一个上下文预算</title>
				<link>http://programmer.ie/zh-cn/examples/pi/04-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/04-chapter/</guid>
				<description>&lt;p&gt;锁定在 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 上的压缩参考资料把触发条件记述为&#xA;&lt;code&gt;contextTokens &amp;gt; contextWindow - reserveTokens&lt;/code&gt;；默认保留区是 16,384。&#xA;第 4 章的测试使用一个带 100,000 token 窗口的脚本化模型。下面就是这些&#xA;输入：窗口是一个测试模型的容量，不是每个 provider 的容量。&lt;/p&gt;</description>
			</item>
			<item>
				<title>读一个会话文件及其树</title>
				<link>http://programmer.ie/zh-cn/examples/pi/05-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/05-chapter/</guid>
				<description>&lt;p&gt;一个持久的 Pi 会话是一个你能在任何编辑器中打开的普通 JSONL 文件。&#xA;第一行是一个头部，之后每一行都是一个带 &lt;code&gt;id&lt;/code&gt; 和 &lt;code&gt;parentId&lt;/code&gt; 的树条目，&#xA;而模型永远只看到活动分支。这是一条&lt;strong&gt;示意性&lt;/strong&gt;的记录，加上一次目录名&#xA;计算，以第 5 章的测试为依据；它是形状的一幅画，不是来自你机器的一份&#xA;转录记录。&lt;/p&gt;</description>
			</item>
			<item>
				<title>看 Pi 把哪些工具声明给模型</title>
				<link>http://programmer.ie/zh-cn/examples/pi/06-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/06-chapter/</guid>
				<description>&lt;p&gt;Pi 向模型声明一个&lt;strong&gt;活动工具集合&lt;/strong&gt;；那个集合就是模型可以索要的东西。&#xA;三样输入组成它：内置工具、由扩展注册的工具，以及 MCP 工具。&#xA;&lt;code&gt;defaultTools&lt;/code&gt; 修订用户的选择，&lt;code&gt;--tools&lt;/code&gt; 为一次调用替换它，而同一套&#xA;语法在这两个地方意思不同。&lt;/p&gt;</description>
			</item>
			<item>
				<title>合并用户设置与项目设置</title>
				<link>http://programmer.ie/zh-cn/examples/pi/07-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/07-chapter/</guid>
				<description>&lt;p&gt;Pi 合并两个文件：用户级的 &lt;code&gt;&amp;lt;agent-dir&amp;gt;/settings.json&lt;/code&gt;，以及在你信任该项目之后的 &lt;code&gt;&amp;lt;project&amp;gt;/.pi/settings.json&lt;/code&gt;。标量值遵循普通的覆盖规则，但 &lt;code&gt;defaultTools&lt;/code&gt; 有它自己的规则，而一个未获信任的项目的设置根本不会被读取。下面这些片段是小的&lt;strong&gt;说明性&lt;/strong&gt;设置；第 7 章的测试会在真实文件上断言每一个结果。&lt;/p&gt;</description>
			</item>
			<item>
				<title>决定是否信任一个项目</title>
				<link>http://programmer.ie/zh-cn/examples/pi/08-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/08-chapter/</guid>
				<description>&lt;p&gt;只有当工作目录里含有某个&lt;em&gt;将要&lt;/em&gt;加载的东西时，Pi 才会提出项目信任问题，而答案决定哪些受保护资源加载。顺序是：命令行标志，然后 &lt;code&gt;project_trust&lt;/code&gt; 扩展，然后已保存的决策，然后 &lt;code&gt;defaultProjectTrust&lt;/code&gt;。像 &lt;code&gt;AGENTS.md&lt;/code&gt; 这样的上下文文件不是触发项，两条路都会加载。这是对第 8 章测试的一次决策表走查。&lt;/p&gt;</description>
			</item>
			<item>
				<title>检查 shell 前缀与会话环境</title>
				<link>http://programmer.ie/zh-cn/examples/pi/09-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/09-chapter/</guid>
				<description>&lt;p&gt;使用 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 和它的内置 Bash 工具。你会把模型的命令和你自己的 &lt;code&gt;!&lt;/code&gt; 命令作比较。下面的配置和手动命令是对现有第 9 章测试的教学性改编；测试仍然是规范的可执行证据。&lt;/p&gt;</description>
			</item>
			<item>
				<title>决定一个需求需要哪种 Pi 机制</title>
				<link>http://programmer.ie/zh-cn/examples/pi/11-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/11-chapter/</guid>
				<description>&lt;p&gt;两个听起来很像的需求，是不同种类的需求。&amp;ldquo;在动 &lt;code&gt;migrations/&lt;/code&gt; 下的任何东西之前先确认&amp;quot;会去问一个人。&amp;ldquo;不要强制推送&amp;quot;则必须成立，无论有没有人在那里可问。只有一个扩展能在一次工具调用运行之前对它行动，所以两者都属于同一个 &lt;code&gt;tool_call&lt;/code&gt; 处理器——但它们需要不同的代码。&lt;/p&gt;</description>
			</item>
			<item>
				<title>把一个 Markdown 文件变成 /review 命令</title>
				<link>http://programmer.ie/zh-cn/examples/pi/12-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/12-chapter/</guid>
				<description>&lt;p&gt;第 11 章的那个 &lt;code&gt;/review&lt;/code&gt; 是一个四行的 Markdown 文件。本页写出真正要紧的最小的提示词模板，分别展开不带参数的 &lt;code&gt;/review&lt;/code&gt; 和带一个参数的 &lt;code&gt;/review&lt;/code&gt;，然后展示&amp;quot;我的模板不展开&amp;quot;背后的两条顺序规则。这是有文档记载的 Pi 1.0.4 行为，由一次会话测试确认。&lt;/p&gt;</description>
			</item>
			<item>
				<title>通过描述通告一个技能，按需加载正文</title>
				<link>http://programmer.ie/zh-cn/examples/pi/13-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/13-chapter/</guid>
				<description>&lt;p&gt;一个提示词模板要等到你键入它。一个技能在 Pi 辨认出任务的&lt;em&gt;种类&lt;/em&gt;时开始。整个机制都转折在一个字段上：系统提示词携带每一个技能的名称、描述和路径，从不携带正文，所以描述就是整个路由面。本页写出一个 &lt;code&gt;SKILL.md&lt;/code&gt;，并精确展示模型被告知了什么。&lt;/p&gt;</description>
			</item>
			<item>
				<title>给一个技能文件，以及一个它能运行的检查脚本</title>
				<link>http://programmer.ie/zh-cn/examples/pi/14-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/14-chapter/</guid>
				<description>&lt;p&gt;评审守卫的清单有四十项；把它内联进 &lt;code&gt;SKILL.md&lt;/code&gt; 会在技能每次触发时把全部四十项都加载进来。改成把它打包成正文中点名的一个文件。一个打包的文件是磁盘上的一个文件——它只在模型用它自己的工具读它时才到达上下文。本示例中打包的脚本需要一个 POSIX shell，所以在 Windows 上要在 Git Bash 下运行它。&lt;/p&gt;</description>
			</item>
			<item>
				<title>从一个扩展里注册一个工具和一个命令</title>
				<link>http://programmer.ie/zh-cn/examples/pi/15-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/15-chapter/</guid>
				<description>&lt;p&gt;扩展（extension）是一个默认导出接收 &lt;code&gt;ExtensionAPI&lt;/code&gt; 的 TypeScript 模块。注册一个工具会让它变为活动并向模型声明，而注册一个命令会在内置命令旁边添加一个 &lt;code&gt;/&lt;/code&gt; 命令。这个页面同时加载最小的命令扩展和这个一贯示例的 &lt;code&gt;review_scope&lt;/code&gt; 工具；唯一的替换是模型，一个重放脚本的 faux provider。&lt;/p&gt;</description>
			</item>
			<item>
				<title>用一个 tool_call 处理器阻止强制推送</title>
				<link>http://programmer.ie/zh-cn/examples/pi/16-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/16-chapter/</guid>
				<description>&lt;p&gt;一个 &lt;code&gt;tool_call&lt;/code&gt; 处理器在它点名的那个工具之前运行，所以它可以拒绝这次调用。这个页面上的守卫阻止破坏性的 git 命令——强制推送、&lt;code&gt;reset --hard&lt;/code&gt; 和 &lt;code&gt;git clean -f&lt;/code&gt;——并且在没有人可问（没有 UI）时，它拒绝而不是默默放行。这些情形通过一个 faux provider 在真实会话中运行，所以你看到的是守卫，不是一个真实模型。&lt;/p&gt;</description>
			</item>
			<item>
				<title>返回结构化的工具结果并路由嵌套调用</title>
				<link>http://programmer.ie/zh-cn/examples/pi/17-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/17-chapter/</guid>
				<description>&lt;p&gt;一个会执行的工具返回数据也返回文本：给脚本的机器可读的 &lt;code&gt;structuredContent&lt;/code&gt;，与供模型阅读的 &lt;code&gt;content&lt;/code&gt; 并列。这个页面的工具用注解声明风险，并通过 &lt;code&gt;ctx.executeTool()&lt;/code&gt; 相互运行，而那些嵌套调用与模型发出的调用一样，经过同一道 &lt;code&gt;tool_call&lt;/code&gt; 门。下面的行为是通过一个真实会话&lt;strong&gt;已观察&lt;/strong&gt;到的；模型是一个重放脚本的 faux provider。&lt;/p&gt;</description>
			</item>
			<item>
				<title>让模型所知的内容跟随活动工具</title>
				<link>http://programmer.ie/zh-cn/examples/pi/18-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/18-chapter/</guid>
				<description>&lt;p&gt;注册 &lt;code&gt;run_checks&lt;/code&gt; 并没有告诉模型它存在。这个示例从 &lt;code&gt;pi.getActiveTools()&lt;/code&gt; 推导提示词指引，并给落定守卫加上只催促一次的边界——一切都观察自一个脚本化的模型，而不是真实模型。&lt;/p&gt;&#xA;&lt;h2 id=&#34;运行它&#34;&gt;运行它&lt;/h2&gt;&#xA;&lt;p&gt;使用 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 和示例仓库的测试运行器。下面是那些规范扩展的摘录：&lt;/p&gt;</description>
			</item>
			<item>
				<title>把一个守卫的被阻止计数持久化为一条会话条目</title>
				<link>http://programmer.ie/zh-cn/examples/pi/19-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/19-chapter/</guid>
				<description>&lt;p&gt;一个模块级 &lt;code&gt;let&lt;/code&gt; 随进程一起消亡：&lt;code&gt;/reload&lt;/code&gt; 和恢复都会把它重置。修复办法是用 Pi 已经交给你的那个持久存储。这个示例把每一次被阻止的写入记录为一条模型永远看不见的 &lt;code&gt;custom&lt;/code&gt; 会话条目，并在 &lt;code&gt;session_start&lt;/code&gt; 时和导航时从活动分支重建计数。这些论断观察自一个脚本化的模型和一个录制型 UI。&lt;/p&gt;</description>
			</item>
			<item>
				<title>添加一条斜杠命令和一块尊重模式规则的自定义屏幕</title>
				<link>http://programmer.ie/zh-cn/examples/pi/20-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/20-chapter/</guid>
				<description>&lt;p&gt;一条命令能不能做成任何事，取决于它的模式：对话框需要 &lt;code&gt;ctx.hasUI&lt;/code&gt;，自定义屏幕需要一个真实终端。这个示例是最小的 &lt;code&gt;/guard&lt;/code&gt; 命令、那个双守卫规则，以及一个按列宽适配的组件——全都观察自一个脚本化的模型。&lt;/p&gt;</description>
			</item>
			<item>
				<title>按完整的 mcp__ 名把关 MCP 工具，并把注解当作提示</title>
				<link>http://programmer.ie/zh-cn/examples/pi/21-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/21-chapter/</guid>
				<description>&lt;p&gt;一个 MCP 服务器的工具以 &lt;code&gt;mcp__&amp;lt;server&amp;gt;__&amp;lt;tool&amp;gt;&lt;/code&gt; 到来，所以一个以裸工具名为键的 &lt;code&gt;tool_call&lt;/code&gt; 关卡会放行每一次远程调用。这个示例是一个以完整名称为键的拒绝清单关卡，是一对为一个会话添加服务器的注册调用，也是服务器就自身声明的注解与决定模型是否被告知该工具存在的暴露方式之间的区别。只有远端和模型是假的；命名、暴露方式和关卡都是 Pi 的。&lt;/p&gt;</description>
			</item>
			<item>
				<title>把扩展、技能和提示词作为一个 Pi 包交付</title>
				<link>http://programmer.ie/zh-cn/examples/pi/22-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/22-chapter/</guid>
				<description>&lt;p&gt;一个 Pi 包是你写下的一切的分发单元：一个扩展连同它的技能、提示词和主题，作为一个目录或 npm 包到来，而不是一个在别人机器上就坏掉的 &lt;code&gt;.pi&lt;/code&gt; 文件夹 zip。本章没有独立的代码文件，所以这个页面是一趟带占位名字的命令走查，依据是那个交付二进制测试所断言的内容。&lt;/p&gt;</description>
			</item>
			<item>
				<title>接管压缩摘要的生成</title>
				<link>http://programmer.ie/zh-cn/examples/pi/23-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/23-chapter/</guid>
				<description>&lt;p&gt;压缩改变的是下一个模型请求由&lt;strong&gt;什么构建而成&lt;/strong&gt;，永远不会改变会话文件所持有的东西。在 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 上，一个扩展可以通过 &lt;code&gt;session_before_compact&lt;/code&gt; 提供摘要，而切点仍由 Pi 选择；每个条目都留在文件里，而在压缩之前往回导航会再次发送原始消息。&lt;/p&gt;</description>
			</item>
			<item>
				<title>让会话树发生分支</title>
				<link>http://programmer.ie/zh-cn/examples/pi/24-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/24-chapter/</guid>
				<description>&lt;p&gt;一个被存储的会话是一棵由 &lt;code&gt;id&lt;/code&gt; 和 &lt;code&gt;parentId&lt;/code&gt; 连接起来的条目树，而当前位置是叶子。&lt;code&gt;/tree&lt;/code&gt; 在这棵树内部移动，&lt;code&gt;/fork&lt;/code&gt; 从一条更早的提示词开始一个新会话，而 &lt;code&gt;/clone&lt;/code&gt; 把活动分支复制进一个新会话。下面的轨迹是&lt;strong&gt;示意性&lt;/strong&gt;的；它所引出的论断，是 &lt;code&gt;branching.test.ts&lt;/code&gt; 在 1.0.4 上断言的那些，其中 &lt;code&gt;/fork&lt;/code&gt; 和 &lt;code&gt;/clone&lt;/code&gt; 在随附的二进制上运行。&lt;/p&gt;</description>
			</item>
			<item>
				<title>引导一次运行而不打断它</title>
				<link>http://programmer.ie/zh-cn/examples/pi/25-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/25-chapter/</guid>
				<description>&lt;p&gt;在 Pi 工作时键入并不是一次打断：一条引导消息&lt;strong&gt;在当前轮次的工具调用之后、下一个请求之前&lt;/strong&gt;进入，一条后续跟进消息等到智能体否则就要停下来时才进入，而 Escape 会中止并把你排队的文本还给你。下面的演练镜像了 1.0.4 上的 &lt;code&gt;ch25-queue/queue.test.ts&lt;/code&gt;，后者把消息排进一个真实会话，这个会话运行在一个刻意缓慢的工具下，使用一个脚本化的 provider。&lt;/p&gt;</description>
			</item>
			<item>
				<title>叫出八种消息角色</title>
				<link>http://programmer.ie/zh-cn/examples/pi/26-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/26-chapter/</guid>
				<description>&lt;p&gt;Pi 在 SDK 状态、生命周期事件、RPC 响应和持久化的会话条目中使用 &lt;code&gt;AgentMessage&lt;/code&gt; 联合——一个类型横跨四个面。在 &lt;strong&gt;1.0.4&lt;/strong&gt; 上，编码智能体给它扩展了四种角色，而应用可以通过声明合并添加更多。下面的声明复现了 &lt;code&gt;ch26-message-types/declared.ts&lt;/code&gt; 导出的类型；&lt;code&gt;assert-equal.ts&lt;/code&gt; 用两种方式对着真实导出检查那些复现。&lt;/p&gt;</description>
			</item>
			<item>
				<title>用本章的程序读一个会话文件</title>
				<link>http://programmer.ie/zh-cn/examples/pi/27-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/27-chapter/</guid>
				<description>&lt;p&gt;一个 Pi 会话是一个 JSONL 文件：一行一个 JSON 对象，&lt;code&gt;session&lt;/code&gt; 头在最前，然后是由 &lt;code&gt;id&lt;/code&gt; 和 &lt;code&gt;parentId&lt;/code&gt; 链接起来的条目。这种格式是第 5、6、23、24 章那些会话论断的&lt;strong&gt;共同来源&lt;/strong&gt;——它们引用它的声明，而不是重新定义它——所以一个能跑的读取器是看清它们全都意味着什么的最直接方式。下面是第 27 章自己的读取程序，在 &lt;strong&gt;1.0.4&lt;/strong&gt; 上，原样复现。&lt;/p&gt;</description>
			</item>
			<item>
				<title>在上下文管线中把发现与准入分开</title>
				<link>http://programmer.ie/zh-cn/examples/pi/28-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/28-chapter/</guid>
				<description>&lt;p&gt;&amp;ldquo;模型读了我的 AGENTS.md&amp;quot;这句话藏着四个事实：文件存在、Pi 发现了它、某个东西准入了它，而它在模型收到的请求里。每一个都可能独自失败，而每一个都有一个不同的所有者。下面的摘录作为第 28 章的测试在一棵临时树上运行——默认加载器，没有模型。&lt;/p&gt;</description>
			</item>
			<item>
				<title>把某个 provider 的溢出消息归一化，好让 Pi 能恢复</title>
				<link>http://programmer.ie/zh-cn/examples/pi/29-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/29-chapter/</guid>
				<description>&lt;p&gt;一次失败的请求有三种不同的答案：重复它（暂时的）、修复上下文后重试一次（溢出），或者停下来。Pi 识别它自己的溢出信号；一个自定义 provider 的消息可能不会被识别。下面的扩展只把那一个 provider 的溢出文本映射到 Pi 识别的那个标记上，好让恢复得以运行。这里的一切都在 &lt;strong&gt;1.0.4&lt;/strong&gt; 上被观察过，对手是一个脚本化 provider，运行在一个启用了压缩的会话里——一个真实的 &lt;code&gt;AgentSession&lt;/code&gt;，没有真实模型。&lt;/p&gt;</description>
			</item>
			<item>
				<title>通过三个界面驱动同一个智能体</title>
				<link>http://programmer.ie/zh-cn/examples/pi/31-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/31-chapter/</guid>
				<description>&lt;p&gt;终端是驱动这个智能体的五种方式之一，而切换驱动改变的是你如何观察它，不是它是什么。下面两个微小的驱动把那个论断摆到同一个 agent-core 智能体面前，而一个随附二进制文件的测试把它推过 print、JSON 和 RPC。这里的一切都在 &lt;strong&gt;1.0.4&lt;/strong&gt; 上、在一个脚本化模型之下运行——它演练的是每个界面如何观察这个智能体，而不是某个 provider 的输出。&lt;/p&gt;</description>
			</item>
			<item>
				<title>在没有人的情况下运行 Pi</title>
				<link>http://programmer.ie/zh-cn/examples/pi/32-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/32-chapter/</guid>
				<description>&lt;p&gt;一个 CI 作业和一个 pre-commit 钩子都需要没有终端的 Pi。模式决定输入如何进入智能体、输出如何被暴露、失败如何被报告。下面的每一条论断都是在 &lt;strong&gt;1.0.4&lt;/strong&gt; 上&lt;strong&gt;已观察&lt;/strong&gt;的：以子进程的方式驱动随附的 &lt;code&gt;pi&lt;/code&gt; 二进制文件，配一个脚本化的模型——真实的命令行、模式选择和退出码，没有凭据，也没有 provider。&lt;/p&gt;</description>
			</item>
			<item>
				<title>逐条读取 JSON 事件流</title>
				<link>http://programmer.ie/zh-cn/examples/pi/33-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/33-chapter/</guid>
				<description>&lt;p&gt;&lt;code&gt;pi --mode json&lt;/code&gt; 不是一个单一的 JSON 结果：它是一条记录流，每条记录都是一个以 LF 结尾的 JSON 对象，而 stdout 不承载别的任何东西。下面那些记录是那个形状的示意画——调用约定本身是在 &lt;strong&gt;1.0.4&lt;/strong&gt; 上&lt;strong&gt;已观察&lt;/strong&gt;的，方法是在一个脚本化的模型下运行随附的二进制文件并检查这条流。&lt;/p&gt;</description>
			</item>
			<item>
				<title>用 SDK 会话把一个智能体嵌进你的进程</title>
				<link>http://programmer.ie/zh-cn/examples/pi/34-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/34-chapter/</guid>
				<description>&lt;p&gt;一个 SDK 会话把智能体移进你自己的 Node.js 或 Bun 进程：&lt;code&gt;createAgentSession()&lt;/code&gt; 返回一个类型化的 &lt;code&gt;AgentSession&lt;/code&gt;，而那些你曾经从管道里解析出来的事件，以对象的形式到达，它们保留 JSON 流所剥去的累积式 &lt;code&gt;partial&lt;/code&gt; 快照。在你的进程内部，终端过去默默处理的规则变成了你要陈述的东西。这里的一切都是&lt;strong&gt;已观察&lt;/strong&gt;的——&lt;code&gt;sdk.test.ts&lt;/code&gt; 驱动一个 provider 被脚本化的真实 &lt;code&gt;AgentSession&lt;/code&gt;，在 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 上。&lt;/p&gt;</description>
			</item>
			<item>
				<title>通过 JSONL 驱动一个运行中的 Pi 子进程</title>
				<link>http://programmer.ie/zh-cn/examples/pi/35-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/35-chapter/</guid>
				<description>&lt;p&gt;RPC 把 Pi 保留在一个单独的进程里，并以换行分隔的 JSON 与它对话，所以子进程的生命期由你决定——跨进程时你等的是一个事件，而不是一个 promise。代价是一个协议：命令与响应记录、一股不带命令 id 的会话事件流，以及第四种记录族、双向流动的扩展 UI 记录。下面的一切都是在 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 上、针对&lt;strong&gt;交付的二进制文件&lt;/strong&gt;、由一个只按 LF 切分的手写客户端&lt;strong&gt;已观察&lt;/strong&gt;到的。&lt;/p&gt;</description>
			</item>
			<item>
				<title>从一次模型调用拿到一个类型化的答案</title>
				<link>http://programmer.ie/zh-cn/examples/pi/36-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/36-chapter/</guid>
				<description>&lt;p&gt;一个应用从模型那里需要的大多数东西是一个问题和一份答案。&lt;code&gt;assess.ts&lt;/code&gt; 就是那一级——&lt;strong&gt;第 1 层，模型/provider 访问&lt;/strong&gt;，这架五级梯子的底层：一次请求，没有循环、没有会话、没有终端。一份工具声明是一个由模型填写的 schema，而 &lt;code&gt;validateToolCall()&lt;/code&gt; 把答案变成一个类型化的值或一个异常，全部&lt;strong&gt;已观察&lt;/strong&gt;于 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 上的脚本化响应之下。&lt;/p&gt;</description>
			</item>
			<item>
				<title>用一个语料库工具单独运行智能体循环</title>
				<link>http://programmer.ie/zh-cn/examples/pi/37-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/37-chapter/</guid>
				<description>&lt;p&gt;&lt;code&gt;research-agent.ts&lt;/code&gt; 用一个读语料库的工具和一个注入的流函数，包裹了 &lt;code&gt;pi-agent-core&lt;/code&gt; 的 &lt;code&gt;Agent&lt;/code&gt;——也就是编码智能体所构建的那个类：这是&lt;strong&gt;第 2 层，智能体内核&lt;/strong&gt;，编码智能体的会话、信任门、扩展和终端都不在场。与第 1 章那个自包含的打印脚本不同，这是一个库函数：语料库、模型和流函数都来自调用者，而转录记录是你断言的数据。下面的一切都是&lt;strong&gt;已观察&lt;/strong&gt;于 Pi &lt;strong&gt;1.0.4&lt;/strong&gt; 上的脚本化响应之下。&lt;/p&gt;</description>
			</item>
			<item>
				<title>从一个有界的模型循环里返回一个匹配 schema 的值</title>
				<link>http://programmer.ie/zh-cn/examples/pi/38-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/38-chapter/</guid>
				<description>&lt;p&gt;随机一步是一个带类型的函数：文本进，一个匹配你的 TypeBox schema 的值出，没有第三种结果。模型只能通过调用一个 &lt;code&gt;submit&lt;/code&gt; 工具来结束，那个工具的参数就是那个 schema，所以文字无法从接缝处漏出去。本页用一个脚本化的 provider 在 &lt;strong&gt;pi-agent-core 1.0.4&lt;/strong&gt; 上运行那个标准的 &lt;code&gt;step.ts&lt;/code&gt;。&lt;/p&gt;</description>
			</item>
			<item>
				<title>按每个钩子还能决定什么来映射智能体内核的钩子</title>
				<link>http://programmer.ie/zh-cn/examples/pi/39-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/39-chapter/</guid>
				<description>&lt;p&gt;一个钩子只有在它触发时还能做出的那些决定上，才是一个真实的接缝。&lt;code&gt;beforeToolCall&lt;/code&gt; 是唯一一个能拒绝一个效果的钩子；&lt;code&gt;afterToolCall&lt;/code&gt; 改写故事，但不能撤销行为。本页重现 &lt;strong&gt;pi-agent-core 1.0.4&lt;/strong&gt; 上那个观察到的顺序，然后是那个说出哪些决定在哪儿还便宜的接缝矩阵。&lt;/p&gt;</description>
			</item>
			<item>
				<title>在每个位置都用最弱的部件组合出一条流水线</title>
				<link>http://programmer.ie/zh-cn/examples/pi/40-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/40-chapter/</guid>
				<description>&lt;p&gt;组合并不意味着要用智能体。一个论断检查器需要四种部件——一个普通函数、一次带类型的模型调用、一次成员资格检查和一个智能体——而每一种都只在更弱的那些无法决定的地方被使用。本页展示那个标准的 &lt;code&gt;examples/ch40-composition/pipeline.ts&lt;/code&gt; 里承重的部分，在 &lt;strong&gt;Pi 1.0.4&lt;/strong&gt; 上用一个脚本化的 provider 运行。&lt;/p&gt;</description>
			</item>
			<item>
				<title>用 pass@1 和 pass^k 测量智能体可靠性</title>
				<link>http://programmer.ie/zh-cn/examples/pi/41-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/41-chapter/</guid>
				<description>&lt;p&gt;有三种活动都被叫作&amp;quot;测试&amp;quot;：脚本化（你选定的一个响应）、结构化（对事件断言，而不是对措辞）和评估（整个东西在反复运行中多久成功一次）。本页是那个评估测试骨架——被摘录出来的 &lt;code&gt;eval.ts&lt;/code&gt; 的测量部分——运行在 &lt;strong&gt;Pi 1.0.4&lt;/strong&gt; 上。下面那个&amp;quot;模型&amp;quot;是一枚带种子的 85% 硬币，所以这测量的是那个测试骨架的算术，而不是任何 provider 的；本页的台账里&lt;strong&gt;不含任何真实模型的证据&lt;/strong&gt;。&lt;/p&gt;</description>
			</item>
			<item>
				<title>把一个自报的注解当作论断，而不是控制</title>
				<link>http://programmer.ie/zh-cn/examples/pi/42-chapter/</link>
				<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
				<guid>http://programmer.ie/zh-cn/examples/pi/42-chapter/</guid>
				<description>&lt;p&gt;能力不是权限，而你能写下的几乎没有一个东西是边界——操作系统边界才是。本页用 &lt;code&gt;AgentTool.replay&lt;/code&gt; 在 &lt;strong&gt;Pi 1.0.4&lt;/strong&gt; 上展示这一点：一个由工具在它自身上填写的字段，而类型里没有任何东西核实它。&lt;/p&gt;</description>
			</item>
	</channel>
</rss>
