Impostazioni dell'agente

Questa pagina descrive le varie impostazioni che puoi applicare a un agente. Per accedere a queste impostazioni:

1. Vai alla console di Dialogflow ES
2. Seleziona il tuo agente nella parte superiore del menu della barra laterale sinistra.
3. Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.

Versione agente

Per impostazione predefinita, gli agenti utilizzano Dialogflow Trial Edition. Per modificare la versione di un agente:

Se utilizzi più progetti, il progetto consumer viene utilizzato per determinare l'edizione per le quote e gli addebiti.

Generale

Per accedere alle impostazioni generali, fai clic sulla scheda Generali.

Sono disponibili le seguenti impostazioni:

• Descrizione: descrizione dell'agente.
• Fuso orario predefinito: il fuso orario predefinito per l'agente. Le richieste di data e ora vengono risolte utilizzando questo fuso orario se il fuso orario non è specificato nelle richieste API.
• URI avatar agente: un URI per l'avatar dell'agente utilizzato da alcune integrazioni.
• Progetto Google: progetto Google Cloud collegato all'agente.
• Versione del protocollo webhook dell'agente: visibile solo negli agenti della versione precedente dell'API V1. Ti consente di passare al formato webhook dell'API V2.
• Funzionalità beta: attiva/disattiva questa opzione per attivare le funzionalità beta per l'agente.

• Impostazioni log:

  • Registra le interazioni in Dialogflow:

    Indica se la registrazione delle interazioni è abilitata per l'agente.

  • Registra le interazioni con Google Cloud:

    Indica se Cloud Logging è abilitato per l'agente. Questa opzione è disponibile solo se è attiva l'opzione Registra le interazioni in Dialogflow. La disattivazione della registrazione di Dialogflow comporterà anche la disattivazione di questa impostazione. Puoi anche fare clic sul link Apri log per aprire i log dell'agente in Cloud Logging.

• Elimina agente: elimina completamente l'agente e l'operazione non può essere annullata. Se l'agente è condiviso con altri utenti, questi utenti devono essere rimossi dall'agente prima che tu possa eliminarlo. Consulta Gestione degli agenti.

Lingue

Per accedere alle impostazioni della lingua, fai clic sulla scheda Lingua.

Puoi impostare la lingua predefinita e più lingue aggiuntive. Per alcune lingue principali, puoi anche aggiungere una o più impostazioni internazionali. Per ulteriori informazioni, consulta Agenti multilingue.

Impostazioni ML (machine learning)

Per accedere alle impostazioni di machine learning, fai clic sulla scheda Impostazioni ML.

Gli agenti Dialogflow utilizzano algoritmi di machine learning per comprendere le espressioni degli utenti finali, associarle alle intenzioni ed estrarre i dati strutturati. Un agente impara dalle frasi di addestramento che fornisci e dai modelli linguistici integrati in Dialogflow. In base a questi dati, viene creato un modello per prendere decisioni su quale intent deve essere associato a un'espressione dell'utente finale. Questo modello è univoco per l'agente.

Per impostazione predefinita, Dialogflow aggiorna il modello di machine learning dell'agente ogni volta che apporti modifiche a intent ed entità, importi o ripristini un agente o lo addestri.

Sono disponibili le seguenti impostazioni:

• Soglia di classificazione ML: per filtrare i risultati falsi positivi e ottenere comunque una varietà di input in linguaggio naturale corrispondenti per l'agente, puoi ottimizzare la soglia di classificazione del machine learning. Questa impostazione controlla la confidenza del rilevamento dell'intenzione minima richiesta per una corrispondenza dell'intenzione.

• Correzione ortografica automatica:

  Se questa opzione è attivata e l'input utente contiene un errore ortografico o grammaticale, viene trovata una corrispondenza per un'intenzione come se fosse stata scritta correttamente. La risposta al rilevamento dell'intenzione conterrà l'input utente corretto. Ad esempio, se un utente inserisce "Voglio una mela", viene elaborato come se avesse inserito "Voglio una mela". Questo vale anche per le corrispondenze che coinvolgono entità di sistema e personalizzate.

  La correzione ortografica è disponibile per tutte le lingue supportate da Dialogflow.

  Avvisi e best practice:

  • La correzione ortografica non può correggere gli errori del riconoscimento vocale automatico (ASR), pertanto non è consigliabile attivarla per gli agenti che utilizzano input ASR.
  • È possibile che l'input corretto corrisponda all'intent sbagliato. Per risolvere il problema, aggiungi frasi con mancata corrispondenza comune agli esempi negativi.
  • La correzione ortografica aumenta leggermente il tempo di risposta dell'agente.
  • La correzione ortografica non deve essere utilizzata con Actions on Google.
  • La correzione ortografica viene addestrata sulle query generali degli utenti. Se un agente è definito utilizzando un gergo specifico del dominio, le correzioni potrebbero non essere auspicabili.

