Что такое пространство имён Connector? (предварительная версия)

Important

На эту предварительную версию распространяются Дополнительные условия использования предварительных версий Microsoft Azure. Во время предварительной версии эта возможность доступна только в Azure общедоступных регионах.

При создании решений, которые интегрируются с приложениями SaaS, бизнес-системами и платформами данных программного обеспечения как услуга, обычно необходимо написать пользовательский код клиента API для каждого подключения или интеграции. Также необходимо управлять процессами аутентификации, ротацией учетных данных, логикой повторного тестирования, страницированием и подписками на webhook на разных системах. Эти задачи добавляют значительные накладные расходы на развитие и операционные риски.

Connector Namespace — это полностью управляемый сервис интеграции, который устраняет эту сложность. Сервис содержит каталог готовых, многоразовых коннекторов, которые ваши решения могут использовать для подключения к таким сервисам, как SharePoint, Salesforce, SAP и Outlook, используя единую модель программирования. Каждый коннектор предоставляет доступ к таким операциям, как триггеры событий, действия для выполнения задач и инструменты ИИ-агента в рамках общей модели подключения. Решение может вызывать триггеры и действия с помощью наборов средств разработки программного обеспечения для C#, Node.jsи Python или через прямые HTTP-вызовы.

Пространство имен соединителя управляет базовой инфраструктурой интеграции, обрабатывая следующие задачи:

задачи Description
Управление проверкой подлинности и учетными данными Храните и регулярно обновляйте учетные данные или секреты для OAuth, API-ключей и подключений с использованием токенов.
Опрос и доставка вебхуков Создавайте подписки на события и управляйте ими, которые помещают данные в приложение при изменении исходных систем.
Повторная попытка, регулирование и обработка ошибок Настройте встроенные политики устойчивости без пользовательской реализации.
Размещение сервера MCP для агентов ИИ Опубликуйте соединители в качестве серверов протокола MCP, чтобы агенты ИИ и Copilot могли вызывать внешние службы в качестве инструментов.

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

Note

Connector Namespace — это путь интеграции вычислительных сервисов, которые не работают на движке рабочих процессов. Пространства имён соединителей не требуют, не используют и не изменяют ничего в Azure Logic Apps. Коллекция соединителей в Azure Logic Apps работает независимо и отдельно для рабочих процессов в Azure Logic Apps.

Что можно сделать с пространствами имен соединителя

Интеграция приложений с сотнями внешних служб с помощью согласованной модели программирования. В следующей таблице описаны распространённые сценарии, когда ваше приложение может использовать пространство имён Connector для интеграции с другими сервисами без дополнительного кода:

Сценарий Пример интеграции
Обработка документов и содержимого Функция Azure использует операции соединителя SharePoint для обнаружения новых или обновленных файлов на сервере SharePoint, считывания и обработки файлов и записи результатов обратно в SharePoint.
Отслеживайте события из внешних служб Приложение-контейнер Azure использует триггер соединителя Salesforce для получения событий о новых потенциальных клиентах из Salesforce.
Автоматизация производительности Приложение Node.js использует операции соединителя Outlook для чтения и отправки электронной почты, повторно используя подключение, которое уже принадлежит другому приложению.
Создание и запуск ИИ или агентических рабочих нагрузок Python-сервис вызывает действия коннектора, чтобы привязать или обогатить выходные данные модели данными из бизнес-систем.
Повторное использование существующего кода приложения ASP.NET, Node.jsи службы Python могут использовать управляемые интеграции без обработчика рабочих процессов в пути вызова.
Публикация соединителей в качестве управляемых серверов MCP Преобразуйте любой коннектор из вашего пространства имён в сервер Model Context Protocol (MCP) за один шаг. Пространство имён отвечает за хостинг, определения инструментов и аутентификацию, благодаря чему Copilot и другие ИИ-агенты могут вызывать действия соединителя как инструменты.
Разверните серверы MCP из подобранного каталога Выберите и разверните готовые серверы MCP в пространстве имен коннектора. Вы управляете конфигурацией сервера, а пространство имен обрабатывает развертывание, масштабирование и учетные данные — инфраструктура для управления не требуется.

Ключевые понятия

