¿Qué es el espacio de nombres del conector? (versión preliminar)

Importante

Esta funcionalidad de vista previa está sujeta a los Términos de uso complementarios para las versiones preliminares de Microsoft Azure. Durante la versión preliminar, esta funcionalidad solo está disponible en Azure regiones públicas.

Al compilar soluciones que se integran con aplicaciones de software como servicio (SaaS), sistemas empresariales y plataformas de datos, normalmente tiene que escribir código de cliente de API personalizado para cada conexión o integración. También debes gestionar los flujos de autenticación, la rotación de credenciales, la lógica de reintentos, la paginación y las suscripciones a webhooks en múltiples sistemas. Estas tareas suponen una carga de desarrollo significativa y un riesgo operativo.

Connector Namespace es un servicio de integración totalmente gestionado que elimina esta complejidad. El servicio aloja un catálogo de conectores preconstruidos y reutilizables que tus soluciones pueden usar para conectarse a servicios como SharePoint, Salesforce, SAP y Outlook mediante un modelo de programación consistente. Cada conector expone operaciones como desencadenadores de eventos, acciones que completan tareas y herramientas del agente de IA a través de un modelo de conexión compartido. La solución puede invocar desencadenadores y acciones mediante SDK específicos para cada lenguaje, para C#, Node.js y Python, o a través de llamadas HTTP directas.

Un espacio de nombres del conector gestiona la infraestructura de integración subyacente encargándose de las siguientes tareas:

tarea Description
Autenticación y administración de identidades Almacene y rote las credenciales o secretos de OAuth, la clave de API y las conexiones basadas en tokens.
Sondeo y entrega de webhook Cree y administre suscripciones de eventos que insertan datos en la aplicación cuando cambian los sistemas de origen.
Reintentos, regulación y gestión de errores Configure directivas de resistencia integradas sin implementación personalizada.
Hospedaje de servidores MCP para agentes de IA Publicar conectores como servidores de Model Context Protocol (MCP) para que los agentes de IA y Copilot puedan usar servicios externos como herramientas.

En esta introducción se describe lo que puede hacer con los espacios de nombres del conector, conceptos clave, cómo funcionan los espacios de nombres del conector, aspectos de seguridad y consideraciones para la implementación durante la versión preliminar.

Note

El Espacio de Nombres de Conectores es una vía de integración para servicios de cómputo que no se ejecutan en un motor de flujos de trabajo. Los espacios de nombres del conector no requieren, usan ni cambian nada en Azure Logic Apps. La galería de conectores de Azure Logic Apps funciona de forma independiente y por separado para flujos de trabajo en Azure Logic Apps.

Qué se puede hacer con espacios de nombres del conector

Integre sus aplicaciones con cientos de servicios externos mediante un modelo de programación coherente. La siguiente tabla describe escenarios comunes en los que tu aplicación puede usar Espacio de Nombres del Conector para integrarse con otros servicios sin necesidad de código adicional:

Escenario Integración de ejemplo
Procesar documentos y contenido Una función de Azure usa las operaciones del conector de SharePoint para detectar archivos nuevos o actualizados en un servidor de SharePoint, leer y procesar los archivos, y escribir de nuevo los resultados en SharePoint.
Supervisión de eventos desde servicios externos Una aplicación de contenedor en Azure usa un desencadenador del conector de Salesforce para recibir eventos sobre nuevos clientes potenciales desde Salesforce.
Automatización de la productividad Una aplicación de Node.js usa operaciones del conector de Outlook para leer y enviar correo electrónico reutilizando una conexión que ya posee otra aplicación.
Creación y ejecución de cargas de trabajo de inteligencia artificial o agente Un servicio de Python invoca acciones del conector para fundamentar o enriquecer el resultado del modelo con datos procedentes de sistemas empresariales.
Reutilización del código de aplicación existente Los servicios de ASP.NET, Node.js y Python pueden usar integraciones gestionadas sin un motor de flujo de trabajo en la ruta de llamada.
Publicar conectores como servidores MCP administrados Convierta cualquier conector del espacio de nombres en un servidor de Protocolo de contexto de modelo (MCP) con un solo paso. El espacio de nombres controla el hospedaje, las definiciones de herramientas y la autenticación para que Copilot y otros agentes de IA puedan usar las acciones del conector como herramientas.
Implementa servidores MCP desde un catálogo seleccionado Seleccione e implemente servidores MCP listos para usar en el espacio de nombres del conector. Puede controlar la configuración del servidor, mientras que el espacio de nombres controla la implementación, el escalado y las credenciales, no hay ninguna infraestructura que pueda administrar.

Conceptos clave

En la siguiente tabla se describen los conceptos fundamentales que debe comprender cuando trabaje con espacios de nombres de conectores:

Concepto Description
Espacio de nombres del conector El recurso Azure que hospeda el entorno de ejecución del conector y controla las siguientes tareas:

- Cargue y ejecute operaciones del conector.
- Mantener el estado de conexión y las credenciales.
- Sondee los servicios y sistemas de origen. Distribuya eventos de webhook.
- Aplicar directivas de reintento, limitación y diagnóstico.

