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

Учебное пособие: по подключению вики-сайта Azure DevOps к агенту Azure SRE

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

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

  • Подключите вики-сайт Azure DevOps, используя документальный коннектор
  • Выбор между управляемым удостоверением и аутентификацией с использованием персонального маркера доступа (PAT)
  • Проверьте подключение, задав агенту вопрос, использующий вики-содержимое

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

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

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

  • Агент Azure SRE (уже создан).
  • Проект Azure DevOps с вики-сайтом, содержащим содержимое.
  • Один из следующих вариантов проверки подлинности:
    • Управляемое удостоверение: добавьте управляемое удостоверение агента в качестве пользователя в организации Azure DevOps (Параметры организации>, Пользователи>, Добавить пользователей> введите идентификатор клиента удостоверения).
    • Личный маркер доступа (PAT): создание в Azure DevOps с областью кода (чтение).

Получение URL-адреса вики-сайта

Чтобы подключить вики-сайт, сначала потребуется URL-адрес из Azure DevOps.

  1. Перейдите в проект Azure DevOps.
  2. Выберите вики-сайт в левой боковой панели.
  3. Скопируйте URL-адрес из адресной строки браузера.

Ваш URL-адрес выглядит следующим образом:

https://dev.azure.com/{your-org}/{your-project}/_wiki/wikis/{wiki-name}

Кроме того, поддерживаются устаревшие URL-адреса:

https://{your-org}.visualstudio.com/{your-project}/_wiki/wikis/{wiki-name}

Подсказка

Чтобы индексировать только определенный раздел вики-сайта, сначала перейдите к данному разделу в Azure DevOps, а затем скопируйте URL-адрес. Идентификатор страницы в URL-адресе сообщает агенту об обходе только этой страницы и ее вложенных страниц. Этот подход полезен для крупных вики-сайтов, где актуален только такой раздел, как /Operations или /Runbooks.

Открытие страницы соединителей

Перейдите к конфигурации соединителей на портале агента Azure SRE.

  1. Перейдите к sre.azure.com.
  2. Выберите агент.
  3. В левой боковой панели разверните Конструктор.
  4. Выберите Соединители.

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

Запуск мастера добавления соединителя

Выберите "Добавить соединитель" на панели инструментов, чтобы открыть трехэтапный мастер:

  1. Выберите соединитель: выберите тип соединителя.
  2. Настройка соединителя: настройка имени, URL-адреса и проверки подлинности.
  3. Проверка и добавление: подтверждение и создание.

Выбор соединителя документации

В инструменте выбора коннектора найдите и выберите коннектор документации с подзаголовком Azure DevOps. Описание соединителя гласит: "Агент ссылается на документацию и файлы, чтобы понимать ваши проекты и процессы".

Нажмите кнопку "Далее ", чтобы перейти к форме установки.

Настройка соединителя

Заголовок формы показывает настройку соединителя Azure DevOps. Заполните следующие поля:

Поле Что ввести
Имя Описательное имя (например, ops-wiki или team-runbooks)
URL-адрес Azure DevOps URL-адрес вики-сайта из предыдущего шага

Выбор метода проверки подлинности

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

  1. Выберите Управляемое удостоверение (выбрано по умолчанию).
  2. Выберите управляемое удостоверение в раскрывающемся списке управляемое удостоверение (по умолчанию системное назначение).
  3. При необходимости выберите "Использовать управляемое удостоверение в качестве федеративного удостоверения личности".

Вариант B. Личный маркер доступа (PAT)

  1. Выберите личный маркер доступа (PAT).
  2. Вставьте Azure DevOps PAT в поле Личный токен доступа.

Нажмите кнопку "Далее ", чтобы перейти к шагу проверки.

Проверка и создание соединителя

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

Новый соединитель появится в списке соединителей со состоянием "Подключено " (зеленый флажок).

Замечание

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

Проверка подключения

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

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

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

What are our standard procedures for handling a database failover?

Агент выполняет поиск вики-сайта вместе с другими источниками знаний и содержит ссылки на исходную вики-страницу в ответе. Ответ включает ссылку на вики-страницу-источник в Azure DevOps.

Troubleshooting

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

Проблема Решение
Соединитель отображает отключен Проверьте формат URL-адреса вики и учетные данные аутентификации.
Вики-содержимое не отображается в ответах Подождите несколько минут, пока будет завершено начальное индексирование, а затем повторите попытку.
Ошибка проверки URL-адреса Убедитесь, что URL-адрес совпадает https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} или https://dev.azure.com/{org}/{project}/_git/{repo}. Также принимаются устаревшие visualstudio.com URL-адреса.
Сбой проверки подлинности PAT Убедитесь, что у вашего PAT есть область кода (чтение) и срок действия не истек.
Сбой управляемого удостоверения Убедитесь, что управляемое удостоверение агента добавляется в качестве пользователя в организации Azure DevOps (параметры организации>пользователи).

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

Сведения о знаниях ADO Wiki

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

  • Last updated on