# 产品概述 Volcengine Skills（火山引擎 Skills）是一组面向 Agent 的火山引擎官方任务能力，帮助 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、OpenCla、豆包工作等 Agent 理解并使用火山引擎云能力。安装相应 Skill 后，你可以直接向 Agent 描述目标。Agent 会根据任务收集必要参数，并通过 ve、产品专用 CLI、OpenAPI、SDK 或 Terraform 查询和管理云资源、分析和部署应用，以及诊断调用和运行问题。 ## 你可以完成什么 * 查询火山引擎产品文档、API 参数、错误码和 SDK 示例。 * 查询、创建和管理 ECS、VPC、RDS、Redis 等云资源。 * 分析代码仓库，并在 ECS、VKE 和 veFaaS 之间选择部署方式。 * 生成部署计划，在确认后完成资源准备、应用发布和结果验证。 * 根据 ErrorCode、RequestId、权限、配额和资源状态诊断失败原因。 * 按任务发现并安装对象存储、数据库、IaC、合规和 Landing Zone 等能力。 ## 为什么需要 Skills 通用 AI Agent 可以生成云 API 或 CLI 命令，但模型知识可能没有覆盖最新产品能力，也不一定了解具体账号、地域、权限、参数约束和多步骤操作顺序。 Volcengine Skills 为 Agent 补充官方信息来源、任务判断规则、操作步骤、安全确认要求和结果验证方式，降低因依赖模型记忆而生成错误命令或遗漏关键步骤的风险。 ## 工作方式 1. 你使用自然语言描述目标。 2. Agent 根据任务发现并加载相应 Skill。 3. Skill 指导 Agent 查询官方信息、收集参数并判断操作风险。 4. Agent 通过 CLI、OpenAPI、SDK 或 Terraform 执行确定性操作。 5. Agent 检查业务返回、RequestId 和资源最终状态，并解释结果和后续动作。 ## 核心概念与职责 |**概念** |**作用** |**使用方式** | |---|---|---| |Skill |提供任务识别、步骤、参数约束、安全检查和结果解释 |Agent 根据任务加载相关 Skill，并按需读取脚本和参考资料 | |Plugin |面向部分 Agent 的 Skills 打包和分发单元，不是独立能力 |Claude Code、Codex、Cursor 等按各自的 Plugin 机制安装 | |Catalog |记录当前可安装的官方 Skills 及其所属产品域 |用于浏览能力，或由 Finder 读取后选择所需 Skill | |Finder |发现并安装当前任务缺少的 Skill |读取 Catalog，选择最小必要集合，并验证安装结果 | |执行工具 |完成确定性的云资源查询和变更 |包括 ve、产品专用 CLI、OpenAPI、SDK 和 Terraform | |Telemetry |记录低敏的 Skill 加载归因事件 |用于了解 Skill 是否被 Agent 加载，不判断任务完成和结果质量 | ## 能力组织方式 * 四个核心 Skills 默认提供通用云资源操作、故障诊断、官方文档检索和能力发现。 * 存储、数据库、部署、IaC、合规和 Landing Zone 等能力按任务安装。 * Agent 根据宿主机制和任务需要发现并加载相关 Skill，避免将全部 Skill 正文同时加入上下文。 ## 能力边界 * Skills 不替代云产品，也不重新定义 OpenAPI、CLI 或 SDK。 * CLI 命令和参数以对应工具的实时帮助和官方 API 规格为准。 * Volcengine Skills 暂不提供独立的统一 MCP（Model Context Protocol）Server；veFaaS Skill 中的 MCP 部署说明只用于对应部署场景。 * 实际可用能力以 Skills Catalog 和安装结果为准。 * 创建、修改和删除资源仍受当前火山引擎账号权限约束。 ## 开始使用 * [安装与配置](https://docs.volcengine.com/docs/88782/2657127) * [快速开始](https://docs.volcengine.com/docs/88782/2657128) * [Skills 与能力目录](https://docs.volcengine.com/docs/88782/2657129)