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

Genie Code подключается к внешним инструментам, документам и данным через серверы Model Context Protocol (MCP) и нативные коннекторы для Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack и GitHub. Используйте собственные соединители для распространенных источников SaaS или добавьте собственные внешние или настраиваемые серверы MCP из рабочей области. Вы выбираете, какие инструменты включить в настройках Genie Code.

Что такое 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 и агентские инструменты.

Использование собственных соединителей для сторонних источников данных

Genie Code предоставляет встроенные соединители для распространённых корпоративных источников данных:

  • Google Drive: Поиск и создание Google Docs, Sheets and Slides; редактирование созданной документации.
  • Gmail: Поиск, чтение и черновик письма.
  • Google Calendar: Поиск и создание событий календаря.
  • Microsoft 365: поиск в SharePoint, Teams, Outlook и Календаре; черновик письма Outlook.
  • Atlassian: Поиск и обновление Jira и Confluence.
  • Glean (бета): Выполняйте поиск по подключённым приложениям вашей организации с помощью Glean.
  • Slack: Поиск сообщений и каналов Slack, а также отправка сообщений.
  • GitHub: Поиск и обновление репозиториев, проблем и pull requests.

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

Эти соединения используют MCP-коннекторы, предоставленные Databricks, поэтому нет сервера для размещения и нет приложения OAuth для регистрации. Azure Databricks управляет каждым соединением через Unity Catalog и Unity Gateway. Шлюз авторизирует каждый вызов инструмента с разрешениями Unity Catalog, применяет встроенные политики и требования к утверждению, а также фиксирует логи использования и аудита в системных таблицах. См. Регистрировать внешний MCP-сервер.

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

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

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

Замечание

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

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

Запланированные задачи и аутентификация

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

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

  • При авторизации Google Drive вы можете увидеть страницу с сообщением "непроверенное приложение". Нажмите кнопку "Дополнительно" и продолжайте процесс авторизации.
  • Максимальный размер файла составляет 25 МБ.
  • Поддерживаются только собственные файлы рабочей области Google (документы, листы, слайды). PDF-файлы, изображения и другие двоичные форматы не поддерживаются.
  • Genie Code может создавать документы, таблицы и презентации Google, а также редактировать созданные им через коннектор документы Google. Он не может редактировать документы, созданные вне соединителя, или редактировать существующие Sheets или Slides.
  • Чтение очень крупного документа может быть медленным.

Замечание

Использование и передача необработанных или производных пользовательских данных, полученных от API Рабочей области Google, будет соответствовать политике пользовательских данных служб API Google, включая требования к ограниченному использованию.

Ограничения Gmail

  • Genie Code может искать, читать и чертить письма, но не может отправлять письма или редактировать существующие сообщения.
  • Genie Code не может добавлять файлы Drive как родные вложения Gmail. В качестве обходного пути добавьте ссылки на файлы в теле письма.

Ограничения Microsoft 365

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

Ограничения Glean (Бета)

  • Glean предназначен только для поиска. Он не может прочитать документ по прямой ссылке.
  • Администратор метамагазина должен сначала настроить идентификатор арендатора Glean, прежде чем пользователи без администратора смогут использовать соединение. Администратор может ввести идентификатор клиента при первом подключении к Glean.
  • Чтобы подключиться к конкретному серверу Glean MCP, администратор метамагазина может по желанию установить путь к MCP-серверу (например /mcp/eng, ) при настройке соединения. Оставьте это поле пустым, чтобы использовать стандартный путь (/mcp/default). Пользователи без администраторов не могут указывать или менять путь сервера Glean MCP.

Ограничения Slack

  • Genie Code не может редактировать или удалять сообщение после отправки.

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

  • Записи ограничены содержимым файлов, проблемами и pull request-запросами.
  • По умолчанию соединитель Databricks GitHub MCP может получить доступ только к общедоступным репозиториям. Чтобы предоставить соединителю доступ на чтение к вашим частным корпоративным репозиториям, администратор организации GitHub должен выполнить дополнительную настройку. См. раздел "Включить доступ к частному репозиторию".
  • GitHub Enterprise Server (локальная версия GitHub) не поддерживается.

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

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

  1. Откройте параметры кода Genie. На панели Genie Code щелкните значок шестерёнки. Настройки.
  2. В разделе "Серверы MCP" щелкните значок Добавление сервера.
  3. Выберите серверы MCP, которые нужно добавить. Вы можете выбрать управляемые серверы MCP Databricks или внешние серверы MCP:
    • Функция каталога Unity: выберите схему для функции. Это позволяет Genie Code использовать функции для выполнения предопределенных запросов SQL.
    • Поиск ИИ: выберите схему для индекса. Это позволяет 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 автоматически использует эти серверы при необходимости.

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

Ограничения

  • Last updated on