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 lavori 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 Dialogflow Trial Edition. Per modificare la versione per un agente:

Console

Nota: solo i proprietari del progetto possono modificare l'edizione di un agente nella console di Dialogflow.

1. Scorri fino in fondo al menu della barra laterale sinistra, dove viene visualizzata l'edizione dell'agente
2. Fai clic sul link Modifica o Esegui l'upgrade.
3. Seleziona un piano

API

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

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

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

Sono disponibili le seguenti impostazioni:

• Descrizione: la 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 è fornito nelle richieste API.
• URI avatar agente: un URI per l'avatar del tuo 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 log:

  • Registra le interazioni in Dialogflow:

    Nota :per visualizzare o modificare questa impostazione con la console, devi disporre del ruolo Proprietario progetto IAM. 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 di 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 Proprietario progetto IAM. Questa impostazione non è disponibile nell'API.

    Indica se Cloud Logging è abilitato per l'agente. Questa opzione è disponibile solo se è attivata l'opzione Registra interazioni in Dialogflow. La disattivazione della registrazione di Dialogflow disattiva 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 utenti devono essere rimossi dall'agente prima di poterlo eliminare. Consulta Gestione 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 saperne di più, 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, abbinarle agli intent ed estrarre dati strutturati. Un agente apprende dalle 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 è unico 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 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 regolare la soglia di classificazione del 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 è attivata e l'input utente contiene un errore ortografico o grammaticale, l'intent verrà abbinato come se fosse scritto correttamente. La risposta di rilevamento dell'intent conterrà l'input utente corretto. Ad esempio, se un utente inserisce "Voglio una mela", la richiesta verrà elaborata come se l'utente 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.

  Nota :se l'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), quindi non è consigliabile attivarla per gli agenti che utilizzano input ASR.
  • È possibile che l'input corretto corrisponda all'intent sbagliato. Puoi risolvere il problema aggiungendo frasi che non corrispondono 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 linguaggio specifico per il 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.

Esportazione e importazione

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à 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 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 attuale con il file zip fornito.
• Importa da ZIP: aggiunge intent ed entità all'agente corrente dal file zip fornito. Se intent o 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 prima come 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)

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

• Nome agente
• Editor in linea file package.json e index.json
• Impostazioni 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.

Versioni e 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 di sintesi vocale, fai clic sulla scheda Sintesi vocale.

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

• Migliorare la qualità del riconoscimento vocale
  • Attiva modelli vocali avanzati e logging dei dati: consulta Logging dei dati e modelli vocali avanzati.
  • Attiva l'adattamento vocale automatico: vedi Adattamento vocale automatico.
• Text to Speech
  • Attiva sintesi vocale automatica: Converte automaticamente le risposte di testo predefinite in voce in tutte le conversazioni. Vedi Rilevamento dell'intent con l'uscita audio.
  • Configurazione della voce:
    • Lingua dell'agente: Scegli la lingua predefinita per la sintesi vocale.
    • Voce: Scegli un modello di sintesi vocale.
    • Velocità del parlato: regola la velocità del parlato della voce.
    • Tono: Regola il tono della voce.
    • Guadagno del volume: regola il guadagno del volume audio.
    • Profilo effetti audio: seleziona i profili degli effetti audio da applicare alla voce sintetizzata. L'audio della voce è ottimizzato per i dispositivi associati ai profili selezionati (ad esempio cuffie, speaker di grandi dimensioni, chiamata). 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 saperne di più, consulta Controllo dell'accesso.

Avanzato

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

Al momento, solo una funzionalità è controllata da queste impostazioni. Per saperne di più, vedi Analisi del sentiment.