Cos'è il Namespace dei Connettori? (anteprima)

Importante

Questa funzionalità di anteprima è soggetta alle condizioni per l'utilizzo Supplemental per le anteprime Microsoft Azure. Durante l'anteprima, questa funzionalità è disponibile solo nelle regioni pubbliche di Azure.

Quando si creano soluzioni che si integrano con app SaaS (Software-as-a-Service), sistemi aziendali e piattaforme dati, in genere è necessario scrivere codice client API personalizzato per ogni connessione o integrazione. Devi anche gestire i flussi di autenticazione, la rotazione delle credenziali, la logica di ripetizione dei tentativi, la paginazione e le sottoscrizioni ai webhook tra più sistemi. Questi compiti aggiungono un significativo carico di sviluppo e rischi operativi.

Connector Namespace è un servizio di integrazione completamente gestito che elimina questa complessità. Il servizio ospita un catalogo di connettori preassemblati e riutilizzabili che le tue soluzioni possono utilizzare per collegarsi a servizi come SharePoint, Salesforce, SAP e Outlook attraverso un modello di programmazione coerente. Ogni connettore espone operazioni come trigger di evento, azioni che eseguono attività e strumenti per agenti di intelligenza artificiale attraverso un modello di connessione condiviso. La soluzione può chiamare trigger e azioni usando SDK (Software Development Kit) specifici del linguaggio per C#, Node.jse Python o tramite chiamate HTTP dirette.

Uno spazio dei nomi del connettore gestisce l'infrastruttura di integrazione sottostante gestendo le attività seguenti:

Attività Description
Gestione dell'autenticazione e delle credenziali Archiviare e ruotare credenziali o segreti per connessioni OAuth, chiave API e basate su token.
Polling e recapito webhook Creare e gestire sottoscrizioni di eventi per il push dei dati nell'app quando cambiano i sistemi di origine.
Nuovi tentativi, limitazione della velocità e gestione degli errori Configurare criteri di resilienza predefiniti senza implementazione personalizzata.
Hosting del server MCP per gli agenti di intelligenza artificiale Pubblicare i connettori come server MCP (Model Context Protocol) in modo che gli agenti di intelligenza artificiale e Copilot possano chiamare i servizi esterni come strumenti.

Questa panoramica descrive le operazioni che è possibile eseguire con gli spazi dei nomi dei connettori, i concetti chiave, il funzionamento degli spazi dei nomi dei connettori, gli aspetti di sicurezza e le considerazioni per la distribuzione durante l'anteprima.

Note

Connector Namespace è un percorso di integrazione per servizi di calcolo che non funzionano su un motore di workflow. I namespace dei connettori non richiedono, utilizzano o modificano nulla in App per la logica di Azure. La galleria dei connettori in App per la logica di Azure funziona in modo indipendente e separato per i flussi di lavoro in App per la logica di Azure.

Cosa è possibile fare con gli spazi dei nomi dei connettori

Integrare le app con centinaia di servizi esterni usando un modello di programmazione coerente. La tabella seguente descrive scenari comuni in cui la tua app può utilizzare Connector Namespace per integrarsi con altri servizi senza codice extra:

Scenario Integrazione di esempio
Elaborare documenti e contenuti Una funzione Azure usa operazioni SharePoint connettore per rilevare file nuovi o aggiornati in un server SharePoint, leggere ed elaborare i file e scrivere nuovamente i risultati in SharePoint.
Monitorare gli eventi da servizi esterni Un'app contenitore di Azure usa un trigger del connettore di Salesforce per ricevere eventi sui nuovi lead da Salesforce.
Automatizzare la produttività Un'app Node.js usa operazioni Outlook connettore per leggere e inviare messaggi di posta elettronica riutilizzando una connessione già proprietaria di un'altra app.
Creare ed eseguire carichi di lavoro di intelligenza artificiale o basati su agenti Un servizio Python chiama le azioni del connettore per basare o arricchire l'output del modello con i dati dei sistemi aziendali.
Riutilizzare il codice dell'app esistente I servizi ASP.NET, Node.js e Python possono usare integrazioni gestite senza un motore di flusso di lavoro nel percorso della chiamata.
Pubblicare i connettori come server MCP gestiti Convertire qualsiasi connettore dallo spazio dei nomi in un server MCP (Model Context Protocol) con un singolo passaggio. Lo spazio dei nomi gestisce l'hosting, le definizioni degli strumenti e l'autenticazione, in modo che Copilot e altri agenti di intelligenza artificiale possano chiamare le azioni del connettore come strumenti.
Distribuire server MCP da un catalogo curato Selezionare e distribuire server MCP predefiniti nel namespace del connettore. È possibile controllare la configurazione del server, mentre lo spazio dei nomi gestisce la distribuzione, il ridimensionamento e le credenziali, senza alcuna infrastruttura da gestire.

Concetti chiave

La tabella seguente descrive i concetti fondamentali da comprendere quando si utilizzano i namespace dei connettori:

Concetto Description
Namespace del connettore La risorsa Azure che ospita il runtime del connettore e gestisce le attività seguenti:

- Caricare ed eseguire le operazioni del connettore.
- Mantenere lo stato e le credenziali della connessione.
- Eseguire il polling dei servizi e dei sistemi di origine. Inviare eventi webhook.
- Applicare criteri di ripetizione, limitazione e diagnostica.

È possibile creare uno spazio dei nomi del connettore usando il portale di Azure, Azure Resource Manager (ARM) e i modelli di Bicep o interfaccia della riga di comando di Azure. Si associano quindi le connessioni e si utilizzano i connettori nelle proprie app.
Connector Componente predefinito per l'integrazione di un servizio specifico, ad esempio SharePoint, Salesforce, SAP e Outlook. Un connettore astrae l'API del servizio sottostante, il protocollo di autenticazione, la paginazione e il comportamento di ripetizione dei tentativi in modo che il codice rimanga incentrato sulla logica di business.

Ogni connettore espone una superficie tipizzata per le operazioni seguenti:

- Trigger: operazione di sottoscrizione di eventi registrata dall'app in un connettore. Ad esempio, quando arriva un nuovo messaggio di posta elettronica, quando un record viene aggiornato o quando un file viene aggiunto a una cartella. Quando il servizio di origine o il sistema genera un evento, lo spazio dei nomi del connettore invia il payload all'app.

--- Ogni connettore definisce i trigger indipendentemente da qualsiasi app specifica.

--- Più app possono sottoscrivere lo stesso evento di trigger usando la stessa connessione.

--- Lo spazio dei nomi del connettore gestisce le pianificazioni di polling e la registrazione del webhook per conto dell'utente, in base alle funzionalità supportate dal servizio sottostante.

- Azione: operazione che l'app chiama. Ad esempio, inviare un messaggio, leggere una riga o caricare un file.
Connection Associazione autenticata e configurata con un account esterno o un tenant. È possibile riutilizzare le connessioni, il che significa che più app e connettori possono condividere la stessa connessione. Tipi di autenticazione di connessione supportati:

-Oauth
- Chiave API
- Base
Server MCP Una risorsa di prima classe che espone gli strumenti che gli agenti di intelligenza artificiale possono usare tramite il protocollo MCP (Model Context Protocol). Gli spazi di nomi dei connettori supportano i seguenti tipi di server MCP, che sono ospitati da uno spazio di nomi dei connettori:

- Gestiti: server e connettori che il namespace del connettore crea e configura. È possibile distribuire un server gestito o un connettore come server MCP. È sufficiente autenticare la connessione sottostante. Lo spazio dei nomi del connettore gestisce la configurazione del server, le definizioni degli strumenti, il ciclo di vita e il runtime.

- Ospitati: server MCP predefiniti da un catalogo selezionato che scegli, configuri e distribuisci nel namespace del connettore. Si mantiene il controllo sulle impostazioni del server, sull'ambiente e sui parametri. Il namespace del connettore gestisce l'hosting, la scalabilità e le credenziali.

In entrambi i casi, gli agenti di intelligenza artificiale, ad esempio Copilot, agenti personalizzati o qualsiasi client compatibile con MCP, possono rilevare e chiamare gli strumenti usando il modello di connessione dello spazio dei nomi. È possibile abilitare, disabilitare o ruotare i server MCP in modo indipendente dalla connessione sottostante.
Connettore SDKs SDK a tipizzazione forte che includono namespace per i connettori, così puoi richiamare i connettori usando gli idiomi standard del tuo linguaggio:

- C#: Azure. Connectors.Sdk in NuGet, con il servizio di linguaggio Visual Studio Code per IntelliSense, completamenti e CodeLens.

- Node.js: @azure/connectors, ovvero un client TypeScript nativo con invocazione di azioni async-await.

- Python: azure-connectors, allineato alle Azure SDK per le convenzioni di Python.

Ogni SDK espone lo stesso catalogo, il modello di connessione, i dati di telemetria coerenti e la semantica di ripetizione dei tentativi.

Nota: se un SDK tipizzato non è appropriato, è possibile chiamare i connettori tramite HTTP.

Come usare gli spazi dei nomi dei connettori

Le sezioni seguenti descrivono il processo generale per avviare l'integrazione di connettori o server MCP con l'app.

Passaggi tipici per integrare i connettori con l'app

