火山方舟
火山方舟
文档指南
请输入
- 文档首页
火山方舟调用接入 AI 工具Pi
复制全文
下载 pdfPi
文档反馈
问问助手本文介绍如何在 Pi 中配置并使用方舟 按量计费模型服务。
前提条件
- 在配置工具前，需要 开通所需的模型服务。
- 安装 Node.js 20 或更新版本。
安装 Pi
在命令行界面，执行以下命令安装 Pi。
安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。
通过 npm 全局安装：
安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。
配置 Pi
方式 1：一键配置（推荐）
Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。
- 安装 Ark CLI
- 环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。
- 登录 Ark CLI
- 根据界面提示选择登录方式，推荐选择 火山 SSO (浏览器登录)，在浏览器中完成授权即可。
- 一键配置 Pi
运行 ArkCLI Helper，根据界面提示完成配置。
- 选择 Profile：platform_cn-beijing_accountwide。
- 选择 Endpoint：按需选择要使用的推理接入点。
- 选择 AI Agent：Pi。
配置完成后，Pi 会自动识别配置的模型。启动 Pi 即可使用。
方式 2：手动配置
创建并编辑 ~/.pi/agent/models.json 文件。关注的配置信息如下：
- <ARK_API_KEY>：替换为您自己的 API Key。
- model：更新为需要使用的 Model ID，模型列表参见 模型列表。
-
说明
修改 models.json 后无需重启 Pi，在对话中执行 /model 会自动重新加载。
使用 Pi
- 进入项目目录并启动 Pi：
-
- 在 Pi 交互界面执行 /model，可选择切换刚才配置的 provider 和模型。
- 模型列表参见 模型列表。
- 发送任意问题验证连通性，例如：
-
- 若返回内容正常，说明 按量计费模型服务已成功接入。
最近更新时间：2026.11.03 21:11:09
这个页面对您有帮助吗？
有用
有用
无用
无用