Aggiungere un suffisso al nome visualizzato per identificare gli agenti nei vari ambienti (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Quando si distribuisce la stessa soluzione agente in più ambienti (sviluppo, test e produzione), tutte le istanze dell'agente usano lo stesso nome visualizzato in Microsoft Teams e Microsoft 365 Copilot. Di conseguenza, gli utenti potrebbero avere un tempo più difficile per identificare l'ambiente a cui appartiene un agente.

Per risolvere questo problema, configurare un suffisso del nome visualizzato del canale che aggiunge un valore di variabile di ambiente al nome visualizzato dell'agente in Teams e Microsoft 365 Copilot. Poiché le variabili di ambiente possono avere valori diversi in ogni ambiente, l'agente visualizza automaticamente l'identificatore di ambiente corretto senza modifiche alla soluzione stessa.

Ad esempio, se l'agente è denominato "HR Support Agent" e si configura una variabile di ambiente suffisso:

Prerequisiti

• L'agente deve trovarsi in una soluzione personalizzata.
• Una variabile di ambiente di tipo String deve esistere nella stessa soluzione dell'agente. Per altre informazioni, vedere Aggiungere variabili di ambiente.
• L'agente è connesso al canale Teams e Microsoft 365 Copilot.

Configurare il suffisso del nome visualizzato del canale

1. In Copilot Studio aprire l'agente da configurare.

2. Selezionare Impostazioni e quindi Avanzate.

3. In Soluzioni, trova il campo Suffisso del nome visualizzato del canale.

4. Nell'elenco a discesa selezionare una variabile di ambiente da usare come suffisso. Sono elencate solo le variabili di ambiente di tipo String .

   Per rimuovere un suffisso configurato in precedenza, cancellare la selezione in modo che il campo sia vuoto.

5. Seleziona Salva.

6. Pubblica l'agente affinché le modifiche abbiano effetto in Teams e Microsoft 365 Copilot.

Come funziona con la gestione del ciclo di vita delle applicazioni e le distribuzioni di soluzioni

Quando si usano soluzioni per la gestione del ciclo di vita delle applicazioni, queste soluzioni fungono da fonte di verità per la configurazione degli agenti. L'impostazione del suffisso del nome visualizzato del canale fa parte della soluzione. Quando si esegue la distribuzione, il suffisso del nome visualizzato persiste in tutti gli ambienti.

Poiché si distribuisce sempre una soluzione gestita, non vengono modificati gli ambienti di test o di produzione di destinazione, ad eccezione dei valori delle variabili di ambiente, che è possibile aggiornare per ogni ambiente. È possibile usare le pipeline di Power Platform per distribuire la soluzione e aggiornare i valori delle variabili di ambiente come parte del processo di distribuzione.

Per esempio:

1. Nell'ambiente di sviluppo creare una variabile di ambiente String (ad esempio, dev_EnvironmentDescription) con un valore predefinito .(Development)

2. Configura il Suffisso del nome visualizzato del canale dell'agente per usare questa variabile di ambiente.

3. Esportare la soluzione e distribuirla nell'ambiente di test . Aggiornare il valore della variabile di ambiente in (Test).

4. Distribuire la soluzione nell'ambiente di produzione . Lasciare vuoto il valore della variabile di ambiente in modo che non venga aggiunto alcun elemento al nome dell'agente.

Canali supportati

Il suffisso del nome visualizzato del canale viene applicato solo quando viene pubblicato l'agente nei canali seguenti:

• Microsoft Teams
• Microsoft 365 Copilot

Questa impostazione non influisce su altri canali, ad esempio Facebook, SharePoint o siti Web personalizzati.

Contenuti correlati

• Connetti e configura un agente per Teams e Microsoft 365 Copilot
• Creare e gestire soluzioni personalizzate
• Esportare e importare agenti in soluzioni
• Variabili in Microsoft Copilot Studio