Configurazione e pulizia di Dialogflow ES

Questa guida fornisce tutte le procedure di configurazione necessarie per iniziare a utilizzare Dialogflow. Fornisce anche consigli per possibili passaggi di pulizia dopo aver provato o testato Dialogflow.

Prima di iniziare

Prima di leggere questa guida, devi:

1. Leggi Nozioni di base su Dialogflow ES.
2. Leggi Versioni.

Informazioni sulla Google Cloud console

La Google Cloud Console (visita la documentazione, apri la console) è una UI web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud . Utilizzi la console Google Cloud per configurare e gestire le risorse Dialogflow CX.

Crea un progetto

Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. che organizza tutte le risorse Google Cloud . Un progetto è composto da un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, informazioni di fatturazione, controlli di autenticazione e accesso. Puoi creare un progetto oppure più progetti e utilizzarli per organizzare le tue risorse Google Cloud in una gerarchia delle risorse. Quando crei un progetto, prendi nota dell'ID progetto. Avrai bisogno di questo ID per effettuare chiamate API. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.

La console Dialogflow ES (visita la documentazione, apri la console) può facoltativamente creare un progetto di base per te quando crei un agente. Se prevedi di utilizzare il progetto per qualcosa di più dell'accesso di base a un'edizione senza costi o se prevedi di utilizzare l'API, devi creare un progetto con la console Google Cloud come descritto di seguito.

Ti consigliamo di creare progetti separati per esperimenti, test e produzione. Ogni progetto può creare un solo agente Dialogflow. Se hai bisogno di più agenti, devi creare più progetti.

Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Vai al selettore di progetti

Avviso: se un progetto viene eliminato, gli agenti collegati al progetto non possono essere recuperati.

Abilita fatturazione

Nota: puoi saltare questo passaggio se utilizzi una versione di Dialogflow disponibile senza costi.

Un account di fatturazione viene utilizzato per definire chi paga per un determinato insieme di risorse e può essere collegato a uno o più progetti. L'utilizzo del progetto viene addebitato all'account di fatturazione collegato. Nella maggior parte dei casi, la fatturazione viene configurata durante la creazione di un progetto. Per saperne di più, consulta la documentazione sulla fatturazione.

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

Abilita l'API

Nota: puoi saltare questo passaggio se utilizzi la console Dialogflow per creare il progetto.

Devi abilitare l'API Dialogflow per il tuo progetto. Per saperne di più sull'attivazione delle API, consulta la documentazione di Service Usage.

Abilita l'API Dialogflow, se non è già abilitata.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilitare l'API

Abilita audit log

Nota: puoi saltare questo passaggio per gli agenti non di produzione.

Abilita gli audit log di accesso ai dati per l'API Dialogflow nel tuo progetto. In questo modo, puoi monitorare le modifiche apportate in fase di progettazione negli agenti Dialogflow collegati a questo progetto.

Installa e inizializza Google Cloud CLI

Nota: puoi saltare questo passaggio se non utilizzerai l'API.

Se prevedi di utilizzare l'API Dialogflow, devi installare e inizializzare Google Cloud CLI. gcloud CLI è un insieme di strumenti che puoi utilizzare per gestire le risorse e le applicazioni ospitate su Google Cloud.

Il seguente link fornisce le istruzioni:

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

gcloud init

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Configurare l'autenticazione e controllo dell'accesso

Nota: puoi saltare questo passaggio se non utilizzerai l'API.

Se prevedi di utilizzare l'API Dialogflow, devi configurare l'autenticazione. Qualsiasi applicazione client che utilizza l'API deve essere autenticata e deve essere autorizzata ad accedere alle risorse richieste. Questa sezione descrive concetti importanti relativi all'autenticazione e fornisce i passaggi per configurarla. Per saperne di più, consulta la panoramica dell'autenticazione diGoogle Cloud .

Autenticazione con account utente

Gli account utente sono l'opzione di autenticazione migliore quando si impara a utilizzare l'API Dialogflow e per lo sviluppo locale. Puoi utilizzare il tuo account utente per l'autenticazione per l'esecuzione di righe di comando REST o le chiamate alla libreria client.

Autenticazione dell'account utente della riga di comando REST

Nota: se utilizzi Cloud Shell, l'accesso a gcloud viene eseguito automaticamente, quindi non devi eseguire gcloud auth login.

Per l'autenticazione per le chiamate alla riga di comando REST, utilizzi gcloud CLI. Il comando gcloud auth login ti consente di accedere a gcloud con il tuo account utente, operazione da eseguire prima di chiamare l'API. Il comando gcloud auth print-access-token viene utilizzato in tutti gli esempi di riga di comando REST in questa documentazione per autenticare le chiamate REST.

Per creare le credenziali utente per il tuo ambiente locale:

gcloud auth login

Autenticazione dell'account utente della libreria client

Per autenticarti per le chiamate alle librerie client, utilizza gcloud CLI. Il comando gcloud auth application-default login ti consente di accedere a gcloud per le credenziali predefinite dell'applicazione con il tuo account utente, operazione da eseguire prima di chiamare l'API. Il comando gcloud auth application-default set-quota-project deve essere utilizzato per impostare il progetto per la fatturazione e le quote relative alle chiamate API. In genere, si tratta dello stesso progetto utilizzato dal tuo agente e fornisci l'ID progetto per il progetto che hai creato nei passaggi precedenti.

La variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS non deve essere impostata affinché le credenziali predefinite dell'applicazione vengano utilizzate dalle librerie client.

Per creare le credenziali predefinite dell'applicazione per il tuo ambiente locale:

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Autenticazione con service account

I service account forniscono le credenziali per le applicazioni, anziché per gli utenti finali. I service account sono di proprietà dei progetti e puoi creare molti service account per un progetto. Per saperne di più, vedi:

• Panoramica account di servizio account
• Best practice per gli account di servizio
• Crea e gestisci gli account di servizio

Controllo dell'accesso con i ruoli

Quando un'entità (account utente, account di servizio e così via) chiama un'API, Google Cloud richiede che l'entità disponga delle autorizzazioni appropriate. Puoi concedere autorizzazioni assegnando ruoli a un'entità. Per ulteriori informazioni, consulta la panoramica dei ruoli.

Se hai creato il progetto con il tuo account utente, il tuo account utente ha il ruolo di base Proprietario per il progetto. Questo ruolo fornisce l'accesso per chiamare qualsiasi API per il progetto. Tuttavia, se il progetto è stato creato da un altro account, potresti dover disporre di ruoli concessi al tuo account utente prima di poter chiamare l'API. Per istruzioni, consulta la guida al controllo dell'accesso di Dialogflow CX.

Installa la libreria client di Dialogflow

Nota: puoi saltare questo passaggio se non utilizzerai l'API.

Hai tre opzioni per chiamare l'API: librerie client, REST e gRPC supportate da Google.

Le librerie client sono disponibili per diversi linguaggi popolari. Per istruzioni di installazione, consulta la pagina relativa al linguaggio che preferisci in Librerie client.

Esegui la pulizia

Dopo la configurazione e la prova o il test di Dialogflow CX, potresti voler eliminare le risorse che hai creato:

• Ti consigliamo di eliminare l'agente.
• Ti consigliamo di disattivare il progetto.
• Se hai chiamato gcloud auth login, questo comando memorizza le credenziali nella directory utente del tuo computer. Potresti voler eliminare queste credenziali chiamando:

  gcloud auth revoke

• Se hai chiamato gcloud auth application-default login, questo comando memorizza le credenziali nella directory utente del tuo computer. Potresti voler eliminare queste credenziali chiamando:

  gcloud auth application-default revoke