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 accanto al nome dell'agente

Nota: se stai lavorando su uno schermo piccolo e il menu della barra laterale è nascosto, fai clic sul pulsante del menu nell'angolo in alto a sinistra.

Versione dell'agente

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

Console

Nota: Solo i proprietari del progetto possono modificare la versione di un agente nella console di Dialogflow.

1. Scorri fino alla fine del menu della barra laterale sinistra, dove viene visualizzata la versione dell'agente
2. Fai clic sul link Modifica o Esegui l'upgrade
3. Seleziona un piano

API

Chiama il metodo setAgent per la risorsa Projects. Fornisci "TIER_ENTERPRISE" al campo tier per eseguire l'upgrade alla versione Dialogflow Essentials o "TIER_STANDARD" per ripristinare la versione di prova di Dialogflow.

Nota: l'autorizzazione minima richiesta per l'utilizzo di questo metodo è dialogflow.agents.create.

Se utilizzi più progetti, il progetto consumer viene utilizzato per determinare la versione per quote e addebiti.

Generale

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

Sono disponibili le seguenti impostazioni:

• Descrizione: descrizione dell'agente.
• Fuso orario predefinito: fuso orario predefinito per l'agente. Le richieste di data e ora vengono risolte utilizzando questo fuso orario se non viene fornito nelle richieste API.
• URI dell'avatar dell'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 legacy dell'API v1. Consente di passare al formato webhook dell'API v2.
• Funzionalità beta: attiva/disattiva per abilitare le funzionalità beta per l'agente.

• Impostazioni dei log:

  • Registra le interazioni in Dialogflow:

    Nota: per visualizzare o modificare questa impostazione con la console, devi disporre del ruolo IAM Project Owner. Per leggere o modificare questa impostazione con l'API, devi disporre di uno dei seguenti ruoli: amministratore API Dialogflow IAM, editor IAM, o proprietario IAM; oppure un ruolo personalizzato contenente l'autorizzazione dialogflow.agents.create.

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

  • Registra le interazioni in Google Cloud:

    Nota: per visualizzare o modificare questa impostazione con la console, devi disporre del ruolo IAM Project Owner. Questa impostazione non è disponibile nell'API.

    Indica se Cloud Logging è abilitato per l'agente. Questa opzione è disponibile solo se è abilitata l'opzione Registra le interazioni in Dialogflow. Se disattivi la registrazione di Dialogflow, verrà disattivata anche 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 non può essere annullata. Se l'agente è condiviso con altri utenti, questi devono essere rimossi dall'agente prima di poterlo eliminare. 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 locali. Per maggiori 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 agli intent ed estrarre dati strutturati. Un agente apprende da frasi di addestramento che fornisci e dai modelli linguistici integrati in Dialogflow. In base a questi dati, crea un modello per prendere decisioni su quale intent deve essere associato a un'espressione dell'utente finale. Questo modello è univoco per il tuo 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 addestri l'agente.

Sono disponibili le seguenti impostazioni:

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

  Nota: prima di modificare questo valore, prova ad aggiungere esempi negativi.

• Correzione ortografica automatica:

  Se questa opzione è abilitata e input utente contiene un errore di ortografia o grammatica, verrà associato un intent come se fosse scritto correttamente. La risposta di rilevamento dell'intent conterrà l'input utente corretto. Ad esempio, se un utente inserisce "I want an aple", verrà elaborato come se l'utente avesse inserito "I want an apple". Questo vale anche per le corrispondenze che coinvolgono sia entità di sistema sia entità personalizzate.

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

  Nota: se input utente originale e quello corretto corrispondono a intent diversi, viene selezionato l'intent corrispondente all'input utente originale.

  Avvisi e best practice:

  • La correzione ortografica non può correggere gli errori ASR (riconoscimento vocale automatico), pertanto non è consigliabile abilitarla per gli agenti che utilizzano input ASR.
  • È possibile che l'input corretto corrisponda all'intent sbagliato. Puoi risolvere il problema aggiungendo le frasi che non corrispondono spesso 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 degli utenti generali. Se un agente è definito utilizzando un gergo specifico del dominio, le correzioni potrebbero non essere desiderate.

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

  Nota: dopo il ripristino o l'importazione, l'agente viene riaddestrato, anche se l'addestramento automatico è disattivato.

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

Esporta e importa

Nota: i tipi di agenti Dialogflow ES e Dialogflow CX non sono compatibili. Non puoi importare un agente incompatibile.

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

Questa funzionalità ti consente di esportare/importare un agente da/in un file ZIP per eseguire il backup degli agenti o trasferirli da un account a un altro. Anche se puoi modificare direttamente i file JSON e importarli di nuovo, la modifica deve essere eseguita utilizzando la console o l'API di 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 esistono intent o entità con 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 prima nella bozza.

Di seguito sono riportati gli elementi inclusi nell'esportazione di un agente:

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

Di seguito sono riportati gli elementi non inclusi nell'esportazione di un agente e non sovrascritti durante l'importazione o il ripristino:

• Nome agente
• Editor incorporato file package.json e index.json
• Impostazioni di integrazione
• Versione
• Knowledge base e documenti della knowledge base
• Impostazioni vocali
• Log delle interazioni

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 maggiori informazioni, consulta Versioni e ambienti.

Voce

Per accedere alle impostazioni vocali, fai clic sulla scheda Voce.

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

• Migliora la qualità del riconoscimento vocale
  • Abilita modelli vocali avanzati e logging dei dati: consulta Logging dei dati e modelli vocali avanzati.
  • Abilita l'adattamento vocale automatico: consulta Adattamento vocale automatico.
• Sintesi vocale
  • Abilita la sintesi vocale automatica: converte automaticamente le risposte di testo predefinite in voce in tutte le conversazioni. Consulta Rilevamento dell'intent con l'uscita audio.
  • Configurazione vocale:
    • Lingua dell'agente: Scegli la lingua predefinita per la sintesi vocale.
    • Voce: Scegli un modello di sintesi vocale.
    • Velocità di pronuncia: regola la velocità di pronuncia della voce.
    • Tono: regola il tono della voce.
    • Guadagno del volume: regola il guadagno del volume audio.
    • Profilo degli effetti audio: seleziona i profili degli effetti audio che vuoi applicare alla voce sintetizzata. L'audio vocale è ottimizzato per i dispositivi associati ai profili selezionati (ad esempio cuffie, speaker di grandi dimensioni, chiamata telefonica). Per un elenco dei profili disponibili, consulta Utilizzare i profili dispositivo 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 maggiori informazioni, consulta Controllo dell'accesso.

Avanzato

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

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