O que é o Espaço de Nomes do Conector? (pré-visualização)

Importante

Esta capacidade de pré-visualização está sujeita aos Termos de Utilização Suplementares para Microsoft Azure Pré-visualizações. Durante a pré-visualização, esta funcionalidade só está disponível nas regiões públicas do Azure.

Quando constrói soluções que integram aplicações de Software como Serviço (SaaS), sistemas empresariais e plataformas de dados, normalmente é necessário escrever código cliente personalizado para cada ligação ou integração. Deve também gerir fluxos de autenticação, rotação de credenciais, lógica de repetição, paginação e subscrições de webhook em vários sistemas. Estas tarefas acrescentam custos significativos de desenvolvimento e risco operacional.

O Connector Namespace é um serviço de integração totalmente gerido que elimina esta complexidade. O serviço aloja um catálogo de conectores pré-construídos e reutilizáveis que as suas soluções podem usar para se ligar a serviços como SharePoint, Salesforce, SAP e Outlook através de um modelo de programação consistente. Cada conector expõe operações como gatilhos de eventos, ações que completam tarefas e ferramentas de agentes de IA através de um modelo de ligação partilhada. A sua solução pode chamar gatilhos e ações utilizando kits de desenvolvimento de software (SDKs) específicos de cada linguagem para C#, Node.jse Python, ou através de chamadas HTTP diretas.

Um namespace de conectores gere a infraestrutura de integração subjacente ao tratar das seguintes tarefas:

Tarefa Description
Autenticação e gerenciamento de credenciais Armazene e rode credenciais ou segredos para OAuth, chave API e ligações baseadas em tokens.
Sondagens e entrega por webhook Crie e gere subscrições de eventos que enviem dados para a sua aplicação quando os sistemas de origem mudam.
Retentar, limitação e gestão de erros Configure políticas de resiliência incorporadas sem implementação personalizada.
Alojamento de servidores MCP para agentes de IA Publicar conectores como servidores Model Context Protocol (MCP) para que agentes de IA e Copilot possam chamar serviços externos como ferramentas.

Esta visão geral descreve o que pode fazer com namespaces de conectores, conceitos-chave, como funcionam os namespaces de conectores, aspetos de segurança e considerações para a implementação durante a pré-visualização.

Note

O namespace do conector é uma via de integração para serviços de computação que não são executados num motor de fluxo de trabalho. Os namespaces de conectores não exigem, usam nem alteram nada no Azure Logic Apps. A galeria de conectores no Azure Logic Apps funciona de forma independente e separada para fluxos de trabalho no Azure Logic Apps.

O que pode fazer utilizando os espaços de nomes dos conectores

Integre as suas aplicações com centenas de serviços externos utilizando um modelo de programação consistente. A tabela seguinte descreve cenários comuns em que a sua aplicação pode usar o Espaço de Nomes do Conector para integrar-se com outros serviços sem código adicional:

Scenario Exemplo de integração
Documentos e conteúdos de processo Uma função do Azure utiliza operações do conector SharePoint para detetar ficheiros novos ou atualizados num servidor SharePoint, ler e processar os ficheiros, e gravar os resultados de volta no SharePoint.
Monitorizar eventos de serviços externos Uma aplicação de contentores do Azure utiliza um gatilho do conector Salesforce para receber eventos sobre novos leads do Salesforce.
Automatizar a produtividade Uma aplicação Node.js utiliza operações do conector do Outlook para ler e enviar mensagens de correio eletrónico, reutilizando uma ligação que já pertence a outra aplicação.
Criar e executar cargas de trabalho de IA ou agentes Um serviço em Python chama ações do conector para fundamentar ou enriquecer a saída do modelo com dados de sistemas de negócio.
Reutilizar código de aplicação existente Os serviços ASP.NET, Node.jse Python podem usar integrações geridas sem um motor de workflow no caminho da chamada.
Publicar conectores como servidores MCP geridos Converta qualquer conector do seu namespace para um servidor Model Context Protocol (MCP) com um único passo. O seu espaço de nomes assegura o alojamento, as definições das ferramentas e a autenticação para que o Copilot e outros agentes de IA possam invocar ações do conector como ferramentas.
Implemente servidores MCP a partir de um catálogo selecionado Selecione e implemente servidores MCP prontos a utilizar no espaço de nomes do seu conector. Controlas a configuração do servidor, enquanto o namespace trata da implementação, escalabilidade e credenciais – não há infraestrutura para gerires.

Conceitos-chave

A tabela seguinte descreve os conceitos fundamentais que deve compreender ao trabalhar com espaços de nomes de conectores:

Conceito Description
Espaço de nomes de conectores O recurso do Azure que hospeda o runtime do conector e gere as seguintes tarefas:

- Carregar e executar operações de conectores.
- Manter o estado da ligação e as credenciais.
- Serviços e sistemas de sondagem fonte. Enviar eventos de webhook.
- Aplicar políticas de repetição, limitação e diagnóstico.

