Condividi tramite


Creare e modificare argomenti

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

Per creare gli argomenti, puoi personalizzare i modelli forniti, creare argomenti da zero o descrivere ciò che desideri e lasciare che l'IA crei l'argomento per te.

In Copilot Studio, un argomento rappresenta una parte di un thread di conversazione tra un utente e un copilota. Puoi definire e lavorare con gli argomenti su un'area del contenuto. Un argomento contiene uno o più nodi di conversazione, che definiscono insieme i percorsi conversazionali che un argomento può intraprendere. Ogni nodo esegue un'azione, come inviare un messaggio o porre una domanda.

Spesso, un argomento ha un set di frasi trigger: frasi, parole chiave e domande digitate probabilmente dagli utenti e relative a un problema specifico. I copiloti di Copilot Studio utilizzano la comprensione del linguaggio naturale, il messaggio del cliente e le frasi trigger per tutti i tuoi argomenti per trovare l'argomento migliore da attivare. Non è necessario che il messaggio corrisponda esattamente alle frasi trigger di argomento per attivare l'argomento. Ad esempio, un argomento sull'orario del punto vendita potrebbe includere la frase di attivazione check store hours. Se un cliente immette "consulta gli orari di apertura del negozio", questa frase attiva l'argomento orari del negozio.

Prerequisiti

Natural Language Understanding

Un copilota usa la comprensione del linguaggio naturale (NLU) per analizzare ciò che un cliente ha digitato e trovare la frase trigger o il nodo più appropriato.

Ad esempio, un utente potrebbe digitare "Orario di apertura". Il copilota abbinerà l'argomento Orari del punto vendita e inizia una conversazione che chiede a quale punto vendita è interessato il cliente, quindi visualizza l'orario di apertura del punto vendita.

Il riquadro Prova copilota mostra come si svolge la conversazione del copilota in ogni fase. Puoi usare il riquadro Copilota di test per mettere a punto un argomento senza dover uscire dal portale Copilot Studio.

Per i limiti di copiloti e argomenti, fai riferimento all'argomento Quote, limiti, registrazione app, certificati e valori di configurazione.

Argomenti in Copilot Studio

Tipi di argomento

Un copilota può includere due tipi di argomenti: di sistema e personalizzato. Ogni nuovo copilota 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 di sistema dispongono di frasi trigger che puoi personalizzare per soddisfare le esigenze del tuo copilota.

    • 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 avrai acquisito dimestichezza con la creazione di esperienze copilota complete, non è consigliabile 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 modificare gli argomenti personalizzati predefiniti o rimuoverli interamente dal tuo copilota.
    • Tutti gli argomenti che crei sono argomenti personalizzati.

Tipi di nodo

Sono disponibili i tipi di nodo descritti di seguito:

Opzione Descrzione
Inviare un messaggio Invia un messaggio al cliente.
Fai una domanda Fai una domanda al cliente.
Chiedi con una scheda adattiva Crea un frammento di codice JSON da scambiare con altre app.
Creare utilizzando le condizioni Dirama la conversazione in base a una condizione.
Gestione variabili Imposta un valore, analizza un valore o cancella tutte le variabili.
Gestisci argomenti Reindirizza, trasferisci o termina l'argomento o la conversazione.
Chiama un flusso Richiama un flusso Power Automate o Excel Online oppure utilizza un connettore o un plug-in.
Avanzato 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. Apri il tuo copilota dall'elenco nella pagina Copiloti. Per una migliore visibilità, chiudi il pannello Testa il tuo copilota 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 copilota 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.

    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 dell'argomento del tuo copilota:

    • Inserisci un nome per identificare l'argomento, ad esempio "Orari del negozio". La pagina Argomenti elenca tutti gli argomenti definiti nel tuo copilota, in base a questo nome.
    • Se lo desideri, inserisci un nome visualizzato da mostrare al cliente quando il copilota non riesce a determinare quale argomento corrisponde al messaggio del cliente.
    • Se desiderato, usa il campo Descrizione per descrivere lo scopo dell'argomento per te stesso e per gli altri creatori di copiloti 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.

Importante

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

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.

    Screenshot delle opzioni disponibili per la selezione per inserire un nodo dopo un nodo Trigger.

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.

Screenshot dei controlli della barra degli strumenti per la modifica dei nodi sul canvas di creazione.

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.

Screenshot del menu Annulla.

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 copilota utilizza la modalità generativa, può compilare automaticamente input di argomento dal contesto della conversazione o dopo aver generato 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 seleziona + Crea>Da vuoto.

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

    Screenshot di come aprire l'editor di codice per un argomento.

  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.

    Screenshot di una conversazione creata da YAML nell'editor di codice Copilot Studio.

Testa e pubblica il tuo copilota

Testare il copilota quando apporti modifiche ai tuoi argomenti, per assicurarti che tutto funzioni come previsto.

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