Creare e modificare argomenti

Tipi di argomento

Un agente può includere due tipi di argomenti: argomenti di sistema e argomenti personalizzati. Ogni nuovo agente inizia con una serie 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 di sistema contengono frasi grilletto, 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 agente complete, ti sconsigliamo di modificare gli argomenti di 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:

Creare un argomento

1. Apri il tuo agente dall'elenco nella pagina agenti . Per una migliore visibilità, Chiudi il pannello di prova agente per ora.

2. Nella barra dei menu in alto seleziona Argomenti.

3. Seleziona Aggiungi un argomento, quindi Da vuoto.

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

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

5. Nel pannello Proprietà Su intento riconosciuto, seleziona l'area Frasi. Viene visualizzato il riquadro secondario Frasi.

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

   Il tuo agente necessita di 5-10 frasi grilletto per addestrare l'IA 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.

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

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

8. Aggiungi i dettagli agente argomento:

   • Inserisci un nome per identificare argomento, ad esempio "Orari di apertura". 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 agente non riesce a determinare quale argomento corrisponde al messaggio del cliente.
   • Se lo desideri, usa il campo Descrizione per descrivere lo scopo di argomento per te e per gli altri creatori di agente nel tuo team. I clienti non vedono mai le descrizioni dell'argomento.

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

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 dispone anche di un controllo per annullare una modifica. Apri il menu Annulla per riportare tutte le azioni all'ultimo salvataggio o 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 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.

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 seleziona + Crea>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. Il nodo Domanda ora ha molte condizioni per la domanda sulla spedizione.

   

Prova e pubblica il tuo agente

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

Dopo aver progettato e testato il tuo agente, pubblicalo sul web, sulle app mobili o native oppure Microsoft Bot Framework sui canali.

Usa argomenti di sistema e di esempio

Quando crei un bot, vengono creati diversi argomenti automaticamente.

Questi argomenti creati automaticamente rientrano in due 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.

Creare un argomento

1. Dal menu di navigazione, seleziona Argomenti, quindi + Nuovo argomento, quindi Da vuoto.

   Viene visualizzato il riqudro Frasi trigger.

2. Aggiungi diverse frasi trigger per il tuo argomento nella sezione Aggiungi frasi.

   

   È 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.

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

   

4. Premi Invio o seleziona l'icona Salva per salvare le modifiche.

5. Seleziona l'icona Dettagli. Qui puoi in alternativa 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.

   

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

Progettazione del percorso di conversazione dell'argomento

1. Nell'elenco degli argomenti, seleziona l'argomento che vuoi modificare. Vedi le frasi trigger dell'argomento. Qui puoi definire il percorso della conversazione tra un cliente e agente.

   Per gli argomenti esistenti o quelli di sistema, verranno creati automaticamente diversi nodi. Questi nodi possono essere modificati proprio come gli altri nodi.

   Quando crei un nuovo argomento, vengono inseriti automaticamente un nodo Trigger e un nodo vuoto Messaggio.

2. Per aggiungere un nodo, seleziona "+", Aggiungi nodo, situato tra o dopo i nodi.

   

3. 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.

   

Inserimento dei nodi

Quando aggiungi un nodo dopo il nodo Frasi trigger o tra due nodi Messaggio, puoi selezionare:

• Fai una domanda
• Chiama un'azione
• Mostra un messaggio
• Reindirizzare a un altro argomento
• Termina la conversazione

Fai una domanda

1. Seleziona l'opzione Fai una domanda del menu "+" Aggiungi nodo per aggiungere un nuovo nodo Domanda. Viene visualizzato un nodo domanda.

   

2. Immetti la frase di domanda nel campo Fai una domanda.

   Ad esempio, se l'utente desidera conoscere gli orari del negozio, la domanda del bot potrebbe essere Di quale negozio hai bisogno?

3. 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.

4. 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.

   

   Ogni scelta viene presentata all'utente come un pulsante a scelta multipla nella chat, ma gli utenti possono anche digitare la propria risposta.

