Pianificare e progettare strategie di integrazione

Gli agenti creati in Copilot Studio acquisiscono nuove funzionalità tramite l'integrazione con altri servizi online. Questi servizi possono includere servizi Microsoft, come SharePoint e Dataverse, servizi di terze parti come ServiceNow, Salesforce e Databricks, e API personalizzate. Power Platform offre un ricco ecosistema di connettori integrati disponibili per Copilot Studio, così non è necessario crearli personalmente. Sono disponibili diverse opzioni per creare integrazioni personalizzate utilizzando soluzioni con poco codice o a uso intensivo di codice. Gli agenti possono estendere le proprie capacità tramite il Model Context Protocol (MCP) per interagire con strumenti e dati esterni in modo standardizzato e scalabile, oppure tramite uso del computer per automatizzare applicazioni web e desktop direttamente su una macchina virtuale, abilitando scenari di integrazione più ampi anche quando non è disponibile un'API.

Utilizzando le integrazioni, gli agenti diventano un'interfaccia pratica per accedere alle funzionalità di più sistemi. Gli utenti possono eseguire molte operazioni diverse senza dover allontanarsi dall'agente. Ad esempio, un singolo agente progettato in Copilot Studio può essere utilizzato per:

• Leggere, creare e aggiornare elementi in un elenco di SharePoint.
• Inviare un messaggio e-mail tramite Office 365 Outlook.
• Aprire un nuovo ticket di supporto su ServiceNow.

Considerazioni sui criteri di integrazione

Copilot Studio supporta l'integrazione tramite connettori Power Platform, richieste HTTP, flussi degli agenti, competenze Bot Framework e altro ancora. La scelta del corretto criterio di integrazione dipende dai requisiti del progetto.

Connettori Power Platform

I connettori consentono agli agenti di interagire con un servizio sottostante. Sono un insieme di azioni e trigger esposti tramite un'interfaccia con poco codice. Le azioni sono operazioni eseguite da un agente, come leggere, scrivere o aggiornare. I trigger notificano all'agente quando si verifica un evento in un altro servizio.

Usa connettori predefiniti e connettori personalizzati:

• Connettori predefiniti: Microsoft offre un ampio ecosistema di connettori software as a service (SaaS) pronti all'uso con Copilot Studio.
• Connettori personalizzati: quando non c'è un connettore predefinito disponibile, puoi creare il tuo connettore per un servizio. Sono un wrapper senza codice o con poco codice per le API REST.

I connettori Power Platform soddisfano questi requisiti:

• Gli autori che creano soluzioni con Power Platform ha familiarità con i connettori con poco codice o con uso intensivo di codice.
• È supportato il codice Power Fx, inclusi variabili, condizioni, parametri e altro ancora.
• L'analisi e la gestione degli errori sono integrati.
• I connettori predefiniti richiedono solo la configurazione, senza necessità di sviluppo.
• I connettori personalizzati possono essere creati una sola volta e utilizzati da molti agenti.
• È possibile monitorare l'attività nell'ambito dell'integrazione di Copilot Studio con Application Insights (una funzionalità di Monitoraggio di Azure).
• Alcuni connettori, inclusi quelli personalizzati, supportano le reti virtuali.

Quando si utilizzano i connettori Power Platform per l'integrazione, considera i seguenti punti:

• La restituzione di centinaia di risultati causa un ritardo significativo nella risposta dell'agente all'utente.
• I connettori di terze parti richiedono agli utenti di inserire le credenziali prima di poter accedere al servizio. Un utente potrebbe non capire come effettuare la connessione senza una guida. Considera l'utilizzo delle credenziali dell'autore quando l'utente non dispone delle informazioni necessarie per effettuare la connessione.

Richieste HTTP

Gli agenti possono integrarsi con un altro servizio effettuando una richiesta HTTP. Lo sviluppatore deve specificare questi valori ogni volta che effettua una richiesta HTTP:

• URI
• Metodo (GET, POST, PATCH, e così via)
• Titoli
• Body

Le richieste HTTP soddisfano questi requisiti:

• Possibilità di connettersi con servizi ed eseguire azioni non presenti nell'elenco dei connettori predefiniti.
• Meno tempo per sviluppare rispetto a un connettore personalizzato.

Quando usi le richieste HTTP, considera i seguenti fattori:

• Molti autori con poco codice e con uso intensivo di codice non sanno come configurare una richiesta HTTP e potrebbero avere difficoltà a gestirla.
• Non è possibile condividerlo in tutta l'organizzazione per il riutilizzo, come avviene con i connettori personalizzati.

Flussi dell'agente

I flussi dell'agente eseguono una serie di azioni in una sequenza predefinita. Utilizzano le azioni con poco codice presenti nei connettori Power Platform. Gli agenti possono fornire valori come input a un flusso dell'agente e riceverne gli output.

I flussi dell'agente sono funzionalmente simili ai flussi cloud di Power Automate, con alcune differenze importanti:

• I flussi dell'agente consentono una velocità effettiva elevata e una bassa latenza.
• I flussi dell'agente offrono più funzionalità rispetto ai flussi Power Automate, come ad esempio azioni "human-in-the-loop".
• I flussi dell'agente utilizzano crediti Copilot in base all'utilizzo. I flussi di Power Automate sono tipicamente eseguiti secondo un modello di licenza per utente o per processo.

I flussi dell'agente soddisfano questi requisiti:

• Senza codice o con poco codice.
• Concatenamento deterministico delle azioni.
• L'attività può essere monitorata separatamente.
• Nasconde valori sensibili come chiavi e segreti nelle azioni di flusso. Ottiene le credenziali da Azure Key Vault per l'autenticazione.
• Gestisce ingenti quantità di dati e file di grandi dimensioni.
• Utilizza thread di concorrenza ed esecuzione parallela per consentire prestazioni migliori.
• I flussi cloud esistenti di Power Automate possono essere convertiti in flussi dell'agente.

Quando si progetta un agente che utilizza flussi dell'agente, si considerino i seguenti punti:

• Le prestazioni sono limitate dai limiti delle API dei servizi e delle azioni inclusi.
• Lo sviluppatore deve progettare un modello di gestione degli errori affinché l'agente sappia come gestire le eccezioni.
• La risposta all'agente da parte del flusso ha un limite di dimensione.
• La logica di lunga durata può continuare a eseguire dopo l'azione Rispondi all'Agente.

Competenze di Bot Framework

Le competenze sono blocchi riutilizzabili per la creazione di competenze conversazionali che si costruiscono utilizzando Bot Framework. Implementa le competenze usando attività con poco codice. Registra le competenze in Copilot Studio per usarle. Dopo aver registrato una competenza in Copilot, puoi attivarla come nodo in un argomento di conversazione.

Le competenze del Bot Framework soddisfano questi requisiti:

• Esecuzione sincrona.
• Supporto per endpoint privati.
• Le competenze esistenti di Bot Framework possono essere riutilizzate in Copilot Studio.

Quando utilizzi le competenze Bot Framework, considera i seguenti fattori:

• Richiede attività con poco codice per lo sviluppo e il supporto continui (ad esempio, C#).
• Viene eseguito in Servizio di Azure AI Bot.
• In Azure si sostengono costi aggiuntivi che devi coprire con un abbonamento ad Azure.
• Application Lifecycle Management (ALM) è esterno a Power Platform.

Altre considerazioni per gli schemi di integrazione

Oltre alle linee guida per ogni tipo di integrazione, considera i seguenti punti per una strategia complessiva di integrazione:

• Gli schemi di integrazione di Copilot Studio non sono esclusivi e possono essere combinati.
• Le integrazioni sono rapide quanto gli endpoint a cui si collegano.
• Ottimizza sempre le query per restituire i risultati il più rapidamente possibile e offrire una buona esperienza conversazionale.
• Dove i flussi dell'agente e Copilot Studio non eseguono la logica in modo sufficientemente rapido, prendere in considerazione queste opzioni:
  • API personalizzate di Dataverse
  • Plug-in con poco codice di Dataverse
  • Funzioni di Azure
• Scenari specifici richiedono che l'integrazione dei dati venga effettuata in uno strato intermedio che modifica i messaggi durante la loro trasmissione.

Aggiunta di integrazioni a un agente

Aggiungi integrazioni a un agente usando i seguenti metodi:

• Strumenti

  • Collega l'integrazione come strumento per espandere le funzionalità di un agente.
  • Usa il linguaggio naturale per descrivere quando l'orchestratore dovrebbe selezionare lo strumento per svolgere un'attività.
  • Definisci come l'agente dovrebbe determinare i valori di input dello strumento e come dovrebbe essere strutturato l'output. L'IA generativa può inserire dinamicamente gli input basandosi su una descrizione, oppure puoi definire manualmente valori e formule.
  • Invoca come parte di un piano creato tramite orchestrazione generativa.

• Argomenti

  • Chiama un'integrazione tramite un nodo di argomento. Viene eseguito sempre nella stessa posizione nella sequenza dell'argomento.
  • Fornisci input al nodo usando Power Fx.

• Agenti

  • Crea un agente figlio che abbia un proprio insieme di istruzioni e definisci l'accesso alle conoscenze e agli strumenti disponibili per l'agente padre.
  • In alternativa, collegati a un agente esistente in Copilot Studio, Microsoft 365 SDK, Microsoft Foundry, Fabric, Agent-To-Agent e così via.

Quote e limiti

Esamina i limiti di servizio attuali per Copilot Studio e Power Platform:

• Limiti e quote per Copilot Studio
• Limiti della capacità di Power Automate
• Limiti e allocazioni delle richieste di Power Platform
• Limiti del connettore Power Platform, elencati nella pagina dedicata di ciascun connettore.

Devi determinare separatamente i limiti API per questi servizi:

• Capacità di OpenAI: i limiti di flusso in entrata non sono documentati.
• Competenze di Bot Framework: consulta la documentazione di Azure per i servizi specifici utilizzati.

Esempio di panoramica della pianificazione delle integrazioni

Quando pianifichi integrazioni con Copilot Studio, determina le seguenti informazioni per ogni servizio:

• Sistema connesso: il servizio con cui si effettua la connessione.
• Chiamato da: Il componente bot in Copilot Studio che chiama il servizio.
• Chiamato con: il tipo di integrazione selezionato.
• Volume giornaliero atteso: il numero medio di richieste.
• Picco previsto: il numero massimo atteso di richieste giornaliere.
• Dettagli: altre informazioni sull'integrazione.

Ecco un esempio di agente con più integrazioni:

Passaggio successivo

Scopri come i prompt, il Model Context Protocol e gli agenti per l’uso del computer possono ampliare le funzionalità del tuo agente.

Informazioni correlate

• Panoramica dei flussi dell'agente
• Utilizzare i connettori Power Platform come strumenti
• Aggiungere altri agenti
• Estendi il tuo agente con strumenti da un'API REST