Questa guida fornisce tutti i passaggi di configurazione necessari per iniziare a utilizzare gli agenti conversazionali (Dialogflow CX). Fornisce inoltre consigli su possibili misure di pulizia dopo aver provato o testato gli agenti conversazionali (Dialogflow CX).
Informazioni sulla console Google Cloud
Google Cloud Console (visita la documentazione, apri la console) è un'interfaccia utente web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud. Utilizza la console Google Cloud per configurare e gestire le risorse Dialogflow.
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 (e altre risorse) abilitate, strumenti di monitoraggio, dati di fatturazione, e i 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, prendi nota dell'ID progetto. Ti servirà questo ID per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta documentazione di Resource Manager.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Abilita fatturazione
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 al momento della creazione di un progetto. Per ulteriori informazioni, consulta la documentazione relativa alla fatturazione.
Make sure that billing is enabled for your Google Cloud project.
Abilita l'API
Devi abilitare l'API Dialogflow per il tuo progetto. Per ulteriori informazioni sull'abilitazione delle API, consulta la documentazione di Service Usage.
Enable the Dialogflow API.
Se usi le funzionalità generative dei playbook o dei datastore, devi inoltre attivare il servizio Vertex AI Agent Builder.
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
Configura 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 deve essere autenticata e deve disporre dell'accesso 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 imparare a utilizzare l'API Dialogflow e per lo sviluppo locale. Puoi utilizzare il tuo account utente per autenticarti per le esecuzioni della riga di comando REST o le chiamate alla libreria client.
Autenticazione dell'account utente della 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.
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 alla libreria client,
utilizza l'interfaccia a riga di comando gcloud.
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 che deve essere eseguita prima di chiamare l'API.
La
gcloud auth application-default set-quota-project
per impostare la fatturazione e le quote del progetto
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
di variabile di ambiente non deve essere impostata per
le credenziali predefinite dell'applicazione
che devono essere usate 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 account di servizio
Gli account di servizio sono un'altra opzione di autenticazione che deve essere utilizzata solo in ambienti protetti come la produzione o l'implementazione. Un account di servizio fornisce le credenziali per le applicazioni, diversamente dagli 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 dell'account di servizio
- Autenticazione con le chiavi dell'account di servizio
Controllo dell'accesso con i ruoli
Quando un principale (account utente, account di servizio e così via) chiama un'API, Google Cloud richiede che il principale disponga delle autorizzazioni appropriate. Puoi concedere le autorizzazioni concedendo i 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 i ruoli al tuo account utente prima di poter chiamare l'API. Per le istruzioni, consulta la guida al controllo dell'accesso di Dialogflow.
Installazione della libreria client degli agenti conversazionali (Dialogflow CX)
Hai 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
, le credenziali vengono memorizzate nella directory utente del computer. Puoi eliminare queste credenziali chiamando:gcloud auth revoke
-
Se hai chiamato
gcloud auth application-default login
, In questo modo le credenziali vengono memorizzate nella directory utente sul tuo computer. Puoi eliminare queste credenziali chiamando:gcloud auth application-default revoke