5. (Facoltativo) Salva la risposta dell'utente in una variabile da usare in seguito.

L'editor delle conversazioni crea percorsi separati nella conversazione, a seconda della risposta del cliente. Il percorso di conversazione porta il cliente alla soluzione appropriata per ogni risposta. Puoi aggiungere altri nodi per creare una logica di ramificazione e specificare con quale bot deve rispondere per ogni percorso o variabile.

Chiama un'azione

Per chiamare i flussi Power Automate e inserire i nodi di autenticazione, seleziona Chiama un'azione dal menu "+" Aggiungi nodo.

Se le funzionalità vocali sono abilitate per il tuo bot, vedi più azioni.

Mostra un messaggio

1. Per specificare una risposta del bot, seleziona "+" Aggiungi nodo per aggiungere un nodo, quindi seleziona Mostra un messaggio per aggiungere un nuovo nodo Messaggio.

2. 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

1. Per fare in modo che il bot si sposti a un argomento diverso, seleziona "+" Aggiungi nodo per aggiungere un nodo, quindi Reindirizzare a un altro argomento. Verrà visualizzato un elenco di argomenti.

2. 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.

   

L'argomento reindirizzato è un argomento secondario.

Puoi inserire più nodi nel nodo dell'argomento secondario.

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.

Se tuttavia esegui il reindirizzamento a uno di questi argomenti di sistema, 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

Quando la conversazione termina, puoi creare un sondaggio che chiede agli utenti se hanno ottenuto la risposta che cercavano o se il problema è stato 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.

Alla fine di una risposta che risolve il problema dell'utente o risponde alla sua domanda, aggiungi un nodo Termina la conversazione.

• 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.

  (Facoltativo) Immetti un messaggio privato per l'agente.

  

Aggiungi una condizione

1. Per aggiungere una logica di diramazione basata su variabili, seleziona "+" Aggiungi nodo per aggiungere un nodo.

2. Seleziona Aggiungi una condizione.

3. Seleziona Ramo basato su una condizione.

4. Seleziona la variabile che determina se la conversazione del bot deve a questo punto diramarsi.

   Ad esempio, se imposti autenticazione utente, potresti volere un messaggio diverso se l'utente ha effettuato l'accesso.

Eliminazione dei nodi

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

Testa e pubblica il tuo bot

Testa il tuo agente quando apporti modifiche ai tuoi argomenti per assicurarti che tutto funzioni come previsto.

Dopo aver progettato e testato il tuo bot, pubblicalo sul Web, sulle app per dispositivi mobili o native o nei canali Microsoft Bot Framework.

Progettazione del percorso di conversazione dell'argomento - Teams

1. Nell'elenco argomento del tuo agente, Seleziona inserisci il argomento che vuoi modificare. Ad esempio, potresti voler modificare l'argomento Orari di apertura.

   

   Una volta aperta, vedi le frasi trigger dell'argomento. Questa area del contenuto è l'area in cui si definisce il percorso di conversazione tra un cliente e il bot.

   Quando crei un nuovo argomento, un nodo Frasi trigger e un nodo vuoto Messaggio vengono inseriti per l'utente.

   Per gli argomenti esistenti o quelli di sistema, verranno creati automaticamente diversi nodi con ciascun nuovo argomento. Puoi modificare questi nodi, se necessario.

2. Puoi aggiungere più nodi selezionando "+" Aggiungi nodo tra i nodi o dopo un nodo.

   

3. Per spostare i percorsi tra nodi, trascina l'ancora del nodo, il piccolo cerchio sopra il nodo. Vedrai una linea punteggiata che indica il percorso originale.

   

Inserimento dei nodi - Teams

Quando aggiungi un nodo a un nodo di frasi trigger, scegli tra cinque diverse opzioni:

• Fai una domanda
• Chiama un'azione
• Mostra un messaggio
• Reindirizzare a un altro argomento
• Termina la conversazione