Puede crear un espacio de nombres de conector mediante el portal de Azure, Azure Resource Manager (ARM), las plantillas de Bicep o la CLI de Azure. A continuación, vinculas las conexiones y usas conectores desde tus aplicaciones.
Conector Un componente creado previamente para integrar un servicio específico, como SharePoint, Salesforce, SAP y Outlook. Un conector abstrae la API del servicio subyacente, el protocolo de autenticación, la paginación y el comportamiento de reintento para que el código permanezca centrado en la lógica de negocios.

Cada conector expone una interfaz tipada para las siguientes operaciones:

- Desencadenador: una operación de suscripción de eventos que la aplicación registra en un conector. Por ejemplo, cuando llega un nuevo correo electrónico, cuando se actualiza un registro o cuando se agrega un archivo a una carpeta. Cuando el servicio de origen o el sistema genera un evento, el espacio de nombres del conector envía la carga a la aplicación.

--- Cada conector define sus desencadenadores independientemente de cualquier aplicación específica.

--- varias aplicaciones pueden suscribirse al mismo evento de desencadenador mediante la misma conexión.

--- El espacio de nombres del conector administra las programaciones de sondeos y el registro de webhooks en su nombre, en función de lo que admita el servicio subyacente.

- Acción: una operación a la que llama la aplicación. Por ejemplo, envíe un mensaje, lea una fila o cargue un archivo.
Connection Enlace autenticado y configurado a una cuenta o inquilino externo. Puede reutilizar las conexiones, lo que significa que varias aplicaciones y conectores pueden compartir la misma conexión. Tipos de autenticación de conexión admitidos:

- OAuth
- Clave de API
- Básico
Servidor MCP Un recurso de primera clase que expone herramientas que los agentes de IA pueden usar a través del Protocolo de contexto de modelo (MCP). Los espacios de nombres de conectores soportan los siguientes tipos de servidores MCP, que están alojados por el Espacio de Nombres de Conectores:

- Administrado: servidores y conectores que crea y configura el espacio de nombres del conector. Puede implementar un servidor administrado o un conector como un servidor MCP. Solo tiene que autenticar la conexión subyacente. El espacio de nombres del conector controla la configuración del servidor, las definiciones de herramientas, el ciclo de vida y el tiempo de ejecución.

- Hospedado: servidores MCP creados previamente desde un catálogo mantenido que usted elige, configura e implementa en el espacio de nombres del conector. Mantiene el control sobre la configuración del servidor, el entorno y los parámetros. El espacio de nombres del conector controla el hospedaje, el escalado y las credenciales.

En ambos casos, los agentes de inteligencia artificial, como Copilot, agentes personalizados o cualquier cliente compatible con MCP, pueden detectar y llamar a herramientas mediante el modelo de conexión del espacio de nombres. Puede habilitar, deshabilitar o rotar servidores MCP independientemente de la conexión subyacente.
SDK de conectores SDK fuertemente tipados que incorporan espacios de nombres del conector, para que usted pueda llamar a los conectores mediante expresiones estándar en su idioma:

- C#: Azure. Connectors.Sdk en NuGet, con el servicio de lenguaje Visual Studio Code para IntelliSense, finalizaciones y CodeLens.

- Node.js: @azure/connectors, que es un cliente con TypeScript como prioridad y con invocación de acciones mediante async-await.

- Python: azure-connectors, que se alinea con SDK de Azure para las convenciones de Python.

Cada SDK expone el mismo catálogo, modelo de conexión, telemetría coherente y semántica de reintento.

Nota: Si un SDK tipado no es adecuado, puede llamar a los conectores a través de HTTP.

Cómo trabajar con espacios de nombres del conector

En las secciones siguientes se describe el proceso de alto nivel para empezar a integrar conectores o servidores MCP con la aplicación.

Pasos típicos para integrar conectores con la aplicación

Los siguientes pasos generales describen una manera típica de empezar a usar conectores con la aplicación:

  1. En su suscripción de Azure, cree un recurso del espacio de nombres del conector.

  2. Cree una o varias conexiones a los servicios que desea integrar.

    Por ejemplo, supongamos que crea una conexión de OAuth para Microsoft 365 o una conexión de clave de API a un servicio externo. En los pasos siguientes se describe lo que sucede entre la aplicación y el espacio de nombres del conector.

    1. La aplicación, que se ejecuta en Functions, Container Apps, App Service u otro servicio de proceso, hace referencia al espacio de nombres y a la conexión a través de un SDK de conector.

    2. Su aplicación se suscribe a desencadenadores del conector o llama a acciones del conector.

      Las llamadas a las acciones del conector se ejecutan de forma sincrónica. La entrega del desencadenador utiliza webhooks o suscripciones basadas en la extracción, en función del conector y del servicio de origen.

    3. Su espacio de nombres controla la autenticación, la firma de solicitudes, el sondeo, la suscripción a webhooks y los reintentos.

    4. Su aplicación recibe respuestas tipadas y cargas de eventos.