Pode criar um namespace de conectores usando o portal Azure, os templates Azure Resource Manager (ARM) e Bicep, ou CLI do Azure. Depois atribuis ligações e consomes os conectores das tuas aplicações.
Connector Um componente pré-construído para integrar um serviço específico, como SharePoint, Salesforce, SAP e Outlook. Um conector abstrai a API, o protocolo de autenticação, a paginação e o comportamento de retentativa do serviço subjacente, para que o seu código se mantenha focado na lógica de negócio.

Cada conector expõe uma superfície tipada para as seguintes operações:

- Trigger: Uma operação de subscrição de evento que a sua aplicação regista num conector. Por exemplo, quando chega um novo email, quando um registo é atualizado ou quando um ficheiro é adicionado a uma pasta. Quando o serviço de origem ou sistema gera um evento, o espaço de nomes do seu conector envia o payload para a sua aplicação.

--- Cada conector define os seus gatilhos independentemente de qualquer aplicação específica.

--- Várias aplicações podem subscrever o mesmo evento acionador usando a mesma ligação.

--- O namespace do seu conector gere os agendamentos de polling e o registo do webhook por si, com base no que o serviço subjacente suporta.

- Ação: Uma operação que a sua aplicação chama. Por exemplo, enviar uma mensagem, ler uma linha ou carregar um ficheiro.
Connection Uma vinculação autenticada e configurada a uma conta ou tenant externo. Podes reutilizar ligações, o que significa que várias aplicações e conectores podem partilhar a mesma ligação. Tipos de autenticação de ligação suportados:

- OAuth
- Chave de API
- Básico
Servidor MCP Um recurso de primeira classe que expõe ferramentas que os agentes de IA podem usar através do Model Context Protocol (MCP). Os namespaces de conectores suportam os seguintes tipos de servidores MCP, que são alojados pelo Espaço de Nomes de Conectores:

- Geridos: Servidores e conectores que o namespace do conector cria e configura. Pode implementar um servidor ou conector gerido como servidor MCP. Só precisas de autenticar a ligação subjacente. O seu espaço de nomes de conectores trata da configuração do servidor, definições de ferramentas, ciclo de vida e tempo de execução.

- Hospedado: Servidores MCP pré-criados de um catálogo curado que pode escolher, configurar e implementar no espaço de nomes do seu conector. Manténs o controlo sobre as definições do servidor, o ambiente e os parâmetros. O seu espaço de nomes de conectores trata do alojamento, escalabilidade e credenciais.

Em ambos os casos, agentes de IA como o Copilot, agentes personalizados ou quaisquer clientes conscientes do MCP, podem detetar e chamar ferramentas usando o modelo de ligação do namespace. Pode ativar, desativar ou rodar servidores MCP independentemente da ligação subjacente.
SDKs de Conectores SDKs com tipagem forte que incluem namespaces de conectores para poder chamar conectores usando as convenções padrão da linguagem:

- C#: Azure. Connectors.Sdk no NuGet, com o serviço de linguagem Visual Studio Code para IntelliSense, completions e CodeLens.

- Node.js: @azure/connectors, que é um cliente concebido primariamente para TypeScript com invocação de ações com async/await.

- Python: azure-connectors, que está alinhado com as convenções do SDK do Azure para Python.

Cada SDK expõe o mesmo catálogo, modelo de ligação, telemetria consistente e política de repetição.

Nota: Se um SDK tipado não for adequado, pode chamar os conectores através de HTTP.

Como trabalhar com namespaces de conectores

As secções seguintes descrevem o processo de alto nível para começar a integrar conectores ou servidores MCP com a sua aplicação.

Passos típicos para integrar conectores com a sua aplicação

Os seguintes passos gerais descrevem uma forma típica de começar a usar conectores com a sua aplicação:

  1. Na sua subscrição do Azure, crie um recurso de namespace de conectores.

  2. Crie uma ou mais ligações aos serviços que pretende integrar.

    Por exemplo, suponha que cria uma ligação OAuth para o Microsoft 365 ou uma ligação de chave API para um serviço externo. Os passos seguintes descrevem o que acontece entre a sua aplicação e o namespace do seu conector.

    1. A sua aplicação, que corre em Functions, Container Apps, App Service ou outro serviço de computação, faz referência ao namespace e à ligação através de um Connector SDK.

    2. A sua aplicação subscreve os gatilhos do conector ou chama ações do conector.

      As chamadas para ações de conector são executadas de forma síncrona. A entrega de gatilhos utiliza webhooks ou subscrições baseadas em pull, baseadas no conector e no serviço de origem.

    3. O seu espaço de nomes trata da autenticação, da assinatura de pedidos, da consulta periódica, da subscrição de webhooks e das novas tentativas.

    4. A sua aplicação recebe respostas digitadas e payloads de eventos.