Se vuoi reindirizzare un argomento, puoi andare a un altro argomento.

Fai una domanda - Teams

1. Seleziona l'opzione Fai una domanda del menu "+" Aggiungi nodo per aggiungere un nuovo nodo Domanda. Viene visualizzato un nodo domanda.

   

2. Immetti la frase di domanda nel campo Fai una domanda.

   Ad esempio, se l'utente desidera conoscere gli orari del negozio, la domanda del bot potrebbe essere Di quale negozio hai bisogno?

3. 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.

4. 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.

   

   Ogni scelta viene presentata all'utente come un pulsante a scelta multipla nella chat, ma gli utenti possono anche digitare la propria risposta.

5. (Facoltativo) Salva la risposta dell'utente in una variabile da usare in seguito.

L'editor delle conversazioni crea percorsi separati nella conversazione, a seconda della risposta del cliente. Il percorso di conversazione porta il cliente alla soluzione appropriata per ogni risposta. Puoi aggiungere altri nodi per creare una logica di ramificazione e specificare con quale bot deve rispondere per ogni percorso o valore.

Aggiungi una condizione - Teams

Su alcuni tipi di nodo è possibile aggiungere una condizione.

1. Per aggiungere una logica di diramazione basata su variabili, seleziona il menu "+" Aggiungi nodo, quindi seleziona Aggiungi una condizione per aggiungere un nuovo nodo. Vengono visualizzati un paio di nodi di condizione.

2. Scegli la variabile che desideri utilizzare per determinare se la conversazione bot deve ramificarsi a questo punto.

   

Chiama un'azione - Teams

Puoi chiamare flussi di Power Automate selezionando il menu Chiama un'azione nel menu "+" Aggiungi nodo.

Mostra un messaggio - Teams

Un messaggio può specificare una risposta dal tuo bot all'utente.

1. Seleziona il menu "+" Aggiungi nodo, quindi seleziona Mostra un messaggio per aggiungere un nuovo nodo Messaggio.

2. Inserisci quello 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.

Termina la conversazione - Teams

Puoi scegliere di Terminare la conversazione come nodo finale della conversazione del tuo bot.

Sono disponibili due opzioni:

• Fine con sondaggio mostra un sondaggio, è possibile fare in modo che venga visualizzato un sondaggio che chiede all'utente se ha ottenuto la risposta che cercava o se il suo problema è stato risolto. Queste informazioni sono raccolte nella pagina di analisi della soddisfazione del cliente.

  

• Trasferisci all'agente ti consente di digitare un messaggio privato a un agente che avvia il contatto con l'utente.

Reindirizzare a un altro argomento - Teams

Per fare in modo che il bot si sposti automaticamente a un argomento separato, seleziona Aggiungi nodo (+) per aggiungere un nodo, quindi Reindirizzare a un altro argomento.

Nel menu a comparsa, seleziona l'argomento su cui deviare il bot. Ad esempio, è possibile che si desideri indirizzare l'utente a un argomento specifico sulla chiusura di un negozio qualora l'utente chieda informazioni sul suo orario.

Quando il bot passa a un altro argomento, seguirà il percorso di conversazione per quell'argomento e poi tornerà all'argomento originale, nel punto in cui è stato lasciato.

Puoi considerare l'argomento reindirizzato come argomento secondario.

Se tuttavia esegui il reindirizzamento a uno dei seguenti argomenti di sistema, l'intera conversazione termina:

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

Utilizzare variabili

Puoi anche usare variabili definite altrove nella conversazione con il bot.

Eliminazione dei nodi - Teams

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

Testa e pubblica il tuo bot - Teams

Dopo aver apportato modifiche ai tuoi argomenti, testa il tuo agente per assicurarti che tutto funzioni come previsto.

Una volta che hai finito di progettare e testare il tuo bot, puoi pubblicarlo in modo che altri membri del team possano utilizzarlo.