Utilizza l'editor di codice per scrivere e modificare YAML negli argomenti

Gli argomenti possono essere scritti e modificati nell'editor di codice, che supporta l'uso di YAML. YAML sta per "YAML Ain't Markup Language" (YAML non è un linguaggio di markup). YAML è tipicamente usato per scrivere file di configurazione ed è più facile da leggere rispetto a XML o JSON. I file YAML utilizzano l'estensione .yaml o .yml. I file YAML vengono formattati con spaziatura e rientro per rappresentare strutture di dati, ad esempio stringhe, numeri, valori booleani, elenchi e dizionari.

Per accedere all'editor di codice da un argomento, seleziona (…) Altro sulla barra degli strumenti e poi seleziona Apri editor di codice.

Guarda questo video per avere una panoramica su come utilizzare YAML nell'editor di codice:

Quando utilizzare l'editor di codice

Copilot Studio non richiede di scrivere YAML da zero. YAML viene invece generato automaticamente quando crei oggetti sulla canvas dell'argomento. Puoi quindi rivedere la configurazione nell'editor del codice per comprendere meglio le impostazioni oppure puoi scegliere di apportare modifiche a YAML. Ecco alcuni casi d'uso per l'editor di codice:

• L'editor di codice mostra la configurazione completa di un argomento senza la necessità di interagire con i singoli elementi della finestra di dialogo all'interno dell'argomento. È il punto di riferimento unico per visualizzare tutte le impostazioni di un argomento.
• I creatori possono scegliere di copiare nodi specifici da un argomento e incollarli in altri argomenti, anziché utilizzare le icone Copia e Incolla. Potrebbe essere più semplice che selezionare più nodi di una configurazione.
• Gli autori potrebbero scegliere di aggiornare un ID di flusso Power Automate in YAML, anziché attendere la sincronizzazione con il menu Chiamata e Azione.
• Gli autori possono scegliere di clonare e rivedere i nodi Domanda o Messaggio quando sono simili. Tuttavia, in questi casi, è fondamentale assicurarsi che tutti gli ID e le variabili rimangano univoci. Ricorda di rivedere gli ID clonati per trasformarli in ID unici.
• Gli autori potrebbero scegliere di fare semplici revisioni nell'editor del codice, come aggiungere un termine alle frasi dell'argomento, poiché può essere più veloce digitare o copiare e incollare il testo nel codice YAML.

Informazioni su YAML nell'editor di codice

L'immagine seguente mostra un esempio di un blocco tipico di YAML.

Ecco come quel codice si applica all'argomento corrispondente così come appare sulla canvas.

• Riga 1: il tipo di argomento.
• Righe 2-3: indicano l'inizio di un argomento di ottimizzazione della conversazione.
• Riga 7: indica un nodo di risposte generative.
• Riga 9: la variabile rilevante.
• Righe 11-12: dettagli sul prompt e istruzioni speciali.
• Righe 20-26: collegamenti alle fonti delle informazioni.
• Righe 28-32: gruppo di condizioni. Ogni condizione ha un ID univoco, insieme ai dettagli della formula della condizione e ai reindirizzamenti.

Testa YAML nell'editor di codice

Se vuoi testare questo codice, completa i seguenti passaggi in Copilot Studio:

1. Creazione di un agente.

2. Vai alla pagina Impostazioni dell'agente e seleziona IA generativa e seleziona Generativa.

3. Vai alla pagina Argomenti, seleziona Sistema quindi l'argomento Ottimizzazione della conversazione.

4. Apri l'editor di codice.

5. Sostituisci il codice esistente con il seguente codice YAML di esempio.

    kind: AdaptiveDialog
    beginDialog:
     kind: OnUnknownIntent
     id: main
     priority: -1
     actions:
       - kind: SearchAndSummarizeContent
         id: search-content
         userInput: =System.Activity.Text
         variable: Topic.Answer
         moderationLevel: Medium
         additionalInstructions: Include emojis to make responses more fun.
         publicDataSource:
           sites:
             - "www.chessusa.com/"
             - "www.chess.com/"
             - "www.lichess.org/"
   
         sharePointSearchDataSource: {}
   
       - kind: ConditionGroup
         id: has-answer-conditions
         conditions:
           - id: has-answer
             condition: =!IsBlank(Topic.Answer)
             actions:
               - kind: EndDialog
                 id: end-topic
                 clearTopicQueue: true
   

6. Seleziona Salva, quindi chiudi l'editor di codice.

7. Prova l'agente nel riquadro Test ponendo una domanda relativa agli scacchi, ad esempio "Come si muove un cavallo?"

Informazioni correlate

• YAML non è una revisione del linguaggio di markup (YAML™) 1.2.2
• Verifica YAML: la convalida della sintassi YAML
• Convertitore da YAML a JSON