Configurazione e pulizia di Dialogflow ES

Questa guida fornisce tutti i passaggi di configurazione necessari per iniziare a utilizzare Dialogflow. Fornisce inoltre consigli per possibili passaggi di pulizia dopo aver provato o testato Dialogflow.

Prima di iniziare

Prima di leggere questa guida, devi procedere nel seguente modo:

1. Leggi l'articolo Nozioni di base su Dialogflow ES.
2. Leggi Versioni.

Informazioni sulla Google Cloud Console

Console Google Cloud (consulta la documentazione, apri la console) è una UI web usata per il provisioning, la configurazione, la gestione e monitorare i sistemi che usano i prodotti Google Cloud. Puoi utilizzare la Google Cloud Console per configurare e gestire le risorse Dialogflow.

Crea un progetto

Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le tue risorse Google Cloud. Un progetto è composto da un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, dati di fatturazione e controlli di autenticazione e accesso. Puoi creare un solo progetto, Oppure puoi creare più progetti e utilizzarle per organizzare le risorse Google Cloud gerarchia delle risorse. Quando crei un progetto, tieni presente ID progetto. Questo ID è necessario per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta documentazione di Resource Manager.

La console di Dialogflow ES (visita la documentazione e apri la console) può facoltativamente creare un progetto di base per te quando crei un agente. Se prevedi di utilizzare il tuo progetto per altre offerte oltre all'accesso di base a un versione senza costi, o se prevedi di utilizzare l'API, devi creare un progetto con la Google Cloud Console come descritto di seguito.

Ti consigliamo di creare progetti separati per esperimenti, test e produzione. Ogni progetto può crearne uno solo Agente Dialogflow. Se hai bisogno di più agenti, dovrai creare più progetti.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Abilita fatturazione

Un account di fatturazione viene utilizzato per definire chi deve pagare per un 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 al momento della creazione di un progetto. Per ulteriori informazioni, consulta Documentazione sulla fatturazione.

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

Abilita l'API

Devi abilitare l'API Dialogflow per il tuo progetto. Per ulteriori informazioni sull'abilitazione delle API, consulta Documentazione sull'utilizzo dei servizi.

Enable the Dialogflow API.

Enable the API

Abilita audit log

Abilita gli audit log dell'accesso ai dati per API Dialogflow nel tuo progetto. Questo può aiutarti a tenere traccia delle modifiche in fase di progettazione gli agenti Dialogflow collegati a questo progetto.

Installa e inizializza Google Cloud CLI

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

Le istruzioni sono disponibili al seguente link:

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Configurare l'autenticazione e il controllo dell'accesso

Se prevedi di utilizzare l'API Dialogflow, devi configurare l'autenticazione. Qualsiasi applicazione client che utilizza l'API devono essere autenticati e autorizzati ad accedere alle risorse richieste. Questa sezione descrive concetti importanti sull'autenticazione e fornisce i passaggi per la configurazione. Per ulteriori informazioni, consulta la panoramica sull'autenticazione di Google Cloud.

Autenticazione con gli account utente

Gli account utente sono la migliore opzione di autenticazione per l'apprendimento dell'API Dialogflow e per lo sviluppo locale. Puoi utilizzare il tuo account utente per l'autenticazione Esecuzioni a riga di comando REST o chiamate alla libreria client.

Autenticazione degli account utente da riga di comando REST

Per l'autenticazione per le chiamate REST a riga di comando, utilizza la CLI gcloud. La gcloud auth login il comando permette di accedere a gcloud con il tuo account utente da eseguire prima di chiamare l'API. La gcloud auth print-access-token viene usato negli esempi della riga di comando REST di 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 eseguire l'autenticazione per le chiamate alla libreria client, utilizzi gcloud CLI. La gcloud auth application-default login il comando permette di accedere a gcloud per le credenziali predefinite dell'applicazione con il tuo account utente, 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. Di solito, si tratta dello stesso progetto utilizzato dall'agente e fornisci l'ID per il progetto creato nei passaggi precedenti.

La GOOGLE_APPLICATION_CREDENTIALS non deve essere impostata per le tue le credenziali predefinite dell'applicazione che devono essere usate dalle librerie client.

Per creare 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 account di servizio

Gli account di servizio sono un'altra opzione di autenticazione da utilizzare solo in ambienti protetti come la produzione o la gestione temporanea. Un account di servizio fornisce le credenziali per le applicazioni, piuttosto che agli utenti finali. Gli account di servizio sono di proprietà dei progetti, e puoi creare molti account di servizio per un progetto. Per ulteriori informazioni, vedi:

• Panoramica dell'account di servizio
• Best practice per gli account di servizio
• Creare e gestire account di servizio
• Creare e gestire le chiavi degli account di servizio
• Autenticazione con le chiavi degli 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 le autorizzazioni assegnando dei ruoli a un'entità. Per ulteriori informazioni, consulta panoramica del ruolo.

Se hai creato il progetto con il tuo account utente, il tuo account utente ha 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 concedere dei ruoli al tuo account utente prima di poter chiamare l'API. Per istruzioni, vedi Guida al controllo dell'accesso a Dialogflow.

Installare la libreria client di Dialogflow

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

Le librerie client sono disponibili per diversi linguaggi diffusi. Per le istruzioni di installazione, consulta la lingua che preferisci in Librerie client.

Esegui la pulizia

Dopo aver configurato e provato Dialogflow, è consigliabile eliminare le risorse che hai creato:

• Ti consigliamo di eliminare l'agente.
• Ti consigliamo di arrestare il progetto.
• Se hai chiamato gcloud auth login, In questo modo le credenziali vengono archiviate nella directory utente sul tuo computer. Puoi eliminare queste credenziali chiamando:

  gcloud auth revoke

• Se hai chiamato gcloud auth application-default login, In questo modo le credenziali vengono archiviate nella directory utente sul tuo computer. Puoi eliminare queste credenziali chiamando:

  gcloud auth application-default revoke