创建和管理技能

技能是可重复使用的自定义指令，可帮助 Gemini Enterprise 助理执行特定任务，例如审核法律合同或以品牌风格撰写内容。

注意：如需创建技能，您的管理员必须开启技能功能。 同样，如需共享技能，您的管理员还必须启用技能共享功能，他们可以将其配置为需要管理员审核或允许立即共享。如需了解详情，请参阅管理技能。

每项技能都是一个包含 SKILL.md 提示文件的软件包。技能包还可以包含助理用于完成任务的脚本、文件或背景信息。默认情况下，Gemini Enterprise 会启用您创建的技能。

支持的版本

能否创建、上传或使用技能取决于您订阅的 Gemini Enterprise 版本：

• 标准版、Plus 版和随用随付版：您可以创建和上传自定义 skill，并使用 Google 管理的 skill 以及与您共享的用户创建的 skill。
• 一线员工版：您可以浏览、安装和使用 Google 管理的 skill 以及与您分享的用户创建的 skill。您无法创建或上传自定义技能。

概览

技能的主要方面包括：

• 开放标准：基于开放技能标准构建，每项技能都由一个核心 SKILL.md 文件定义，并可通过其他文件或脚本进行扩展。
• 模块化扩展：通过技能，您可以使用自定义指令和上下文，让智能体学会执行特定领域的任务。
• 动态访问：当这些专用指令与您的问题或任务相关时，Gemini Enterprise 会自动访问这些指令。

创建技能

注意：您无法使用 Gemini Enterprise Frontline 版创建技能。如需了解详情，请参阅支持的版本。

如需在 Gemini Enterprise Web 应用中创建新技能，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 点击添加图标，然后点击使用 Gemini 创建 skill。
4. 输入技能名称。
5. 输入说明。Gemini Enterprise 会根据说明来判断该技能是否可以帮助完成提示或任务。您还可以在说明中添加触发指令，以帮助引导 Gemini Enterprise。
6. 在对话框或指令字段中使用自然语言提供技能指令。如需使用包含自定义 Markdown 或 YAML front matter 的现有 SKILL.md 文件创建 skill，请参阅上传 skill。
7. 点击保存。Gemini Enterprise 会默认启用新技能。

上传技能

注意：您无法通过 Gemini Enterprise Frontline 版上传 skill。如需了解详情，请参阅支持的版本。

如需添加现有技能，请以 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。此字段指定的是 skill 文件本身的使用条款，而不是 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 应用

如需上传技能，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 点击添加图标，然后点击上传技能。
4. 拖动或浏览 Markdown 或 ZIP 文件，然后点击导入。 Gemini Enterprise 默认会启用该技能。

注意：如果上传失败并出现 Upload failed. Details: Request contains an invalid argument 等错误，请验证以下内容：

• SKILL.md 文件以有效的 YAML 前置元数据开头，并用 --- 定界符括起来。
• 前置元数据包含必需的 name 和 description 字段，且字符数未超出限制。
• name 字段只能使用小写字母、数字和连字符（如果以 ZIP 归档文件形式上传，则与父文件夹名称匹配）。
• 您的归档文件符合 ZIP 归档文件限制。

浏览技能

您可以使用以下部分过滤列表，浏览和安装技能：

部分	说明
全部	Google 管理的 skill 和用户创建的 skill。
Google	Google 提供的内置技能。
与我共享	其他用户与您共享的只读、用户创建的技能。

如需浏览和安装技能，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 点击添加图标，然后点击浏览技能。
4. 找到您要使用的技能，然后点击 + 安装。

更新技能

如需更新现有技能，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 点击要更新的技能的名称。
4. 点击技能旁边的 图标，然后点击修改。
5. 对指令、名称或说明进行必要的更新。
6. 点击保存。

如需返回“Skill”页面，请点击 Skill。

查看和恢复技能版本

如果您拥有某项技能，则可以查看其版本记录、检查早期版本并恢复早期版本。

注意：只有技能的所有者才能查看和使用版本记录。在预览面板中，版本记录仅针对您拥有的技能显示。

恢复 skill 的早期版本后，对话会使用恢复的内容。您可以通过以下任一方式在对话中使用恢复的技能：

• 直接在对话输入字段中提及技能。
• 在技能页面上，选择技能，然后点击预览面板中的新对话。

如需查看技能的版本记录并恢复到早期版本，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击 Skill 以打开技能库。
3. 选择您拥有的技能，打开其预览面板。
4. 在预览面板中，点击 操作按钮，然后选择版本记录。版本记录面板会列出已保存的 skill 版本及其时间戳，并将有效版本标记为当前。
5. 如需查看较早的版本，请点击列表中的相应版本。该版本的指令和文件（例如 SKILL.md）会以只读模式打开。
6. 如需恢复您正在查看的版本，请点击恢复此版本，然后在要恢复此版本吗？对话框中，点击恢复。

