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 Dialogflow.
Prima di iniziare
Prima di leggere questa guida, devi procedere nel seguente modo:
- Leggi le nozioni di base su Dialogflow CX.
- Leggi Versioni.
Informazioni sulla Google Cloud Console
La console Google Cloud (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. 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, informazioni di fatturazione e controlli di autenticazione e accesso. Puoi creare un progetto o più progetti e utilizzarli per organizzare le 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.
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 deve pagare 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 saperne di più, consulta la 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 maggiori informazioni sull'abilitazione delle API, consulta la documentazione sull'utilizzo dei servizi.
Attiva Dialogflow API.
Se utilizzerai le caratteristiche generative di Vertex AI Agents, devi anche 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.
Il seguente link fornisce le istruzioni:
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Configura l'autenticazione e 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 importanti concetti dell'autenticazione e fornisce i passaggi per configurarla. Per maggiori informazioni, consulta la panoramica dell'autenticazione Google Cloud.
Autenticazione con 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 a riga di comando REST o per le chiamate alla libreria client.
Autenticazione degli account utente da riga di comando REST
Per eseguire 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,
operazione che deve essere eseguita 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 eseguire l'autenticazione per le chiamate della 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. Questa operazione deve essere eseguita prima di chiamare l'API.
Devi 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 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 account di servizio
Gli account di servizio sono un'altra opzione di autenticazione che deve essere utilizzata solo in ambienti sicuri come la produzione o la gestione temporanea. Un account di servizio fornisce le credenziali per le applicazioni, invece che 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 l'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 maggiori informazioni, consulta la panoramica dei ruoli.
Se hai creato il progetto con il tuo account utente, quest'ultimo 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 account diverso, potresti dover concedere dei ruoli al tuo account utente prima di poter chiamare l'API. Per le istruzioni, consulta la guida controllo dell'accesso Dialogflow.
Installare la libreria client di Dialogflow
Per chiamare l'API hai a disposizione tre opzioni: librerie client supportate da Google, REST e gRPC.
Le librerie client sono disponibili per diversi linguaggi diffusi. Per istruzioni di installazione, controlla il linguaggio che preferisci 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 chiudere il progetto.
-
Se hai chiamato
gcloud auth login, le credenziali vengono memorizzate nella directory utenti sul tuo computer. Ti consigliamo di eliminare queste credenziali chiamando il numero:gcloud auth revoke
-
Se hai chiamato
gcloud auth application-default login, le credenziali vengono memorizzate nella directory utenti sul tuo computer. Ti consigliamo di eliminare queste credenziali chiamando il numero:gcloud auth application-default revoke