第七部分，Pi SDK

Pi SDK 快速开始

安装 @earendil-works/pi-coding-agent，并用 createAgentSession 创建内存 Session。

进阶 / 12 分钟 / 第 37 篇

最小 Node.js 集成

SDK 包含在主 coding-agent 包中，不需要独立安装。它适合自定义 UI、自动化流水线、嵌入式代理和测试。

createAgentSession 返回 session。订阅事件后调用 prompt，message_update 的 text_delta 可用于流式界面。

npm install @earendil-works/pi-coding-agent

import {
  createAgentSession,
  ModelRuntime,
  SessionManager,
} from "@earendil-works/pi-coding-agent";

const modelRuntime = await ModelRuntime.create();
const { session } = await createAgentSession({
  sessionManager: SessionManager.inMemory(),
  modelRuntime,
});

session.subscribe((event) => {
  if (event.type === "message_update"
      && event.assistantMessageEvent.type === "text_delta") {
    process.stdout.write(event.assistantMessageEvent.delta);
  }
});

await session.prompt("只读解释当前目录中的文件");

应用边界

SDK 在同一进程中运行工具和扩展。服务端必须为每个租户指定 cwd、凭据、Session 存储和工具 allowlist。

不要让用户输入直接决定任意文件路径、Extension 路径或 Shell 权限。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。

Pi SDK