恢复版本不会覆盖版本记录。而是，Gemini Enterprise 会复制所选版本的指令和文件，并将其保存为新版本，该版本会成为当前版本。例如，如果当前版本为 4，而您恢复了版本 3，Gemini Enterprise 会将版本 3 的内容保存为版本 5，而版本 3 和版本 4 在版本记录中保持不变。

共享 skill

如果 Gemini Enterprise 管理员启用了技能共享功能，您可以与其他用户共享您创建的技能。

注意：分享技能不会发送电子邮件通知。如需查找技能，接收者必须前往浏览技能中的与我共享部分。

如需分享技能，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 找到您创建并想要分享的技能。
4. 点击技能旁边的 图标，然后点击分享。
5. 在共享技能对话框中，输入要与之共享技能的用户的邮箱，以逗号分隔。
6. 点击完成。

注意：如果 Gemini Enterprise 管理员要求对共享请求进行审批，则在管理员批准请求之前，其他用户无法访问该技能。

使用技能

你可以在 Gemini Enterprise Web 应用中直接在对话中使用技能。

在“技能”页面中测试技能

您可以直接从 Skill 页面测试 skill，方法是使用该 skill 启动新的对话会话：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 选择相应技能以打开其预览面板，然后点击新对话。 Gemini Enterprise 会打开一个新对话，并引用所选技能。

在对话中调用技能

您可以在对话期间动态调用技能，以定制助理的回答。

注意：您可以动态使用技能和智能体，但不能在同一提示中同时调用智能体和技能。

与 Gemini Enterprise 助理对话时，您可以通过以下方式使用技能：

• 手动提及：您可以在对话框中使用 @ 或 / 提及功能（例如 @Brand Voice 或 /Brand Voice）明确调用技能。输入 / 会打开一个仅显示可用技能的菜单，而输入 @ 会打开常规提及菜单。
• 直接请求：如果您需要 Gemini Enterprise 使用特定技能，可以直接在提示中提出要求。例如 Use the brand voice skill to review this。
• 自动选择：Gemini Enterprise 会根据技能的说明和触发指令，在技能与任务相关时自动使用该技能。

关闭技能

如需阻止 Gemini Enterprise 使用特定技能，请将其关闭。关闭技能后，Gemini Enterprise 不会在对话中调用该技能。

如需关闭某项技能，请按以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 在技能页面上，找到要关闭的技能。
4. 将相应技能旁边的切换开关切换到关闭位置。

卸载技能

如需从技能页面中移除已安装的技能，请按照以下步骤操作：

1. 登录 Gemini Enterprise Web 应用。
2. 在导航菜单中，点击技能。
3. 点击技能旁边的 图标，然后点击卸载。

注意：关闭某项技能会暂停自动触发，但该技能仍会保留在技能页面上。卸载技能后，该技能会从技能页面中移除，但仍会显示在浏览技能页面中，供您重新安装。

技能状态

除了自行启用或停用技能之外，您的管理员还可以更改技能的状态，这会影响技能的可用性：

• 已暂停：管理员暂时停用了该技能。它仍会显示在技能页面上，但处于暂停状态，其他用户无法在对话中调用它，直到管理员重新启用它。Skill 所有者可以更新和测试 skill。
• 已停用：管理员会暂时向其他用户隐藏该技能，并将其从技能页面中移除。技能所有者仍可看到该技能，并可以对其进行更新和测试，直到管理员重新启用该技能。
• 已删除：管理员从 Gemini Enterprise Web 应用中永久移除该技能，因此您无法再使用该技能。

限制

本部分列出了 Gemini Enterprise 中技能的限制：

• 技能无法与智能体搭配使用。
• 技能仅支持 Python 和 Bash 执行。
• 借助 Web 应用编辑器，您可以通过在表单字段中输入指令或与助理聊天来创建 skill，系统会自动生成一个 SKILL.md 文件。对于需要额外脚本或文件的更复杂 skill，您必须以 ZIP 文件形式上传。
• 自然语言技能创建功能不会使用对话上下文或连接器作为输入来创建技能。
• 当技能只有一个 SKILL.md 文件时，技能与 Canvas 的搭配效果最佳。
• SKILL.md 文件有严格的长度限制：name 为 64 个字符，description 为 1,024 个字符，Markdown 指令正文为 500,000 个字符。上传的 ZIP 归档文件不能超过 100 MB（压缩或未压缩）、100 个文件或 10 级目录嵌套。
• 只有技能的所有者才能查看和使用其版本记录。对于其他用户创建的 skill 或 Google 管理的 skill，版本记录不可用。

后续步骤

• 了解管理员如何管理技能。