Как создать навыки агента для Gemini CLI

1. Введение

В этой лабораторной работе вы научитесь создавать навыки агентов , предоставляющие студентам магистратуры доступ к специализированным знаниям и рабочим процессам. Вы создадите локальный навык, доступный через интерфейс командной строки Gemini.

Что вы будете делать

  • Создавайте собственные навыки агента для ваших любимых вещей.
  • Используйте Gemini CLI для запроса информации о вашем навыке.
  • Установите официальные Agent Skills для Firebase и используйте их для сборки и развертывания приложения.

Что вы узнаете

  • Как структурировать навык.
  • Как создать файл SKILL.md .
  • Как использовать локальные навыки с помощью Gemini CLI.

2. Настройка проекта

  1. Если у вас еще нет учетной записи Google, вам необходимо ее создать .
    • Используйте личный аккаунт вместо рабочего или учебного. Рабочие и учебные аккаунты могут иметь ограничения, которые не позволят вам включить API, необходимые для этой лабораторной работы.
  2. Войдите в консоль Google Cloud .
  3. Включите выставление счетов в облачной консоли.
    • Выполнение этой лабораторной работы должно обойтись менее чем в 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
    • Если вы не помните идентификатор своего проекта:
      • Вы можете вывести список всех идентификаторов ваших проектов с помощью: 
        gcloud projects list | awk '/PROJECT_ID/{print $2}'
      Установите идентификатор проекта в терминале редактора Cloud Shell.
  5. Вы должны увидеть следующее сообщение:
    Updated property [core/project].
    Если вы видите WARNING и вас спрашивают Do you want to continue (Y/n)? , то, скорее всего, вы неправильно ввели идентификатор проекта. Нажмите n , затем Enter и попробуйте снова выполнить команду gcloud config set project .

4. Создайте навык «Любимые вещи».

Папки Agent Skills содержат как минимум файл SKILL.md , который предоставляет инструкции и знания для ИИ-агента. В этом разделе вы создадите навык, который научит 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/skills автоматически обнаруживаются Gemini CLI.

  1. Запустите интерфейс командной строки Gemini в Cloud Shell.
    gemini
    Возможно, вам потребуется нажать Enter , чтобы принять некоторые настройки по умолчанию.
  2. Пусть Близнецы перечислят доступные им навыки в контексте их жизни.
    /skills
    В списке доступных навыков вы должны увидеть my-favorite-things .
  3. Спросите Близнецов о вашем любимом цвете:
    What is my favorite color?
    Интерфейс командной строки Gemini должен использовать навык my-favorite-things чтобы ответить на ваш вопрос. Если появится запрос, разрешите Gemini CLI использовать этот навык.

В результате должно отобразиться сообщение о том, что Gemini CLI использовал ваш навык и ответил словом «Blue».

У вас получилось! Вы успешно создали навык и протестировали его с помощью Gemini CLI.

Когда вы будете готовы завершить сессию, введите /quit и нажмите Enter , чтобы выйти из Gemini CLI.

6. Установите навыки агента для Firebase.

Помимо создания собственных навыков, вы можете устанавливать навыки, созданные другими пользователями. Agent Skills for Firebase (GitHub) — это портативные, самодостаточные модули, содержащие знания, инструкции и рабочие процессы, специфичные для Firebase. Они разработаны, чтобы помочь ИИ-помощникам понять лучшие практики Firebase и выполнять сложные задачи с большей точностью и меньшей стоимостью токенов.

Вы можете установить все навыки агента Firebase с помощью интерфейса командной строки (CLI) в терминале: 

npx skills add firebase/agent-skills

Эта команда загрузит и установит навыки, включая firebase-basics , firebase-auth-basics , firebase-firestore-basics и firebase-app-hosting-basics , сделав их доступными для использования в Gemini CLI вместе с вашим навыком my-favorite-things .

Чтобы узнать больше о навыках агентов для Firebase, см. раздел «Доступные навыки» .

7. Изучите навыки агентов Firebase.

Навыки агента Firebase теперь установлены и готовы к использованию в Gemini CLI. Вы можете увидеть их, запустив Gemini CLI и набрав команду /skills firebase : 

gemini

Затем в командной строке Gemini: 

/skills firebase

Вы увидите список установленных навыков Firebase, таких как firebase-basics , firebase-auth-basics , firebase-firestore-basics и firebase-app-hosting-basics .

8. (Необязательно) Используйте Agent Skills для Firebase, чтобы создать и развернуть приложение.

Теперь используйте установленные Agent Skills для Firebase, чтобы создать веб-приложение "Список дел" с аутентификацией пользователей и базой данных, и разверните его на Firebase App Hosting.

  1. Если вы все еще находитесь в Gemini CLI, введите /quit для выхода.
  2. Создайте новую директорию для своего проекта и перейдите в неё: 
    mkdir todo-app && cd todo-app
  3. Войдите в Firebase, используя свою учетную запись Google. Если вы находитесь в 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.
    Следуйте инструкциям, чтобы настроить размещение приложения и завершить развертывание. После развертывания вы получите URL-адрес для вашего работающего приложения!

9. Заключение

Поздравляем! Вы успешно создали навык и научились устанавливать дополнительные навыки для Gemini CLI.

(Необязательно) Уборка

Если вы хотите навести порядок, вы можете удалить свой облачный проект, чтобы избежать дополнительных расходов.

При желании вы можете удалить проект: 

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Также вы можете удалить ненужные ресурсы с диска Cloudshell. Для этого выполните следующие действия:

  1. Удалите каталог навыков: 
    rm -rf ~/.gemini/skills/my-favorite-things
  2. Внимание! Следующее действие необратимо! Если вы хотите удалить все данные в Cloud Shell, чтобы освободить место, вы можете удалить всю свою домашнюю директорию . Будьте внимательны и убедитесь, что все, что вы хотите сохранить, сохранено в другом месте. 
    sudo rm -rf $HOME