Поделиться через


Руководство: использование DocsGuide в агенте SRE Azure

В этом руководстве используйте DocsGuide (встроенную документацию), чтобы задать вопросы о функциях агента Azure SRE, конфигурации и концепциях. Ответы DocsGuide из динамической официальной документации, поэтому ответы остаются актуальными по мере развития функций.

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

Изучив это руководство, вы:

  • Задайте вопрос о концепции и просмотрите карточку ответа DocsGuide
  • Задайте вопрос о настройке и получите пошаговые инструкции
  • Задавайте вопросы о функциях и изучайте подробности о возможностях.
  • Изучение различных шаблонов вопросов, которые активируют DocsGuide

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

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

  • Агент Azure SRE в состоянии выполнения
  • Доступ к интерфейсу чата агента
  • Исходящий сетевой доступ к sre.azure.com (DocsGuide извлекает страницы документации во время выполнения)

Открытие чата агента

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

  1. Перейдите к sre.azure.com и выберите агент.
  2. Интерфейс чата открывается с новым представлением потока и полем ввода.

Снимок экрана: интерфейс чата агента, показывающий представление нового потока с готовыми входными данными чата.

Контрольная точка: Вход чата видим и показывает заполнитель "Задать вопрос или ввести косую черту (/) для использования команды".

Задать концептуальный вопрос

Попробуйте задать вопрос о концепции агента Azure SRE, чтобы узнать, как отвечает DocsGuide.

Введите следующий вопрос во входных данных чата:

What are run modes?

Подождите около 10 секунд для ответа.

Снимок экрана: карточка пользовательского агента DocsGuide с задачей

Контрольная точка: Вы видите:

  • Карта параллельного изучения с «1 агент · 1 задача завершена»
  • Вложенная карточка пользовательского агента DocsGuide с значком поиска и зеленым флажком
  • Карточка DocsGuide отображает свою задачу (например, "Определение режимов выполнения")
  • Под карточкой синтезированный ответ агента о режимах работы

Задать вопрос о настройке

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

Введите следующий вопрос:

How do I connect PagerDuty to my agent?

Контрольная точка: Ответ включает конкретные шаги настройки. Перейдите в Настройки>Платформа инцидентов, введите API-ключ, включите план быстрого реагирования, который взят из официальной документации учебного пособия PagerDuty.

Задать вопрос о функции

Запросите информацию о конкретной возможности, чтобы узнать, как DocsGuide объясняет особенности.

Введите следующий вопрос:

How do scheduled tasks work?

Контрольная точка: Ответ объясняет создание запланированных задач, опции повторения и их связь с пользовательскими агентами, которые взяты из возможностей выполнения запланированных задач и страниц руководств.

Попробуйте вопросы формата "Могу ли я"

Шаблон вопроса "Могу ли я..." также активирует DocsGuide.

Введите следующий вопрос:

Can I use Python to extend my agent?

Контрольная точка: DocsGuide возвращает информацию о средствах Python, включая то, как создавать и развертывать пользовательские средства Python, из документации по выполнению Python-кода.

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

Используйте эти шаблоны вопросов, чтобы получить наиболее точные и полные ответы из DocsGuide.

Тип вопроса Хороший пример Менее эффективный пример
Конкретная функция "Как настроить планы реагирования на инциденты?" "Расскажите мне об агенте"
Действия по настройке "Как подключить соединитель Kusto?" "Настройка всего"
Уточнение концепции "Что такое разница между навыками и знаниями?" Объясните агента
Проверка возможностей "Можно ли отправлять уведомления через Teams?" "Что вы можете сделать?"

Подсказка

Три шаблона вопросов лучше всего работают: "Как я...", "Могу ли я..." и "Что такое...". Чем более конкретный вопрос, тем более целевой ответ.

Сводка

Из этого руководства вы узнали, как:

  • Используйте DocsGuide, чтобы задать вопросы документации непосредственно в чате агента.
  • Задайте вопросы о концепции, настройке и функциях, чтобы получить точные ответы.
  • Распознает карточку задачи пользовательского агента DocsGuide, показывающую, какие страницы документации были проверены.
  • Используйте конкретные шаблоны вопросов ("Как я...", "Могу ли я...", "Что такое...") для лучших результатов.

Ответы DocsGuide поступают из официальной документации на sre.azure.com, а не из обучающих данных. Эта возможность работает так же, как в чате портала и боте Teams.

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