Configurazione e pulizia di Dialogflow CX

Questa guida fornisce tutti i passaggi di configurazione necessari per iniziare a utilizzare Dialogflow CX. Offre anche consigli su possibili passaggi di pulizia dopo aver provato o testato Dialogflow.

Prima di iniziare

Prima di leggere questa guida, segui questi passaggi:

1. Leggi le nozioni di base di Dialogflow CX.
2. Leggi la sezione Versioni.

Informazioni sulla Google Cloud Console

La console Google Cloud (consulta la documentazione, console aperta) è una UI web utilizzata per eseguire il provisioning, la configurazione, la gestione e il monitoraggio dei 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 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. Questo ID è necessario per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta la documentazione di Resource Manager.

Nota: i passaggi riportati di seguito utilizzano la Google Cloud Console per creare un progetto. Facoltativamente, la console di Dialogflow CX (consulta la documentazione, apri la console) può creare un progetto per te.

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

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

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 quando crei un progetto. Per saperne di più, consulta la documentazione di 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 la documentazione relativa all'utilizzo dei servizi.

Attiva Dialogflow API.

Abilita l'API

Se utilizzerai le funzionalità generative di Vertex AI Agents, devi anche attivare il servizio Vertex AI Agent Builder.

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 è una serie 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, quindi initialize eseguendo questo comando:

gcloud init

Configura 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 concessa l'accesso alle risorse richieste. Questa sezione descrive importanti concetti di autenticazione e fornisce i passaggi per la configurazione. Per maggiori informazioni, consulta la panoramica dell'autenticazione Google Cloud.

Autenticazione con gli account utente

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

Autenticazione account utente dalla riga di comando REST

Nota: se utilizzi Cloud Shell, l'accesso a gcloud è automatico, quindi non è necessario eseguire gcloud auth login.

Per l'autenticazione per le chiamate a riga di comando REST, utilizza gcloud CLI. Il comando gcloud auth login ti consente di accedere a gcloud con il tuo account utente, che deve essere eseguito 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 credenziali utente per il tuo ambiente locale:

gcloud auth login

Autenticazione account utente della libreria client

Per l'autenticazione per le chiamate alla libreria 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, che deve essere eseguito prima di chiamare l'API. È necessario utilizzare il comando gcloud auth application-default set-quota-project per impostare il progetto per la fatturazione e le quote relative alle chiamate API. Normalmente si tratta dello stesso progetto utilizzato dall'agente e tu devi fornire l'ID per il progetto 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 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 gli 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 la gestione temporanea. Un account di servizio fornisce le credenziali per le applicazioni, anziché per gli utenti finali. Gli account di servizio sono di proprietà dei progetti e puoi crearne molti per un progetto. Per ulteriori informazioni, vedi:

• Panoramica dell'account di servizio
• Best practice per gli account di servizio
• Creare e gestire gli 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 concedendo i ruoli a un'entità. Per maggiori informazioni, consulta la panoramica del ruolo.

Se hai creato il progetto con il tuo account utente, l'account utente dispone del 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, potrebbe essere necessario concedere dei ruoli al tuo account utente prima di chiamare l'API. Per le istruzioni, consulta la guida controllo dell'accesso Dialogflow.

Installare la libreria client Dialogflow

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

Sono disponibili 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 desiderata in Librerie client.

esegui la pulizia

Dopo aver configurato e provato o testato Dialogflow, ti consigliamo di eliminare le risorse che hai creato:

• Ti consigliamo di eliminare l'agente.
• Potresti voler arrestare il tuo progetto.
• La chiamata a gcloud auth login comporta l'archiviazione delle credenziali nella directory utente sul computer. Ti consigliamo di eliminare queste credenziali chiamando il numero:

  gcloud auth revoke

• La chiamata a gcloud auth application-default login comporta l'archiviazione delle credenziali nella directory utente sul computer. Ti consigliamo di eliminare queste credenziali chiamando il numero:

  gcloud auth application-default revoke