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

Руководство: Загрузка документов знаний в агент SRE Azure

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

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

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

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

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

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

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

  • Агент Azure SRE находится в состоянии работает.
  • Разрешения на запись для агента.
  • Режим выполнения агента, установленный для проверки или автономности.

Начните с расследования

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

  1. Перейдите к sre.azure.com и выберите агент.
  2. На левой боковой панели в разделе "Чаты" найдите предыдущий поток исследования, в котором агент диагностировал или устранил проблему, и выберите ее.

Если у вас еще нет темы расследования, начните новый чат и попросите агента провести расследование.

Investigate high memory usage on our container apps

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

Создание модуля Runbook из исследования

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

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to the knowledge base as high-memory-runbook.md

Агент выполняет следующие действия:

  1. Синтезирует контекст исследования в структурированном модуле Runbook.
  2. Создает разделы, такие как анализ первопричин, шаги диагностики, устранение рисков и триггеры эскалации.
  3. Сохраняет документ в базе знаний и подтверждает отправку.

Агент подтверждает, что документ Runbook сохранен в базе знаний под именем java-app-high-memory-runbook.md.

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

Подсказка

Укажите имя файла с расширением .md или .txt. Это определяет, как документ называется в базе знаний и упрощает поиск позже.

Замечание

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

На этом этапе подтвердите следующее:

  • Агент создал структурированный Runbook из расследования.
  • Агент подтвердил, что документ сохранен.

Проверка документа в базе знаний

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

  1. На левой боковой панели выберите построитель , чтобы развернуть раздел.
  2. Выберите базу знаний.

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

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

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

Отправка файла через портал

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

  1. На странице базы знаний выберите "Добавить файл".
  2. Перетащите файл в зону загрузки или выберите просмотреть файлы, чтобы выбрать один.
  3. Выберите "Добавить файл для отправки ".

Диалоговое окно отправки, показывающее зону перетаскивания с поддерживаемыми форматами файлов и максимальным размером 100 МБ.

Портал принимает следующие типы файлов:

  • Текст: .md, .txt, .csv, .json.xml.yaml.yml.log.ini.cfg.conf.config.properties
  • Документы: .pdf, , .docx, .pptx.xlsx.doc.ppt.xls
  • Изображения: .png, .jpg.jpeg.gif.bmp.webp.tiff.tif

Максимальный размер файла составляет 16 МБ на файл с размером до 100 МБ на отправку.

Проверка извлечения в новой беседе

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

  1. Выберите новый поток чата на боковой панели.
  2. Задайте вопрос, на который ваши загруженные документы должны ответить.

Рассмотрим пример.

What are the steps for troubleshooting high memory usage on container apps?

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

Сбор знаний после инцидентов

После устранения любой проблемы попросите агента сохранить то, что он узнал:

Create a runbook from the steps we just used to resolve this incident.
Include the root cause, investigation steps, and the fix.
Save it as incident-12345-resolution.md in the knowledge base.

Со временем это создает поисковую библиотеку институциональных знаний. Каждый прошлый инцидент становится ресурсом для будущих.

Обновление существующих документов

Отправьте документ с тем же именем файла, чтобы заменить предыдущую версию:

Update the high-memory-runbook.md document in the knowledge base.
Add a new section about container memory limits as a common cause.

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

Импортируйте несколько документов одновременно с помощью интерфейса командной строки:

# Upload a single file
srectl doc upload --file ./runbooks/high-memory-guide.md

# Upload all .md and .txt files in a folder (recursive)
srectl doc upload --file ./runbooks

Troubleshooting

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

Error Причина Исправление
"Память агента отключена. Не удается отправить документы". База знаний не активирована для вашего агента. Обратитесь к администратору, чтобы включить базу знаний.
У меня нет права на запись в вашу базу знаний Агент не мог найти инструмент загрузки. Повторите запрос: "Сохраните его в базе знаний как filename.md"
"Недопустимое расширение файла. Разрешены только файлы MD и .txt". Имя файла не оканчивается на .md или .txt (загрузка чата). Используйте расширение .md или .txt при запросе агента на сохранение.
"Содержимое документа превышает максимальный размер 16 МБ" Слишком большое содержимое для одного документа. Разделите на несколько небольших документов.
"Имя файла не может быть пустым" Имя файла не указано. Добавьте имя файла в запрос (например, runbook.md).

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

Узнайте о памяти и знаниях

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

  • Last updated on