Connetti e configura 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:

• Personalizza l'aspetto del tuo agente in Teams
• Installa agente per te stesso in Teams
• Condividi l'installazione di agente collegare con altri utenti
• Mostra agente nell'app store di Teams.
  • Mostra agente agli utenti condivisi aggiungendolo alla sezione estensioni agente dell'app store di Teams.
  • Condividi il agente con l'organizzazione inviando il agente per l'approvazione dell'amministratore per essere inserito nella sezione Creato per la tua organizzazione dell'app store di Teams.
• Aggiungi agente al canale di un team.
• Scarica il manifesto dell'app per il tuo agente per distribuirlo nel tuo tenant Teams.

Quando aggiungi un agente a Teams, alcuni dei tuoi dati, come il contenuto di agente e il contenuto della chat dell'utente finale, vengono 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 condividi il tuo agente con altri utenti in modo che possano installarlo e chattare con agente in Teams.
• La tua organizzazione deve consentire l'aggiunta di app a Teams prima che tu o altri utenti possiate installare direttamente un agente in Teams o trovarlo nella sezione Microsoft Power Platform 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 compaiono nella sezione Creato per la tua organizzazione (approvati da un amministratore) vengono gestiti separatamente dagli amministratori nella pagina Gestisci app di Teams interfaccia di amministrazione.
• Prima di installare un agente per te stesso o di condividerlo con altri, dovresti pubblicare l'agente almeno una volta.

Connetti e agente sul canale Microsoft Teams

Dopo aver pubblicato il tuo agente almeno una volta, puoi aggiungerlo al canale Connetti per consentire agli utenti di chattare con esso in Teams. Microsoft Teams

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Attiva Teams.

   

   Nota

   Se non vedi questa opzione, allora il canale Microsoft Teams è già abilitato.

Personalizza l'aspetto di un agente per i team

Fornire la descrizione e l'aspetto corretti per un agente prima di renderlo disponibile ad altri utenti è importante, poiché ciò li informa sullo scopo e sul marchio di agente, ove applicabile.

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Modifica i dettagli per cambiare l'icona, il colore e le descrizioni di agente. Questi attributi sono visibili nell'app store di Teams e nella scheda Informazioni dell'app dopo che l'utente ha installato agente. Esamina le linee guida relative al formato dell'icona dell'app per Teams.

   Importante

   Le modifiche ai dettagli di un agente non sono disponibili per gli utenti che hanno già installato agente da un collegare condiviso o dalla sezione estensioni agente dell'app store di Teams. Per ottenere gli aggiornamenti, gli utenti devono reinstallare agente.

   Per gli agenti che sono stati approvati da un amministratore, è necessario inviare nuovamente agente per l'approvazione.

3. Seleziona Altro per aggiungere le seguenti informazioni:

   • Nome sviluppatore
   • Sito Web
   • Informativa sulla privacy
   • Condizioni per l'utilizzo

   Dovresti fornire queste informazioni per informare gli utenti del tuo agente. Per ulteriori informazioni, vedi Creare un'informativa sulla privacy e condizioni per l'utilizzo in Microsoft Teams.

4. Seleziona Salva. Le modifiche al colore, all'icona e alla descrizione breve sono ora visibili nel riquadro di configurazione.

Installa un agente come app in Teams

Una volta pubblicato il tuo agente, puoi aggiungerlo direttamente al tuo profilo Teams da Copilot Studio.

Ti consigliamo di aggiungere prima l'hashtag agente al tuo profilo in Teams, prima di condividerlo con altri.

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Open agente per avviare la richiesta di installazione in Teams. Seleziona Aggiungi per aggiungerlo come app in Teams. Questa operazione installa solo agente per te.

Condividi a collegare in modo che altri possano installare un agente

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Opzioni disponibilità.

3. Selezionare Copia collegamento.

4. Condividi l'collegare con gli utenti in modo che possano installare agente in Teams.

Mostra un agente nell'app store di Teams

Dopo aver pubblicato il tuo agente, puoi mostrarlo nell'app store di Teams in modo che gli utenti possano trovarlo e installarlo.

Mostrare il bot agli utenti condivisi

Puoi Condividi il tuo agente aggiungendolo al Estensioni agente sezione dell'app store di Teams. Soltanto utenti condivisi puoi trovare agente lì.

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Opzioni disponibilità.

3. Seleziona Mostra ai miei compagni di squadra e controlla chi ha accesso a agente.

4. Verificare che la casella di controllo Visibile nelle estensioni agente sia selezionata e Seleziona Condividi.

   Il tuo agente diventa disponibile nella sezione estensioni agente dell'app store di Teams e nella pagina delle opzioni di disponibilità viene visualizzata un'etichetta verde Aggiunto a Teams .

Rimuovi un agente dalla sezione delle estensioni agente

