Gestisci argomenti

Errori degli argomenti

Quando salvi un argomento, Copilot Studio segnala eventuali problemi nell'argomento.

• Gli errori impediscono il funzionamento del tuo agente. Devi correggerli prima di poter pubblicare il tuo agente.
• Avvertenze non impediscono il funzionamento del tuo agente, ma potrebbero impedire ad alcuni argomenti di funzionare come previsto. Dovresti correggere gli avvisi quando li vedi.

Sulla pagina Argomenti puoi vedere se un argomento contiene errori e il numero di errori nella colonna Errori. Questa pagina mostra solo gli errori perché, a differenza degli avvisi, gli errori impediscono il funzionamento del tuo agente.

Visualizzare gli errori degli argomenti

1. Apri il tuo argomento dalla pagina Argomenti.

2. Seleziona Verifica argomento nella barra degli strumenti.

   Viene visualizzato il pannello Verifica argomento con gli errori e gli avvisi per il tuo argomento.

3. Seleziona un errore per andare direttamente al nodo che contiene l'errore.

Stato dell'argomento

Gli argomenti possono avere uno stato Attivo o Disattivo per indicare se possono essere utilizzati o attivati in una conversazione agente. Per impostazione predefinita, vengono creati nuovi argomenti con il loro stato impostato su Disattivato.

Quando un argomento è Abilitato, si attiva come previsto. Gli argomenti vengono attivati ​​in seguito alle sue frasi di attivazione o quando un altro argomento reindirizza ad esso.

Quando un argomento viene Disattivato:

• L'icona argomento diventa grigia con un indicatore.
• L'argomento non si attiva affatto.
• L'argomento non si attiva quando le frasi trigger vengono utilizzate in una conversazione o se un altro argomento reindirizza ad esso.
• La verifica dell'argomento identifica un errore se un altro argomento reindirizza a un argomento Disattivato.
• Quando pubblichi un agente, vengono pubblicati tutti gli argomenti, indipendentemente dal fatto che siano Attivi o Disattivi.

Attivare/disattivare un argomento

Per modificare lo stato di un argomento, seleziona l'icona Altre opzioni (…) accanto al nome dell'argomento e utilizza l'interruttore Stato.

Copia di un argomento

Dopo aver creato alcuni argomenti, potresti voler utilizzare un argomento precedente come base per la creazione di nuovi argomenti.

Nella pagina Argomenti, seleziona l'icona Altre opzioni (...) accanto al nome dell'argomento, quindi seleziona Crea una copia.

In questo modo l'argomento selezionato viene duplicato con (Copia) aggiunto al nome. Tutto il contenuto dell'argomento, come la descrizione, le frasi trigger e l'intera conversazione, viene copiato nel nuovo argomento.

Per evitare confusione con l'argomento originale, che ha le stesse frasi trigger, valuta la possibilità di Disattivare il nuovo argomento.

Quando hai finito di modificare il nuovo argomento, impostalo su Attivato per provarlo. Quando è pronto, pubblica il nuovo argomento.

Non esiste limite al numero di volte che puoi copiare un argomento. Ogni argomento ha il proprio ID interno.

Rinominare un argomento

Puoi utilizzare la barra degli strumenti dell'area del contenuto per rinominare rapidamente un argomento. Nella barra degli strumenti, seleziona Argomenti, quindi seleziona il nome dell'argomento nell'elenco. Nella pagina dell'argomento, seleziona il nome dell'argomento, digita un nuovo nome e quindi premi Invio.

Reindirizzare a un altro argomento

Per spostare la conversazione da un argomento a un altro senza ricominciare da capo, aggiungi un nodo Reindirizzamento. Quando la conversazione raggiunge la fine dell'argomento di destinazione, ritorno all'argomento di origine per impostazione predefinita. Puoi inserire più nodi dopo il nodo Reindirizzamento, se lo desideri.

1. Seleziona l'icona Aggiungi nodo sotto il nodo in cui desideri che avvenga la transizione, punta a Gestione argomento e seleziona Vai a un altro argomento.

2. Seleziona l'argomento di destinazione desiderato nell'elenco.

3. Passa variabili tra argomenti se necessario. Se l'argomento sul quale stai eseguendo il reindirizzamento richiede variabili di input o si prevede che restituisca variabili di output all'argomento di origine, inserisci o seleziona un valore per ciascuno di essi.

4. Salva il tuo argomento, quindi utilizza il riquadro Test agente per confermare che il tuo agente chiami correttamente il argomento di destinazione.

Terminare l'argomento corrente o tutti gli argomenti

