Panoramica della modalità multi-tenant in Copilot Studio (anteprima)

[Questo articolo è una documentazione preliminare ed è soggetto a modifiche.]

Copilot Studio supporta ora la modalità multi-tenant. Questo nuovo supporto consente l'uso di un agente in un tenant di Microsoft Entra diverso rispetto al tenant che lo ospita. La modalità multi-tenant modifica il comportamento di un agente di Copilot Studio quando si usano opzioni di autenticazione specifiche. Questo articolo descrive l'autenticazione in Copilot Studio e il ruolo che l'autenticazione svolge in modalità multitenant.

Importante

La funzionalità multitenant in Copilot Studio è in anteprima pubblica ed è chiaramente contrassegnata in Copilot Studio per i creatori. Contiene termini che sono menzionati nel prodotto. Le funzionalità di anteprima pubblica non sono supportate per un uso generalmente disponibile. Tuttavia, puoi provare gli agenti di anteprima pubbliche su Teams/Agent Store seguendo linee guida specifiche. I partner dovrebbero sottolineare agli utenti finali che i loro agenti utilizzano la funzionalità di anteprima includendo un banner di Anteprima nell'icona.

Autori di Copilot Studio possono selezionare tra tre opzioni di autenticazione per gli agenti.

Metodo di autenticazione	Descrzione
Nessuna autenticazione	Quando si seleziona l'impostazione di configurazione No Authenticaton nell'area Authentication e Settings dell'agente, Copilot Studio consente agli utenti esterni di usare gli agenti compilati e ospitati nella piattaforma. Quando attivi questa impostazione, il client a cui l'utente accede all'agente non passa un token di accesso all'agente. Spesso si trova questo tipo di scenario nei siti web in casi d'uso in stile FAQ self-service. Questa impostazione permette a qualsiasi utente di accedere all'agente.
Autenticazione con Microsoft	Questa opzione utilizza un'opzione di autenticazione integrata. L'agente si aspetta un'identità Microsoft Entra ID dal client. Teams e altri client Microsoft inviano questa identità quando autenticano gli utenti con account di Microsoft Entra aziendali o dell'istituto di istruzione. L'agente utilizza questa identità per permettere all'utente di accedere alla sua funzionalità. Questa opzione in Copilot Studio esegue un'esperienza single sign-on (SSO) tra il client, l'agente e l'utente. L'utente non deve prima accedere al client e poi una seconda volta per accedere all'agente.
Autentica manualmente	Se selezionata, questa opzione segnala esplicitamente a Copilot Studio di non gestire o aspettarsi l'identità. Il creatore configura l'autenticazione per l'opzione di autenticazione selezionata. L'autenticazione manuale viene tipicamente utilizzata quando non si utilizza un'identità o un client basato su Microsoft. Ad esempio, stai incorporando l'agente in un sito web o in un'applicazione nativa e vuoi autenticare gli utenti esterni. Quando si utilizza l'autenticazione manuale, puoi selezionare il tipo di autenticazione: OAuth: Quando OAuth è selezionato, all'utente che accede all'agente sul client viene invitato ad accedere con OAuth. Questo apre un flusso di accesso basato sui provider di identità OAuth configurati dal maker. Una volta che l'utente effettua l'accesso con successo, l'agente riceve un token di accesso e può utilizzare il token nei servizi a valle e per la personalizzazione. Opzioni di identità basate su Microsoft Entra: sono disponibili opzioni per l'identità basata sul servizio e l'identità basata sull'utente (ad esempio, certificati e autenticazione utente Microsoft Entra). L'autenticazione del servizio è tipicamente per quando l'agente richiede una propria identità. L'entità basata sull'utente viene utilizzata per accedere ai servizi a valle che richiedono autenticazione. I creatori di Copilot Studio possono scegliere di configurare manualmente l'autenticazione utente con Microsoft Entra.

Importante

Per usare Microsoft Teams come canale in Copilot Studio, è necessario selezionare Authenticate with Microsoft or Authenticate Manually. Questo requisito è progettato e allinea i modelli di identità. Teams richiede che un utente sia sempre connesso, quindi di conseguenza gli agenti di Teams non possono essere anonimi. Lo stesso vale per tutti i canali Microsoft (ad esempio SharePoint).

