Connettere e configurare un agente per Microsoft Teams
Dopo averlo pubblicato, è possibile rendere disponibile l'agente agli utenti in Teams. In questo modo tu, i membri del tuo team e la tua organizzazione potete interagirci. Devi pubblicare l'agente almeno una volta prima che gli utenti possano interagire con l'agente in Teams.
È possibile:
- Personalizzare l'aspetto dell'agente in Teams
- Installare l'agente in Teams
- Condividere l'agente di installazione del bot con altri utenti
- Mostrare l'agente nell'app store di Teams.
- Mostrare l'agente agli utenti condivisi aggiungendolo alla sezione estensioni Agente dell'app store di Teams.
- Condividi l'agente con l'organizzazione inviandolo per l'approvazione dell'amministratore affinché venga inserito nella sezione Creato dalla tua organizzazione dell'app store di Teams.
- Aggiungi l'agente a un canale del team.
- Scarica il manifesto dell'app per l'agente per distribuirlo nel tenant di Teams.
Quando aggiungi un agente a Teams, alcuni dei dati, come il contenuto dell'agente e il contenuto della chat dell'utente, verranno condivisi con Teams. I dati possono uscire dalla conformità dell'organizzazione e dai confini geografici o regionali. Per ulteriori informazioni, vedi Informazioni sulle autorizzazioni e sulle informazioni a cui accedono le app di Teams.
Prerequisiti
- Condividi il tuo agente con altri utenti in modo che possano installare e chattare con il agente in Teams.
- La tua organizzazione deve consentire l'aggiunta delle app Microsoft Power Platform a Teams prima che tu o altri utenti possiate installare direttamente l'agente in Teams o trovarlo nella sezione Estensioni Agente nell'app store di Teams. Collabora con l'amministratore per gestire le app Microsoft Power Platform nell'interfaccia di amministrazione di Microsoft Teams se è disabilitato per l'organizzazione.
- Gli agenti che vengono visualizzati nella sezione Creato dalla tua organizzazione (approvato da un amministratore) sono gestiti separatamente dagli amministratori nella pagina pagina Gestisci app dell'interfaccia di amministrazione di Teams.
- Prima di installare un agente per te stesso o condividere il bot con altri, è consigliabile pubblicare l'agente almeno una volta.
Connettere un agente al canale Microsoft Teams
Dopo aver pubblicato l'agente almeno una volta, puoi connetterlo al canale Microsoft Teams per consentire agli utenti di chattare con il copilota in Teams.
Nota
Ti consigliamo di attivare le impostazioni di sicurezza per gli agenti creati per Teams o l'utilizzo interno da parte dei dipendenti in modo da garantire che gli agenti non siano accessibili da persone esterne all'organizzazione.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Attiva Teams.
Nota
Se non vedi questa opzione, allora il canale Microsoft Teams è già abilitato.
Personalizza l'aspetto di un agente per Teams
Fornire la descrizione e l'aspetto corretti per un agente prima di renderlo disponibile ad altri utenti è importante, poiché li informa su quale sia lo scopo dell'agente e il relativo marchio, se applicabile.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Modifica dettagli per modificare l'icona, il colore e le descrizioni dell'agente. Questi attributi sono visibili nell'app store di Teams e nella scheda Informazioni su dell'app dopo che l'utente ha installato l'agente. Esamina le linee guida relative al formato dell'icona dell'app per Teams.
Importante
Le modifiche ai dettagli dell'agente non sono disponibili per gli utenti che hanno già installato l'agente da un collegamento condiviso o dalla sezione Estensioni agente dell'app store di Teams. Gli utenti devono reinstallare l'agente per ottenere gli aggiornamenti.
Per gli agenti che sono stati approvati da un amministratore, è necessario inviare nuovamente l'agente per l'approvazione.
Seleziona Altro per aggiungere le seguenti informazioni:
- Nome sviluppatore
- Sito Web
- Informativa sulla privacy
- Condizioni per l'utilizzo
Devi fornire queste informazioni per informare gli utenti in relazione all'agente. Per ulteriori informazioni, vedi Creare un'informativa sulla privacy e condizioni per l'utilizzo in Microsoft Teams.
Seleziona Salva. Le modifiche al colore, all'icona e alla descrizione breve sono ora visibili nel riquadro di configurazione.
Nota
La personalizzazione delle icone in questa sezione si applica solo all'avatar dell'agente per i bot che sono approvati dall'amministratore e non si applica agli utenti che installano l'agente con un collegamento di installazione diretto o dall'app store di Teams, sezione Estensioni agente. Puoi personalizzare l'avatar dell'agente in Personalizzare l'aspetto dell'agente.
Installare un agente come app in Teams
Dopo la pubblicazione dell'agente, puoi aggiungere l'agente al profilo di Teams direttamente da Copilot Studio.
Importante
I nuovi contenuti in un agente appena pubblicato non verranno visualizzati nelle conversazioni attualmente in corso.
Puoi digitare "Ricomincia" in una conversazione esistente per iniziare subito una nuova conversazione e vedere gli ultimi aggiornamenti dell'agente.
Ti consigliamo di aggiungere l'agente al profilo in Teams, prima di condividerlo con altri.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Apri agente per avviare il prompt di installazione in Teams. Seleziona Aggiungi per aggiungerlo come app in Teams. In questo modo l'agente viene installato solo per te.
Condividi un collegamento in modo che altri possano installare l'agente
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Opzioni disponibilità.
Selezionare Copia collegamento.
Condividi il collegamento con gli utenti di modo che possano installare l'agente in Teams.
Importante
Solo gli utenti che possono accedere all'agente possono utilizzare il collegamento di installazione per installare l'agente. Puoi condividere l'agente per consentire agli utenti l'accesso all'agente.
Non è possibile utilizzare un collegamento di installazione nell'app Teams per dispositivi mobili. Per assicurarti che il tuo agente sia disponibile per gli utenti mobili di Teams, configuralo per visualizzarlo nell'app store di Teams.
Visualizzare un agente nell'app store di Teams
Una volta pubblicato l'agente, puoi mostrarlo nell'app store di Teams di modo che gli utenti possano trovarlo e installarlo.
Mostrare il bot agli utenti condivisi
Puoi condividere l'agente aggiungendolo alla sezione Estensioni agente dell'app store di Teams. Solo gli utenti condivisi vedranno l'agente in quella sezione.
Importante
Solo gli utenti condivisi possono trovare e installare l'agente nella sezione Estensioni agente dell'app store di Teams. L'agente non verrà mostrato a chiunque nell'organizzazione anche se è configurato per consentire a tutti di utilizzare l'agente. Per mostrare l'agente all'organizzazione, invialo per l'approvazione dell'amministratore affinché sia visibile nella sezione Creato per l'organizzazione dell'app store di Teams.
Un agente può essere visualizzato solo nella sezione Estensioni agente dell'app store di Teams se il numero totale di utenti condivisi non supera i limiti imposti dai Criteri di individuazione dell'app store di Teams per il tenant. Per rendere l'agente disponibile a un numero maggiore di utenti, collabora con l'amministratore per mostrare l'agente all'organizzazione.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Opzioni disponibilità.
Seleziona Mostra ai miei colleghi ed esamina chi ha accesso all'agente.
Conferma che la casella di controllo Visibile nelle estensioni dell'agente sia selezionata e seleziona Condividi.
L'agente diventa disponibile nella sezione Estensioni agente dell'app store di Teams e viene visualizzata un'etichetta Aggiunto a Teams verde nella pagina delle opzioni disponibili.
Nota
Se la tua app non viene visualizzata nella sezione Estensioni agente la tua app Teams potrebbe memorizzare le informazioni nella cache.
Prova a disconnetterti e ad accedere di nuovo (se usi l'app desktop Teams) o ad aggiornare il browser (se usi l'app Web Teams).
Rimuovi un agente dalla sezione delle estensioni agente
Puoi rimuovere un agente dalla sezione Estensioni agente. La rimozione dell'agente da qui non influisce sugli utenti con l'agente installato.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Opzioni disponibilità.
Seleziona Mostra ai miei compagni di squadra e deseleziona la casella di controllo Visibile nelle estensioni agente.
Seleziona Condividi. L'agente non viene più visualizzato nella sezione Estensioni agente dell'app store di Teams.
Mostrare il bot all'organizzazione
Puoi condividere un agente con l'organizzazione inviandolo per l'approvazione dell'amministratore da includere nella sezione Creato per la tua organizzazione dell'app store di Teams. Includere l'app in Creato per la tua organizzazione è un ottimo modo di distribuire ampiamente l'agente collaborando con l'amministratore per distribuirlo a chiunque nell'organizzazione o a un sottoinsieme di utenti.
Gli amministratori possono anche utilizzare i criteri di configurazione dell'uso delle app per installare automaticamente e aggiungere un agente per gli utenti nell'organizzazione in modo che possano accedere direttamente dalla barra delle applicazioni in Teams.
Prima di inviare un agente alla tua organizzazione, assicurati che:
- L'agente sia pronto per essere rilasciato e conforme agli standard, alle regole e ai criteri aziendali.
- Ti coordini con altri gestori dell'agente. Una volta che un agente è stato inviato, non può essere inviato nuovamente da un altro utente fino a quando l'invio precedente non viene approvato o rifiutato da un amministratore.
- Puoi rimuovere l'agente, se applicabile, dalla sezione Estensioni agente dell'app store di Teams. In caso contrario, se invii il tuo agente per l'approvazione dell'amministratore, potrebbe finire per essere visualizzato in due posizioni.
Nota
Una volta che un agente viene approvato da un amministratore, la disponibilità dell'agente nella sezione Creato dalla tua organizzazione è completamente gestita dall'amministratore. Solo un amministratore può rimuovere l'agente dalla sezione Creato dall'organizzazione.
Inviare un agente per la sezione Creato per la tua organizzazione
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Opzioni disponibilità.
Conferma che l'agente non venga mostrato ai membri del team o agli utenti condivisi. Rimuovilo se indica Aggiunto a Teams.
Seleziona Mostra a tutti nella mia organizzazione.
Rivedi i requisiti per l'invio e seleziona Invia per l'approvazione dell'amministratore.
Nota
Assicurati di rivedere il contenuto e che sia pronto per essere esaminato da un amministratore. Devi inviare una nuova richiesta di approvazione per aggiornare l'icona e le descrizioni degli agente precedentemente approvati.
Una volta approvato, tutti gli utenti nuovi ed esistenti dell'agente in Teams riceveranno l'aggiornamento.
Questo si applica solo ai dettagli dell'agente. Puoi comunque aggiornare i contenuti del tuo agente e pubblicarlo tutte le volte che lo desideri. Non è necessario inviare nuovamente l'agente per l'approvazione dopo aver pubblicato tali modifiche ai contenuti.
Viene visualizzata una richiesta di conferma finale.
Seleziona Sì per continuare. L'agente viene inviato all'amministratore per l'approvazione e appare una nota che indica lo stato dell'invio.
Nota
Dopo aver inviato l'agente per l'approvazione dell'amministratore, è consigliabile non modificare l'impostazione di accesso dell'agente in modo da essere di livello inferiore a tutti gli utenti dell'organizzazione.
Impostare risultati di livello inferiore a tutti gli utenti dell'organizzazione impedirà agli utenti dell'organizzazione di chattare con l'agente dopo averlo installato dall'app store di Teams nella sezione Creato dalla tua organizzazione.
Collabora con l'amministratore sul criterio dell'app Microsoft Teams per determinare chi può trovare e installare l'agente.
Attendi l'approvazione dell'amministratore. Puoi controllare lo stato più recente selezionando Aggiorna oppure aprendo la finestra Rendi l'agente disponibile per altri utenti nella pagina Pubblica.
Dopo che l'amministratore ha approvato l'agente, lo stato viene aggiornato in Approvato. Puoi aprire direttamente l'agente e condividere il collegamento della versione approvata con altri utenti.
Facoltativamente, chiedi all'amministratore di usare i criteri di configurazione delle app per installare e aggiungere automaticamente un agente per gli utenti dell'organizzazione in modo che possano accedervi direttamente dalla barra dell'app in Teams.
Nota
Se la tua app non appare nella sezione Creato per la tua organizzazione anche se è contrassegnato come Approvato, la tua app Teams potrebbe memorizzare le informazioni nella cache.
Prova a disconnetterti e ad accedere di nuovo (se usi l'app desktop) o ad aggiornare il browser (se usi l'app Web Teams).
Consentire agli utenti di aggiungere un agente a un team in Teams
In Teams, gli utenti possono aggiungere un agente a un team specifico. Una volta che un agente è disponibile per un team, i membri del team lo possono "@menzionare" in qualsiasi canale del team e tutti i membri del team vedono le risposte dall'agente. Questa funzionalità è utile per situazioni come i seguenti esempi:
- L'agente supporta la collaborazione, ad esempio condividendo le ultime informazioni sui rapporti di vendita con il resto del team di vendita.
- È opportuno consentire a tutti i membri del team di interagire con l'agente in un canale del team o tramite chat privata senza che sia necessario manualmente l'agente stesso.
Due opzioni determinano se gli utenti possono aggiungere un agente a qualsiasi team di cui fanno parte o alle chat di gruppo e di riunione in Teams. Con queste opzioni selezionate, l'agente ha accesso alla cronologia delle conversazioni dal canale del team, dalla chat di gruppo o dalla chat della riunione, che consente all'agente di fornire risposte più adatte al contesto della conversazione.
Quando gli utenti installano un agente dall'app store di Teams o utilizzando il collegamento per l'installazione possono vedere una delle seguenti opzioni, a seconda dell'ambito di collaborazione impostato per l'agente:
- Aggiungere l'agente a un canale del team
- Aggiungi l'agente alle chat di gruppo e della riunione in Teams
I membri del team possono anche rimuovere un agente da un team.
Importante
L'agente deve essere configurato per consentire a tutti nell'organizzazione di chattare con il bot stesso. Ciò garantisce che tutti i membri del team abbiano l'autorizzazione per chattare con l'agente. Si consiglia vivamente di non modificare le impostazioni di sicurezza dell'agente dopo aver abilitato questa funzionalità. In caso contrario, gli utenti potrebbero visualizzare errori di autorizzazione quando provano a interagire con l'agente nei canali Teams o nelle chat di gruppo.
Per consentire agli utenti di aggiungere un agente a un team:
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Modifica dettagli.
Seleziona Consenti agli utenti di aggiungere questo agente a un team.
Seleziona Salva.
Teams memorizza nella cache le informazioni, quindi potrebbe essere necessario del tempo prima che gli utenti vedano l'opzione per aggiungere l'agente a un team o a una chat di gruppo. Gli utenti possono aggiornare il browser (o disconnetterti dal client desktop Teams e accedere nuovamente) per ottenere le ultime modifiche.
Se in precedenza hai inviato l'agente per l'approvazione dell'amministratore, devi inviarlo nuovamente dopo aver abilitato questa opzione. L'amministratore deve approvare queste modifiche prima che gli utenti dell'agente possano aggiungere il bot ai propri team dall'app store nella sezione Creato dalla tua organizzazione.
Impedire agli utenti di aggiungere un agente a un team o a chat di gruppo e riunioni
La disabilitazione di questa opzione impedisce agli utenti di aggiungere un agente a un nuovo team, gruppo o chat di riunione. Se hai già aggiunto un agente a una conversazione, la disabilitazione di questa opzione non lo rimuove. È necessario rimuovere manualmente l'agente.
Per impedire agli utenti di aggiungere un agente a un team:
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Modifica dettagli.
Deselezionare la casella di controllo Consenti agli utenti di aggiungere questo agente a un team.
Seleziona Salva.
Configura il comportamento di saluto privato
I saluti privati di un agente sono utili quando si desidera che i membri del team abbiano conversazioni individuali con l'agente senza che sia necessario installare manualmente l'agente stesso.
Nota
La configurazione del saluto privato è disponibile solo per i chatbot classici.
Se abilitato, l'agente avvia automaticamente una conversazione con i membri del team. Per personalizzare il messaggio di saluto dell'agente, vedi Modifica dell'argomento di sistema di saluto.
Considera quanto sia rilevante l'agente per i membri del team. Assicurati che il saluto dell'agente li aiuti a capire cosa farne, ne descriva i limiti e, soprattutto, li metta a proprio agio nell'interazione con il bot stesso.
Per configurare il momento in cui un agente invia un saluto privato:
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Impostazioni.
Configura le opzioni di saluto privato.
Seleziona Salva.
Scaricare il manifesto dell'app Teams per un agente (avanzata)
Puoi scaricare il manifesto dell'app Teams dell'agente per apportare modifiche dettagliate direttamente nel manifesto e condividerlo con l'amministratore o gli utenti nel tenant. Puoi anche caricare direttamente un manifesto dell'app in Teams se i criteri della tua organizzazione ti consentono di caricare applicazioni personalizzate.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Opzioni disponibilità.
Seleziona Scarica .zip.
Il manifesto viene generato come file .zip e viene salvato in base alle impostazioni di salvataggio del browser.
Disconnettere un agente da Teams
Puoi portare l'agente offline in modo che gli utenti non possano più chattare con l'agente in Teams. Quando il tuo agente è offline, non risponde a nessuno che tenta di chattare con esso. Dovresti considerare attentamente la necessità di disconnettere l'agente prima di farlo.
Gli agenti disconnessi non vengono visualizzati nella sezione Estensioni agente dell'app store di Teams e non possono essere installati da un collegamento condiviso. Se un utente ha già un agente di questo tipo installato in Teams, rimane disponibile fino a quando l'utente non lo disinstalla.
Dopo aver disconnesso un agente approvato da un amministratore, continua a essere visualizzato nella sezione Crea per l'organizzazione dell'App Store di Teams. Devi chiedere al tuo amministratore di rimuoverlo.
Aprire il riquadro di configurazione per il canale Microsoft Teams.
Seleziona Disconnetti da Teams.
Rivedi le informazioni sulla disconnessione dell'agente e seleziona Disconnetti per continuare.
Puoi sempre riconnettere l'agente dopo averlo disconnesso selezionando Attiva Team nella finestra Rendi l'agente disponibile per altri utenti nella pagina Pubblica.
Apri il riquadro di configurazione per il canale Microsoft Teams
Apri l'agente in Copilot Studio.
Nella barra dei menu superiore, seleziona Canali.
Seleziona il riquadro Microsoft Teams. Viene visualizzato il riquadro di configurazione
Limitazioni note
- La configurazione dei saluti privati non è supportata per gli agente che utilizzano l'area del contenuto unificata aggiornata.
- L'impostazione dell'icona dell'avatar dell'agente nella pagina Dettagli non verrà visualizzata per gli agente approvati da un amministratore. Gli agenti approvati da un amministratore utilizzeranno l'icona dell'app come avatar dell'agente.
- Teams ha una limitazione della frequenza sugli agenti. A seconda delle esigenze aziendali, potresti voler mantenere conciso il contenuto dell'agente per gli agenti aggiunti a Teams.
- Attualmente, se l'agente supporta l'autenticazione utente, l'utente non sarà in grado di disconnettersi esplicitamente. Questo comportamento restituisce esito negativo per la certificazione Microsoft Teams AppSource se stai pubblicando l'agente nella dashboard venditori. Questa limitazione non si applica all'utilizzo personale o del tenant dell'agente. Ulteriori informazioni su come pubblicare la tua app nello store di Teams e riguardo a criteri di certificazione di AppSource.
- Dopo aver disconnesso l'agente dal canale Microsoft Teams, ci potrebbero volere alcuni minuti prima che l'agente diventi irraggiungibile dagli utenti in Teams.
- Le chat di gruppo e le chat della riunione non supportano gli agenti configurati per l'autenticazione manuale con Single Sign-On (SSO) per Teams. A seconda delle esigenze aziendali, puoi: eseguire l'autenticazione con Microsoft oppure rimuovere SSO per Teams dall'autenticazione manuale.