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

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

Ваш агент поставляется с встроенным мониторингом Azure, но у каждой команды есть свой уникальный контекст: справочники Runbook, документация по архитектуре, внутренние вики-сайты и репозитории кода. Используя базу знаний, вы можете управлять всеми этими источниками знаний в одном месте, чтобы агент может ссылаться на них во время расследования.

Подсказка

Ключевые выводы

  • Построитель > База знаний — это центральное место для управления всеми источниками знаний, включая файлы, веб-страницы и репозитории.
  • Отправьте рукбуки и документы, добавляйте веб-страницы с помощью URL-адреса или подключайте репозитории исходного кода.
  • Агент автоматически ссылается на индексированные знания во время исследования.
  • Чем больше у агента актуальных знаний, тем быстрее и точнее он может отвечать.

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

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

Если у агента есть доступ к этим знаниям, он может:

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

База знаний

Используйте страницу базы знаний на портале (база знаний>) для управления знаниями агента. Вы можете отправлять файлы, добавлять веб-страницы и просматривать подключенные репозитории.

В следующей таблице описаны три типа источников знаний.

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

Каждая запись показывает свое имя, состояние индексирования (индексирование , ожидание или не индексирование), тип и дату последнего изменения .

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

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

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

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

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

Подсказка

Хотите постоянно хранить файл?

После присоединения файла в чате попросите агента: "Сохраните это в параметрах знаний". Агент считывает файл из потока и отправляет копию в базу знаний, что делает его индексированным и доступным для поиска во всех будущих беседах. Исходный файл также остается в потоке.

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

Отправка знаний Общий доступ к файлам в чате
Where База знаний Builder >, или задайте вопрос в чате Ввод сообщения чата (+, перетаскивание, вставка)
Хранение Уровень агента: индексированные, доступные для поиска во всех потоках Уровень темы: доступен в этой беседе
лучше всего подходит для Модули Runbook, документация по архитектуре, процедуры, на которые агент будет ссылаться в каждой следующей беседе. Снимки экрана, журналы, файлы конфигурации, которые необходимо проанализировать прямо сейчас
Повышение уровня знаний Уже там Попросите агента: "Сохранить это в параметрах знаний", что скопирует содержимое в хранилище уровня агента.
Форматы 28 типов, включая документы, данные, изображения 31 типов, включая код, скрипты, инфраструктуру, веб-сайт
Ограничения размера 16 МБ на файл, 100 МБ на отправку 10 МБ на файл, 50 МБ всего, 5 файлов

Подключение исходного кода

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

Добавление репозиториев

Вбазе знаний> выберите "Добавить репозиторий", чтобы открыть интерактивный мастер, который поможет вам выполнить три шага.

Step Что вы делаете
1. Выбор платформы Выберите GitHub или Azure DevOps. Для Azure DevOps введите имя организации.
2. Проверка подлинности Войдите с помощью OAuth или введите личный маркер доступа (PAT). Azure DevOps также поддерживает управляемое удостоверение.
3. Добавление репозиториев Просмотрите доступные репозитории из раскрывающегося списка или введите URL-адреса вручную. Добавьте отображаемое имя и необязательное описание для каждой записи. Для Azure DevOps сначала выберите проект, чтобы отфильтровать список репозитория.

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

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

Поддерживаемые платформы и проверка подлинности

Platform Методы проверки подлинности Что вам нужно
GitHub OAuth, личный маркер доступа Учетная запись GitHub с доступом к репозиторию. Для PAT создайте маркер с repo областью действия.
Azure DevOps OAuth, личный маркер доступа, управляемое удостоверение Доступ к организации Azure DevOps. Для управляемого удостоверения добавьте управляемую идентичность, назначаемую пользователем, к ресурсу агента.

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

Учебное пособие: Загрузка документов знаний

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

  • Last updated on