建立及管理技能

技能是可重複使用的自訂指令,能協助 Gemini Enterprise 助理執行特定工作,例如審查法律合約或以品牌語氣撰寫內容。

每項技能都是一個套件,內含 SKILL.md 提示檔案。技能套件也可能包含指令碼、檔案或背景資訊,供助理用來完成工作。根據預設,Gemini Enterprise 會啟用您建立的技能。

支援版本

能否建立、上傳或使用技能,取決於您訂閱的 Gemini Enterprise 版本:

  • Standard、Plus 和即付即用:可以建立及上傳自訂技能,以及使用 Google 代管技能和他人分享的使用者建立技能。
  • Frontline:可以瀏覽、安裝及使用 Google 代管技能,以及他人建立並與您共用的技能。無法建立或上傳自訂技能。

總覽

技能的主要面向包括:

  • 開放標準:以開放技能標準為基礎,每項技能都由核心 SKILL.md 檔案定義,並可透過其他檔案或指令碼擴充。
  • 模組化擴充:技能可讓您使用自訂指令和背景資訊,教導代理執行特定領域的工作。
  • 動態存取:Gemini Enterprise 會在問題或任務與這些專門指令相關時,自動存取這些指令。

建立技能

如要在 Gemini Enterprise 網頁應用程式中建立新技能,請按照下列步驟操作:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 按一下「新增」圖示,然後點選「使用 Gemini 建立技能」。
  4. 輸入技能名稱。
  5. 輸入說明。Gemini Enterprise 會根據說明,判斷技能是否能協助處理提示或工作。您也可以在說明中加入觸發條件指示,引導 Gemini Enterprise。
  6. 在對話方塊或「Instructions」(指令) 欄位中,使用自然語言提供技能指令。如要使用現有的 SKILL.md 檔案 (含自訂 Markdown 或 YAML front matter) 建立技能,請參閱「上傳技能」。
  7. 按一下 [儲存]。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 frontmatter 中繼資料 (例如 name 和 description),後面接著引導 Gemini Enterprise 助理的 Markdown 指令。
scripts/ 否 可執行的 Python 或 Bash 輔助指令碼,用於確定性或重複作業。
references/ 否 視需要載入補充背景資訊,例如結構定義、速查表或 API 參考文件。
assets/ 否 輸出內容中使用的檔案 (例如範本或圖片),但未直接載入 Gemini Enterprise 的提示詞脈絡。

YAML frontmatter 規定

SKILL.md 檔案開頭必須是有效的 YAML frontmatter 區塊,並以 --- 分隔符號括住,後面接著 Markdown 指令主體 (硬性限制為 500,000 個字元,超過此限制的上傳作業會失敗)。

YAML frontmatter 支援下列欄位:

欄位 必填 格式和限制
name 是 技能的專屬 ID (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 授權 ID (例如 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 層。
  • 路徑完整性:不得使用重複的檔案路徑和上層目錄參照 (..)。

將技能上傳至網頁應用程式

如要上傳技能,請按照下列步驟操作:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 按一下「新增」圖示,然後點選「上傳技能」。
  4. 拖曳或瀏覽 Markdown 或 ZIP 檔案,然後按一下「匯入」。 Gemini Enterprise 預設會啟用這項技能。

瀏覽技能

您可以使用下列各節篩選清單,瀏覽及安裝技能:

區段 說明
全部 Google 代管技能和使用者建立的技能。
Google Google 提供的內建技能。
與我共用 其他使用者與您共用的唯讀技能 (由使用者建立)。

如要瀏覽及安裝技能,請按照下列步驟操作:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 按一下「新增」圖示,然後點選「瀏覽技能」。
  4. 找到要使用的技能,然後按一下「+ 安裝」。

更新技能

如要更新現有技能,請按照下列步驟操作:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 按一下要更新的技能名稱。
  4. 按一下技能旁邊的 圖示,然後點選「Edit」(編輯)。
  5. 視需要更新指令、名稱或說明。
  6. 按一下 [儲存]。

如要返回「技能」頁面,請按一下 「技能」。

分享技能

如果 Gemini Enterprise 管理員啟用技能共用功能,您就能與其他使用者分享自己建立的技能。

如要分享技能,請按照下列步驟操作:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 找出要分享的自創技能。
  4. 按一下技能旁的 圖示,然後點選「分享」。
  5. 在「Share skill」(共用技能) 對話方塊中,輸入要共用技能的使用者電子郵件地址,並以半形逗號分隔。
  6. 按一下「完成」。

使用技能

在 Gemini Enterprise 網頁應用程式中,您可以直接在對話中使用技能。

在「技能」頁面測試技能

您可以直接在「Skills」(技能) 頁面測試技能,方法是使用該技能發起新的對話工作階段:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 按一下技能旁的 圖示,然後點選「New chat」(新增對話)。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 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 在「技能」頁面,找到要關閉的技能。
  4. 將技能旁的切換鈕設為「關閉」。

解除安裝技能

如要從「Skills」(技能) 頁面移除已安裝的技能,請按照下列步驟操作:

  1. 登入 Gemini Enterprise 網頁應用程式。
  2. 按一下導覽選單中的「技能」。
  3. 按一下技能旁邊的 圖示,然後點選「Uninstall」(解除安裝)。

技能狀態

除了自行啟用或停用技能外,管理員也可以變更技能狀態,進而影響技能的可用性:

  • 已停權:管理員暫時停用技能。該技能仍會顯示在「Skills」(技能) 頁面上,但狀態為停用,其他使用者無法在對話中叫用該技能,直到管理員重新啟用為止。技能擁有者可以更新及測試技能。
  • 已停用:管理員會暫時對其他使用者隱藏這項技能,並從「技能」頁面中移除。技能擁有者仍可查看技能,並在管理員重新啟用前更新及測試技能。
  • 已刪除:管理員已從 Gemini Enterprise 網頁應用程式永久移除該技能,因此您無法再使用。

限制

本節列出 Gemini Enterprise 技能的限制:

  • 代理無法使用技能。
  • 技能僅支援 Python 和 Bash 執行。
  • 在網頁應用程式編輯器中,你可以透過在表單欄位輸入指令,或與助理對話來建立技能,系統會自動生成單一 SKILL.md 檔案。如果技能較複雜,需要額外的指令碼或檔案,請以 ZIP 檔案格式上傳。
  • 建立自然語言技能時,不會使用對話內容或連接器做為輸入內容。
  • 如果技能只有一個 SKILL.md 檔案,與 Canvas 搭配使用的效果最佳。
  • SKILL.md 檔案有硬性長度限制:name 為 64 個字元、description 為 1,024 個字元,Markdown 指示內文則為 500,000 個字元。上傳的 ZIP 封存檔不得超過 100 MB (壓縮或未壓縮)、100 個檔案或 10 層目錄巢狀結構。

後續步驟