Pasos típicos para integrar servidores MCP con la aplicación

Los siguientes pasos generales describen una forma típica de empezar a usar servidores MCP con tu app:

  1. En su suscripción de Azure, cree un recurso del espacio de nombres del conector.

  2. En el catálogo, agregue un servidor MCP al espacio de nombres del conector.

    Puede agregar un servidor MCP administrado o un servidor MCP hospedado.

  3. Autentique la conexión subyacente. Configure los requisitos de configuración específicos del servidor.

    • El espacio de nombres del conector publica el punto de conexión del servidor MCP y ejecuta el servidor. El espacio de nombres gestiona la autenticación, el escalado y la rotación de credenciales.
    • Los agentes de IA, como Copilot, agentes personalizados o cualquier cliente compatible con MCP, pueden encontrar el servidor MCP, leer su catálogo de herramientas e invocar herramientas utilizando la conexión configurada.

Dónde puede utilizar espacios de nombres del conector

En esta sección se describen las formas en que la aplicación puede usar los espacios de nombres del conector y las operaciones del conector para la integración.

  • Los espacios de nombres del conector admiten los siguientes servicios de proceso Azure en los que la aplicación puede usar las operaciones de conector disponibles:

    • Azure App Service
    • Azure Container Apps (Aplicaciones de Contenedores de Azure)
    • Funciones de Azure

  • Cualquier servicio de proceso autohospedado puede usar conectores mediante un espacio de nombres para conectores.

    Por ejemplo, estos servicios autohospedados incluyen ASP.NET, Node.jso Python en Azure Kubernetes o Azure Virtual Machines.

  • Los agentes de inteligencia artificial, las extensiones de Copilot y los clientes compatibles con el servidor MCP pueden encontrar e invocar herramientas para los servidores MCP hospedados en el espacio de nombres del conector, todo ello sin pasar por una capa de proceso independiente.

    Tus aplicaciones pueden usar estas herramientas de IA y de agentes que interactúan con sistemas conectados y servicios externos utilizando los puntos de conexión de los servidores MCP implementados en el espacio de nombres de tu conector. No necesita ningún código de cliente de API ni contenedores de herramientas personalizados. El espacio de nombres del conector proporciona y administra la capacidad de cómputo subyacente para ejecutar servidores, por lo que no tiene que aportar su propia infraestructura.

Seguridad y gobernanza

  • Deje la administración de credenciales al espacio de nombres del conector, que almacena, administra y renueva las credenciales de conexión en su nombre. La aplicación nunca controla credenciales sin procesar.

  • Restrinja el acceso de red mediante la integración de redes virtuales y los puntos de conexión privados en el espacio de nombres del conector.

  • Controlar quién puede crear conexiones, registrar desencadenadores e invocar acciones mediante el control de acceso basado en rol (RBAC) en el espacio de nombres del conector.

  • Para permitir la trazabilidad de extremo a extremo en el espacio de nombres del conector y los servicios de computación, los registros de diagnóstico y los identificadores de correlación se envían a Azure Monitor.

Pricing

La fijación de precios de espacios de nombres de conectores utiliza un modelo de consumo. Los cargos por la ejecución de acciones de los conectores varían según el tipo de conector. La siguiente tabla explica cómo se mide cada componente en un espacio de nombres de conectores:

Capability Medición
Connectors Por acción del conector
Triggers Por acción del disparador
Conectores MCP gestionados Por llamada de herramienta
Conectores MCP configurables Por cada llamada a herramienta
Retención de datos Por GB al mes

Las tarifas por unidad de conectores se publican bajo Precios de conectores en la página de precios de Azure Logic Apps.

Las llamadas a herramientas de conector MCP se miden en función de las llamadas a acciones subyacentes del conector.

Note

La facturación de los servidores MCP alojados no está activada durante la vista previa. Microsoft avisa con antelación antes de que empiece la facturación de esta funcionalidad.

Consideraciones y limitaciones

Mientras Connector Namespace está en vista previa, revisa las siguientes consideraciones si planeas un despliegue durante la previsualización:

Consideración Description
No hay acuerdo de nivel de servicio (SLA) para la vista previa Actualmente no se recomienda Connector Namespace (vista previa) para cargas de trabajo en producción.
Disponibilidad en regiones La compatibilidad con regiones es limitada actualmente, pero se ampliará con el tiempo.
Cobertura del conector Los conectores estándar y los de uso más frecuente están disponibles primero, mientras que los conectores empresariales, como SAP, IBM MQ y Oracle Database, llegarán en fases posteriores.
Identidad Actualmente se admiten la clave de API y las conexiones OAuth. La compatibilidad con la identidad administrada para las conexiones estará disponible más adelante, pero está prevista antes para determinados servidores MCP.
Control de versiones Las versiones del SDK y del entorno de ejecución del espacio de nombres se combinan durante la versión preliminar. Espere cambios importantes entre hitos de versión preliminar.

Contenido relacionado

  • Last updated on