Passos típicos para integrar servidores MCP com a sua aplicação

Os seguintes passos gerais descrevem uma forma típica de começar a usar servidores MCP com a sua aplicação:

  1. Na sua subscrição do Azure, crie um recurso de namespace de conectores.

  2. A partir do catálogo, adicione um servidor MCP ao espaço de nomes do seu conector.

    Pode adicionar um servidor MCP gerido ou um servidor MCP alojado.

  3. Autentica a ligação subjacente. Configure quaisquer requisitos de configuração específicos do servidor.

    • O namespace do teu conector publica o endpoint para o servidor MCP e executa o servidor. O namespace trata da autenticação, escalonamento e rotação de credenciais.
    • Agentes de IA, como Copilot, agentes personalizados ou qualquer cliente consciente do MCP, podem encontrar o servidor MCP, ler o seu catálogo de ferramentas e invocar ferramentas usando a ligação configurada.

Onde pode usar namespaces de conectores

Esta secção descreve formas como a sua aplicação pode usar namespaces e operações de conectores para integração.

  • Os namespaces de conectores suportam os seguintes serviços de computação do Azure onde a sua aplicação pode usar as operações de conectores disponíveis:

    • Serviço de Aplicações do Azure
    • Azure Container Apps
    • Funções do Azure

  • Qualquer serviço de computação autoalojado pode utilizar conectores por meio de um namespace de conectores.

    Por exemplo, estes serviços auto-hospedados incluem ASP.NET, Node.jsou Python no Azure Kubernetes ou Máquinas Virtuais do Azure.

  • Agentes de IA, extensões do Copilot e clientes com reconhecimento do servidor MCP podem encontrar e invocar ferramentas para servidores MCP alojados no espaço de nomes do seu conector — tudo isto sem passarem por uma camada de computação separada.

    As suas aplicações podem utilizar estas ferramentas de IA e agênticas que interagem com sistemas conectados e serviços externos, utilizando os endpoints dos servidores MCP implementados no namespace do seu conector. Não precisas de código cliente API personalizado ou envolventes de ferramentas. O espaço de nomes do seu conector disponibiliza e gere a capacidade de computação subjacente necessária para executar servidores, pelo que não precisa de fornecer a sua própria infraestrutura.

Segurança e governação

  • Deixe a gestão das credenciais a cargo do namespace do seu conector, que armazena, gere e faz a rotação das credenciais de ligação por si. A tua aplicação nunca gere credenciais brutas.

  • Restrinja o acesso à rede utilizando a integração com rede virtual e pontos finais privados no espaço de nomes do conector.

  • Controla quem pode criar ligações, registar gatilhos e invocar ações usando controlo de acesso baseado em funções (RBAC) no espaço de nomes do teu conector.

  • Para suportar o rastreio de ponta a ponta em todo o namespace do seu conector e os serviços de processamento, os registos de diagnóstico e os identificadores de correlação são enviados para o Azure Monitor.

Pricing

Os preços do espaço de nomes do conector baseiam-se num modelo de consumo. As taxas para execuções de ação do conector variam consoante o tipo de conector. A tabela seguinte explica como cada componente num namespace de conectores é medido:

Capability Medição
Conectores Por ação do conector
Triggers Por ação de acionamento
Conectores MCP geridos Por chamada da ferramenta
Conectores MCP configuráveis Por chamada à ferramenta
Retenção de dados Por GB por mês

As tarifas por unidade dos conectores são publicadas na rubrica Preços dos Conectores na página de preços do Azure Logic Apps.

As chamadas às ferramentas do conector MCP são medidas com base nas chamadas de ação do conector subjacente.

Note

A faturação dos servidores MCP alojados não está ativada durante a pré-visualização. A Microsoft fornece aviso antes do início da faturação para esta funcionalidade.

Considerações e limitações

Enquanto o Espaço de Nomes do Conector estiver em pré-visualização, reveja as seguintes considerações se estiver a planear uma implementação durante a pré-visualização:

Consideração Description
Sem acordo de nível de serviço (SLA) para pré-visualização O Espaço de Nomes de Conectores (pré-visualização) não é atualmente recomendado para cargas de trabalho em produção.
Disponibilidade da região O apoio às regiões é atualmente limitado, mas expande-se com o tempo.
Cobertura do conector Os conectores de utilização elevada e os conectores padrão ficam disponíveis primeiro, enquanto os conectores empresariais, como SAP, IBM MQ e Oracle Database, são disponibilizados em fases posteriores.
Identidade Atualmente, a chave API e as ligações OAuth são suportadas. O suporte de identidade gerida para ligações chega mais tarde, mas está planeado mais cedo para servidores MCP selecionados.
Versioning As versões do SDK e do runtime do namespace são combinadas na fase de pré-visualização. Espere alterações marcantes entre marcos de pré-visualização.

Conteúdo relacionado

  • Last updated on