如何為 Gemini CLI 建立代理程式技能

1. 簡介

在本實驗室中，您將瞭解如何建立代理程式技能，讓大型語言模型存取專屬知識和工作流程。您將建立本機技能，並透過 Gemini CLI 存取。

學習內容

  • 為喜愛的事物建立專屬的 Agent Skills。
  • 使用 Gemini CLI 查詢技能。
  • 安裝 Firebase 官方代理程式技能，並使用這些技能建構及部署應用程式。

課程內容

  • 如何建構技能。
  • 如何編寫 SKILL.md 檔案。
  • 如何透過 Gemini CLI 使用本機技能。

2. 專案設定

  1. 如果沒有 Google 帳戶，請先建立帳戶。
    • 請改用個人帳戶，而非公司或學校帳戶。公司和學校帳戶可能設有限制，導致您無法啟用本實驗室所需的 API。
  2. 登入 Google Cloud 控制台。
  3. 在 Cloud 控制台中啟用帳單。
    • 完成本實驗室的 Cloud 資源費用應不到 $1 美元。
    • 您可以按照本實驗室結尾的步驟刪除資源，以免產生後續費用。
    • 新使用者可享有價值 $300 美元的免費試用期。
  4. 建立新專案，或選擇重複使用現有專案。
    • 如果看到專案配額相關錯誤，請重複使用現有專案，或刪除現有專案來建立新專案。

3. 開啟 Cloud Shell 編輯器

  1. 按一下這個連結，直接前往 Cloud Shell 編輯器
  2. 如果系統在今天任何時間提示您授權，請點選「授權」繼續操作。按一下即可授權 Cloud Shell
  3. 如果畫面底部未顯示終端機，請開啟終端機：
    • 按一下「查看」
    • 按一下「終端機」在 Cloud Shell 編輯器中開啟新終端機
  4. 在終端機中，使用下列指令設定專案：
    • 格式：
      gcloud config set project [PROJECT_ID]
    • 範例：
      gcloud config set project lab-project-id-example
    • 如果忘記專案 ID，請按照下列步驟操作：
      • 您可以使用下列指令列出所有專案 ID：
        gcloud projects list | awk '/PROJECT_ID/{print $2}'
      在 Cloud Shell 編輯器終端機中設定專案 ID
  5. 您應該會看到下列訊息：
    Updated property [core/project].
    如果看到 WARNING 並收到 Do you want to continue (Y/n)? 提示，表示您可能輸入了錯誤的專案 ID。按下 n 和 Enter，然後再次嘗試執行 gcloud config set project 指令。

4. 建立「喜愛的事物」技能

代理程式技能是目錄，至少包含一個 SKILL.md 檔案，可為 AI 代理程式提供指令和知識。在本節中，您將建立技能，讓 Gemini CLI 瞭解您喜歡的事物。

  1. 建立目錄來儲存技能：
    mkdir -p ~/.gemini/skills/my-favorite-things
  2. 為技能建立及開啟新的 SKILL.md 檔案：
    cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
    cloudshell edit 指令會在終端機上方的編輯器中開啟 SKILL.md 檔案。
  3. 將下列內容新增至 SKILL.md 檔案：
    ---
name: my-favorite-things
description: Information about my favorite things. Use this skill to answer questions about my favorite color, food, or programming language.
---

My favorite color is blue.
My favorite food is pizza.
My favorite programming language is Python.

If asked about one of my favorite things, please respond with the information provided above.

您只使用 SKILL.md 檔案，就建立第一個技能！現在可以在 Gemini CLI 中使用這項技能。

5. 透過 Gemini CLI 使用技能

您已成功建立技能，現在可以使用 Gemini CLI。Gemini CLI 會自動探索 ~/.gemini/skills 中的技能。

  1. 在 Cloud Shell 中啟動 Gemini CLI
    gemini
    您可能需要按下 Enter 來接受部分預設設定。
  2. 讓 Gemini 列出在目前環境中可用的技能
    /skills
    可用技能清單中應該會顯示「my-favorite-things」。
  3. 詢問 Gemini 最喜歡的顏色：
    What is my favorite color?
    Gemini CLI 應使用 my-favorite-things 技能回答問題。如果系統提示，請允許 Gemini CLI 使用技能。

