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

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

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

Important

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

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

• Встроенный соединитель использует системное подключение Databricks по умолчанию. Чтобы использовать вместо этого пользовательский сервер MCP для GitHub, добавьте его вручную. См. раздел "Добавление серверов MCP в код Genie" вручную.
• Чтобы улучшить ответы, добавьте контекст для каждого репозитория, чтобы помочь средствам поиска GitHub лучше понимать вашу кодовую базу.

Включение доступа к частному репозиторию

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

1. Установите приложение Databricks GitHub connector app в своей организации GitHub, чтобы предоставить ему доступ на чтение к вашим закрытым репозиториям.

2. Добавьте исходящие IP-адреса бессерверной среды Databricks в список разрешённых для облака и региона вашей рабочей области. Список IP-адресов см. в разделе IP-адреса и домены Azure Databricks служб и ресурсов. Инструкции по настройке разрешенных IP-адресов для организации GitHub см. в разделе Управляемые IP-адреса для вашей организации.

После завершения настройки администратора пользователи в организации могут получить доступ к частным репозиториям с помощью подключения к системе Databricks по умолчанию.

Создайте пользовательский MCP-сервер GitHub (не рекомендуется)

Пропустите этот раздел, если в вашей рабочей области Databricks уже настроено подключение Unity Catalog к GitHub, которое вы можете использовать. Если вам нужен доступ только к общедоступным репозиториям и данным собственной учетной записи, перейдите к шагу 3.

Выполните приведенные ниже действия, чтобы создать пользовательский сервер GitHub MCP. Это позволяет настроить сервер для конкретных потребностей в данных и безопасности.

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

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

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

3. Создайте новое подключение Unity Catalog для GitHub. У вас должны быть CREATE CONNECTION привилегии.

   • Если в вашей рабочей области уже установлен этот компонент, вы можете использовать его до тех пор, пока у вас есть USE CONNECTION привилегии.
   • Заполните следующие поля:
     • Тип подключения: HTTP
     • Тип проверки подлинности: OAuth User to Machine
     • Поставщик OAuth: Manual configuration
       • Если вам нужен доступ только к общедоступным репозиториям и данным собственной учетной записи, выберите Github MCP здесь и пропустите остальные действия.
     • Хозяин: https://api.githubcopilot.com
     • Область OAuth: области приложения. Например: mcp:access read:user user:email repo read:org
     • Секрет клиента и идентификатор клиента: создан на шаге 2
     • Конечная точка авторизации: https://github.com/login/oauth/authorize
     • Конечная точка токена: https://github.com/login/oauth/access_token
     • Базовый путь: /mcp
     • Подключение MCP: checked
   • Нажмите Create connection (Создать подключение).

4. В правом верхнем углу нажмите кнопку "Войти" , чтобы войти в подключение. Откроется новое окно с запросом на авторизацию приложения GitHub в учетную запись Databricks. Нажмите кнопку "Подключиться" в учетной записи GitHub, к которой вы хотите подключиться.

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