You need to enable JavaScript to run this app.
文档中心
复制全文
下载 pdf
产品概述
核心能力与使用方式
复制全文
下载 pdf
核心能力与使用方式
你通常只需要描述目标。Agent 负责选择 Skill、收集必要参数并调用执行工具。volcengine-cli 调用 ve 原生 API 时,先检查安全策略:策略已启用且规则非空时,按 CLI 判定执行、等待确认或停止,不再叠加内置确认;策略关闭、规则为空或版本不支持时,使用 Skill 内置确认。策略读取或格式异常时停止调用。产品代理命令和其他专业 Skill 按各自规则执行;需要确认时,Agent 会先展示目标、参数和影响。​
Toolkit、Plugin 与 Skills​
Agent Toolkit 是整体工具包。Plugin 是安装和管理一组 Skills 的方式,Skills 为 Agent 提供产品知识与任务流程,CLI 和 MCP 提供命令执行及工具连接。它们不是四个架构层级,也不要求全部配置后才能开始。​
先安装核心 Plugin 或兼容的核心 Skills,专业能力按任务补充。Ark Skills 来自独立的官方产品仓库,不在当前 Volcengine Finder 本地 Catalog 中;查看模型与智能体管理。​
先区分要操作的对象​
正在接收需求的 Code Agent 是本地开发工具;Agent Toolkit 为它提供火山引擎的任务知识与工具。方舟 Managed Agent 是被创建和管理的云端智能体,具有独立的配置、运行环境和会话。安装本地 Skill 不会自动把它挂载到云端智能体。​
希望本地 Agent 使用方舟模型,与希望创建一个云端 Managed Agent,是两类任务。可分别描述“把方舟模型接入当前开发工具”和“在方舟创建并测试一个云端智能体”。Agent Toolkit 与 AgentKit 也不是同一产品;需求只写“创建 Agent”时,应先确认运行位置、目标产品和使用方式,不按名称相似直接替换。​
一次任务的处理过程​
  1. 描述目标及要操作的项目或资源;存在歧义时先确认目标。​
  1. 检查当前会话可用的 Skills。Volcengine Catalog 内的能力由 Finder 查找;Ark 能力按模型与智能体管理获取。​
  1. 检查实际执行工具、版本与认证。缺少依赖时说明安装来源和影响,得到授权后准备;文件已安装但未加载时重新加载或新建对话。​
  1. 按对应 Skill 与工具规则确认操作范围,通过 CLI、OpenAPI、SDK 或 Terraform 执行。​
  1. 检查业务返回及最终结果。创建资源、会话可用和任务回答正确分别验证,未完成项明确说明。​
​
Skills 与执行工具​
​
对象​
主要用途​
使用说明​
Volcengine Skills​
面向 Agent 的任务入口​
提供流程、参数、安全确认和结果解释​
ve CLI​
通用云资源查询与操作​
调用标准 OpenAPI;先检查身份、Profile 和地域​
产品专用 CLI​
特定产品的深度操作​
相关 Skill 按需使用 ve tosutil、ve arkcli、ve volclog,或 tosutil、vefaas 或 AI 原生 BaaS 平台 CLI 等工具​
OpenAPI / SDK​
接口规格查询、代码生成和应用集成​
由 volcengine-api、volcengine-sdk-generator 等 Skills 承接​
Terraform / IaC​
基础设施计划、变更和状态管理​
仅在你选择 IaC 或已有 Terraform 工作流时使用​
​
CLI 与 Skills 的安装关系​
​
工具​
安装方式​
说明​
ve CLI​
一键安装程序检测并按需安装​
其他入口不保证同步安装;volcengine-cli 会在使用前检查​
arkcli​
按任务和安装方式准备;可通过 ve arkcli 使用​
arkcli 提供方舟模型、推理接入点、用量和诊断,以及托管 Agent 管理能力。相关 Skills 从 Ark 官方仓库获取,不推定已随核心 Plugin 安装。详见模型与智能体管理。​
tosutil​
使用 volcengine-tosutil 时准备​
按操作系统和芯片架构下载并校验​
vefaas​
使用 volcengine-vefaas 时准备​
提供安装、登录检查和部署流程​
AI 原生 BaaS 平台 CLI​
使用 volcengine-db-supabase 时准备​
用于火山引擎 AI 原生 BaaS 平台 Supabase 版;实际命令和安装方式见 Skill 详情​
​
CLI 与 MCP​
CLI 适合终端、自动化脚本或能执行命令的 Agent;MCP 适合通过协议连接工具的 Agent。ve mcp 提供文档检索、服务与 API 发现、参数查询及受权限约束的 API 调用,但不代表全部产品 CLI 命令。​
安装 Plugin、安装 CLI、配置 MCP 和取得云权限是不同操作。ve mcp 在本地进程中运行,使用 stdio 或客户端支持的 HTTP 传输,不是官方托管端点。查看CLI 使用与通过 MCP 接入 Agent。​
​
方舟工具与 MCP 的关系​
Ark Skills 指导本地 Agent 使用 arkcli;已有 ve 时也可以通过 ve arkcli 使用产品命令。产品 CLI 有自己的认证和版本要求,不沿用 ve 原生 API 的全部参数与策略。​
ve mcp 暴露的文档与 API 工具,不等于 arkcli 的全部命令。Ark 自身的 MCP 接入和云端 Managed Agent 挂载的外部 MCP 也是不同连接,应分别核对服务、工具清单及授权。使用 CLI 完成方舟任务时,不要求先配置 MCP。​
​
最近更新时间:2026.10.29 15:14:58
这个页面对您有帮助吗?
有用
有用
无用
无用