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


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

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

Подсказка

Агент создает и загружает рабочие книги (runbooks) во время бесед без ручного управления файлами. Система индексирует документы для семантического поиска, тем самым делая их доступными для всех будущих исследований. Разрешения инцидентов автоматически становятся институциональными знаниями.

Как ваш агент собирает знания

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

Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to the knowledge base.

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

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

До и после

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

Area До После
Сбор знаний После инцидента: инженер пишет Runbook (может быть) Ваш агент фиксирует исправление по мере его возникновения.
Время документировать 30–60 минут для записи модуля Runbook Секунды: агент создает и отправляет встроенные данные
Свежесть знаний Ранбуки устаревают в течение нескольких недель База знаний увеличивается с каждым решением
Доступность Знания, застрявшие в голове инженера или в чате Возможность поиска вашим агентом во всех будущих беседах
Согласованность форматирования Зависит от автора Структурированная, согласованная документация каждый раз

Что делает это разными

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

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

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

Принцип работы

Средство "Отправить документ знаний" принимает три параметра.

Параметр Обязательный Описание
Имя файла Да Имя с расширением .md или .txt (например, database-pool-runbook.md)
Content Да Полный текст документа в формате Markdown или обычного текста
Активация индексирования Необязательный (по умолчанию: true) Следует ли немедленно выполнять поиск в документе

При отправке документа агентом:

  1. Агент проверяет имя файла и содержимое (не более 16 МБ на файл).
  2. Агент сохраняет документ в базе знаний вашего агента.
  3. Агент индексирует содержимое для семантического поиска.
  4. Агент подтверждает загрузку сообщением об успешной загрузке.

Замечание

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

Поддерживаемые форматы файлов

Средство "Загрузить документ знаний" поддерживает форматы на текстовой основе, создаваемые агентом в режиме онлайн.

Формат Расширение лучше всего подходит для
Markdown (язык разметки) .md Runbooks, руководства по устранению неполадок с форматированием и заголовками
Обычный текст .txt Простые заметки, журналы, необработанные документы

Замечание

При отправке файлов через API или CLI можно использовать дополнительные текстовые форматы, включая CSV, JSON, YAML и файлы журналов. API отправки поддерживает двоичные форматы (PDF, Word, Excel, PowerPoint) и изображения. Средство агента сосредоточено на форматах .md и .txt, так как агент генерирует текстовый контент во время бесед.

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

Пример: сбор знаний об инциденте

Во время расследования инцидентов попросите агента:

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to the knowledge base.

Агент создает структурированное руководство по устранению неполадок с помощью:

  • Этапы определения проблемы
  • Быстрые способы устранения рисков: немедленные действия для уменьшения влияния
  • Анализ первопричин: что исследовать
  • Действия по разрешению: решение, которое сработало
  • Предотвращение. Как избежать повторения

При следующем возникновении аналогичной проблемы ЦП агент автоматически ссылается на этот документ во время исследования, превратив опыт одного инженера в общие знания команды.

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

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

Требование Сведения
Версия агента 26.1.57.0 или более поздней версии
База знаний Включено для вашего агента
Разрешения на запись Агенту требуется права на запись в базу данных знаний
Режим выполнения Проверка или автономная запись (действия записи требуют утверждения в режиме проверки)

Ограничения

Следующие ограничения применяются к загруженным документам по знаниям.

Ограничение Ценность
Максимальный размер файла 16 МБ на документ
Поддерживаемые расширения .md и .txt.
Символы имени файла Буквы, цифры, дефисы, подчеркивания, точки (нет /, \, ?, #)
Максимальная длина имени файла 1024 символов

Когда использовать что-то другое

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

Сценарий Лучший подход
Подключение актуального вики-содержимого, которое само регулярно обновляется. Вики-знания Azure DevOps
Отправка двоичных файлов (PDF, Word, images) Загрузите вручную через Builder > базу знаний > Добавить файл
Массовое импортирование нескольких документов одновременно Используйте команду srectl doc upload --file <path> CLI

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