Puoi rimuovere un agente dalla sezione estensioni agente . La rimozione di agente non avrà alcun effetto sugli utenti che hanno installato agente.

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Opzioni disponibilità.

3. Seleziona Mostra ai miei compagni di squadra e deseleziona la casella di controllo Visibile nelle estensioni agente .

4. Seleziona Condividi. Agente non compare più nella sezione estensioni agente dell'app store di Teams.

Mostrare il bot all'organizzazione

Puoi usare Condividi e agente con la tua organizzazione inviandola all'amministratore per l'approvazione, in modo che venga visualizzata nella sezione Creato per la tua organizzazione dell'app store di Teams. Inserire la tua app in Creata per la tua organizzazione è un ottimo modo per distribuire ampiamente il tuo agente, collaborando con il tuo amministratore per distribuirla a tutti nell'organizzazione o a un sottoinsieme di utenti.

Gli amministratori possono anche utilizzare 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 delle app in Teams.

Prima di inviare un agente alla tua organizzazione, assicurati che:

• Il tuo agente è pronto per essere rilasciato ed è conforme agli standard, alle regole e alle policy aziendali.
• Ti coordinerai con gli altri gestori di agente. Una volta inviato un agente, un altro utente non potrà inviarlo nuovamente finché un amministratore non approverà o rifiuterà l'invio precedente.
• Se applicabile, puoi rimuovere agente dalla sezione estensioni agente dell'app store di Teams. Altrimenti, se invii il tuo agente per l'approvazione dell'amministratore, potrebbe finire per essere visualizzato in due posti.

Invia un agente per la sezione Costruito per la tua organizzazione

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Opzioni disponibilità.

3. Verifica che agente non venga mostrato ai compagni di squadra o agli utenti condivisi. Rimuovilo se dice Aggiunto ai team.

4. Seleziona Mostra a tutti nella mia organizzazione.

5. 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. È necessario inviare una nuova richiesta di approvazione per aggiornare l'icona e le descrizioni degli agenti precedentemente approvati.

   Una volta approvato, tutti gli utenti nuovi ed esistenti di agente in Teams riceveranno l'aggiornamento.

   Questo vale solo per i dettagli agente. Puoi comunque aggiornare i contenuti del tuo agente e pubblicarli tutte le volte che vuoi. Dopo aver pubblicato tali modifiche al contenuto, non è necessario inviare nuovamente il tuo agente per l'approvazione.

   Viene visualizzata una richiesta di conferma finale.

6. Seleziona Sì per continuare. Il messaggio agente viene inviato al tuo amministratore per l'approvazione e puoi vedere una nota che indica lo stato del tuo invio.

   Nota

   Dopo aver inviato l'agente per l'approvazione dell'amministratore, non dovresti modificare l'impostazione di accesso dell'agente in modo che sia inferiore a quella di tutti gli utenti della tua organizzazione.

   Impostando un numero inferiore a tutti, gli utenti dell'organizzazione non potranno chattare con agente dopo averlo installato dalla sezione Creato per la tua organizzazione dell'app store di Teams.

   Collabora con l'amministratore per stabilire i Microsoft Teams criteri dell'app per determinare chi può trovare e installare agente.

7. Attendi l'approvazione dell'amministratore. Puoi controllare lo stato più recente selezionando Aggiornare, o aprendo il Rendi disponibile agente ad altri finestra dal Pubblicare pagina.

8. Dopo che l'amministratore approva agente, lo stato viene aggiornato in Approvato. Puoi aprire direttamente agente e Condividi della versione approvata collegare con altri utenti.

9. Facoltativamente, chiedi all'amministratore di utilizzare 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 delle app in Teams.

Consenti 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 possono "@menzionarlo" in qualsiasi canale del team e tutti i membri del team vedranno le risposte dell'agente. Questa funzionalità è utile per situazioni come i seguenti esempi:

• Il tuo agente supporta la collaborazione, ad esempio condividendo gli ultimi report sulle vendite con il resto del team di vendita.
• Vuoi consentire a tutti i membri del team di interagire con agente in un canale del team o tramite chat privata senza dover installare manualmente agente.

Due opzioni determinano se gli utenti possono aggiungere un agente a qualsiasi team di cui fanno parte o alle chat di gruppo e di riunioni in Teams. Selezionando queste opzioni, agente ha accesso alla cronologia delle conversazioni dal canale del team, dalla chat di gruppo o dalla chat della riunione, il che aiuta agente a fornire risposte più adatte al contesto della conversazione.

Quando gli utenti installano un agente dall' app store di Teams o tramite l' installazione collegare , possono visualizzare una delle seguenti opzioni, a seconda dell'ambito collaborativo impostato per agente:

• Aggiungi agente a un canale del team
• Aggiungi agente alle chat di gruppo e di riunione in Teams

I membri del team possono anche rimuovere un agente da un team.

Per consentire agli utenti di aggiungere un agente a un team:

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Modifica dettagli.

