Интеграция знаний в SRE-агенте Azure

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

Подсказка

• Использование базы знаний Builder > для управления файлами, веб-страницами и репозиториями в одном месте.
• Индексированные знания автоматически доступны во время расследований и чата.
• Вы можете отправлять документы напрямую, присоединять файлы в чате или подключать репозитории для анализа с поддержкой источника.
• Наиболее полезными источниками знаний являются те, от которых уже зависит ваша команда, например модули Runbook, заметки об архитектуре, руководства по устранению неполадок и исходный код.

Почему знания важны

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

Когда вы подключите эти знания, ваш агент сможет:

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

Управление знаниями в базе знаний

Используйте Базу знаний Builder > для управления источниками знаний агента.

На странице для каждого источника отображается следующее:

• Name
• Статус
• Тип
• Дата последнего изменения

Доступны три исходных типа:

Тип источника	Что он предоставляет	Как это добавить
Files	операционные инструкции, руководства по устранению неполадок, архитектурная документация и справочные материалы	Отправка через портал или запрос агента сохранить документ во время чата
Веб-страницы	Внешняя документация, внутренние URL-адреса вики-сайта и страницы состояния	Добавьте URL-адрес страницы, чтобы агент смог индексировать содержимое.
Репозитории	Исходный код, файлы развертывания и определения инфраструктуры	Подключите репозитории GitHub или Azure DevOps

Проверка состояния индексирования и свежести

Каждый источник знаний показывает одно из следующих состояний:

Статус	Значение
Индексирован	Содержимое обрабатывается и выполняется поиск
В ожидании	Содержимое по-прежнему обрабатывается
Не индексирован	Сбой обработки или не удалось индексировать источник

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

Отправить документы

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

Ниже приведены типичные примеры:

• Модули Runbook для инцидентов
• Руководства по эскалации
• Ссылки на архитектуру
• Контрольные списки по устранению неполадок

Вы можете отправить файлы через портал или попросить агента сохранить содержимое из беседы в базу знаний.

Поддерживаемые форматы и ограничения файлов см. в разделе "Отправка документов знаний".

Полный рабочий процесс см. в разделе "Отправка документов знаний".

Общий доступ к файлам в чате

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

Подсказка

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

В следующей таблице сравниваются долговременные загрузки знаний с временными вложениями в чате:

Сценарий	Отправка в базу знаний	Поделиться в чате
лучше всего подходит для	Руководства, процедуры и документы, которые вы хотите сделать доступными в последующих беседах	Файлы, которые вы хотите, чтобы агент проанализировал прямо сейчас
Область хранения	На уровне агента и с возможностью поиска в последующих беседах	На уровне потока и доступно в текущей беседе
Как добавить	Загрузите на портале или попросите агента сохранить содержимое	Перетащите файл, вставьте из буфера обмена или используйте + в чате
Может стать долгосрочным знанием	Уже накопленные долговременные знания	Да, если вы попросите агента сохранить его

Дополнительные сведения см. в разделе "Общий доступ к файлам в чате".

Добавление веб-страниц

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

Подходящие кандидаты включают:

• Внутренние вики-статьи
• Документация по общедоступному продукту
• Страницы состояния службы
• Справочные страницы, поддерживаемые командой

После добавления URL-адреса агент индексирует содержимое страницы, чтобы он смог ссылаться на эти сведения во время будущих исследований.

Подключение репозиториев

Подключите репозитории GitHub или Azure DevOps, если вашему агенту нужен контекст с учётом исходного кода.

Подключенные репозитории помогают агенту:

• Поиск шаблонов ошибок в исходном коде
• Сопоставление инцидентов с недавними изменениями кода
• Справочные файлы развертывания и конфигурации
• Использование содержимого репозитория во время анализа первопричин

Сведения о подключении к исходному коду см. в разделе "Подключение исходного кода".

Выбор подходящего источника знаний

Используйте тип источника, соответствующий типу необходимого контекста:

Если вам нужно подключиться...	Используйте...
Операционная инструкция или руководство по устранению неполадок, сохранённые в виде файла	Загрузка документов знаний
Снимок экрана, журнал или файл для одного активного исследования	Общий доступ к файлам в чате
Репозиторий GitHub или Azure DevOps	Подключение исходного кода
Внешние системы, такие как Datadog или Splunk	Соединители MCP