Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Подключите вики Azure DevOps, чтобы ваш агент мог ссылаться на инструкции и процедуры вашей команды во время расследований. Содержимое вики-сайта индексируется и выполняется поиск, и агент находит нужную страницу автоматически. Соединитель поддерживает аутентификацию с использованием управляемой идентификации и персонального токена доступа (PAT).
Проблема: знания неиспользуются во время инцидентов
Ваша команда вкладывает сотни часов в написание рабочих инструкций, руководств по устранению неполадок и операционных процедур в wiki Azure DevOps. Но когда инцидент произойдет в 3 часа утра, никто не ищет вики. Инженер по вызову открывает десяток вкладок, проверяет Azure Monitor и либо определяет это по памяти, либо передаёт запрос дальше. Документация, написанная именно для этой ситуации, остается нетронутой.
Существует знание. Проблема заключается в доступе — не к вики-сайту, а к правильной странице в нужное время в контексте реальной проблемы.
Как агент SRE решает эту проблему
Подключите вики-сайт Azure DevOps один раз, и агент автоматически выполняет поиск во время каждого исследования:
- Индексирует вики-страницы — выполняет обход и индексирует все страницы из вики-сайта Azure DevOps.
- Контекстный поиск — когда вы задаете вопрос или возникает инцидент, ваш агент выполняет поиск по вашей вики вместе с другими источниками знаний.
- Ссылки на определенные страницы — ответы включают ссылки обратно на исходную вики-страницу.
- Получает обновления — повторно подключите или обновите соединитель, чтобы повторно индексировать обновленное вики-содержимое.
До и после
| Сценарий | До | После |
|---|---|---|
| Реагирование на инциденты | Дежурный не ищет информацию на вики во время инцидентов. | Агент автоматически выполняет поиск вики-сайта для каждого запроса. |
| Доступ к знаниям | Знания на вики не используются в 3 часа ночи | Плейбуки появляются именно тогда, когда они нужны. |
| адаптация | Новые члены команды не знают, какую вики-страницу проверить | Агент находит соответствующую страницу независимо от опыта |
| Качество поиска | Поиск вики-сайта требует знать правильные ключевые слова | Агент понимает контекст и находит связанное содержимое |
Что делает это разными
В отличие от отправки статических файлов, вики-сайт остается в живых. Когда команда обновляет Runbook в Azure DevOps, агент обнаруживает изменения. Вам не нужно повторно отправлять файлы.
В отличие от полнотекстового вики-поиска, агент понимает контекст. Это не соответствует ключевым словам. Вместо этого он сопоставляет ваш вопрос с соответствующим вики-контентом, сочетая его с динамической телеметрией из Azure Monitor, журналов из Kusto и других подключенных источников.
В отличие от внешнего вики-доступа на основе MCP, встроенный соединитель документации не требует настройки внешнего сервера. Вы предоставляете URL-адрес и проверку подлинности вики-сайта, а агент обрабатывает остальные.
Принцип работы
Соединитель документации (Azure DevOps тип службы) сканирует ваши вики-страницы и индексирует их для поиска. Когда агент получает запрос, он выполняет поиск индексированного содержимого вместе с другими источниками знаний, такими как отправленные файлы, веб-страницы и подключенные репозитории.
Соединитель поддерживает два типа содержимого Azure DevOps:
| Тип контента | Шаблон URL-адреса | Что индексируется |
|---|---|---|
| Вики | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Все вики-страницы (Markdown) |
| Вики (ограниченный) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Конкретная страница и ее вложенные страницы |
| Репозиторий Git | https://dev.azure.com/{org}/{project}/_git/{repo} |
Текстовые файлы (Markdown, документы, код) |
| Устаревшая вики | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
То же, что и выше (формат устаревшего URL-адреса) |
Замечание
При включении идентификатора страницы в вики-URL соединитель индексирует только эту страницу и ее вложенные страницы. Этот подход полезен для целевых разделов, таких как /Operations/Runbooks или без индексирования всего вики-сайта.
Как работает синхронизация документации
После подключения агент автоматически обновляет индекс документации. Вам не нужно перезагрузить ничего вручную.
| Аспект | Сведения |
|---|---|
| Частота синхронизации | Автоматическое сканирование каждые 24 часа |
| Поддерживаемые форматы |
.md, .txt, .rst.adoc.asciidoc.wiki.textile.org.htm.html.json.yaml.yml.xml.csv(15 форматов файлов) |
| Процесс индексирования | Документы разбиваются на части, встраиваются и индексируются для семантического поиска. |
| Обновления | Изменения в репозитории учитываются в следующем цикле синхронизации без необходимости выполнения ручных действий. |
Агент обрабатывает каждый документ, разделяя его на семантически значимые блоки, создавая векторные внедрения и сохраняя их в индексе поиска. При поступлении запроса агент выполняет семантический поиск во всех индексированных блоках и извлекает наиболее релевантные фрагменты независимо от точных совпадений ключевых слов.
Ваша команда может обновлять модули Runbook, добавлять новые процедуры или реорганизовать вики-страницы, а агент отражает эти изменения в течение 24 часов.
Необходимые условия
| Требование | Сведения |
|---|---|
| Вики-сайт Azure DevOps | Вики-сайт в проекте Azure DevOps с содержимым |
| Аутентификация | Управляемое удостоверение (рекомендуется) или личный маркер доступа (PAT) |
| Разрешения | Доступ на чтение к вики-сайту |
Варианты проверки подлинности
В следующей таблице описаны доступные методы проверки подлинности для вики-соединителя Azure DevOps.
| Метод | лучше всего подходит для | Принцип работы |
|---|---|---|
| Управляемая идентичность | Рабочие среды | Использует управляемое удостоверение, назначаемое системой или назначаемое пользователем. Требуется добавить учетную запись в вашу организацию Azure DevOps в качестве пользователя. |
| Личный маркер доступа (PAT) | Быстрая настройка, тестирование | Создайте личный токен доступа (PAT) в Azure DevOps с областью 'Чтение кода'. |
Пример. Использование модуля Runbook во время инцидента
После того как подключите вики-сайт своих операций, попросите агента:
Our payment service is returning 503 errors. What does our runbook say to do?
Агент выполняет поиск в вашей вики, находит страницу под названием "Устранение неполадок службы оплаты" и отвечает согласно документированной процедуре. Ответ включает ссылку обратно на исходную вики-страницу в Azure DevOps.