Creare e modificare argomenti

Importante

Le capacità e funzionalità di Power Virtual Agents ora fanno parte di Microsoft Copilot Studio a seguito di investimenti significativi nell'intelligenza artificiale generativa e integrazioni migliorate in Microsoft Copilot.

Alcuni articoli e schermate potrebbero fare riferimento a Power Virtual Agents durante l'aggiornamento della documentazione e dei contenuti per il training.

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

Per creare gli argomenti puoi personalizzare i modelli forniti, creare nuovi argomenti da zero oppure ottenere suggerimenti da siti di supporto esistenti.

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 Microsoft 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 invia "vedi gli orari di apertura del negozio", verrà attivato 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 Copilota di test 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 del copilota e dell'argomento, vedi Quote, limiti e valori di configurazione.

Argomenti in Microsoft Copilot Studio

Tipi di argomento

Un copilota può includere due tipi di argomenti, di sistema e personalizzato. Ogni nuovo copilota inizia con una serie di argomenti di sistema e personalizzati.

  • 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 riguardano comportamenti comuni, come salutare un cliente, terminare una conversazione o riavviare una conversazione.

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

Tipi di nodo

I tipi di nodi disponibili sono i seguenti:

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.
Aggiungi una condizione Dirama la conversazione in base a una condizione.
Gestione variabili Imposta un valore, analizza un valore o cancella tutte le variabili.
Gestione argomenti Reindirizza, trasferisci o termina l'argomento o la conversazione.
Chiama un'azione 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.

Creare un argomento

  1. Apri il tuo copilota dall'elenco nella pagina Copiloti. Per una migliore visibilità, chiudi la finestra Test copilota per ora.

  2. Seleziona Argomenti e plug-in nel riquadro di spostamento laterale.

  3. Seleziona + Crea, punta ad Argomento e seleziona Da vuoto.

    Il nodo Trigger viene visualizzato su un argomento dell'area del contenuto altrimenti vuoto e il riquadro Proprietà Su intento riconosciuto è aperto. Se il riquadro non è aperto, seleziona l'icona menu Nodo () del nodo Trigger e seleziona Proprietà.

  4. Nel riquadro Proprietà Su intento riconosciuto, fai clic sull'area Frasi. Viene visualizzato il riquadro secondario Frasi.

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

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

  7. Aggiungi i dettagli dell'argomento del tuo copilota:

    • Inserisci un nome per identificare l'argomento, ad esempio "Orari del negozio". La pagina Argomenti e plug-in elenca tutti gli argomenti definiti nel tuo copilota, con questo nome.
    • Se lo desideri, inserisci un nome visualizzato che il tuo copilota mostrerà al cliente quando 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.
  8. Per salvare l'argomento, seleziona Salva nella barra dei menu in alto.

Progettare un percorso di conversazione dell'argomento

Quando crei un argomento, questo aggiunge automaticamente un nodo Trigger 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 () del nodo che desideri eliminare, quindi seleziona Elimina.

Controlli per la modifica dei nodi nel canvas

Puoi utilizzare la barra degli strumenti dell'area del contenuto per rinominare rapidamente l'argomento. Seleziona il nome dell'argomento nella barra degli strumenti, digita il nuovo nome, quindi premi Invio.

Screenshot del canvas di creazione dell'argomento che evidenzia il nome dell'argomento.

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

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 + Nuovo argomento.

  2. Nell'angolo in alto a destra dell'area di creazione, seleziona ... per visualizzare Altre opzioni, quindi seleziona Apri editor di codice.

    Screenshot che mostra come aprire l'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.

    Screenshot di una conversazione creata da YAML nell'editor di codice Microsoft 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.