Расширение кода Genie с помощью навыков агента

Genie Code поставляется со встроенными навыками для распространенных рабочих процессов Azure Databricks: написание кода в записных книжках, изучение данных в каталоге Unity, создание панелей мониторинга, создание конвейеров и работа с MLflow. Создайте пользовательские навыки, чтобы расширить Genie Code с помощью специализированных функций для задач в предметной области вашей команды. На этой странице объясняется, как создавать и оптимизировать их.

Что такое навыки?

Создание навыков для расширения Кода Genie с помощью специализированных возможностей. Навыки соответствуют открытому стандарту навыков агента. Пакет навыков, содержащий специфические знания и рабочие процессы, которые "код Genie" может загружать по мере необходимости для выполнения конкретных задач. Навыки могут включать рекомендации, лучшие практики, повторно используемый код и исполняемые скрипты.

Навыки должны быть адаптированы для задач, относящихся к домену. С помощью навыков можно предоставить более широкий контекст (например, скрипты, примеры и другие ресурсы) для задачи, чем можно с инструкциями. В отличие от пользовательских инструкций, которые применяются глобально, навыки загружаются автоматически и только в соответствующем контексте. Genie Code автоматически загружает навыки в зависимости от вашего запроса и описания навыка. Вы также можете вручную вызывать навыки, @ упоминая их. Это поддерживает эффективное окно контекста и сокращает необходимость предоставления одного контекста в нескольких чатах.

Существует два типа навыков:

  • Навыки рабочей области: доступны всем пользователям в рабочей области. Администраторы рабочей области могут создавать навыки рабочей области и предоставлять другим пользователям доступ к папке навыков, чтобы добавить дополнительные сведения. Используйте навыки рабочей среды, чтобы обеспечивать соблюдение общих стандартов организации, получать единообразные результаты у разных пользователей (например, навык обработки PII, который маскирует конфиденциальные столбцы) и поддерживать разные команды (например, с помощью шаблонов конвейеров для инженеров по данным и плейбуков обучения моделей для пользователей платформы машинного обучения).
  • Навыки пользователя: доступны только для вас. Используйте навыки пользователя для личных предпочтений, таких как предпочитаемые библиотеки, стиль программирования или контекст роли и фона. Навыки пользователей также полезны для прототипа навыка, прежде чем продвигать его на уровне рабочей области.

Создание навыка

Навыки располагаются в каталоге .assistant/skills/. Каждый навык должен иметь собственную папку и SKILL.md файл в этой папке. Расположение зависит от типа навыка:

  • Навыки рабочей области: Workspace/.assistant/skills/
  • Навыки пользователя: /Users/{username}/.assistant/skills/

Чтобы создать новый навык, выполните приведенные действия.

  1. Создайте новую папку для навыков по соответствующему пути для вашего типа навыка.

    После создания вы можете быстро получить доступ к папке навыков на панели кода Genie. Щелкните значок шестеренки в разделе Параметры, а затем щелкните значок стрелки, чтобы открыть папку навыков.

  2. Создайте выделенную папку для навыка в папке навыков. Каждый навык должен иметь собственную папку. Рассмотрим пример.

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. В папке навыка SKILL.md создайте файл. Этот файл является обязательным и определяет навык. Навыки соответствуют спецификациям навыков агента.

  4. Добавьте необходимые метаданные для навыка:

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Добавьте инструкции навыка в формате Markdown после frontmatter. Рекомендуется включить следующие разделы:

    • Пошаговые инструкции: Ясные процедурные рекомендации
    • Примеры: примеры входных данных и ожидаемых выходных данных
    • Пограничные варианты: распространенные варианты и исключения

  6. (Необязательно) Для более сложных навыков можно предоставить и ссылаться на дополнительные ресурсы:

    • Скрипты, содержащие исполняемый код, который может выполнять агент.
    • Файлы, содержащие дополнительную документацию для ссылки, например рекомендации и шаблоны.

    При ссылке на другие файлы используйте относительные пути из корневого навыка.

    Например, навык рабочего процесса машинного обучения в рабочей области и личный навык рабочего процесса могут иметь следующую структуру:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         └── pipeline-setup.sh   # Environment setup scripts

Genie Code автоматически распознаёт ваши навыки при следующем использовании. Вы также @ можете упомянуть навыки, чтобы обеспечить их использование Genie Code.

Когда вы редактируете существующий навык, начните новый чат для применения изменений. Правки не вступают в силу в активных чатах. Если навык по-прежнему отображается устаревшим, например отображение старого поведения или устаревшего описания, жестко обновите вкладку браузера, чтобы очистить кэшированные метаданные навыка.

Лучшие практики

Напишите эффективные описания навыков, следуя этим рекомендациям:

  • Выберите соответствующий тип навыка. Используйте навыки рабочей области, чтобы кодифицировать общие стандарты (такие как обработка персональных данных, соглашения об именовании или шаблоны для конкретных групп), чтобы каждый пользователь получал согласованные выходные данные. Используйте пользовательские навыки в личных целях и для создания прототипа навыка перед его переносом в рабочее пространство.
  • Держите навыки сосредоточены. Навыки лучше всего работают, когда они сосредоточены на одной задаче или рабочем процессе. Узкий охват облегчает распознавание Genie Code при применении навыка.
  • Используйте четкие имена и описания. Краткое, описательное имя и обобщенное описание помогают Genie Code сопоставить соответствующий навык с правильным запросом.
  • Будьте предельно ясными и ориентированными на примеры. Опишите рабочие процессы пошагово и включите конкретные примеры или шаблоны, которые Genie Code может повторно использовать.
  • Избегайте ненужных контекстов. Включайте только сведения, необходимые для задачи. Дополнительные сведения могут сделать навыки более сложными для надежного применения.
  • Итерируйте с течением времени. Рассматривайте навыки как живые рабочие процессы. Небольшие обновления на основе реального использования могут значительно улучшить результаты.
  • Создавайте навыки с помощью Genie Code. Используйте Genie Code для разработки и уточнения навыков. Проверьте новые или обновлённые навыки на репрезентативных задачах, чтобы определить, где агент испытывает затруднения, а затем обновите инструкции, чтобы устранить эти пробелы.
  • Разделите руководство и автоматизацию. Используйте markdown для объяснения намерений и передового опыта, а скрипты для повторяющихся действий. Разделение этих аспектов упрощает обслуживание и повторное использование навыков.
  • Управление версиями навыков. Создайте резервную копию папки с навыками с помощью папок Databricks Git для отслеживания изменений, совместной работы с коллегами и отката при необходимости.

Дополнительные ресурсы

  • Last updated on