Настройка соединителя GitHub (OAuth или PAT) в агенте SRE Azure

Используйте коннектор GitHub, чтобы подключить github.com к своему агенту для управления обращениями, запросами на слияние и рабочими процессами. Настройте соединитель в портале через Builder > Connectors.

Note

В этом руководстве рассматривается коннектор GitHub для операций с обращениями, PR и рабочими процессами. Контекст кода во время исследований см. в разделе "Подключение исходного кода". Сведения о GitHub Enterprise Cloud см. в разделе Connect GitHub Enterprise Cloud.

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

  • Активный агент в состоянии выполнения
  • Доступ к github.com репозиториям, которые нужно использовать агенту
  • Роль агента: администратор или стандартный пользователь

Откройте настройку соединителя GitHub

  1. Откройте своего агента в портале.
  2. Перейдите в Коннекторы Builder>.
  3. Выберите "Добавить соединитель".
  4. Выберите соединитель GitHub OAuth.

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

Выберите один метод:

Method Когда использовать
OAuth Интерактивная настройка для доступа, управляемого пользователем
PAT Учетная запись службы или неинтерактивная настройка

Поток OAuth

  1. Выберите OAuth.
  2. Выберите вход в GitHub.
  3. Завершите авторизацию всплывающего окна GitHub.
  4. Проверьте, что статус отображается как Подключено.

PAT-поток

  1. Выберите PAT.
  2. Вставьте токен GitHub с необходимыми областями доступа.
  3. Нажмите Подключиться.
  4. Проверьте, что статус отображается как Подключено.

Подтверждение операций среды выполнения соединителя GitHub

После сохранения коннектора протестируйте его с помощью запроса в чате:

List recent issues from owner/repo and summarize the top 3 risks.

Используйте прямой запрос проверки в качестве конечной контрольной точки:

Get me recent issues from owner/repo.

Необходимые разрешения для операций

Операция Минимум для OAuth/PAT
Чтение метаданных и содержимого репозитория repo для частных репозиториев (public_repo только для общедоступных)
Перечисление или создание проблем Доступ к репозиторию с возможностью работы с issues
Операции с запросами на включение изменений Доступ к репозиторию с поддержкой PR

Устранение неполадок подключений

Симптом Вероятно, причина Исправление
Соединитель отображается как отключённый Токен истёк или аннулирован Повторная проверка подлинности OAuth или смена PAT
Проблема считывает работу, действия PR завершаются сбоем Отсутствует разрешение для PR Предоставьте PR разрешение и повторите попытку
Соединитель не может получить доступ к частным репозиториям Область действия токена слишком узкая Используйте область действия repo для частных репозиториев
Всплывающее окно не открывается Всплывающее окно браузера заблокировано Разрешить всплывающие окна для домена портала

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