Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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 с приложением.
Типичные шаги по интеграции соединителей с приложением
Следующие высокоуровневые шаги описывают типичный способ начать использование соединителей с приложением:
В подписке Azure создайте ресурс пространства имен коннектора.
Создайте одно или несколько подключений к службам, которые требуется интегрировать.
Например, предположим, что вы создаете подключение OAuth к Microsoft 365 или подключение с ключом API к внешней службе. Следующие шаги описывают, что происходит между вашим приложением и пространством имён соединителя.
Ваше приложение, которое работает в Functions, Container Apps, App Service или другой вычислительной службе, обращается к пространству имён и строке подключения через Connector SDK.
Ваше приложение подписывается на триггеры коннектора или вызывает действия коннектора.
Вызовы действий соединителя выполняются синхронно. Для доставки триггеров используются вебхуки или подписки с опросом в зависимости от соединителя и исходной службы.
Ваше пространство имён отвечает за аутентификацию, подписание запросов, опрос, подписку на вебхуки и повторные попытки.
Ваше приложение получает типизированные ответы и полезную нагрузку событий.
Типичные шаги по интеграции серверов MCP с приложением
Следующие высокоуровневые шаги описывают типичный способ начала использования MCP-серверов с вашим приложением:
В подписке Azure создайте ресурс пространства имен коннектора.
В каталоге добавьте сервер MCP в пространство имен соединителя.
Вы можете добавить управляемый сервер MCP или размещенный сервер MCP.
Проверка подлинности базового подключения. Настройте все требования к конфигурации для конкретного сервера.
- Пространство имён вашего коннектора публикует конечную точку для 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 и пространства имен объединяются во время предварительной версии. Ожидайте критические изменения между вехами предварительной версии. |
Связанные материалы
- Краткое руководство: создание пространств имён коннектора для интеграции
- Создать многократно используемые подключения в пространствах имён коннектора для интеграции
- Узнайте о размещенных серверах MCP и о том, как они отличаются от управляемых серверов MCP.
- Добавьте размещенный сервер MCP из каталога и настройте его для вашего сценария.