Modalità multi-tenant

In modalità a tenant singolo, gli utenti di Microsoft Teams devono essere registrati e accedere all'agente di Copilot Studio usando lo stesso tenant di quello in cui l'agente è ospitato in Copilot Studio. Se un utente di un altro tenant (ad esempio, example@zavainsurance.com tenta di accedere a un agente ospitato in example@contoso.com), l'utente riceve un messaggio dall'agente: "Non hai accesso per parlare con questo bot. Contatta il proprietario."

Quando si abilita la modalità multi-tenant in Copilot Studio per un agente, gli utenti possono accedere all'agente ospitato in un tenant da un tenant diverso Microsoft Entra ID.

Questa funzionalità è disponibile in anteprima pubblica. La modalità multitenant supporta gli agenti Copilot Studio in Microsoft Teams e Microsoft Copilot. La modalità multi-tenant consente di individuare gli agenti nel Microsoft Teams Store globale, in cui gli agenti possono essere usati dai client quando si trovano in due tenant diversi.

Terminologia

Quando lavori con gli agenti e comprendi l'autenticazione, è importante separare i seguenti comportamenti:

• Autenticazione da utente a cliente: ad esempio, quando un utente accede a un client Teams o a un sito web utilizzando il proprio account Microsoft. Questa autenticazione non è strettamente correlata all'agente di Copilot Studio e si verifica all'esterno dell'agente.
• Autenticazione da cliente a agente: Il cliente invia informazioni all'agente, che si aspetta informazioni dal cliente. Se configuri l'agente per il single sign-on (SSO), l'autenticazione è invisibile per l'utente finale del client. In caso contrario, all'utente viene richiesto di accedere separatamente all'agente.
• Autenticazione dell'agente ad altri servizi autenticati: L'agente deve comunicare con altri servizi e, in alcuni casi, deve trasmettere l'identità. Quell'identità può essere l'identità dell'agente (principale del servizio) se l'agente ha un'identità. Altrimenti, l'agente può usare l'identità dell'utente se l'agente ha i permessi per farlo, accedendo alle risorse ed eseguendo azioni (utilizzando i permessi delegati dall'utente client connesso).

È disponibile anche un'opzione di autenticazione blended in cui un flusso di autenticazione agente può essere gestito tramite argomenti in Copilot Studio usando il nodo Authenticate, che richiede all'utente di accedere. L'autenticazione combinata è disponibile solo quando Authenticate Manually viene selezionato in Copilot Studio e quando Richiedi agli utenti di accedere è disattivato.

Quando usi la modalità multiinquilino, usa la seguente terminologia:

• Il host è l'ambiente in cui Copilot Studio è ospitato, dal quale viene eseguito e da cui viene fatturato. Il server è dove si crea l'agente di Copilot Studio. L'host è anche il luogo attraverso cui l'agente si muove nel ciclo di vita standard dello sviluppo software mentre viene sviluppato, testato e spostato nell'ambiente di produzione per l'uso dal vivo. Questo processo non è diverso dal caso per gli agenti in modalità a tenant singolo.

• Il client è il punto in cui accedi all'agente. Questa applicazione client è come Microsoft Teams o Microsoft Copilot. Da questi client, l'utente accede e usa l'agente, eseguendo l'accesso tramite Microsoft Entra ID. Il client richiede o non usa alcuna infrastruttura di Power Platform, incluso Copilot Studio.

La documentazione seguente illustra le funzionalità attualmente supportate nell'anteprima pubblica quando la modalità multi-tenant è attivata in Copilot Studio.

Funzionalità supportate

L'anteprima pubblica per multi-tenant viene avviata all'interno di un ambito specifico.

Quando l'agente è in modalità multitenant, si comporta in modo diverso. Non tutte le funzionalità di Copilot Studio sono supportate. Le differenze possono essere dovute alla natura della funzionalità (ad esempio, le conoscenze di SharePoint non funzionano tra i tenant) o a causa della portata dell'anteprima pubblica. Le sezioni seguenti contengono ulteriori dettagli.

Punti salienti importanti:

• La modalità multitenant non supporta ancora l'autenticazione degli utenti finali. Questa limitazione significa che non puoi delegare l'accesso per usare l'identità dell'utente nei comportamenti a valle. Il valore di questa funzione è trasmettere informazioni autenticate all'agente tramite l'autenticazione delegata utilizzando altri servizi. Questa funzionalità non è ancora disponibile.
• Le trascrizioni delle conversazioni vengono disattivate quando la modalità multitenant è attivata. Questa restrizione protegge la privacy degli inquilini a valle che utilizzano l'agente.
• I tenant host sono responsabili del pagamento della fatturazione dell'agente di Copilot Studio così come avviene per la modalità a tenant singolo. I partner Microsoft che si schierano nel Teams globale e nel negozio agenti e che cercano diversi modelli di lavoro con i loro clienti finali, ad esempio il pagamento degli agenti sul Teams Store globale, dovrebbero consultare il Partner Center per sapere quali programmi sono disponibili.

La sezione seguente riassume le funzionalità note per funzionare o meno quando si utilizza l'agente in modalità multitenant. Se qualcosa qui non è indicato come funzionante, aspettati che non funzioni per la modalità multitenant. La funzionalità in Copilot Studio non viene modificata in modo diverso quando è attivata la modalità multi-tenant. Ad esempio, le policy dati continuano a essere eseguite sull'host tenant, e le funzionalità e le caratteristiche, se supportate, hanno lo stesso set di funzionalità della modalità single-tenant.

Conoscenza

• Caricamento di Dataverse: supportato nell'anteprima pubblica attraverso i tenant.
• Siti Web pubblici: disponibili nell'anteprima pubblica tra i tenant.

Tools

• Prompt: supportati nell'anteprima pubblica per tutti i tenant.
• Connettori standard limitati: per maggiori informazioni, vedi Autenticazione.
• Connettori API REST: supportati nella visualizzazione pubblica tra i tenant.

Note

Connettori personalizzati, uso del computer, flussi di agenti e strumenti MCP non sono supportati in modalità multitenant.

Argomenti

• Variabili utente: Non disponibili o supportate nell'anteprima pubblica.
• Nodo di autenticazione: disponibile solo per l'autenticazione manuale.
• Nodo HTTP: Funziona per endpoint pubblici in visualizzazione pubblica nella modalità multitenant.

Canali

I canali supportati per l'anteprima pubblica includono:

• Microsoft Teams
• Microsoft Copilot

Authentication

• Autenticazione utente finale: Non supportata. Il client richiede agli utenti di aprire la gestione connessione, ma non può completare la richiesta man mano che invia l'utente alla gestione connessione di Copilot Studio in una posizione diversa da quella in cui si trova l'agente.
• OAuth: Non supportato per l'autenticazione manuale.
• Graph/Microsoft 365 connettori standard: non sono supportati.
• Connettori personalizzati: Non supportati.
• Autenticazione maker (principale del servizio) su strumenti standard: Supportata nell'anteprima pubblica.
• Autenticazione manuale con ID utente Microsoft Entra e principale del servizio: non supportata nell'anteprima pubblica.
• Utenti ospiti: Non supportati.

Altri dettagli

• Sono supportate solo conversazioni individuali. Le conversazioni di gruppo non sono supportate.
• Il multi-geo non è supportato. In anteprima pubblica, gli agenti sono ospitati in una singola area di Dataverse e la conformità alla normativa sulla residenza dei dati rimane sotto la responsabilità del partner.
• Government Community Cloud (GCC) e GCC High non sono supportati.
• L'autenticazione manuale non è ancora supportata (in arrivo presto).

Note

Fai attenzione quando usi l'autenticazione del maker sui connettori. L'autenticazione maker sui connettori può esporre i dettagli del tuo tenant a terzi tramite URL e così via.

Analytics

• Analisi aggregate: Non disponibile nell'anteprima pubblica.
• Dati della trascrizione: Non disponibili in anteprima pubblica.
• Scarica dati della sessione: Non disponibili in anteprima pubblica.
• Soddisfazione, efficacia, panoramica e reazioni: Non disponibili nell'anteprima pubblica.

Note

Le metriche del canale si basano su ciò che Teams offre tramite le capacità e la disponibilità del canale.

Controlli dell'amministratore

Controlli amministrativi per il tenant host agente

L'interfaccia di amministrazione di Power Platform (PPAC) gestisce la modalità multitenant. Gli amministratori dei tenant host possono impedire ai creatori di abilitare la modalità multitenant per gli agenti. Gli amministratori del tenant host possono navigare all'area di isolamento del tenant nel PPAC, che è disattivata per impostazione predefinita. Quando attivi l'isolamento del tenant, il tenant è isolato e non puoi usare la modalità multitenant. Se gli amministratori vogliono permettere solo a un insieme selezionato di tenant di stabilire connessioni con o dal loro tenant, possono attivare l'isolamento dei tenant e usare la funzione lista permessi per specificare quei tenant per inbound e out. Per maggiori informazioni, vedi Restrizioni di entrata e uscita tra inquilini.

Se l'isolamento del tenant è attivato, la modalità multi-tenant non è disponibile in Copilot Studio.

Altri scenari:

• Se l'isolamento del tenant è attivato dopo l'abilitazione e la pubblicazione di un agente, Copilot Studio visualizza una notifica che spiega che l'agente non funziona più come multi-tenant. L'agente si comporta quindi allo stesso modo di un agente single-tenant quando un altro tenant tenta di accedervi.
• Se il controllo amministrativo è attivato (per bloccare il multitenant) ma c'è una voce nella lista dei permessi, solo i tenenti nella lista dei permessi possono accedere all'agente. Tutti gli altri inquilini sono bloccati, come nella modalità single-tenant.
• I controlli di prevenzione della perdita dati prevedono le politiche dati dell'agente ospite.
• Copilot Studio consente di disabilitare il canale di Teams per un agente. Questa azione impedisce all'agente di rispondere sul client Teams.
• Se i canali Teams e Microsoft Copilot sono disattivati, questa azione interrompe il servizio per il tuo agente. Puoi riattivare il tuo agente, dato che il tuo ID agente non è cambiato. Potresti dover completare nuovamente il processo di pubblicazione.
• L'aggiornamento di un agente è identico a quello di Copilot Studio. I creatori dovrebbero usare Publish per inviare modifiche all'agente attivo in uso. Non è necessario pubblicare nuovi aggiornamenti tramite lo store di Teams. Le policy del Teams Store hanno le proprie aspettative sull'aggiornamento di un agente se vengono modificati metadati relativi all'agente, ad esempio scopo, termini, link e così via.

Controlli amministratore per Copilot Studio nel client

Nel tenant client in cui l'agente viene utilizzato, non ci sono cambiamenti per gli amministratori di Microsoft Admin Center (MAC). Gli amministratori MAC controllano un ambiente CEA utilizzando Copilot Studio allo stesso modo degli agenti personalizzati pro-code.

Fatturazione e licenze

Sei responsabile della fatturazione come inquilino host. Questa responsabilità è la stessa di quella per gli agenti pro-code nel negozio e per i clienti che distribuiscono agenti ai propri utenti. Per maggiori informazioni sulla fatturazione, vedi Gestire le sessioni e la capacità.

I tenant host devono gestire la fatturazione come parte del prodotto e assicurarsi che abbia i crediti adeguati e la configurazione di fatturazione per supportare il pubblico a cui accedono.

La modalità multi-tenant è supportata in anteprima pubblica solo dai tenant host con una licenza completa di Copilot Studio.

Se il partner non ha una fatturazione sufficiente e esaurisce i crediti, l'utente finale viene coinvolto e riceve un errore dall'agente. Prima che ciò accada, gli amministratori vengono avvisati e invitati a risolvere il problema tramite una notifica automatica. Il numero massimo di crediti e sessioni di Copilot Studio che è possibile allocare a un ambiente è il massimo che è possibile assegnare.

Se partner o clienti pubblicano il loro agente nello Teams Store, l'adozione dell'agente può causare fatturazioni impreviste se procede rapidamente (ad esempio, tramite il Teams Store o altri metodi di scoperta). Sei responsabile, come tenant ospite, di questo processo e dell'agente, allo stesso modo in cui oggi pubblichi agenti anonimi su canali non autenticati (ad esempio, sul web).

Pratiche di sviluppo software

Come parte del processo di gestione del ciclo di vita (ALM) dell'applicazione, sottoponi gli agenti multitenant a livelli di test più elevati. Gli agent multitenant hanno più aree di funzionalità da testare poiché alcune aree si comportano diversamente rispetto alla modalità single-tenant.

Quando si lavora con agenti multi-tenant in Copilot Studio, prendere in considerazione queste aree:

• Configura i tuoi ambienti di sviluppo e imposta il processo ALM raccomandato, che include un ambiente di sviluppo, un ambiente di test, un ambiente di test in un secondo tenant e un ambiente di produzione.
• Pianifica e configura la tua capacità per gli ambienti. Inoltre, pianifica un modo proattivo per valutare e monitorare quegli agenti.
• Se prevedi di creare un agente multitenant, assicurati di avere un tenant separato per i test, così da poter testare la configurazione specifica in modalità multitenant accedendo all'agente da un tenant diverso da quello in cui è ospitato l'agente.
  • Puoi caricare lateralmente il tuo agente nel tenant del client di test e configurare i criteri di isolamento del tenant nel tuo host di amministrazione di Power Platform per essere utilizzata specificamente con la configurazione del tuo ambiente di prova.
  • Un cliente o un partner può installare manualmente il pacchetto .ZIP che fa riferimento a un agente in esecuzione in Copilot Studio. Il pacchetto .ZIP può essere caricato tramite Teams o Microsoft Admin Center e gestito come per gli agenti a tenant singolo in Copilot Studio.

Aggiorna il tuo agente

Gli agenti pubblicati nel Teams Store richiedono una ripubblicazione tramite il processo di validazione del Teams Store solo se ci sono cambiamenti nei metadati (ad esempio, scopo, termini, link e così via). Questo requisito significa che quando un agente non Microsoft viene pubblicato e reso operativo, è disponibile a tutti gli utenti attuali. Questo requisito è lo stesso per Copilot Studio oggi come per altri canali e metodi di autenticazione.

Esportare il manifesto da Copilot Studio

Quando sei pronto a testare l'agente nel client Microsoft Teams o Microsoft Copilot in un altro tenant, devi rendere l'agente disponibile nel secondo tenant. Per i test, un amministratore MAC o un utente con permessi per installare manualmente l'agente nel proprio client (concessi da un amministratore MAC nel secondo tenant) deve installare manualmente l'agente nell'altro tenant.

È possibile limitare l'accesso al tenant host tramite i criteri di isolamento del tenant nell'interfaccia di amministrazione di Power Platform. Aggiungi le informazioni del tuo tenant client di prova quando stai testando tra i tuoi tenant specifici e mentre procedi nel processo di gestione del ciclo di vita dell'applicazione.

Per esportare il file .ZIP manifesto, vai su Canali in Copilot Studio, seleziona il canale Teams e Microsoft Copilot, e poi seleziona Modifica dettagli.

Puoi modificare nome, descrizione e altri dettagli nel file manifest richiesto da Microsoft Teams e Microsoft Copilot. Il file manifest contiene metadati importanti sul tuo agente, che il tenant del cliente vede quando lo esamina per utilizzarlo nella propria infrastruttura.

Dopo aver modificato i dettagli, seleziona Opzioni di disponibilità per esportare il file .ZIP.

Questa azione scarica un file .ZIP locale sulla tua macchina. Il file .ZIP contiene il file del colore delle icone e il file manifest. Puoi anche modificare manualmente il manifesto. Mentre la funzione è in anteprima pubblica, i creatori devono modificare il manifesto, in particolare il Valid Domains nodo. Per maggiori informazioni, consulta Rendi disponibile il tuo agente su Teams o Microsoft Copilot.

Contenuti correlati

• Rendi disponibile il tuo agente in Teams o Microsoft Copilot: Questo articolo include la documentazione sul caricamento manuale e sulla pubblicazione nel Teams Store globale.
• Migliori pratiche, risoluzione dei problemi e informazioni aggiuntive: Questo articolo include indicazioni sul ciclo di vita dello sviluppo software durante la creazione di agenti, considerazioni, risoluzione dei problemi e informazioni sulla roadmap.