Pi - 火山方舟文档

本文介绍如何在 Pi 中配置并使用方舟 Agent Plan 企业版。

前提条件#

需由管理员账号完成以下操作后，子账号方可配置并使用 Pi：
1. 购买方舟 Agent Plan 企业版套餐：一、购买 Agent Plan 企业版。
2. 为子账号分配席位：二、分配席位。
安装 Node.js 20 或更新版本。

安装 Pi#

在命令行界面，执行以下命令安装 Pi。

1
2
3
4
5# 方式 1：npm 全局安装
npm install -g @earendil-works/pi-coding-agent

# 方式 2：官方一键脚本
curl -fsSL https://pi.dev/install.sh | sh

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

1pi --version

需先额外安装 Git for Windows，Pi 依赖其提供的 bash.exe 执行 ! / !! shell 命令；官方 curl 一键脚本在 Windows 上不支持。

通过 npm 全局安装：

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

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

1pi --version

配置 Pi#

方式 1：一键配置（推荐）#

Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。

安装 Ark CLI

环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。

1
2npm install -g @volcengine/ark-cli@latest
arkcli --version

1arkcli auth login

一键配置 Pi

1arkcli helper

运行 ArkCLI Helper，根据界面提示完成配置。

选择 Profile：agent-plan-team_cn-beijing_team。
选择默认 model：按需选择。
选择 AI Agent：Pi。
支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

配置完成后，Pi 会自动识别配置的模型。启动 Pi 即可使用。

方式 2：手动配置#

创建并编辑 ~/.pi/agent/models.json 文件。关注的配置信息如下：

<ARK_API_KEY>：替换为您自己的专属 API Key。

model：见支持模型及 Harness，需配置文本生成模型。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92{
  "providers": {
    "agent-plan": {
      "api": "openai-completions",
      "apiKey": "<ARK_API_KEY>",
      "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
      "models": [
        {
          "id": "ark-code-latest"
        },
        {
          "contextWindow": 1048576,
          "id": "doubao-seed-evolving",
          "input": ["text", "image"],
          "maxTokens": 256000
        },
        {
          "contextWindow": 1048576,
          "id": "doubao-seed-2.1-pro",
          "input": ["text", "image"],
          "maxTokens": 256000
        },
        {
          "contextWindow": 1048576,
          "id": "doubao-seed-2.1-lite",
          "input": ["text", "image"],
          "maxTokens": 256000
        },
        {
          "contextWindow": 262144,
          "id": "doubao-seed-2.0-mini",
          "input": ["text", "image"],
          "maxTokens": 128000
        },
        {
          "contextWindow": 1048576,
          "id": "glm-5.3",
          "input": ["text"],
          "maxTokens": 128000
        },
        {
          "contextWindow": 1048576,
          "id": "glm-5.3-flash",
          "input": ["text", "image"],
          "maxTokens": 128000
        },
        {
          "contextWindow": 1048576,
          "id": "deepseek-v4-pro",
          "input": ["text"],
          "maxTokens": 393216
        },
        {
          "contextWindow": 1048576,
          "id": "deepseek-v4.1-flash",
          "input": ["text", "image"],
          "maxTokens": 393216
        },
        {
          "contextWindow": 1024000,
          "id": "deepseek-v4.1-flash-economy",
          "input": ["text", "image"],
          "maxTokens": 393216
        },
        {
          "contextWindow": 1048576,
          "id": "deepseek-v4-flash",
          "input": ["text"],
          "maxTokens": 393216
        },
        {
          "contextWindow": 1048576,
          "id": "glm-latest",
          "input": ["text"],
          "maxTokens": 128000
        },
        {
          "contextWindow": 1048576,
          "id": "kimi-k2.8-preview",
          "input": ["text", "image"],
          "maxTokens": 1048576
        },
        {
          "contextWindow": 1024000,
          "id": "kimi-k3.1-pro",
          "input": ["text", "image"],
          "maxTokens": 1024000
        }
      ]
    }
  }
}

使用 Pi#

进入项目目录并启动 Pi：
Bash
```
1pi
```
在 Pi 交互界面执行 /model，可选择切换刚才配置的 provider 和模型。
支持的模型参见支持模型及 Harness。
发送任意问题验证连通性，例如：
```
简单介绍一下当前目录的文件结构。
```
若返回内容正常，说明 Agent Plan 企业版已成功接入。

更多 Pi 使用教程请参见 Pi 官方文档。

其他操作#

切换模型#

Pi 支持两种切换方式：

配置方式	操作
交互切换	在 Pi 对话界面执行 `/model`，从下拉列表选择目标模型。
修改配置	编辑 `~/.pi/agent/models.json`，在对应 provider 的 `models` 数组中新增或调整模型条目，保存后执行 `/model` 触发重载。

添加图片生成/视频生成能力#

方舟 Agent Plan 企业版 Team Medium 及以上套餐提供图片生成模型配额，Team Large 及以上套餐提供视频生成模型配额。Pi 的 models[].input 只声明输入模态（text / image），图片/视频生成需要通过工具调用或 MCP 接入。具体配置方法请参见接入视觉模型。