Creare e modificare argomenti

In Copilot Studio, un argomento definisce come si svolge una conversazione con un agente.

Per creare argomenti, puoi descrivere ciò che desideri e chiedere all'intelligenza artificiale di creare l'argomento per te oppure creare argomenti da zero.

In Copilot Studio, un argomento rappresenta una parte di una conversazione tra un utente e un agente. Si definiscono e si lavora con gli argomenti in un'area di disegno di creazione. Un argomento contiene uno o più nodi, che insieme definiscono i percorsi di conversazione che un argomento può accettare. Ogni nodo esegue un'azione, come inviare un messaggio o porre una domanda.

Per ulteriori informazioni sui limiti di agenti e argomenti, fai riferimento all'argomento Quote, limiti, registrazione app, certificati e valori di configurazione.

Prerequisiti

• Per creare un agente, vedi Avvio rapido: creare e distribuire un agente.

Selezione dell'argomento giusto per rispondere a un utente

Per determinare come rispondere agli utenti, gli agenti utilizzano l'orchestrazione generativa o l'orchestrazione classica.

Con l'orchestrazione generativa, un agente determina la combinazione più appropriata di argomenti, azioni e conoscenze da utilizzare per rispondere alle query degli utenti o ai trigger di eventi. Ogni argomento ha una descrizione che informa l'agente del suo scopo. Ulteriori informazioni sulle descrizioni della creazione di contenuti.

Negli agenti configurati per utilizzare l'orchestrazione classica, ogni argomento dispone di un set di frasi trigger, ovvero frasi, parole chiave e domande che un cliente potrebbe utilizzare per le query correlate a un problema specifico. Questi agenti utilizzano la comprensione del linguaggio naturale, il messaggio del cliente e le frasi trigger dell'argomento per trovare l'argomento migliore da attivare. Non è necessario che l'input del cliente corrisponda esattamente a una frase trigger dell'argomento per attivare l'argomento. Ad esempio, un argomento sugli orari di apertura del negozio potrebbe avere la frase trigger "controlla gli orari del negozio". Se un cliente inserisce "vedi gli orari di apertura del negozio", questa frase attiva l'argomento degli orari del negozio. Altre informazioni sulle frasi trigger per la creazione di contenuti.

Argomenti in Copilot Studio

Applicazione Web

Un agente può avere due tipi di argomenti: argomenti di sistema e argomenti personalizzati. Ogni nuovo agente inizia con un set di argomenti di sistema e personalizzati predefiniti.

• Gli argomenti di sistema supportano comportamenti essenziali, come una richiesta personalizzata di parlare con una persona o di terminare la conversazione. Alcuni argomenti del sistema dispongono di frasi trigger, che puoi personalizzare in base alle esigenze del tuo agente.

  • Non puoi creare argomenti di sistema.
  • Non è possibile eliminare gli argomenti di sistema, ma puoi disabilitarli.
  • Puoi apportare modifiche agli argomenti di sistema. Tuttavia, finché non ti sentirai a tuo agio nel creare esperienze complete per gli agenti, ti consigliamo di non modificare gli argomenti del sistema.

  Per altre informazioni, vedi Utilizzare gli argomenti di sistema.

• Gli argomenti personalizzati predefiniti coprono comportamenti comuni, come salutare un cliente, terminare una conversazione o riavviare una conversazione.

  • Puoi apportare modifiche agli argomenti personalizzati predefiniti o rimuoverli completamente dal tuo agente.
  • Tutti gli argomenti che crei sono argomenti personalizzati.

Tipi di nodo

Sono disponibili i tipi di nodo descritti di seguito:

Tipo di nodo	Descrzione
Nodo messaggio	Invia un messaggio al cliente.
Nodo domanda	Fai una domanda al cliente.
Nodo scheda adattiva	Crea un frammento di codice JSON da scambiare con altre app.
Nodi condizione	Dirama la conversazione in base a una condizione.
Nodi Gestione variabili	Imposta un valore, analizza un valore o cancella le variabili (inclusa la possibilità di cancellare la cronologia delle conversazioni utilizzata dall'agente).
Gestione argomenti	Reindirizza la conversazione, trasferisci l'utente o termina l'argomento o la conversazione.
Nodi Chiama uno strumento	Chiama un flusso come Power Automate Excel Online oppure usa un connettore o un altro tipo di strumento.
Avanzato	Invia risposte generative, richieste HTTP, eventi e altro ancora.

Suggerimento

Rinominare i nodi per renderli più facili da identificare. Seleziona il campo del nome del nodo per aggiornare direttamente il nome, oppure seleziona l'icona Altro (…) del nodo e seleziona Rinomina dal menu. Puoi inoltre rinominare i nodi nell'editor del codice.

Non è possibile rinominare i nodi Trigger e i nodi Vai al passaggio.

I nomi dei nodi possono avere una lunghezza massima di 500 caratteri.

Creare un argomento

1. Vai alla pagina Argomenti dell'agente. Per una migliore visibilità, chiudi per il momento il pannello di test.

2. Seleziona Aggiungi un argomento, quindi Da vuoto.

   Viene visualizzato un nodo Trigger in un'area del contenuto dell'argomento altrimenti vuota.

3. Seleziona l'icona Altro (…) del nodo Trigger, quindi seleziona Proprietà. Viene visualizzato il riquadro Proprietà Su intento riconosciuto.

4. Nelle proprietà Su intento riconosciuto, seleziona l'area Frasi. Viene visualizzato il riquadro secondario Frasi.

5. In Aggiungi frasi, inserisci una frase di attivazione per il tuo argomento.

   L'agente ha bisogno di 5-10 frasi trigger per addestrare l'intelligenza artificiale a comprendere le risposte dei tuoi clienti. Per aggiungere altre frasi trigger, puoi:

   • Seleziona l'icona Aggiungi accanto al campo di testo e inserisci la frase desiderata.
   • Incolla una serie di frasi trigger, ciascuna in una riga separata e seleziona Invio.
   • Digita una serie di frasi trigger, premendo MAIUSC+Invio dopo ciascuna frase per posizionarla su una riga separata e seleziona Inserisci.
   • Carica un file che elenca le frasi trigger che desideri aggiungere per questo argomento.

   In una frase trigger si può includere la punteggiatura, ma è meglio usare frasi brevi invece che lunghe.

6. Seleziona Dettagli sulla barra degli strumenti per aprire il riquadro Dettagli argomento.

7. Aggiungi dettagli per l'argomento:

   • Inserisci un nome per identificare l'argomento, ad esempio "Orari del negozio". La pagina Argomenti elenca tutti gli argomenti definiti nel tuo agente, con questo nome.
   • Se lo desideri, inserisci un nome visualizzato da mostrare al cliente quando l'agente non riesce a determinare quale argomento corrisponde al messaggio del cliente.
   • Se lo desideri, usa il campo Descrizione per descrivere l'ambito dell'argomento per te stesso e altri autori di agenti del tuo team. I clienti non vedono mai le descrizioni dell'argomento.

8. Per salvare l'argomento, seleziona Salva nella barra dei menu in alto.

Importante

Evita di utilizzare i punti (.) nei nomi dei tuoi argomenti. Non è possibile esportare una soluzione che contiene un agente con punti nel nome di uno dei suoi argomenti.

Caricare frasi trigger per un argomento

Dal pannello Frasi del nodo Trigger di un argomento, puoi aggiungere o sostituire il set di frasi trigger associate all'argomento.

1. Prepara un file di testo (massimo 3 MB) che elenchi tutte le frasi trigger che desideri aggiungere per il tuo argomento, con ogni frase su una riga separata.

2. In Aggiungi frasi, seleziona carica un file.

3. In Carica un file, seleziona l'opzione desiderata:

   • Se vuoi aggiungere nuove frasi trigger per l'argomento, seleziona Aggiungi.
   • Per sostituire tutte le frasi trigger esistenti con l'elenco del file, seleziona Sostituisci.

4. Rilascia il file nella finestra. In alternativa, seleziona fai clic per sfogliare, vai al file e selezionalo.

5. Esamina le frasi trigger visualizzate e seleziona Aggiungi.

6. Salva l'argomento.

Scaricare le frasi trigger per un argomento

Dal pannello Frasi del nodo Trigger di un argomento, puoi scaricare il set di frasi trigger associate all'argomento.

1. In Aggiungi frasi, seleziona scarica.

2. Salva il file di testo risultante o aprilo in un editor di testo per rivederne il contenuto. Ogni frase trigger viene visualizzata su una riga separata.

Progettare un percorso di conversazione dell'argomento

Quando crei un argomento, un nodo Trigger appare automaticamente nell'area del contenuto. Puoi quindi aggiungere diversi tipi di nodi per ottenere il percorso di conversazione desiderato per il tuo argomento.

Per aggiungere un nodo dopo un altro nodo o tra due nodi nell'area del contenuto dell'argomento:

1. Seleziona l'icona Aggiungi nodo sotto il nodo sotto il quale desideri aggiungere un nuovo nodo.

2. Seleziona il tipo di nodo desiderato dall'elenco visualizzato.

   

Eliminare un nodo

Seleziona l'icona del menu Altro (…) del nodo che desideri eliminare, quindi seleziona Elimina.

Controlli per la modifica dei nodi nel canvas

È possibile utilizzare i controlli sulla barra degli strumenti per tagliare, copiare, incollare ed eliminare il nodo selezionato o i nodi selezionati adiacenti.

La barra degli strumenti include anche un controllo per annullare le modifiche. Selezionare l'icona Annulla e selezionare:

• Annulla per annullare la modifica più recente
• Annulla per ultimo salvataggio per ripristinare tutte le azioni all'ultimo salvataggio
• Ripeti per ripetere l'azione precedente

Incollare i nodi

Dopo aver utilizzato gli strumenti Taglia o Copia per posizionare uno o più nodi negli appunti, ci sono due modi per incollarli nella canvas:

• Se selezioni un nodo e quindi si selezioni Incolla, i nodi negli Appunti vengono inseriti dopo il nodo selezionato.

• Se selezioni "+" per visualizzare il menu Aggiungi nodo, seleziona Incolla, il nodo negli appunti viene inserito in quella posizione.

Aggiungere parametri di input e output per un argomento

Gli argomenti possono avere parametri di input e output. Quando un argomento reindirizza a un altro argomento, puoi utilizzare questi parametri per passare informazioni tra gli argomenti.

Inoltre, se il tuo agente utilizza la modalità generativa, può compilare automaticamente gli input dell'argomento dal contesto della conversazione o dopo aver generato le domande per raccogliere valori dagli utenti. Questo comportamento è simile al funzionamento del riempimento generativo di slot per le azioni.

Per ulteriori informazioni sui parametri di input e output per gli argomenti, consulta Gestire input e output di argomento.

Modificare argomenti con l'editor di codice

L'editor di codice mostra l'argomento in YAML, un linguaggio di markup di facile lettura e comprensione. Usa l'editor di codice per copiare e incollare argomenti da altri bot, anche quelli creati da altri autori.

Importante

La progettazione di un argomento interamente nell'editor di codice e l'operazione di Incolla di argomenti complessi non sono completamente supportati.

In questo esempio, copi e incolli YAML nell'editor di codice per aggiungere rapidamente un argomento che chiede al cliente informazioni sulla spedizione.

1. Nella pagina Argomenti selezionare Aggiungi un argomento>Da vuoto.

2. Nell'angolo superiore destro dell'area del contenuto, seleziona Altro, quindi seleziona Apri editor di codice.

   

3. Seleziona ed elimina il contenuto dell'editor di codice. Quindi, copia e incolla il seguente codice YAML:

   kind: AdaptiveDialog
   beginDialog:
     kind: OnRecognizedIntent
     id: main
     intent:
       displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
       triggerQueries:
         - Buy items
         - Buy online
         - Buy product
         - Purchase item
         - Order product
   
     actions:
       - kind: SendMessage
         id: Sjghab
         message: I am happy to help you place your order.
   
       - kind: Question
         id: eRH3BJ
         alwaysPrompt: false
         variable: init:Topic.State
         prompt: To what state will you be shipping?
         entity: StatePrebuiltEntity
   
       - kind: ConditionGroup
         id: sEzulE
         conditions:
           - id: pbR5LO
             condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
   
         elseActions:
           - kind: SendMessage
             id: X7BFUC
             message: There will be an additional shipping charge of $27.50.
   
           - kind: Question
             id: 6lyBi8
             alwaysPrompt: false
             variable: init:Topic.ShippingRateAccepted
             prompt: Is that acceptable?
             entity: BooleanPrebuiltEntity
   
           - kind: ConditionGroup
             id: 9BR57P
             conditions:
               - id: BW47C4
                 condition: =Topic.ShippingRateAccepted = true
   
             elseActions:
               - kind: SendMessage
                 id: LMwySU
                 message: Thank you and please come again.
   

4. Seleziona Salva, quindi seleziona Chiudi editore di codice. Si noti la logica condizionale che segue alcuni nodi Domanda.

   

Testa e pubblica l'agente

Testa l'agente quando apporti modifiche ai tuoi argomenti, per assicurarti che tutto funzioni come previsto.

Una volta che sei soddisfatto, pubblica il tuo agente nei canali desiderati.

Classici/Teams

Quando crei un bot, vengono creati diversi argomenti automaticamente. Questi argomenti creati automaticamente rientrano in queste categorie:

• Argomenti di lezione che possono essere utilizzati per aiutare a comprendere modi semplici o complessi di utilizzare i nodi per creare conversazioni bot.

  Puoi modificare gli argomenti di lezione o eliminarli completamente.

• Argomenti di sistema di cui probabilmente avrai bisogno durante una conversazione bot.

  Non puoi eliminare o disabilitare gli argomenti di sistema o modificare le loro frasi trigger. Tuttavia, puoi personalizzare i nodi nel canvas di creazione. Ti consigliamo di non personalizzare questi argomenti finché non ti senti a tuo agio con la creazione di una conversazione bot end-to-end.

Annotazioni

Argomenti suggeriti (legacy)

In un chatbot per il quale è stata usata la funzionalità di suggerimento dell'argomento ormai deprecata, gli argomenti suggeriti potrebbero ancora essere in sospeso. È possibile visualizzare questi argomenti, in una scheda Argomenti suggeriti separata, nell'elenco Argomenti per l'agente. È possibile esaminarli e aggiungerli al chatbot, se necessario.

Creare un argomento

1. Passare all'elenco Argomenti per il chatbot.

2. Selezionare Nuovo argomento>da vuoto. Copilot Studio inserisce automaticamente un nodo Trigger e un nodo Messaggio vuoto. Viene visualizzato il pannello Frasi di attivazione.

3. Aggiungere le frasi trigger desiderate per l'argomento.

   

   È possibile specificare più di una frase trigger per un argomento, usando una nuova riga per ciascuna frase. In una frase trigger si può includere la punteggiatura, ma è meglio usare frasi brevi invece che lunghe.

4. Immettere il messaggio desiderato e aggiungere altri nodi in base alle esigenze.

5. Nella barra in alto, modifica il titolo del tuo argomento per dargli un nome.

6. Seleziona l'icona Dettagli. In alternativa, è possibile modificare il nome e aggiungere un nome visualizzato e una descrizione.

   • Il nome visualizzato indica al bot l'argomento su cui la persona intende fare domande.
   • La Descrizione descrive lo scopo dell'argomento all'utente e ad altri autori di bot. Questa descrizione non viene mostrata agli utenti.

7. Selezionare Salva per aggiungere l'argomento all'elenco degli argomenti.

Modificare un argomento

1. Nell'elenco Argomenti per il chatbot selezionare l'argomento da modificare. Vedi le frasi trigger dell'argomento. Qui si definisce il percorso di conversazione tra un cliente e l'agente.

   Gli argomenti includono alcuni nodi creati automaticamente. Questi nodi possono essere modificati proprio come gli altri nodi.

2. Per aggiungere un nodo, selezionare l'icona Aggiungi nodo sotto il nodo in cui si vuole aggiungere un nuovo nodo e selezionare l'opzione desiderata:

   • Porre una domanda.
   • Aggiungere una condizione, solo possibile negli argomenti in cui sono disponibili le variabili
   • Chiamare uno strumento
   • Mostra un messaggio
   • Reindirizzare a un altro argomento
   • Terminare la conversazione: è possibile solo nella parte inferiore di un percorso di conversazione

3. Per eliminare un nodo, selezionare l'icona del menu (⋮) del nodo da eliminare e selezionare Elimina.

4. Per spostare o modificare i percorsi tra i nodi, trascina il piccolo cerchio sopra il nodo, l'ancora del nodo, in una nuova posizione nella canvas. La linea tratteggiata rappresenta il percorso originale.

Fai una domanda

Dopo aver selezionato Porre una domanda dal menu Aggiungi nodo , viene visualizzato un nuovo nodo Domanda .

1. Immettere la domanda desiderata.

   Ad esempio, se l'utente vuole conoscere le ore di archiviazione, il chatbot potrebbe chiedere "Quale posizione di archiviazione hai bisogno?"

2. In Identifica, seleziona un'opzione per la risposta dell'utente, ad esempio Opzioni a scelta multipla.

   Questa opzione determina ciò che il bot dovrebbe percepire nella risposta dell'utente. Per ulteriori informazioni, vedi Usare le entità in una conversazione.

3. In Opzioni per l'utente, inserisci le risposte previste alla domanda del bot.

   Ad esempio, se scegli Opzioni a scelta multipla in Identifica, le opzioni potrebbero includere le posizioni dei negozi Seattle, Bellevue o Kirkland.

   

   Copilot Studio crea automaticamente un percorso condizionale per ogni opzione. È possibile aggiungere nodi alla logica di diramazione e specificare il modo in cui il bot deve rispondere per ogni percorso o valore.

   Durante una conversazione, ogni scelta viene visualizzata come pulsante nella chat, ma gli utenti possono anche digitare la risposta.

4. (Facoltativo) rinominare la variabile che contiene la risposta dell'utente e configurarne le proprietà. Per altre informazioni, vedi Utilizzo delle variabili.

Aggiungi una condizione

Negli argomenti in cui sono disponibili le variabili è possibile aggiungere logica di diramazione in base ai valori delle variabili. Ad esempio, se si configura l'autenticazione utente, è possibile che il chatbot visualizzi un messaggio diverso se l'utente ha eseguito l'accesso.

Dopo aver selezionato Aggiungi una condizione dal menu Aggiungi nodo , viene visualizzato un menu.

• Per aggiungere un percorso basato su un valore di variabile specifico, selezionare Branch in base a una condizione e configurare la condizione desiderata.
• Per aggiungere il percorso che copre tutti gli altri valori, selezionare Branch per tutte le altre condizioni.

Chiamare uno strumento

Per chiamare i flussi di Power Automate o inserire nodi di autenticazione, selezionare Chiama uno strumento dal menu Aggiungi nodo e selezionare lo strumento desiderato o crearne uno nuovo.

Se il bot dispone di funzionalità basate su voce, sono disponibili altri strumenti.

Mostra un messaggio

Dopo aver selezionato Mostra un messaggio dal menu Aggiungi nodo , viene visualizzato un nuovo nodo Messaggio .

Inserisci il messaggio che vuoi che il bot dica nella casella di testo. Puoi applicare alcune formattazioni di base, come grassetto, corsivo, elenchi ordinati e non ordinati e collegamenti ipertestuali. Puoi anche usare variabili definite altrove nella conversazione con il bot.

Reindirizzare a un altro argomento

Dopo aver selezionato Reindirizza a un altro argomento dal menu Aggiungi nodo , viene visualizzato un elenco di argomenti.

Seleziona l'argomento a cui il bot deve deviare. Ad esempio, potresti indirizzare l'utente a un argomento sulla chiusura di un negozio qualora chieda informazioni sul suo orario.

Viene visualizzato un nodo Di reindirizzamento .

Puoi considerare l'argomento reindirizzato come argomento secondario. È possibile inserire altri nodi nel nodo Reindirizzamento . Quando il percorso della conversazione per l'argomento secondario è terminato, il bot torna all'argomento originale. Il bot segue quindi i nodi che si trovano sotto il nodo dell'argomento secondario.

Tuttavia, se si esegue il reindirizzamento a uno degli argomenti di sistema seguenti, l'intera conversazione termina:

• Fine della conversazione
• Esito positivo confermato
• Esito negativo confermato
• Saluti di chiusura
• Esegui escalation
• Ricomincia (reimposta anche qualsiasi variabile globale)

Termina la conversazione

Al termine della conversazione, è possibile chiedere all'utente un sondaggio se la domanda o il problema è stato risposto o risolto. La risposta viene raccolta nella pagina di analisi della soddisfazione del cliente.

La conversazione può anche essere consegnata a un agente live se stai usando un portale del servizio clienti adatto, come Multicanale per Customer Service.

Al termine di un percorso di conversazione che risolve un problema o risponde a una domanda, dopo aver selezionato Termina la conversazione dal menu Aggiungi nodo , viene visualizzato un menu:

• Per terminare la conversazione con un sondaggio sulla soddisfazione dei clienti, selezionare Termina con sondaggio.

• Per inserire un nodo di distribuzione che collega il prodotto di distribuzione configurato, seleziona Trasferisci ad agente. Facoltativamente, immettere un messaggio privato per il rappresentante del servizio clienti.

Testa e pubblica il tuo bot

Ogni volta che si apportano modifiche agli argomenti, testare il bot per assicurarsi che tutto funzioni come previsto.

Una volta soddisfatti, pubblicarlo nei canali desiderati.