В следующей таблице описываются основные понятия, которые необходимо понять при работе с пространствами имен соединителя:

Концепция Description
Пространство имен коннектора Ресурс Azure, на котором размещается среда выполнения соединителя, и обрабатывает следующие задачи:

— Загрузка и запуск операций соединителя.
— поддержание состояния подключения и учетных данных.
— опрашивайте исходные службы и системы. Отправить события вебхука.
— Примените политики повторных попыток, ограничения скорости и диагностики.

Пространство имен соединителя можно создать с помощью портала Azure, шаблонов Azure Resource Manager (ARM) и Bicep или Azure CLI. Затем вы связываете подключения и используете коннекторы в своих приложениях.
Connector Предварительно созданный компонент для интеграции определенной службы, например SharePoint, Salesforce, SAP и Outlook. Соединитель абстрагирует API базовой службы, протокол проверки подлинности, разбивку на страницы и поведение повторных попыток, чтобы код оставался сосредоточен на бизнес-логике.

Каждый соединитель предоставляет типизированные поверхности для следующих операций:

- Триггер: операция подписки на события, регистрируемая приложением в соединителе. Например, при поступлении нового сообщения электронной почты при обновлении записи или при добавлении файла в папку. Когда исходная служба или система генерирует событие, пространство имён соединителя передаёт полезную нагрузку вашему приложению.

--- каждый соединитель определяет его триггеры независимо от любого конкретного приложения.

--- несколько приложений могут подписаться на одно и то же событие триггера с помощью одного подключения.

--- Пространство имен коннектора управляет расписаниями опроса и регистрацией вебхуков от вашего имени в зависимости от возможностей базовой службы.

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

-Oauth
— ключ API
-Основные
Сервер MCP Ресурс первого класса, предоставляющий средства, которые агенты ИИ могут использовать с помощью протокола контекста модели (MCP). Пространства имён коннекторов поддерживают следующие типы MCP-серверов, которые размещаются в Connector Namespace:

- Управляемые: серверы и коннекторы, которые создаются и настраиваются пространством имён коннектора. Управляемый сервер или соединитель можно развернуть как сервер MCP. Вам нужно аутентифицировать только основное соединение. Пространство имён соединителя управляет конфигурацией сервера, определениями инструментов, жизненным циклом и средой выполнения.

- Размещаемые: готовые серверы MCP из курируемого каталога, которые вы выбираете, настраиваете и развёртываете в пространстве имён коннектора. Вы сохраняете контроль над параметрами сервера, средой и параметрами. Пространство имён коннектора отвечает за размещение, масштабирование и учётные данные.

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

— C#: Azure.Connectors.Sdk в NuGet с языковой службой Visual Studio Code для IntelliSense, автодополнения и CodeLens.

— Node.js: @azure/connectors, клиент, ориентированный в первую очередь на TypeScript, с вызовом действий через async-await.

— Python: azure-connectors, который соответствует соглашениям, принятым в Azure SDK для Python.

Каждый пакет SDK предоставляет один каталог, модель подключения, согласованную семантику телеметрии и семантику повторных попыток.

Примечание. Если типизированный пакет SDK не подходит, можно вызвать соединители по протоколу HTTP.

Как работать с пространствами имен соединителя

В следующих разделах описывается высокоуровневый процесс интеграции соединителей или серверов MCP с приложением.

Типичные шаги по интеграции соединителей с приложением

Следующие высокоуровневые шаги описывают типичный способ начать использование соединителей с приложением:

  1. В подписке Azure создайте ресурс пространства имен коннектора.

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

    Например, предположим, что вы создаете подключение OAuth к Microsoft 365 или подключение с ключом API к внешней службе. Следующие шаги описывают, что происходит между вашим приложением и пространством имён соединителя.

    1. Ваше приложение, которое работает в Functions, Container Apps, App Service или другой вычислительной службе, обращается к пространству имён и строке подключения через Connector SDK.

    2. Ваше приложение подписывается на триггеры коннектора или вызывает действия коннектора.

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

    3. Ваше пространство имён отвечает за аутентификацию, подписание запросов, опрос, подписку на вебхуки и повторные попытки.

    4. Ваше приложение получает типизированные ответы и полезную нагрузку событий.

