Impostazioni dell'agente

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

1. Vai alla console 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 agente

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

Console

Nota: solo i proprietari del progetto possono cambiare la versione di un agente in la console Dialogflow.

1. Scorri fino in fondo al menu della barra laterale sinistra, in cui è mostrata 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 Progetti. Fornisci "TIER_ENTERPRISE" al campo tier per eseguire l'upgrade a Dialogflow Essentials o "TIER_STANDARD" per ripristinare la prova di Dialogflow completamente gestita.

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 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 dell'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 dell'avatar dell'agente utilizzato da alcune integrazioni.
• Progetto Google: progetto Google Cloud collegato all'agente.
• Agent Webhook Protocol Version: visibile solo in Agenti API V1. Consente di passare all'API V2 webhook.
• Funzionalità beta: attiva l'opzione 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 del progetto IAM. Per leggere o modificare questa impostazione con l'API, devi disporre di uno dei seguenti ruoli: Amministratore dell'API Dialogflow IAM, Editor IAM o Proprietario IAM; o un ruolo personalizzato contenente l'autorizzazione dialogflow.agents.create.

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

  • Registra le interazioni con Google Cloud:

    Nota: per visualizzare o modificare questa impostazione con la console, devi disporre del ruolo Proprietario del progetto IAM. 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. La disabilitazione del logging di Dialogflow disabiliterà 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 annullato. Se l'agente viene condiviso con altri utenti, ma questi utenti dovranno essere rimossi dall'agente prima di poterli eliminare. Consulta Gestione degli agenti.

Linguaggi

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, vedi 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 dell'utente finale, abbinarle agli intent, ed estrarre 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 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 pur mantenendo varietà nelle corrispondenti input in linguaggio naturale per il tuo agente, puoi ottimizzare la soglia di classificazione del machine learning. Questa impostazione controlla l'attendibilità minima del rilevamento dell'intenzione necessaria per una corrispondenza dell'intenzione.

  Nota: prima di modificare questo valore, dovresti provare ad aggiungere esempi di esclusione.

• Correzione ortografica automatica:

  Se questa opzione è attivata e l'input dell'utente contiene un errore ortografico o grammaticale, viene trovata una corrispondenza per un'intenzione come se fosse stata scritta correttamente. La risposta di rilevamento dell'intento 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.

  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 del riconoscimento vocale automatico (ASR), pertanto non è consigliabile attivarla per gli agenti che utilizzano input ASR.
  • È possibile che l'input corretto corrisponda all'intent errato. 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: Abilita o disabilita l'addestramento automatico degli agenti ogni volta che l'agente viene modificato.

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

• Convalida degli agenti: Consulta le guida alla convalida degli agenti.

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/verso un file ZIP per il backup degli agenti o per il loro trasferimento da un account all'altro. Anche se puoi modificare i file JSON direttamente e reimportarli, la modifica deve essere effettuata 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
• Editor incorporato file package.json e index.json
• Integrazione impostazioni
• Versione
• Knowledge base e documenti informativi
• Impostazioni di sintesi vocale
• 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 più versioni dell'agente per separare ambienti personalizzabili. Per ulteriori informazioni, vedi 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
  • Abilita modelli vocali avanzati e il logging dei dati: Vedi 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 Rilevare l'intent con l'output audio.
  • Configurazione dei comandi vocali:
    • 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.
    • Presentazione: Regola il tono della voce.
    • Guadagno del volume: consente di regolare il guadagno del volume audio.
    • Profilo 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 es. cuffie, altoparlante di grandi dimensioni, telefonata). Per un elenco dei profili disponibili, vedi Utilizzare i profili dei dispositivi per l'audio generato nella documentazione della sintesi vocale.

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.

Avanzata

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.