輸出內容應顯示 Gemini CLI 使用了你的技能，並回覆「Blue」。

你做到了！您已成功建立技能，並使用 Gemini CLI 進行測試。

如要結束工作階段，請輸入 /quit，然後按下 Enter 退出 Gemini CLI。

6. 安裝 Firebase 專用 Agent Skills

除了自行建立技能，你也可以安裝他人建立的技能。Firebase 專用代理程式技能 (GitHub) 是可攜式獨立模組，內含 Firebase 專屬知識、操作說明和工作流程。這些函式可協助 AI 助理瞭解 Firebase 最佳做法，並以更高的準確度和較低的權杖成本執行複雜工作。

您可以在終端機中使用 skills CLI，安裝所有 Firebase 專用的 Agent Skills：

npx skills add firebase/agent-skills

這項指令會下載並安裝 firebase-basics、firebase-auth-basics、firebase-firestore-basics 和 firebase-app-hosting-basics 等技能，讓您可以在 Gemini CLI 中使用這些技能，以及 my-favorite-things 技能。

如要進一步瞭解 Firebase 適用的 Agent Skills，請參閱「可用技能」。

7. 探索 Firebase 的代理程式技能

Firebase 適用的 Agent Skills 現已安裝完成，可在 Gemini CLI 中使用。執行 Gemini CLI 並輸入 /skills firebase，即可查看這些模型：

gemini

然後在 Gemini CLI 中：

/skills firebase

您會看到已安裝的 Firebase 技能清單，例如 firebase-basics、firebase-auth-basics、firebase-firestore-basics 和 firebase-app-hosting-basics。

8. (選用) 使用 Firebase 專用的代理程式技能建立及部署應用程式

現在請使用已安裝的 Firebase 專用 Agent Skills，建立「待辦事項」網路應用程式，並加入使用者驗證和資料庫，然後部署至 Firebase App Hosting。

  1. 如果仍在使用 Gemini CLI，請輸入 /quit 退出。
  2. 為專案建立新目錄，然後前往該目錄：
    mkdir todo-app && cd todo-app
  3. 使用 Google 帳戶登入 Firebase。如果您在 Cloud Shell 或其他沒有瀏覽器的環境中，請使用 --no-localhost 旗標。
    firebase login --no-localhost
    按照操作說明授權 Firebase CLI。
  4. 啟動 Gemini CLI：
    gemini
  5. 現在，請 Gemini 生成應用程式程式碼：
    Generate HTML, CSS, and Javascript for a single page  application. It should use Google Sign-in with Firebase Authentication, and save tasks in Cloud Firestore for the signed-in user. A user should be able to add new tasks and see a list of their tasks.
    Gemini 可能會要求建立 index.html、style.css 和 script.js 等檔案。允許這麼做。
  6. 最後，將應用程式部署至 Firebase App Hosting：
    /firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
    按照提示設定 App Hosting，並完成部署。部署完成後，您應該會收到應用程式的網址！

9. 結語

恭喜！您已成功建立技能，並瞭解如何為 Gemini CLI 安裝其他技能。

(選用) 清除

如要清理，可以刪除 Cloud 專案，以免產生額外費用。

如要刪除專案，請按照下列步驟操作：

gcloud projects delete $GOOGLE_CLOUD_PROJECT

您也可以從 Cloud Shell 磁碟刪除不必要的資源。您可以：

  1. 刪除技能目錄：
    rm -rf ~/.gemini/skills/my-favorite-things
  2. 警告！這項操作無法復原，如要刪除 Cloud Shell 中的所有內容來釋出空間，可以刪除整個主目錄。請務必將要保留的內容另存他處。
    sudo rm -rf $HOME