技能是可重复使用的自定义指令，可帮助 Gemini Enterprise 助理执行特定任务，例如审核法律合同或以您的品牌风格撰写内容。
每项技能都是一个包含 SKILL.md 提示文件的软件包。技能包还可以包含助理用于完成任务的脚本、文件或背景信息。默认情况下，Gemini Enterprise 会启用您创建的技能。
支持的版本
能否创建、上传或使用技能取决于您订阅的 Gemini Enterprise 版本：
- 标准版、Plus 版和随用随付版：您可以创建和上传自定义 skill，以及使用 Google 管理的 skill 和与您共享的用户创建的 skill。
- 一线员工版：您可以浏览、安装和使用 Google 管理的 skill 以及与您分享的用户创建的 skill。您无法创建或上传自定义技能。
概览
技能的主要方面包括：
- 开放标准：基于开放技能标准构建，每项技能都由一个核心
SKILL.md文件定义，并可通过其他文件或脚本进行扩展。 - 模块化扩展：技能可让您使用自定义指令和上下文，教智能体执行特定领域的任务。
- 动态访问：当这些专用指令与您的问题或任务相关时，Gemini Enterprise 会自动访问这些指令。
创建 skill
如需在 Gemini Enterprise Web 应用中创建新技能，请按以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 点击添加图标，然后点击使用 Gemini 创建 skill。
- 输入技能名称。
- 输入说明。Gemini Enterprise 会根据说明来确定技能是否可以帮助完成提示或任务。您还可以在说明中添加触发器指令，以帮助指导 Gemini Enterprise。
- 在对话框或指令字段中使用自然语言提供技能指令。如需使用包含自定义 Markdown 或 YAML front matter 的现有
SKILL.md文件创建 skill，请参阅上传 skill。 - 点击保存。Gemini Enterprise 会默认启用新技能。
上传技能
如需添加现有技能，请以 Markdown 或 ZIP 文件格式上传。
Gemini Enterprise 会自动从 SKILL.md 文件中提取技能名称和说明。
技能文件格式和目录结构
技能包由必需的 SKILL.md 提示文件以及可选的脚本、参考文档和资源子目录组成。您可以上传独立的 SKILL.md 文件，也可以上传具有以下目录结构的 ZIP 归档文件：
my-skill/
├── SKILL.md # Required: YAML frontmatter + Markdown instructions
├── scripts/ # Optional: executable helper scripts (Python, Bash)
├── references/ # Optional: supplementary context loaded as needed
└── assets/ # Optional: templates or images used in output
| 文件或目录 | 必填 | 说明 |
|---|---|---|
SKILL.md |
是 | 包含技能的 YAML 前置元数据（例如 name 和 description），后跟用于指导 Gemini Enterprise 助理的 Markdown 指令。 |
scripts/ |
否 | 用于确定性或重复操作的可执行 Python 或 Bash 辅助脚本。 |
references/ |
否 | 按需加载的补充上下文，例如架构、速查表或 API 参考文档。 |
assets/ |
否 | 输出中使用的文件（例如模板或图片），这些文件不会直接加载到 Gemini Enterprise 的提示上下文中。 |
YAML 前置元数据要求
SKILL.md 文件必须以有效的 YAML 前置元数据块开头，该元数据块位于文件最开头的 --- 定界符之间，后跟 Markdown 指令正文（硬性限制为 500,000 个字符；超出此限制的上传会失败）。
YAML frontmatter 支持以下字段：
| 字段 | 必填 | 格式和限制条件 |
|---|---|---|
name |
是 | 技能的唯一标识符（1 到 64 个字符）。只能包含小写字母 (a-z)、数字 (0-9) 和连字符 (-)。不得以连字符 (-) 开头或结尾，也不得包含连续的连字符 (--)。如果在文件夹内上传，name 值必须与父文件夹名称一致。 |
description |
是 | 功能说明（1 到 1,024 个字符），用于解释技能的功能以及 Gemini Enterprise 应在何时调用该技能。添加触发关键字，帮助 Gemini Enterprise 识别技能何时适用。这是一个硬性限制；如果说明超过 1,024 个字符，技能上传将失败，并显示以下错误：A field in your SKILL.md is too long. Shorten the name, description or the instructions. |
license |
否 | 适用于技能包的软件或内容分发许可（最多 1,024 个字符），例如开源 SPDX 许可标识符（例如 Apache-2.0 或 MIT）或 Proprietary。此字段指定的是技能文件本身的使用条款，而不是 Gemini Enterprise 企业用户或应用订阅许可。如果指定，则值不得为空。 |
metadata |
否 | 自定义标记、作者或版本参数的可选键值对映射。键必须是标量字符串，值必须是标量字符串或标量字符串列表。 |
SKILL.md 文件示例
以下示例展示了一个有效的 SKILL.md 文件：
--- name: brand-voice-reviewer description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text. --- # Brand Voice Reviewer Follow these guidelines when reviewing or drafting customer-facing text: 1. Use clear, concise, and active language. 2. Avoid jargon and unverified claims. 3. Verify that terminology aligns with the company style guide.
ZIP 归档文件限制
以 ZIP 归档文件形式上传技能时，请确保归档文件符合以下验证要求：
- 单个
SKILL.md文件：每个 ZIP 归档文件必须只包含一个SKILL.md文件，该文件位于归档根目录 (SKILL.md) 或单个顶级封装容器文件夹（最多 3 层，例如my-skill/SKILL.md）中。 - 归档文件大小：ZIP 归档文件的压缩后大小上限为 100 MB，解压后总大小上限为 100 MB。
- 文件数量：每个 ZIP 归档文件最多包含 100 个文件。
- 目录嵌套深度：相对于技能根目录，目录嵌套深度上限为 10 层。
- 路径完整性：不允许使用重复的文件路径和父级目录引用 (
..)。
将技能上传到 Web 应用
如需上传技能，请按照以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 点击添加图标，然后点击上传技能。
- 拖动或浏览 Markdown 或 ZIP 文件，然后点击导入。 Gemini Enterprise 会默认启用该技能。
浏览技能
您可以使用以下部分过滤列表，浏览并安装技能：
| 部分 | 说明 |
|---|---|
| 全部 | Google 管理的 skill 和用户创建的 skill。 |
| Google 提供的内置技能。 | |
| 与我共享 | 其他用户与您共享的只读、用户创建的技能。 |
如需浏览和安装技能，请按以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 点击添加图标，然后点击浏览技能。
- 找到要使用的技能，然后点击 + 安装。
更新技能
如需更新现有技能，请按以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 点击要更新的技能的名称。
- 点击技能旁边的 more_vert 图标，然后点击修改。
- 对指令、名称或说明进行必要的更新。
- 点击保存。
如需返回“技能”页面，请点击 arrow_back 技能。
分享技能
如果 Gemini Enterprise 管理员启用了技能共享功能，您就可以与其他用户共享您创建的技能。
如需分享技能，请按以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 找到您创建并想要分享的技能。
- 点击技能旁边的 more_vert 图标，然后点击分享。
- 在共享技能对话框中，输入要与之共享技能的用户的电子邮件地址（以逗号分隔）。
- 点击完成。
使用技能
你可以在 Gemini Enterprise Web 应用中直接在对话中使用技能。
在“技能”页面中测试技能
你可以直接在技能页面上测试技能，方法是使用该技能发起新的对话会话：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 点击技能旁边的 more_vert 图标，然后点击发起新对话。 Gemini Enterprise 会打开一个新对话，并引用所选技能。
在对话中调用技能
您可以在对话期间动态调用技能，以定制助理的回答。
与 Gemini Enterprise 助理对话时，您可以通过以下方式使用技能：
- 手动提及：您可以在对话框中使用
@或/提及功能明确调用技能（例如@Brand Voice或/Brand Voice）。输入/会打开一个仅显示可用技能的菜单，而输入@会打开常规提及菜单。 - 直接请求：如果您需要 Gemini Enterprise 使用特定技能，可以直接在提示中提出要求。例如
Use the brand voice skill to review this。 - 自动选择：Gemini Enterprise 会根据技能的说明和触发指令，在技能与任务相关时自动使用该技能。
关闭技能
如要阻止 Gemini Enterprise 使用特定技能，请将其关闭。关闭某项技能后，Gemini Enterprise 便不会在对话中调用该技能。
如需关闭某项技能，请按以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 在技能页面上，找到要关闭的技能。
- 将相应技能旁边的切换开关切换到关闭位置。
卸载技能
如需从技能页面中移除已安装的技能，请按照以下步骤操作：
- 登录 Gemini Enterprise Web 应用。
- 在导航菜单中，点击技能。
- 点击技能旁边的 more_vert 图标，然后点击卸载。
技能状态
除了自行启用或停用技能之外，管理员还可以更改技能的状态，这会影响技能的可用性：
- 已暂停：管理员暂时停用了该技能。它仍会显示在技能页面上，但处于暂停状态，其他用户无法在对话中调用它，直到管理员重新启用它。技能所有者可以更新和测试技能。
- 已停用：管理员会暂时向其他用户隐藏该技能，并将其从技能页面中移除。技能所有者仍然可以看到该技能，并且可以对其进行更新和测试，直到管理员重新启用该技能。
- 已删除：管理员已从 Gemini Enterprise Web 应用中永久移除该技能，因此您无法再使用该技能。
限制
本部分列出了 Gemini Enterprise 中技能的限制：
- 技能无法与代理搭配使用。
- 技能仅支持 Python 和 Bash 执行。
- 借助 Web 应用编辑器，您可以通过在表单字段中输入指令或与助理聊天来创建技能，系统会自动生成一个
SKILL.md文件。对于需要额外脚本或文件的更复杂 skill，您必须以 ZIP 文件形式上传。 - 自然语言技能创建功能不会使用对话上下文或连接器作为输入来创建技能。
- 当技能只有一个
SKILL.md文件时，技能与 Canvas 的搭配效果最佳。 SKILL.md文件有严格的长度限制：name为 64 个字符，description为 1,024 个字符，Markdown 指令正文为 500,000 个字符。上传的 ZIP 归档文件不能超过 100 MB（压缩或未压缩）、100 个文件或 10 级目录嵌套。
后续步骤
- 了解管理员如何管理技能。