Pi 运行时

Pi 是 Project 内置 Provider 和自定义 Provider 的可选运行时。在 Agent 预设中选择 Pi，或在 v2 API 请求中传入 harness: "pi"。添加 Provider 不会把已有 Agent 或 Session 切换到 Pi；Project 仅配置自定义 Provider 时，仍默认使用 OpenCode。

配置模型

1. 在当前 Project 中打开 Config → Providers，为内置 Provider 添加 key，或选择 Add custom provider。
2. 对自定义 Provider，保存 API key、HTTPS base URL、准确模型 ID，以及 endpoint 实现的 Model protocol：OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 或 Google Gemini。
3. 在 Agent 编辑器中选择 Pi，再选择 Project 中兼容的模型。内置模型使用目录定义的协议；自定义模型使用凭据中选定的协议。
4. 发送一个需要调用工具的代表性任务，检查回答和输出文件。可选的 Provider 连接测试通过，并不能证明完整的 Pi Run 可用。

Pi 按所选模型协议调用服务商，包括流式响应和工具调用。服务商名称或 OpenAI-compatible 标签不能代替协议选择；仅支持 Responses 的 endpoint 可以通过选择 OpenAI Responses 接入。详见协议与运行时矩阵。

此范围使用 Mosoo Project 中保存的 API key，不等于开放独立 Pi 的全部认证方式，例如订阅 OAuth、Bedrock 或 Vertex 的环境凭据。

通过 API 或 CLI 创建 Session

按照 v2 快速开始配置目标、Project ID 和 Project API key。将以下请求保存为 pi-session.json，并把 YOUR_CUSTOM_MODEL_ID 替换为上一步配置的准确模型 ID：

下例使用自定义 Provider。使用内置 Provider 时，将 provider 和 model 替换为对应目录 ID，并保留 harness: "pi"。协议由 Provider 凭据或模型目录决定，不在 Session 请求中指定。

{
  "configuration": {
    "type": "inline",
    "harness": "pi",
    "provider": "openai-compatible",
    "model": "YOUR_CUSTOM_MODEL_ID",
    "instructions": "Use tools to inspect the workspace and save deliverables in outputs/."
  }
}

curl -X POST "$MOSOO_API_BASE/projects/$MOSOO_PROJECT_ID/threads" \
  -H "Authorization: Bearer $MOSOO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pi-session-1" \
  --data-binary @pi-session.json

MOSOO_API_BASE 必须以 /api/v2 结尾。不带输入的创建请求只会返回空闲 Session，不会测试模型。使用返回的 thread.id 发送输入、等待 Run 并读取文件。后续工作继续使用同一 ID；Session 会保留创建时确定的 Pi 运行时和模型。

v2 CLI 接受同一份 JSON，并要求显式选择 Project：

mosoo public-thread-api-v2 threads create --project-id "$MOSOO_PROJECT_ID" --file ./pi-session.json --idempotency-key pi-session-1 -o json

不要在这份 JSON 中放模型服务商的 API key。请在 Project 中配置它；访问 mosoo 使用 Project API key 或 CLI 登录。

执行与续接

• Pi 接受文本输入。上传文件可以在 Session 工作区中使用，但这并不启用直接向模型输入图片、音频或视频的能力。
• Pi 在 Session 内按全访问模式执行。不支持逐工具限制或交互式审批策略；这些配置会被拒绝。请选用具有所需网络策略的 Environment。
• 附加 Skills 和已授权的 Remote MCP 连接沿用现有 Skills 与 MCP 流程。
• 成功的 Run 会保存工作区文件和 Pi 原生会话状态。继续同一 Session 时会恢复这些状态；原生状态缺失或不匹配时明确失败，不会静默新建对话。

自托管部署需要同时更新匹配的 API Worker、Driver 和 Pi sandbox image。本次集成使用 Pi CLI 0.99.2、原生 RPC 与 Driver 协议 6。在目标环境启用前，请遵循部署指南。