Руководство: Создание навыка в агенте Azure SRE

В этом руководстве вы создадите пользовательский навык, который добавляет доменные знания и пошаговые руководства по выполнению задач в ваш агент. Навыки — это модульные возможности, которые агент загружает автоматически при необходимости, например устранение неполадок определенной службы или выполнение диагностической процедуры.

В этом руководстве вы узнаете, как:

  • Создайте навык в конструкторе субагентов
  • Напишите инструкции по навыкам в SKILL.md
  • Добавление вспомогательных файлов и инструментов
  • Тестирование навыка в чате или на детской площадке
  • Изменение существующего навыка

Предполагаемое время: 10 минут

Подсказка

Навыки и документы, содержащие знания, работают вместе. Навык обучает агента тому, как выполнять что-либо (процедуры, сценарии, пошаговые инструкции). Документ знаний обучает агенту то, что он должен знать (справочные данные, документация по архитектуре, модули Runbook). Вы также можете присоединить справочные документы непосредственно к навыку в качестве вспомогательных файлов. Сведения о потоке отправки знаний см. в разделе "Отправка документов знаний".

Необходимые условия

Перед началом работы убедитесь, что у вас есть следующие предварительные требования:

  • Агент, созданный на портале агента Azure SRE.
  • Четкое понимание процедуры или знаний домена, которые вы хотите закодировать.

Откройте построитель подагентов, где вы создаете навыки и управляете ими.

  1. Откройте портал агента SRE.
  2. Выберите агент.
  3. Выберите построитель в области навигации слева.
  4. Выберите построитель подагентов.

Запуск создания навыка

Запустите процесс создания навыка с панели инструментов.

  1. Выберите раскрывающийся список "Создать " на панели инструментов.
  2. Выберите Навык.

Откроется диалоговое окно создания навыка с двухколоночной компоновкой. Поля формы на одной стороне и редактор кода на другой стороне, показывающий SKILL.md.

Введите имя и описание

Укажите имя и описание, помогающие агенту решить, когда следует использовать этот навык.

Поле Пример значения
Имя high-cpu-troubleshooting
Описание Процедура устранения неполадок для оповещений об интенсивном использовании ЦП в приложениях-контейнерах. Проверяет вышестоящие зависимости, пул соединений и последние развертывания.

Имя должно быть уникальным для ваших навыков. Описание отображается в списке навыков и помогает агенту решить, когда использовать этот навык.

Подсказка

Нажмите кнопку "Изменить " рядом с текстом описания, чтобы переключиться в режим редактирования. После завершения нажмите Сохранить.

Напишите инструкции по использованию навыков

В редакторе центра показано SKILL.md, что содержит инструкции навыка. Файл начинается с шаблона по умолчанию.

---
name:
description:
---

<!-- Add your skill instructions here -->

Область данных YAML (name, description, tools) находится в согласовании с полями формы слева. Напишите инструкции в Markdown ниже передней части документа:

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Добавление вспомогательных файлов

В разделе "Файлы" на одной стороне показан браузер файлов. Помимо стандартного SKILL.mdзначения, можно добавить справочные данные, шаблоны и примеры запросов.

  • Выберите значок нового файла , чтобы добавить файлы.
  • Выберите значок новой папки , чтобы упорядочить файлы в каталоги.
  • Перетащите папку в зону удаления или выберите ссылку " Отправить папку", чтобы отправить всю структуру папок.

Выберите любой файл в браузере, чтобы изменить его в редакторе кода. Редактор поддерживает выделение синтаксиса для Markdown, JSON, YAML, KQL, Python и shell скриптов.

Выберите инструменты

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

  1. Выберите инструменты в разделе "Сервис ".
  2. Найдите или просмотрите инструменты. Фильтруйте по типу (пользовательскому инструменту, средству MCP) или поиску по имени.
  3. Проверьте инструменты, необходимые для этого навыка (например, kusto_query или azure_resource_health).
  4. Закройте панель.

Выбранные средства отображаются как съемные таблетки. Эти средства динамически доступны при активации навыка.

Замечание

Средства, добавленные к навыку, динамически доступны при активации навыка. Для более согласованного поведения конфигурируйте инструменты непосредственно на субагенте.

Сведения о создании настраиваемых средств см. в статье "Создание средства Kusto " или "Создание средства Python". Дополнительные сведения о средствах см. в разделе "Сервис".

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

Нажмите кнопку "Создать", чтобы сохранить навык.

Навык отображается на вкладке "Навыки" в построителе подагентов. Теперь агент может автоматически использовать навык при возникновении соответствующей ситуации.

Тестирование навыка

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

Тестирование в новом чате

Используйте новый чат, чтобы убедиться, что агент активирует ваш навык.

  1. Выберите новый поток чата на боковой панели.
  2. Введите запрос, который должен активировать навык. Например: "Мы видим высокую загрузку процессора в нашем контейнерном приложении, можете ли вы это расследовать?"
  3. Убедитесь, что агент активирует навык и выполняет определенные процедуры.

Тестирование на детской площадке

Используйте игровую площадку для тестирования навыка с помощью подагента.

  1. Создайте подагента и назначьте ему этот навык.
  2. На панели инструментов построителя подагентов выберите переключатель представления тестовой площадки .
  3. Выберите подагента, введите тестовый запрос и проверьте, что он правильно применяет навык.

Дополнительные сведения см. в разделе "Игровая площадка агента".

Изменение навыка

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

  1. На вкладке "Навыки" выберите имя навыка или выберите его и нажмите кнопку "Изменить".

  2. Откроется диалоговое окно редактирования со всеми текущими значениями, предварительно заполненными. Измените необходимые поля:

    Что изменить Где обновить
    Когда агент использует его Описание и SKILL.md инструкции
    Какие процедуры следует выполнить Содержимое SKILL.md в редакторе
    Какие средства доступны Инструменты> Выбор инструментов
    Эталонные данные Файлы> добавление, изменение или удаление файлов

  3. Нажмите Сохранить.

Советы по эффективному описанию навыков

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

  • Будьте конкретны, когда использовать это. Агент читает описание и инструкции, чтобы определить релевантность.
  • Включите пошаговые процедуры. Нумерованные шаги дают агенту четкий сборник схем.
  • Укажите ожидаемые выходные данные. Сообщите агенту, в каком формате должны быть представлены результаты.
  • Добавьте справочные данные. Отправка шаблонов запросов, базовых показателей конфигурации или известных хороших значений в качестве вспомогательных файлов.
  • Назначьте соответствующие инструменты. Если навыку требуются определенные инструменты, такие как запросы Kusto или действия Azure, добавьте их.

Следующий шаг

Узнайте о навыках

Связанный контент

  • Last updated on