3. Seleziona Consenti ai tuoi utenti di aggiungere questo agente a un team.

4. Seleziona Salva.

Teams memorizza nella cache le informazioni, quindi potrebbe volerci un po' di tempo prima che gli utenti vedano l'opzione per aggiungere agente a una chat di gruppo o di team. 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 le modifiche prima che gli utenti possano aggiungere agente ai propri team dalla sezione Creato per la tua organizzazione dell'app store di Teams.

Impedisci agli utenti di aggiungere un agente a un team, a un gruppo o a chat di riunione

Disattivando questa opzione si impedisce agli utenti di aggiungere un agente a una nuova chat di team, gruppo o riunione. Se hai già aggiunto un agente a una conversazione, disabilitando questa opzione non lo rimuoverai. Devi rimuovere manualmente il file agente.

Per impedire agli utenti di aggiungere un agente a un team:

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Modifica dettagli.

3. Deseleziona la casella di controllo Consenti ai tuoi utenti di aggiungere questo agente a un team .

4. Seleziona Salva.

Configura il comportamento di saluto privato

I saluti privati da un agente sono utili quando si desidera che i membri del team abbiano conversazioni individuali con agente senza dover installare manualmente agente.

Se abilitato, il tuo agente avvia automaticamente una conversazione con i membri del team. Per personalizzare il messaggio di saluto di agente, modifica il saluto argomento di sistema.

Considera quanto è rilevante l'hashtag agente per i membri del team. Assicuratevi che il saluto agente li aiuti a capire cosa farne, ne descriva i limiti e, soprattutto, li faccia sentire a loro agio nell'interagire con il dispositivo.

Per configurare quando un agente invia un saluto privato:

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Impostazioni.

3. Configura le opzioni di saluto privato.

4. Seleziona Salva.

Scarica il manifesto dell'app Teams per un agente (avanzato)

Puoi scaricare il manifesto dell'app Teams di agente per apportare modifiche dettagliate direttamente al manifesto e Condividi con il tuo amministratore o con 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.

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Opzioni disponibilità.

3. Seleziona Scarica .zip.

   Il manifesto viene generato come file .zip e viene salvato in base alle impostazioni di salvataggio del browser.

Disconnetti un agente da Teams

Puoi disattivare agente in modo che gli utenti non possano più chattare con agente in Teams. Quando il tuo agente è offline, non risponde a nessuno che provi a chattare con lui. Prima di farlo, dovresti valutare attentamente la necessità di scollegare il tuo agente.

Gli agenti disconnessi non vengono visualizzati nella sezione estensioni agente dell'app store di Teams e non possono essere installati da un collegare condiviso. Se un utente ha già installato un agente in Teams, questo rimane disponibile finché l'utente non lo disinstalla.

Dopo aver disconnesso un agente che è stato approvato da un amministratore, continua ad apparire in Costruito per la tua organizzazione sezione dell'app store di Teams. Devi chiedere al tuo amministratore di rimuoverlo.

1. Aprire il riquadro di configurazione per il canale Microsoft Teams.

2. Seleziona Disconnetti da Teams.

3. Rivedi le informazioni sulla disconnessione di agente e Seleziona Disconnettersi per continuare.

Puoi sempre ricollegare il tuo agente selezionando Attiva Teams nel Rendi disponibile agente ad altri finestra sul Pubblicare pagina.

Apri il riquadro di configurazione per il canale Microsoft Teams

1. Apri il tuo agente in Copilot Studio.

2. Nella barra dei menu superiore, seleziona Canali.

3. Seleziona il riquadro Microsoft Teams. Viene visualizzato il riquadro di configurazione

Limitazioni note

• Configurazione del saluto privato non è supportato per gli agenti che utilizzano canvas di creazione unificato aggiornato.
• Impostazione dell'icona avatar agente nella pagina dei dettagli non viene visualizzato per gli agenti approvati da un amministratore. Gli agenti approvati da un amministratore usano l'icona dell'app come avatar agente.
• Le squadre hanno limitazione della velocità sugli agenti. A seconda delle esigenze aziendali, potrebbe essere opportuno che il contenuto dell'hashtag agente sia conciso per gli agenti aggiunti a Teams.
• Attualmente, se il tuo agente supporta l' autenticazione dell'utente finale, l'utente non è in grado di disconnettersi esplicitamente. Questo comportamento non supera la Microsoft Teams AppSource certificazione se pubblichi il tuo agente nella Dashboard del venditore. Questa limitazione non si applica all'uso personale o da parte degli inquilini di agente. Ulteriori informazioni su come pubblicare la tua app nello store di Teams e riguardo a criteri di certificazione di AppSource.
• Dopo aver disconnesso il tuo agente dal canale, potrebbero volerci alcuni minuti prima che agente diventi irraggiungibile per gli utenti di Teams. Microsoft Teams
• Le chat di gruppo e le chat delle riunioni 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.