- 文档首页
火山引擎技能包 Agent Toolkit
产品概述
核心能力与使用方式
核心能力与使用方式
你通常只需要描述目标。Agent 负责选择 Skill、收集必要参数并调用执行工具。volcengine-cli 调用 ve 原生 API 时,先检查安全策略:策略已启用且规则非空时,按 CLI 判定执行、等待确认或停止,不再叠加内置确认;策略关闭、规则为空或版本不支持时,使用 Skill 内置确认。策略读取或格式异常时停止调用。产品代理命令和其他专业 Skill 按各自规则执行;需要确认时,Agent 会先展示目标、参数和影响。
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”时,应先确认运行位置、目标产品和使用方式,不按名称相似直接替换。
- 描述目标及要操作的项目或资源;存在歧义时先确认目标。
- 检查当前会话可用的 Skills。Volcengine Catalog 内的能力由 Finder 查找;Ark 能力按模型与智能体管理获取。
- 检查实际执行工具、版本与认证。缺少依赖时说明安装来源和影响,得到授权后准备;文件已安装但未加载时重新加载或新建对话。
- 按对应 Skill 与工具规则确认操作范围,通过 CLI、OpenAPI、SDK 或 Terraform 执行。
- 检查业务返回及最终结果。创建资源、会话可用和任务回答正确分别验证,未完成项明确说明。
CLI 适合终端、自动化脚本或能执行命令的 Agent;MCP 适合通过协议连接工具的 Agent。ve mcp 提供文档检索、服务与 API 发现、参数查询及受权限约束的 API 调用,但不代表全部产品 CLI 命令。
安装 Plugin、安装 CLI、配置 MCP 和取得云权限是不同操作。ve mcp 在本地进程中运行,使用 stdio 或客户端支持的 HTTP 传输,不是官方托管端点。查看CLI 使用与通过 MCP 接入 Agent。
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