火山方舟
火山方舟
文档指南
请输入
- 文档首页
火山方舟调用接入 AI 工具WorkBuddy
复制全文
下载 pdfWorkBuddy
文档反馈
问问助手本文介绍如何在 WorkBuddy 中配置并使用方舟 按量计费模型服务。
前提条件
安装 WorkBuddy
配置 WorkBuddy
方式 1：一键配置（推荐）
Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。
- 安装 Ark CLI
- 环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。
- 登录 Ark CLI
- 根据界面提示选择登录方式，推荐选择 火山 SSO (浏览器登录)，在浏览器中完成授权即可。
- 一键配置 WorkBuddy
运行 ArkCLI Helper，根据界面提示完成配置。
- 选择 Profile：platform_cn-beijing_accountwide。
- 选择 Endpoint：按需选择要使用的推理接入点。
- 选择 AI Agent：WorkBuddy。
配置完成后，WorkBuddy 会自动识别配置的模型。启动 WorkBuddy 即可使用。
方式 2：手动配置
- 启动 WorkBuddy，单击左下角账户头像，选择 设置。
- 在左侧导航中选择 模型，在自定义模型区域单击 添加模型。
- 在提供商中选择 自定义 / Custom，填写以下字段并保存：
- 接口地址：https://ark.cn-beijing.volces.com/api/v3
- API Key：API Key（获取地址）。
- 模型名称：按需填写模型的 Model ID，模型列表参见 模型列表。
- 高级工具：非必填，按需勾选。按需开启 工具调用、图片输入、思考模式。
- 自定义协议：当模型服务使用非标准 URL 路径（如经过网关或代理层封装）时，可在高级配置中开启自定义协议开关。开启后 Tencent WorkBuddy 将直接按填写的 URL 发起请求，跳过路径校验与自动补全。关闭（默认）：使用标准 /chat/completions 路径，自动校验并补全接口地址。开启：直接使用用户填写的接口地址发起请求，跳过路径校验与自动补全逻辑。
-
- 除了在客户端 UI 中添加自定义模型，也可以直接编辑本地配置文件 ~/.workbuddy/models.json 来接入 按量计费模型服务，保存后，WorkBuddy 会自动监听并热加载新配置（无需重启）。返回主界面的模型下拉列表中显示的即为 name 字段。
~/.workbuddy/models.json 示例
- 保存后返回 WorkBuddy 主界面。
使用 WorkBuddy
- 在主界面顶部的模型下拉中，选中刚添加的模型。
- 在输入框用一句话描述你的任务（如生成周报、数据分析、整理文件、代码生成 / 重构 / 修 Bug），回车即可启动，WorkBuddy 会自主规划执行并产出文档、表格、代码文件等结果，在右侧结果区可查看生成内容与文件变更。
最近更新时间：2026.11.04 17:47:45
这个页面对您有帮助吗？
有用
有用
无用
无用