• Addestramento automatico: attiva o disattiva l'addestramento automatico dell'agente ogni volta che l'agente viene modificato.

• Convalida dell'agente: consulta la guida alla convalida dell'agente.

Esportazione e importazione

Per accedere alle impostazioni di esportazione e importazione, fai clic sulla scheda Esporta e importa.

Questa funzionalità consente di esportare/importare un agente in/da un file ZIP per eseguire il backup degli agenti o trasferirli da un account all'altro. Sebbene tu possa modificare direttamente i file JSON e importarli di nuovo, la modifica deve essere eseguita utilizzando la console o l'API Dialogflow. In questo modo, le modifiche vengono convalidate dal sistema e la risoluzione dei problemi viene ridotta al minimo.

Sono disponibili le seguenti opzioni:

• Esporta come ZIP: esporta l'agente come file zip.
• Ripristina da ZIP: sovrascrive l'agente corrente con il file zip fornito.
• Importa da ZIP: aggiunge intent ed entità all'agente corrente dal file zip fornito. Se gli intent o le entità esistenti hanno lo stesso nome di quelli nel file zip, verranno sostituiti.

Queste opzioni vengono applicate alla bozza dell'agente. Per esportare una versione dell'agente, caricala come bozza.

Nell'esportazione di un agente sono inclusi i seguenti elementi:

• Intent
• Entità
• La maggior parte delle impostazioni dell'agente (vedi l'elenco di seguito per le impostazioni escluse)

I seguenti elementi non sono inclusi nell'esportazione di un agente e non vengono sovrascritti durante l'importazione o il ripristino:

• Nome agente
• File Editor in lineapackage.json e index.json
• Impostazioni di integrazione
• Versione
• Knowledge base e documenti delle conoscenze
• Impostazioni di sintesi vocale
• Log di interazione

La dimensione massima dell'agente (contenuti non compressi) per l'importazione/il ripristino dell'agente non deve superare i 50 MB.

Ambienti

Per accedere alle impostazioni degli ambienti, fai clic sulla scheda Ambienti.

Le versioni e gli ambienti ti consentono di eseguire il deployment di più versioni dell'agente in ambienti separati e personalizzabili. Per ulteriori informazioni, consulta Versioni e ambienti.

Voce

Per accedere alle impostazioni di sintesi vocale, fai clic sulla scheda Voce.

Queste sono le impostazioni per il riconoscimento vocale e la sintesi vocale. Sono disponibili le seguenti impostazioni:

• Migliorare la qualità del riconoscimento vocale
  • Attiva i modelli vocali avanzati e il logging dei dati: consulta Logging dei dati e modelli vocali avanzati.
  • Attiva l'adattamento vocale automatico: consulta Adattamento vocale automatico.
• Sintesi vocale
  • Attiva la sintesi vocale automatica: converti automaticamente le risposte di testo predefinite in voce in tutte le conversazioni. Consulta Rilevamento dell'intent con l'output audio.
  • Configurazione vocale:
    • Lingua agente: scegli la lingua predefinita per la sintesi vocale.
    • Voce: scegli un modello di sintesi vocale.
    • Velocità voce: consente di regolare la velocità della voce.
    • Tono: consente di regolare l'intonazione della voce.
    • Guadagno del volume: consente di regolare il guadagno del volume audio.
    • Profilo effetti audio: seleziona i profili di effetti audio da applicare alla voce sintetizzata. L'audio vocale è ottimizzato per i dispositivi associati ai profili selezionati (ad esempio cuffie, altoparlanti di grandi dimensioni, telefonate). Per un elenco dei profili disponibili, consulta Utilizzare i profili dei dispositivi per l'audio generato nella documentazione di Text-to-Speech.

Condividi

Per accedere alle impostazioni di condivisione, fai clic sulla scheda Condividi.

Queste impostazioni vengono utilizzate per condividere l'accesso all'agente con altri sviluppatori. Per ulteriori informazioni, consulta Controllo dell'accesso.

Avanzato

Per accedere alle impostazioni avanzate, fai clic sulla scheda Avanzate.

Al momento, esiste una sola funzionalità controllata da queste impostazioni. Per ulteriori informazioni, consulta Analisi del sentiment