技能是可重複使用的自訂指令,能協助 Gemini Enterprise 助理執行特定工作,例如審查法律合約或以品牌語氣撰寫內容。
每項技能都是一個套件,內含 SKILL.md 提示檔案。技能套件也可能包含指令碼、檔案或背景資訊,供助理用來完成工作。根據預設,Gemini Enterprise 會啟用您建立的技能。
支援版本
能否建立、上傳或使用技能,取決於您訂閱的 Gemini Enterprise 版本:
- Standard、Plus 和即付即用:可以建立及上傳自訂技能,以及使用 Google 代管技能和他人分享的使用者建立技能。
- Frontline:可以瀏覽、安裝及使用 Google 代管技能,以及他人建立並與您共用的技能。無法建立或上傳自訂技能。
總覽
技能的主要面向包括:
- 開放標準:以開放技能標準為基礎,每項技能都由核心
SKILL.md檔案定義,並可透過其他檔案或指令碼擴充。 - 模組化擴充:技能可讓您使用自訂指令和背景資訊,教導代理執行特定領域的工作。
- 動態存取:Gemini Enterprise 會在問題或任務與這些專門指令相關時,自動存取這些指令。
建立技能
如要在 Gemini Enterprise 網頁應用程式中建立新技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 按一下「新增」圖示,然後點選「使用 Gemini 建立技能」。
- 輸入技能名稱。
- 輸入說明。Gemini Enterprise 會根據說明,判斷技能是否能協助處理提示或工作。您也可以在說明中加入觸發條件指示,引導 Gemini Enterprise。
- 在對話方塊或「Instructions」(指令) 欄位中,使用自然語言提供技能指令。如要使用現有的
SKILL.md檔案 (含自訂 Markdown 或 YAML front matter) 建立技能,請參閱「上傳技能」。 - 按一下 [儲存]。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 層。
- 路徑完整性:不得使用重複的檔案路徑和上層目錄參照 (
..)。
將技能上傳至網頁應用程式
如要上傳技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 按一下「新增」圖示,然後點選「上傳技能」。
- 拖曳或瀏覽 Markdown 或 ZIP 檔案,然後按一下「匯入」。 Gemini Enterprise 預設會啟用這項技能。
瀏覽技能
您可以使用下列各節篩選清單,瀏覽及安裝技能:
| 區段 | 說明 |
|---|---|
| 全部 | Google 代管技能和使用者建立的技能。 |
| Google 提供的內建技能。 | |
| 與我共用 | 其他使用者與您共用的唯讀技能 (由使用者建立)。 |
如要瀏覽及安裝技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 按一下「新增」圖示,然後點選「瀏覽技能」。
- 找到要使用的技能,然後按一下「+ 安裝」。
更新技能
如要更新現有技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 按一下要更新的技能名稱。
- 按一下技能旁邊的 more_vert 圖示,然後點選「Edit」(編輯)。
- 視需要更新指令、名稱或說明。
- 按一下 [儲存]。
如要返回「技能」頁面,請按一下 arrow_back「技能」。
分享技能
如果 Gemini Enterprise 管理員啟用技能共用功能,您就能與其他使用者分享自己建立的技能。
如要分享技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 找出要分享的自創技能。
- 按一下技能旁的 more_vert 圖示,然後點選「分享」。
- 在「Share skill」(共用技能) 對話方塊中,輸入要共用技能的使用者電子郵件地址,並以半形逗號分隔。
- 按一下「完成」。
使用技能
在 Gemini Enterprise 網頁應用程式中,您可以直接在對話中使用技能。
在「技能」頁面測試技能
您可以直接在「Skills」(技能) 頁面測試技能,方法是使用該技能發起新的對話工作階段:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 按一下技能旁的 more_vert 圖示,然後點選「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 就不會在對話中叫用該技能。
如要關閉技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 在「技能」頁面,找到要關閉的技能。
- 將技能旁的切換鈕設為「關閉」。
解除安裝技能
如要從「Skills」(技能) 頁面移除已安裝的技能,請按照下列步驟操作:
- 登入 Gemini Enterprise 網頁應用程式。
- 按一下導覽選單中的「技能」。
- 按一下技能旁邊的 more_vert 圖示,然後點選「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 層目錄巢狀結構。
後續步驟
- 瞭解管理員如何管理技能。