如何使用 Pi SDK：从入门到实战

 以下是文章的完整内容：

  ────────────────────

  如何使用 Pi SDK：从入门到实战

  │ 本文基于 ]8;id=https://pi.dev/docs/latest/sdk;https://pi.dev/docs/latest/sdk\Pi 官方 SDK 文档 (https://pi.dev/docs/latest/sdk)]8;;\ 整理撰写，帮助你快速理解并上手 Pi SDK，将 AI Agent 能力嵌入到你自己的应用中。

  ────────────────────

  一、Pi SDK 是什么？

  Pi SDK（npm 包名 @earendil-works/pi-coding-agent）是 ]8;id=https://pi.dev;https://pi.dev\Earendil Inc. (https://pi.dev)]8;;\ 提供的官方软件开发工具包。它让你能够以编程方式访问 Pi 的 AI Agent 能力，而无需依赖交互式命令行界面。

  典型使用场景

   场景                  │ 说明
  ───────────────────────┼───────────────────────────────────────────────
   构建自定义 UI         │ 在 Web、桌面或移动端界面中嵌入 Agent 对话能力
  ───────────────────────┼───────────────────────────────────────────────
   集成到现有应用        │ 将 Agent 推理能力接入已有系统或工作流
  ───────────────────────┼───────────────────────────────────────────────
   创建自动化流水线      │ 用 Agent 推理驱动自动化任务
  ───────────────────────┼───────────────────────────────────────────────
   构建自定义工具        │ 生成子 Agent 来完成特定工作
  ───────────────────────┼───────────────────────────────────────────────
   程序化测试 Agent 行为 │ 编写自动化测试验证 Agent 输出

  ────────────────────

  二、安装

  Pi SDK 包含在主包中，无需单独安装其他依赖：

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

  ────────────────────

  三、快速开始

  以下是最小可运行示例——创建一个 Agent 会话，发送一条提示，并实时打印 Agent 的回复：

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

  // 1. 创建模型运行时
  const modelRuntime = await ModelRuntime.create();

  // 2. 创建 Agent 会话
  const { session } = await createAgentSession({
    sessionManager: SessionManager.inMemory(),
    modelRuntime,
  });

  // 3. 订阅事件，实时输出 Agent 的文本回复
  session.subscribe((event) => {
    if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
      process.stdout.write(event.assistantMessageEvent.delta);
    }
  });

  // 4. 发送提示并等待完成
  await session.prompt("What files are in the current directory?");
  ```

  运行后，Agent 会读取当前目录下的文件列表并输出结果。这就是 Pi SDK 的核心使用模式：创建会话 → 订阅事件 → 发送提示。