I passaggi generali seguenti descrivono un modo tipico per iniziare a usare i connettori con l'app:

  1. Nella sottoscrizione di Azure, crea una risorsa dello spazio dei nomi del connettore.

  2. Creare una o più connessioni ai servizi da integrare.

    Si supponga, ad esempio, di creare una connessione OAuth per Microsoft 365 o una connessione con chiave API a un servizio esterno. I passaggi seguenti descrivono cosa accade tra l'app e lo spazio dei nomi del connettore.

    1. L'app, che viene eseguita in Functions, Container Apps, App Service o un altro servizio di elaborazione, fa riferimento al namespace e alla connessione tramite un Connector SDK.

    2. L'app usa i trigger del connettore o chiama le azioni del connettore.

      Le chiamate alle azioni del connettore vengono eseguite in modo sincrono. Il recapito dei trigger avviene tramite webhook o sottoscrizioni pull, in base al connettore e al servizio di origine.

    3. Il namespace gestisce l'autenticazione, la firma delle richieste, il polling, la sottoscrizione ai webhook e i nuovi tentativi.

    4. L'app riceve risposte digitate e payload di eventi.

Passaggi tipici per integrare i server MCP con l'app

I seguenti passaggi di alto livello descrivono un modo tipico per iniziare a usare i server MCP con la tua app:

  1. Nella sottoscrizione di Azure, crea una risorsa dello spazio dei nomi del connettore.

  2. Dal catalogo aggiungere un server MCP allo spazio dei nomi del connettore.

    È possibile aggiungere un server MCP gestito o un server MCP ospitato.

  3. Autenticare la connessione sottostante. Configurare i requisiti di configurazione specifici del server.

    • Il tuo namespace del connettore pubblica l'endpoint per il server MCP e gestisce il server. Il namespace gestisce l'autenticazione, la scalabilità e la rotazione delle credenziali.
    • Gli agenti IA, come Copilot, agenti personalizzati o qualsiasi client consapevole di MCP, possono trovare il server MCP, leggere il suo catalogo di strumenti e invocare strumenti utilizzando la connessione configurata.

Dove è possibile usare gli spazi dei nomi dei connettori

Questa sezione descrive come l'app può usare i namespace dei connettori e le operazioni dei connettori per l'integrazione.

  • Gli spazi dei nomi dei connettori supportano i servizi di calcolo Azure seguenti in cui l'app può usare le operazioni del connettore disponibili:

    • Servizio app di Azure
    • App contenitore di Azure
    • Funzioni di Azure

  • Qualsiasi servizio di elaborazione ospitato autonomamente può utilizzare i connettori tramite uno spazio dei nomi per i connettori.

    Ad esempio, questi servizi self-hosted includono ASP.NET, Node.jso Python in Azure Kubernetes o Macchine virtuali di Azure.

  • Gli agenti di intelligenza artificiale, le estensioni Copilot e i client con riconoscimento del server MCP possono trovare e richiamare strumenti per i server MCP ospitati nello spazio dei nomi del connettore, tutto senza passare attraverso un livello di calcolo separato.

    Le applicazioni possono usare questi strumenti di IA e strumenti agentici, che interagiscono con sistemi connessi e servizi esterni, tramite gli endpoint dei server MCP distribuiti nel namespace del connettore. Non sono necessari codice client o wrapper di strumenti personalizzati per l'API. Lo spazio dei nomi del connettore fornisce e gestisce il calcolo sottostante per i server in esecuzione, in modo da non dover usare la propria infrastruttura.

Sicurezza e gestione

  • Lasciare la gestione delle credenziali allo spazio dei nomi del connettore, che archivia, gestisce e ruota automaticamente le credenziali di connessione. L'app non gestisce mai credenziali in chiaro.

  • Limitare l'accesso alla rete usando l'integrazione con la rete virtuale e gli endpoint privati con lo spazio dei nomi del connettore.

  • Controllare chi può creare connessioni, registrare trigger e richiamare azioni usando il controllo degli accessi in base al ruolo nello spazio dei nomi del connettore.

  • Per supportare la tracciabilità end-to-end nel namespace del connettore e nei servizi di calcolo, i log di diagnostica e gli ID di correlazione vengono inviati ad Monitoraggio di Azure.

Considerazioni e limitazioni

Mentre Connector Namespace è in anteprima, rivaluti le seguenti considerazioni se stai pianificando un deployment durante l'anteprima:

Consideration Description
Nessun contratto sul livello di servizio (SLA) per le versioni in anteprima Attualmente il Connector Namespace (anteprima) non è consigliato per i carichi di lavoro di produzione.
Disponibilità della regione Il supporto per le aree è attualmente limitato, ma si espande nel tempo.
Copertura del connettore I connettori standard e ad utilizzo elevato sono disponibili per primi, mentre i connettori aziendali, ad esempio SAP, IBM MQ e Oracle Database, seguono le fasi successive.
Identità La chiave API e le connessioni OAuth sono attualmente supportate. Il supporto delle identità gestite per le connessioni arriva in un secondo momento, ma è pianificato in precedenza per i server MCP selezionati.
Versionamento Le versioni di runtime dell’SDK e del namespace sono associate durante l’anteprima. Aspettarsi modifiche di rilievo tra le attività cardine di anteprima.
Pricing Il modello di determinazione prezzi non è ancora stato finalizzato. La forma di misurazione può cambiare prima della disponibilità generale.

Contenuti correlati

  • Last updated on