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

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

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

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

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

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

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

Шаг 1. Начало исследования

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

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

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

Investigate high memory usage on our container apps

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

Шаг 2: Попросите агента создать рабочую книгу

В том же потоке исследования попросите агент превратить результаты в модуль 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 Knowledge settings as high-memory-runbook.md

Агент:

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

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

Checkpoint

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

Шаг 3. Проверьте настройки знаний

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

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

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

Checkpoint

• Перейти к Builder → параметрам знаний
• Документ отображается со статусом индексирован.

Шаг 4. Отправка файлов через портал

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

Отправка отдельных файлов

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

Отправка папки

Вы также можете перетащить всю папку, включая вложенные папки, на область для перетаскивания.

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

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

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

Замечание

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

Checkpoint

• Выбран «Добавить файл» и увидено диалоговое окно отправки.
• Файл или папка успешно загружены.
• Файлы отображаются в источниках знаний с состоянием индексированный.

Шаг 5. Проверка получения данных в новой беседе

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

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

Агент ищет Настройки знаний, находит загруженный вами Runbook и упоминает его в ответе. Этот процесс подтверждает индексирование и получение знаний.

Checkpoint

• Начато новое обсуждение в чате
• Задать вопрос, связанный с загруженным содержимым
• Агент ссылается на отправленный документ в ответе

Удаление документа базы знаний

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

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

Замечание

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

Полученные навыки

• Агент может превратить реальные исследования в структурированные модули Runbook и сохранить их в параметрах знаний.
• Файлы можно загружать вручную через пользовательский интерфейс портала в разделе Builder → Настройки знаний. Он поддерживает множество форматов, включая PDF, документы Office и изображения.
• Система индексирует загруженные документы для семантического поиска, и они будут доступны во всех будущих беседах.
• Чтобы обновить документы, отправьте их с помощью того же имени файла.

Troubleshooting

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

Related

Ресурс	Что вы узнаете
Загрузка документов знаний	Как это работает и почему это важно
Создание навыка	Создание процедурных навыков, дополняющих документы знаний
Навыки	Как навыки и знания работают вместе
ADO wiki Knowledge	Подключите живое вики-содержимое в качестве источника знаний