Типичные шаги по интеграции серверов MCP с приложением

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

  1. В подписке Azure создайте ресурс пространства имен коннектора.

  2. В каталоге добавьте сервер MCP в пространство имен соединителя.

    Вы можете добавить управляемый сервер MCP или размещенный сервер MCP.

  3. Проверка подлинности базового подключения. Настройте все требования к конфигурации для конкретного сервера.

    • Пространство имён вашего коннектора публикует конечную точку для MCP-сервера и запускает сервер. Пространство имён отвечает за аутентификацию, масштабирование и ротацию учетных данных.
    • ИИ-агенты, такие как Copilot, пользовательские агенты или любой клиент с поддержкой MCP, могут найти MCP-сервер, прочитать его каталог инструментов и вызывать инструменты через настроенное подключение.

Где можно использовать пространства имён коннектора

В этом разделе описываются способы, которыми ваше приложение может использовать пространства имен соединителя и операции соединителя для интеграции.

  • Пространства имён соединителей поддерживают следующие вычислительные службы Azure, где ваше приложение может использовать доступные операции соединителей:

    • Служба приложений Azure
    • Приложения-контейнеры Azure
    • Функции Azure
  • Любая самостоятельно размещаемая вычислительная служба может использовать коннекторы через пространство имён коннектора.

    Например, эти локальные службы включают ASP.NET, Node.jsили Python на Azure Kubernetes или Виртуальные машины Azure.

  • Агенты ИИ, расширения Copilot и клиенты с поддержкой сервера MCP могут находить и вызывать средства для серверов MCP, размещенных в пространстве имен соединителя, — все без прохождения отдельного уровня вычислений.

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

Безопасность и управление

  • Поручите управление учетными данными пространству имён коннектора, которое хранит, управляет и ротирует учетные данные подключения. Приложение никогда не обрабатывает необработанные учетные данные.

  • Ограничьте сетевой доступ с помощью интеграции с виртуальной сетью и частных конечных точек для пространства имен соединителя.

  • Контролируйте, кто может создавать подключения, регистрировать триггеры и вызывать действия, с помощью ролевого управления доступом (RBAC) в пространстве имён вашего соединителя.

  • Для поддержки сквозной трассировки в пространстве имён соединителя и вычислительных службах журналы диагностики и идентификаторы корреляции передаются в Azure Monitor.

Pricing

Ценообразование пространства имён соединяющих использует модель потребления. Плата за выполнение действия разъёма варьируется в зависимости от типа разъёма. Следующая таблица объясняет, как каждый компонент в пространстве имён разъёмов измеряется:

Capability Замер экспозиции
Соединители Действие каждого разъёма
Triggers Для каждого действия триггера
Управляемые MCP-разъёмы За вызов инструмента
Настраиваемые MCP-разъёмы За вызов инструмента
Хранение данных За ГБ в месяц

Тарифы Connector за единицу публикуются в разделе Connector pricingна странице ценообразования Azure Logic Apps.

Вызовы инструментов-коннекторов MCP тарифицируются на основе вызовов действий базового коннектора.

Note

Выставление счетов за размещённые MCP-серверы не включено во время предварительного просмотра. Microsoft предоставляет уведомление перед началом выставления счетов по этой возможности.

Рекомендации и ограничения

Пока Connector Namespace находится в предварительном просмотре, обратите внимание на следующие моменты, если планируете развертывание во время предварительного просмотра:

Соображение Description
Нет соглашения об уровне обслуживания (SLA) для предварительного просмотра Пространство имен Connector (предварительная версия) в настоящее время не рекомендуется для промышленных рабочих нагрузок.
Доступность по регионам Поддержка регионов в настоящее время ограничена, но расширяется с течением времени.
Покрытие соединителя Высокопроизводительные и стандартные соединители доступны в первую очередь, в то время как корпоративные соединители, такие как SAP, IBM MQ и Oracle Database, следуют более поздним волнам.
Идентичность В настоящее время поддерживаются ключ API и подключения OAuth. Поддержка управляемой идентификации для подключений появится позже, но для некоторых серверов MCP она запланирована раньше.
Versioning Версии среды выполнения sdk и пространства имен объединяются во время предварительной версии. Ожидайте критические изменения между вехами предварительной версии.