文档中心

火山方舟

接入 AI 工具

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

前提条件

您已按需订阅 Agent Plan 套餐。如未订阅，请访问开通管理-Agent Plan 页面订阅套餐。

安装 Node.js 20 或更新版本。

安装 Pi

macOS/Linux

Windows

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

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

配置 Pi

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

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

安装 Ark CLI

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

根据界面提示选择登录方式，推荐选择火山 SSO (浏览器登录)，在浏览器中完成授权即可。

一键配置 Pi

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

选择 Profile：agent-plan_cn-beijing_personal。

选择默认 model：按需选择。

选择 AI Agent：Pi。

支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

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

方式 2：手动配置

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

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

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

{
"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.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-pro",
"input": ["text"],
"maxTokens": 393216
},
{
"contextWindow": 1048576,
"id": "deepseek-v4-flash",
"input": ["text"],
"maxTokens": 393216
},
{
"contextWindow": 1048576,
"id": "kimi-k3",
"input": ["text", "image"],
"maxTokens": 128000
},
{
"contextWindow": 1024000,
"id": "kimi-k3.1-pro",
"input": ["text", "image"],
"maxTokens": 1024000
},
{
"contextWindow": 1048576,
"id": "kimi-k2.8-preview",
"input": ["text", "image"],
"maxTokens": 1048576
},
{
"contextWindow": 1048576,
"id": "glm-latest",
"input": ["text"],
"maxTokens": 128000
}
]
}
}
}

说明

修改 models.json 后无需重启 Pi，在对话中执行 /model 会自动重新加载。

使用 Pi

在 Pi 交互界面执行 /model，可选择切换刚才配置的 provider 和模型。

支持的模型参见支持模型及 Harness。

发送任意问题验证连通性，例如：

若返回内容正常，说明 Agent Plan 已成功接入。

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

其他操作

切换模型

Pi 支持两种切换方式：

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

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

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

注意

不同的套餐支持的视觉模型有所不同，具体参见支持模型及 Harness。

视觉模型不支持通过 Auto 及控制台切换使用。

最近更新时间：2026.11.04 17:47:44

这个页面对您有帮助吗？

有用

无用