Поиск кода GitHub с помощью Genie Code

Genie Code может выполнять поиск GitHub репозиториев при подключении к нему через соединитель native Databricks GitHub или custom GitHub MCP-сервер. В большинстве случаев используйте собственный соединитель. Для доступа к закрытому репозиторию необходимо, чтобы администратор организации GitHub установил приложение-коннектор Databricks GitHub.

Использование собственного соединителя (рекомендуется)

Important

Эта функция доступна в бета-версии. Чтобы использовать соединители сторонних источников данных, администратор рабочей области должен включить предварительную версию сторонних соединителей для агентов. См. статью "Управление предварительными версиями Azure Databricks".

Чтобы подключить Genie One или Genie Code к GitHub, используйте сторонний соединитель Databricks. См. Использовать нативные разъёмы для сторонних источников данных и Подключить Genie One к внешним инструментам и источникам. Для частных репозиториев администраторы должны включить доступ.

Зарегистрировать кастомный сервер GitHub MCP (не рекомендуется)

Пропустите этот раздел, если в вашем рабочем пространстве Azure Databricks уже есть доступный для использования сервис GitHub Unity Catalog MCP. Если вам нужен только доступ к публичным репозиториям и информации вашего аккаунта, используйте управляемый OAuth и пропустите и перейдите к Зарегистрируйте подключение Unity Catalog как MCP-сервис.

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

  • Управляемый OAuth: Databricks управляет приложением GitHub OAuth и учётными данными. Пропустите приложение GitHub и шаги с клиентским секретом ниже, затем выберите поставщика под управлением при создании соединения.
  • Пользовательский OAuth: Создайте собственное приложение GitHub и указывайте его учетные данные при создании соединения.

Создайте приложение GitHub (только для пользовательского OAuth)

  1. Создайте приложение GitHub. Для корпоративных баз кода администратор организации GitHub должен выполнить этот шаг.

    • Перейдите к параметрам разработчика > параметров > профиля > GitHub приложения и нажмите кнопку "Создать GitHub приложение".
    • Заполните запрошенные поля. URL-адрес обратного вызова должен бытьhttps://<your-databricks-workspace-url>/login/oauth/http.html. Это то, как GitHub выполняет проверку подлинности в рабочей области Databricks.
      • URL-адрес домашней страницы не влияет на сервер MCP и может быть задано любое значение, которое вы предпочитаете.
      • Снимите флажок Активно, чтобы сделать URL-адрес вебхука необязательным полем.
    • Предоставьте приложению GitHub необходимые разрешения для доступа к репозиторию и организации.
    • Нажмите кнопку "Создать приложение GitHub".

  2. В созданном приложении в разделе секретов клиента нажмите кнопку "Создать новый секрет клиента". Скопируйте это значение.

Зарегистрируйте соединение Unity Catalog как сервис MCP

  1. Создайте или повторно используйте HTTP-соединение Unity Catalog для GitHub. Чтобы создать схему, у вас должны быть CREATE CONNECTION привилегии на схему. Если вы повторно используете существующее соединение, на нём должен быть USE CONNECTION. Затем зарегистрируйте это соединение как сервис MCP на следующем этапе. Для нового соединения используйте один из следующих вариантов аутентификации:

    • Управляемый OAuth: выберите тип аутентификации OAuth User to Machine Per User и OAuth-провайдера GitHub. Databricks предоставляет GitHub хост, базовый путь и учетные данные OAuth.
    • Пользовательский OAuth: выберите тип аутентификации OAuth User to Machine Per User и провайдер OAuth Ручная настройка. Введите следующие значения:
      • Хозяин: https://api.githubcopilot.com
      • Область OAuth: области приложения. Например: mcp:access read:user user:email repo read:org
      • Секрет клиента и идентификатор клиента: сгенерированы в приложении GitHub на шагах выше
      • Конечная точка авторизации: https://github.com/login/oauth/authorize
      • Конечная точка токена: https://github.com/login/oauth/access_token
      • Базовый путь: /mcp
    • Нажмите Create connection (Создать подключение).

  2. Зарегистрируйте MCP-сервис, использующий HTTP-соединение. Для необходимых разрешений см. Внешние MCP-серверы.

    • В вашем рабочем пространстве Azure Databricks перейдите в Catalog, выберите схему и нажмите Create>MCP Service.
    • Введите каталог, схему и название службы MCP.
    • Выберите HTTP-соединение, которое вы создали или используете существующее, выберите инструменты, которые нужно предоставить, и нажмите «Создать».

  3. Если вы выбрали OAuth для пользователя, откройте сервис MCP в Каталоговом проводнике и нажмите «Войти» для авторизации аккаунта GitHub.

  4. Предоставляйте пользователям или группам EXECUTE на MCP Service, а также USE CATALOG и USE SCHEMA на его родительском каталоге и схеме. Не предоставляйте конечным пользователям USE CONNECTION. См. «Общий доступ к MCP».

Ваш сервис GitHub MCP готов к использованию. Добавьте это в Genie Code.

  • Последнее обновление: