O que é Azure Connector Namespace? (versão prévia)

Importante

Esse recurso em versão prévia está sujeito aos Termos de Uso Suplementares para Versões Prévias do Microsoft Azure. Durante a versão prévia, essa funcionalidade está disponível apenas nas regiões públicas do Azure.

Quando você cria soluções que se integram a aplicativos SaaS (software como serviço), sistemas de negócios e plataformas de dados, normalmente você precisa escrever código de cliente de API personalizado para cada conexão ou integração. Você também deve gerenciar fluxos de autenticação, rotação de credenciais, lógica de repetição, paginação e assinaturas de webhook em vários sistemas, o que adiciona sobrecarga de desenvolvimento significativa e risco operacional.

Azure Namespace do Conector é um serviço de integração totalmente gerenciado que elimina essa complexidade. O serviço hospeda um catálogo de conectores predefinidos e reutilizáveis que suas soluções podem usar para se conectar a serviços, como SharePoint, Salesforce, SAP e Outlook, por meio de um modelo de programação consistente. Cada conector expõe operações como gatilhos de evento, ações que completam tarefas e ferramentas de agente de IA por meio de um modelo de conexão compartilhado. Sua solução pode chamar gatilhos e ações usando SDKs (kits de desenvolvimento de software) específicos de linguagem para C#, Node.jse Python ou por meio de chamadas HTTP diretas.

Um namespace de conector gerencia a infraestrutura de integração subjacente ao executar as seguintes tarefas:

Tarefa Description
Autenticação e gerenciamento de credenciais Armazene e gire credenciais ou segredos para OAuth, chave de API e conexões baseadas em token.
Sondagem e entrega de webhook Crie e gerencie assinaturas de eventos que efetuam push de dados para seu aplicativo quando os sistemas de origem são alterados.
Repetição, limitação e tratamento de erros Configure políticas de resiliência internas sem implementação personalizada.
Hospedagem de servidor MCP para agentes de IA Publique conectores como servidores MCP (Model Context Protocol) para que agentes de IA e Copilot possam chamar serviços externos como ferramentas.

Essa visão geral descreve o que você pode fazer com namespaces do conector, conceitos principais, como os namespaces do conector funcionam, aspectos de segurança e considerações para implantação durante a visualização.

Note

O Namespace do Azure Connector é uma via de integração para serviços de computação que não são executados em um mecanismo de fluxo de trabalho. Os namespaces do conector não exigem, usam ou alteram nada no Aplicativos Lógicos do Azure. A galeria de conectores no Aplicativos Lógicos do Azure funciona de forma independente e separada para fluxos de trabalho no Aplicativos Lógicos do Azure.

O que você pode fazer com namespaces do conector

Integre seus aplicativos a centenas de serviços externos usando um modelo de programação consistente. A tabela a seguir descreve cenários comuns em que seu aplicativo pode usar Azure Namespace do Conector para se integrar a outros serviços sem código extra:

Scenario Integração de exemplo
Processar documentos e conteúdo Uma função do Azure usa operações do conector do SharePoint para detectar arquivos novos ou atualizados em um servidor do SharePoint, ler e processar os arquivos e gravar os resultados de volta no SharePoint.
Monitore eventos de serviços externos Um aplicativo de contêiner do Azure usa um gatilho do conector do Salesforce para receber eventos sobre novos leads do Salesforce.
Automatizar a produtividade Um aplicativo Node.js usa operações do conector do Outlook para ler e enviar e-mails reutilizando uma conexão da qual outro aplicativo já é proprietário.
Criar e executar cargas de trabalho de IA ou agente Um serviço em Python chama ações do conector para fundamentar ou enriquecer a saída do modelo com dados de sistemas corporativos.
Reutilizar o código do aplicativo existente ASP.NET, Node.jse serviços de Python podem usar integrações gerenciadas sem um mecanismo de fluxo de trabalho no caminho da chamada.
Publicar conectores como servidores MCP gerenciados Converta qualquer conector do namespace em um servidor MCP (Model Context Protocol) com uma única etapa. Seu namespace lida com hospedagem, definições de ferramenta e autenticação para que Copilot e outros agentes de IA possam chamar ações do conector como ferramentas.
Implante servidores MCP a partir de um catálogo selecionado Selecione e implante servidores MCP prontos para uso no namespace do conector. Você controla a configuração do servidor, enquanto o namespace manipula a implantação, o dimensionamento e as credenciais – nenhuma infraestrutura para você gerenciar.

Conceitos principais

A tabela a seguir descreve os conceitos essenciais que você deve entender ao trabalhar com namespaces do conector:

Concept Description
Namespace do conector O recurso Azure que hospeda o runtime do conector e manipula as seguintes tarefas:

– Carregar e executar operações de conector.
– Manter o estado da conexão e as credenciais.
– Consultar serviços e sistemas de origem. Enviar eventos de webhook.
– Aplicar políticas de repetição, limitação e diagnóstico.

Você pode criar um namespace de conector usando o portal do Azure, os modelos do Azure Resource Manager (ARM) e do Bicep ou a CLI do Azure. Em seguida, você associa conexões e consome conectores de seus aplicativos.
Connector Um componente predefinido para integrar um serviço específico, como SharePoint, Salesforce, SAP e Outlook. Um conector abstrai a API do serviço subjacente, o protocolo de autenticação, a paginação e o comportamento de repetição para que seu código permaneça focado na lógica de negócios.

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

- Gatilho: uma operação de assinatura de eventos que seu aplicativo registra em um conector. Por exemplo, quando um novo email chega, quando um registro é atualizado ou quando um arquivo é adicionado a uma pasta. Quando o serviço ou sistema de origem gera um evento, o namespace do conector envia o conteúdo para seu aplicativo.

--- Cada conector define seus gatilhos independentemente de qualquer aplicativo específico.

--- Vários aplicativos podem assinar o mesmo evento de gatilho usando a mesma conexão.

--- Seu namespace de conector gerencia os agendamentos de polling e o registro de webhooks em seu nome, com base no suporte oferecido pelo serviço subjacente.

- Ação: uma operação que seu aplicativo chama. Por exemplo, envie uma mensagem, leia uma linha ou carregue um arquivo.
Conexão Um vínculo autenticado e configurado com uma conta externa ou locatário externo. Você pode reutilizar conexões, o que significa que vários aplicativos e conectores podem compartilhar a mesma conexão. Tipos de autenticação de conexão com suporte:

-Oauth
- Chave de API
- Básico
Servidor MCP Um recurso de primeira classe que expõe ferramentas que os agentes de IA podem usar por meio do Protocolo de Contexto de Modelo (MCP). Os namespaces do conector dão suporte aos seguintes tipos de servidores MCP, que são hospedados por Azure Namespace do Conector:

- Gerenciado: servidores e conectores que o namespace do conector cria e configura. Você pode implantar um servidor gerenciado ou conector como um servidor MCP. Você só precisa autenticar a conexão subjacente. O namespace do conector gerencia a configuração do servidor, as definições de ferramentas, o ciclo de vida e o tempo de execução.

- Hospedados: servidores MCP pré-construídos de um catálogo selecionado que você escolhe, configura e implanta no espaço de nomes do conector. Você mantém o controle sobre as configurações, o ambiente e os parâmetros do servidor. O namespace do conector manipula a hospedagem, o dimensionamento e as credenciais.

Em ambos os casos, agentes de IA, como Copilot, agentes personalizados ou clientes com reconhecimento de MCP, podem detectar e chamar ferramentas usando o modelo de conexão do namespace. Você pode habilitar, desabilitar ou girar servidores MCP independentemente da conexão subjacente.
SDKs para conectores SDKs fortemente tipados que incluem namespaces de conectores para que você possa invocar conectores usando as convenções idiomáticas padrão da sua linguagem:

- C#: Azure.Connectors.Sdk no NuGet, com o serviço de linguagem do Visual Studio Code para IntelliSense, conclusão de código e CodeLens.

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

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

Cada SDK expõe o mesmo catálogo, modelo de conexão, telemetria consistente e semântica de repetição.

Observação: se um SDK digitado não for apropriado, você poderá chamar conectores por HTTP.

Como trabalhar com namespaces do conector

As seções a seguir descrevem o processo de alto nível para começar a integrar conectores ou servidores MCP ao seu aplicativo.

Etapas típicas para integrar conectores ao seu aplicativo

As seguintes etapas de alto nível descrevem uma maneira típica de começar a usar conectores com seu aplicativo:

  1. Na sua assinatura do Azure, crie um recurso de namespace de conector.

  2. Crie uma ou mais conexões com os serviços que você deseja integrar.

    Por exemplo, suponha que você crie uma conexão OAuth para Microsoft 365 ou uma conexão de chave de API com um serviço externo. As etapas a seguir descrevem o que acontece entre seu aplicativo e o namespace do conector.

    1. Seu aplicativo, que é executado no Functions, no Container Apps, no App Service ou em outro serviço de computação, faz referência ao namespace e à conexão por meio de um Connector SDK.

    2. Seu aplicativo assina gatilhos de conector ou chama ações do conector.

      As chamadas para ações do conector são executadas de forma síncrona. A entrega do gatilho usa webhooks ou assinaturas baseadas em pull, dependendo do conector e do serviço de origem.

    3. Seu namespace gerencia autenticação, assinatura de requisições, polling, inscrição em webhooks e novas tentativas.

    4. Seu aplicativo recebe respostas tipadas e cargas úteis de evento.

Etapas típicas para integrar servidores MCP ao seu aplicativo

As seguintes etapas de alto nível descrevem uma maneira típica de começar a usar servidores MCP com seu aplicativo:

  1. Em sua assinatura do Azure, crie um recurso de namespace de conector.

  2. No catálogo, adicione um servidor MCP ao namespace do conector.

    Você pode adicionar um servidor MCP gerenciado ou um servidor MCP hospedado.

  3. Autenticar a conexão subjacente. Configure todos os requisitos de configuração específicos do servidor.

    • O namespace do conector publica o endpoint do servidor MCP e o executa, além de gerenciar a autenticação, o escalonamento e a rotação de credenciais.
    • Agentes de IA, como Copilot, agentes personalizados ou qualquer cliente com reconhecimento de MCP, podem encontrar o servidor MCP, ler seu catálogo de ferramentas e invocar ferramentas usando a conexão configurada.

Onde você pode usar namespaces do conector

Esta seção descreve maneiras pelas quais seu aplicativo pode usar namespaces do conector e operações de conector para integração.

  • Os namespaces do conector dão suporte aos seguintes serviços de computação Azure em que seu aplicativo pode usar operações de conector disponíveis:

    • Serviço de Aplicativo do Azure
    • Aplicativos de Contêiner do Azure
    • Azure Functions

  • Qualquer serviço de computação auto-hospedada pode usar conectores por meio de um namespace do conector.

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

  • Agentes de IA, extensões do Copilot e clientes compatíveis com servidores MCP podem localizar e invocar ferramentas de servidores MCP hospedados no espaço de nomes do seu conector, tudo isso sem passar por uma camada computacional separada.

    Seus aplicativos podem usar essas ferramentas de IA e agentes que interagem com sistemas conectados e serviços externos por meio dos endpoints dos servidores MCP implantados no namespace do conector. Você não precisa de código personalizado de cliente de API nem de wrappers para ferramentas. O namespace do seu conector fornece e gerencia a capacidade computacional subjacente para executar servidores, para que você não precise fornecer sua própria infraestrutura.

Segurança e governança

  • Deixe o gerenciamento de credenciais a cargo do namespace do conector, que armazena, gerencia e rotaciona as credenciais de conexão para você. Seu aplicativo nunca lida com credenciais brutas.

  • Restrinja o acesso à rede usando a integração de rede virtual e pontos de extremidade privados com o namespace do conector.

  • Controle quem pode criar conexões, registrar gatilhos e invocar ações ao usar RBAC (controle de acesso baseado em função) no namespace do seu conector.

  • Para dar suporte ao rastreamento de ponta a ponta em seu namespace de conector e serviços de computação, os logs de diagnóstico e os IDs de correlação são enviados ao Azure Monitor.

Considerações e limitações

Enquanto o Namespace do Conector do Azure estiver em prévia, consulte as considerações a seguir se você estiver planejando uma implantação durante a prévia:

Consideration Description
Não há SLA (Acordo de Nível de Serviço) para a prévia Azure Namespace do Conector (versão prévia) não é recomendado atualmente para cargas de trabalho de produção.
Disponibilidade da região O suporte para regiões atualmente é limitado, mas se expande ao longo do tempo.
Cobertura do conector Conectores padrão e de alto uso estão disponíveis primeiro, enquanto conectores empresariais, como SAP, IBM MQ e Oracle Database, seguem em ondas posteriores.
Identity Atualmente, há suporte para a chave de API e as conexões OAuth. O suporte à identidade gerenciada para conexões chega mais tarde, mas é planejado anteriormente para servidores MCP selecionados.
Versioning As versões de runtime do SDK e do namespace são emparelhadas durante a visualização. Espere alterações significativas entre os marcos de visualização.
Pricing O modelo de preços ainda não foi finalizado. A forma de medição pode mudar antes da disponibilidade geral.

Conteúdo relacionado

  • Last updated on