Подключение Кода Genie к серверам MCP

Подключите Genie Code к внешним инструментам и источникам данных с помощью протокола контекста модели (MCP). Genie Code может использовать любые серверы MCP, которые добавлены в вашу рабочую область и на использование которых у вас есть разрешение.

Замечание

Серверы MCP поддерживаются только в режиме агента кода Genie.

Что такое MCP?

MCP — это стандарт открытый код, который связывает агентов ИИ с инструментами, ресурсами, запросами и другими контекстными сведениями. MCP предоставляет стандартный способ предоставления инструментов, данных и рабочих процессов коду Genie без внедрения этого контекста непосредственно в запросы или инструкции.

MCP предназначен для случаев, когда важный контекст уже существует, но трудно получить доступ к агенту ИИ, например Genie Code. MCP предлагает безопасный способ предоставления доступа к контексту Genie Code, как показано ниже:

• Системы документации: Teams часто хранят рабочие инструкции или операционные документы в таких средствах, как Confluence. Вместо копирования разделов в запросы содержимое может быть предоставлено один раз через внешний сервер MCP и ссылаться на него при необходимости. Документы также могут находиться в Databricks в качестве векторного индекса поиска, который Genie Code может использовать для запроса соответствующих документов.
• Средства и службы: команды платформы могут поддерживать API или сценарии для установки, проверки или развертывания. MCP делает эти возможности доступными непосредственно в Genie Code.
• Источники данных: если у вас уже есть данные в Databricks, вы можете подключить Genie Code к пространству Genie, чтобы помочь вам проанализировать данные с помощью естественного языка. Для данных, хранящихся за пределами Databricks, можно обеспечить безопасный доступ к Genie Code через внешние серверы MCP.
• Пользовательские приложения: вы также можете добавить пользовательские функции, размещенные с помощью Databricks Apps. Это позволяет подключать Genie Code к собственным инструментам, рабочим процессам или интеграции, созданным специально для вас или вашей организации, все управляемые безопасно в рабочей области Databricks.

В таких случаях MCP заменяет копирование и вставку вручную на структурированный, повторно используемый подход, предоставляя необходимый контекст только тогда, когда это необходимо.

Вы можете подключить Genie Code к любым серверам MCP в рабочей области, которым у вас есть разрешение на использование. Администраторы рабочей области управляют доступными серверами, а пользователи могут выбирать из этих утвержденных источников по мере необходимости.

Дополнительные сведения о серверах MCP в Databricks и создании собственных серверов см. статью "Протокол контекста модели" (MCP) в Databricks.

Подключение к сторонним источникам данных

Это важно

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

Genie Code предоставляет встроенные соединители для распространенных корпоративных источников данных, включая Google Drive и SharePoint.

Подключение к этим источникам данных позволяет Genie Code выполнять поиск документов при ответе на вопросы. Каждый пользователь выполняет проверку подлинности по отдельности, а маркеры OAuth не передаются между пользователями.

Чтобы подключить сторонний источник данных, выполните приведенные действия.

1. В рабочей области щелкните Код Genie в правом верхнем углу, чтобы открыть чат.
2. В строке запроса щелкните на значок "Создать", иконку с плюсом.
3. Рядом с источником данных, к которому требуется подключиться, нажмите кнопку "Подключить".
4. Выполните действия для входа.

После проверки подлинности Genie Code может выполнять поиск документов при ответе на вопросы. Администраторы хранилища метаданных и владельцы подключений могут управлять или отзывать разрешения пользователей на подключение. См. раздел "Общий доступ к серверу MCP".

Замечание

Средства источника данных не всегда активируются автоматически. Если поиск документов не запускается, попробуйте явно предложить Genie Code использовать этот инструмент, например "Использовать Документы Google" или "Использовать SharePoint".

Чтобы подключить другие источники данных, вручную добавьте их в Код Genie. См. раздел "Добавление серверов MCP в код Genie" вручную.

Ограничения Google Drive

• Максимальный размер файла составляет 10 МБ.
• Поддерживаются только собственные файлы рабочей области Google (документы, листы, слайды). PDF-файлы, изображения и другие двоичные форматы не поддерживаются.
• В выходных данных агента могут появляться ошибки истечения срока действия подключения или токена. Повторно выполните аутентификацию для устранения проблемы.

ограничения SharePoint

• Максимальный размер файла составляет 10 МБ.
• Поддерживаемые типы файлов включают документы Office (.docx, .xlsx, .pptx), а также распространенные текстовые форматы, такие как .txt, .csv, .json.mdи другие. PDF-файлы, изображения и другие двоичные форматы не поддерживаются.

Добавьте серверы MCP вручную в код Genie

Чтобы подключить Genie Code к серверу MCP, добавьте его в параметры кода Genie:

1. Откройте параметры кода Genie. На панели "Код Genie Параметры.
2. В разделе "Серверы MCP" щелкните Добавление сервера.
3. Выберите серверы MCP, которые нужно добавить. Вы можете выбрать управляемые серверы MCP Databricks или внешние серверы MCP:
   • Функция каталога Unity: выберите схему для функции. Это позволяет Genie Code использовать функции для выполнения предопределенных запросов SQL.
     • Для справки по добавлению сервера GitHub MCP см. статью создание сервера GitHub MCP.
   • Векторный поиск: выберите схему для индекса. Это позволяет Genie Code запрашивать индекс векторного поиска, чтобы найти соответствующие документы.
   • Пространство Genie: выберите пространство Genie. Genie MCP вызывает Genie в качестве инструмента, что позволяет запрашивать пространство Genie для анализа данных с помощью естественного языка.
   • Внешний сервер MCP: выберите подключение каталога Unity для использования в качестве внешнего сервера MCP. Прежде чем его можно будет использовать, необходимо войти в подключение.
   • Пользовательский сервер MCP: выберите приложение Databricks для использования в качестве пользовательского сервера MCP. Это позволяет использовать любые инструменты, определенные пользователем. Применяются следующие требования:
     • Приложение должно быть развернуто в той же рабочей области, из которую вы пытаетесь подключиться к нему.
     • К серверу MCP необходимо осуществить доступ по адресу https://<server-url>/mcp.
     • Приложение должно быть без отслеживания состояния. Например, задайте mcp_app = mcp_server.http_app(stateless_http=True).
     • При возникновении ошибок CORS может потребоваться добавить URL-адрес рабочей области в список разрешенных источников приложения. Например, задайте app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Нажмите кнопку Сохранить.

После добавления серверы MCP сразу же доступны в Genie Code. Их можно начать использовать в режиме агента, не изменяя запросы или инструкции. Программный код Genie автоматически будет использовать ресурсы этих серверов в соответствующих случаях.

В настоящее время доступ MCP ограничен 20 инструментами на всех серверах. Вы можете выбрать средства и серверы для включения или отключения в параметрах кода Genie.