Per impostazione predefinita, una conversazione reindirizzata ritorna all'argomento di origine alla fine dell'argomento chiamato. Per uscire da un argomento o per terminare la conversazione, utilizza il nodo Termina argomento corrente o il nodo Termina tutti gli argomenti.

• Un nodo Fine argomento corrente termina l'argomento corrente. Se l'attuale argomento viene chiamato da un altro argomento, la conversazione ritorna immediatamente all'argomento originale. Un uso comune di questo nodo è in un ramo di condizione. Un ramo esce in anticipo da argomento, mentre un altro ramo continua l'attuale argomento.

• Un nodo Termina tutti gli argomenti termina immediatamente tutti gli argomenti attivi. Il tuo agente considera il messaggio successivo dell'utente come il primo messaggio di una nuova conversazione.

  Per far sapere all'utente che la conversazione è terminata, aggiungi un nodo Termina conversazione prima del nodo Termina tutti gli argomenti.

Molti degli argomenti di sistema utilizzano questi nodi per controllare come terminano o ricominciano le conversazioni. Informazioni su come utilizzare argomenti di sistema.

Errori degli argomenti

Quando salvi un argomento, riceverai una notifica in caso di errori o avvisi. Gli avvisi non impediranno al copilota di funzionare, ma potrebbero far sì che singoli argomenti non funzionino come previsto, quindi dovresti correggerli quando li vedi.

Gli errori impediscono al copilota di funzionare e devono essere corretti prima di poterlo pubblicare.

Puoi vedere se ci sono errori negli argomenti nella colonna Errori della pagina Argomenti e Plug-in.

Seleziona il conteggio degli errori per aprire l'area del contenuto e andare alla posizione dell'errore. Seleziona Verifica argomento per visualizzare un elenco degli errori. La selezione di ogni errore consente di passare direttamente all'errore.

Tipi di errori

Esistono quattro tipi di errori che vengono visualizzati nella verifica degli argomenti e nell'area del contenuto:

• Nodo: l'intero nodo non è corretto ed è evidenziato in rosso.
• Campo: nel campo potrebbero mancare i dati obbligatori ed è evidenziato in rosso.
• Espressione:l'espressione potrebbe non essere valida ed è evidenziata in rosso.
• Eliminazione variabile: una variabile in un argomento è stata eliminata e l'errore è evidenziato in rosso ovunque sia stata utilizzata. Questo fa sì che la variabile diventi "orfana" e deve essere rimossa o sostituita.

Stato dell'argomento

Gli argomenti possono avere lo stato di Attivato o Disattivato per indicare se possono essere utilizzati o attivati ​​in una conversazione del copilota. Per impostazione predefinita, vengono creati nuovi argomenti con il loro stato impostato su Disattivato. Modifica lo stato usando il contattore nella colonna Stato della pagina Argomenti e plug-in.

Quando un argomento è Abilitato, si attiva come previsto. Gli argomenti vengono attivati ​​in seguito alle sue frasi di attivazione o quando un altro argomento reindirizza ad esso.

Quando un argomento è impostato su Disattivato:

• L'argomento non si attiva affatto.
• L'argomento non si attiva quando le frasi trigger vengono utilizzate in una conversazione o se un altro argomento reindirizza ad esso.
• La verifica dell'argomento identifica un errore se un altro argomento reindirizza a un argomento Disattivato.
• Tutti gli argomenti vengono pubblicati quando sei pronto per pubblicare il tuo copilota, indipendentemente dal fatto che siano Abilitati o Disabilitati.

Controlla lo stato dalla colonna Stato, Abilitato o Disabilitato.

Per impostazione predefinita, verranno creati nuovi argomenti con il loro stato impostato su Attivato.

Copia di un argomento

Dopo aver creato alcuni argomenti, potresti voler utilizzare un argomento precedente come base per la creazione di nuovi argomenti.

Nella pagina Argomenti, seleziona l'icona Altre azioni (⋮) accanto al nome dell'argomento e seleziona Crea una copia.

In questo modo viene creato un duplicato dell'argomento selezionato con (Copia) aggiunto al nome. Tutto il contenuto dell'argomento, come la descrizione, le frasi trigger e l'intera conversazione, viene copiato nel nuovo argomento.

Un argomento copiato ha uno stato Disattivato per impostazione predefinita quando viene copiato per evitare confusione su quale argomento si innescherà, poiché le frasi trigger sono le stesse dell'argomento originale.

Una volta terminata la modifica del nuovo argomento, puoi Attivarlo per testarlo nel riquadro Testa il copilota. Quando sei pronto, pubblica il nuovo argomento.