Crea agenti conversazionali con Application Integration

Anteprima — strumento dell'agente conversazionale

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Application Integration ora semplifica la creazione di esperienze conversazionali integrandosi direttamente con Dialogflow CX. Questa funzionalità ti consente di creare chatbot e strumenti intelligenti che migliorano le interazioni degli utenti e automatizzano le attività, direttamente dai flussi di lavoro di integrazione utilizzando i trigger API.

Che cos'è un agente conversazionale?

Un agente conversazionale di Dialogflow CX è un agente virtuale che comunica con gli utenti in conversazioni in linguaggio naturale. Analizza input utente, interpreta l'intent e fornisce risposte appropriate, consentendo esperienze conversazionali interattive e personalizzate. Questi agenti sono progettati per gestire le conversazioni su vari canali, come siti web, app per dispositivi mobili e piattaforme di messaggistica.

Che cos'è uno strumento dell'agente conversazionale?

In Dialogflow CX, uno strumento rappresenta una funzionalità o un servizio specifico a cui l'agente conversazionale può accedere. Gli strumenti sono definiti all'interno dei playbook e consentono all'agente di eseguire azioni come recuperare dati, eseguire API o interagire con sistemi esterni. Application Integration genera questi strumenti in base ai trigger API dell'integrazione, semplificando il collegamento della logica di integrazione ai flussi conversazionali.

Prima di iniziare

Prima di creare uno strumento dell'agente conversazionale utilizzando Application Integration, assicurati di quanto segue:

• Assegna i seguenti ruoli IAM all'entità:
  • Amministratore account di servizio (roles/iam.serviceAccountAdmin)
  • Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin)
  • Editor agente console Dialogflow (roles/dialogflow.consoleAgentEditor)

  Per informazioni sulla concessione dei ruoli alle entità, consulta Concedere o revocare un singolo ruolo.

Ruoli IAM richiesti per i service account

I seguenti ruoli IAM sono necessari per i service account utilizzati per creare uno strumento dell'agente conversazionale:

Service account	Descrizione	Ruoli obbligatori
Service account	Service account utilizzato per creare lo strumento dell'agente conversazionale.	Application Integration Invoker (roles/integrations.integrationInvoker)
Agente di servizio Dialogflow (service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com)	Service account utilizzato da Dialogflow CX per accedere all'integrazione.	Creatore token account di servizio (roles/iam.serviceAccountTokenCreator)

Crea un nuovo strumento dell'agente conversazionale

Per creare un nuovo strumento dell'agente conversazionale utilizzando Application Integration:

1. Nella console Google Cloud, vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrazioni.

   Viene visualizzata la pagina Integrazioni con l'elenco di tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota:l'elenco a discesa Regioni mostra solo le regioni di cui è stato eseguito il provisioning nel tuo progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Abilita regione. Per ulteriori informazioni, consulta Abilitare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli del account di servizio di un'integrazione in qualsiasi momento dal Riepilogo integrazione riquadro delle informazioni nella barra degli strumenti di integrazione.
      Nota:l'opzione per selezionare un account di servizio viene visualizzata solo se hai abilitato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

      L'integrazione si apre nell'editor integrazioni.

4. Seleziona un'integrazione esistente. L'integrazione si apre nell'editor integrazioni.
5. Assicurati che l'integrazione selezionata sia configurata con uno o più trigger API.
6. Pubblica la versione dell'integrazione.
7. Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Crea strumento dell'agente conversazionale.

   Application Integration verifica che le API richieste siano abilitate. In caso contrario, ti verrà chiesto di abilitarle.

8. Nel riquadro Crea strumento dell'agente conversazionale, fornisci i seguenti input:
   1. Trigger API: per impostazione predefinita, vengono selezionati tutti i trigger API dell'integrazione. Se vuoi, puoi deselezionare i trigger API che non vuoi includere nello strumento.
   2. Tipo: seleziona Crea nuovo agente conversazionale e inserisci i seguenti dettagli:
      1. Regione: seleziona la regione per l'agente.
      2. Nome agente: inserisci un nome per l'agente.
      3. Nome strumento: inserisci un nome per lo strumento.
      Nota:la lingua predefinita per l'agente è l'inglese (Stati Uniti).
   3. Service account: scegli un account di servizio con i ruoli e le autorizzazioni necessari per l'accesso alle risorse dell'agente. Se mancano, ti verrà chiesto di concederli.
9. Fai clic su Visualizza specifica per esaminare la specifica generata per i trigger selezionati. Se vuoi, puoi modificare la specifica prima di salvarla.
10. Fai clic su Salva.

    Viene visualizzato un messaggio che indica che lo strumento è stato creato correttamente. Fai clic su Visualizza per aprire l'agente nella console Dialogflow CX.

11. Nella console Dialogflow CX, vai a Playbook, fai clic sul playbook per l'agente creato e aggiungi istruzioni al playbook per utilizzare lo strumento. Per ulteriori informazioni, consulta Strumenti del playbook.

Crea uno strumento dell'agente conversazionale utilizzando un agente esistente

Per creare uno strumento dell'agente conversazionale utilizzando un agente esistente:

1. Nella console Google Cloud, vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrazioni.

   Viene visualizzata la pagina Integrazioni con l'elenco di tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota:l'elenco a discesa Regioni mostra solo le regioni di cui è stato eseguito il provisioning nel tuo progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Abilita regione. Per ulteriori informazioni, consulta Abilitare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli del account di servizio di un'integrazione in qualsiasi momento dal Riepilogo integrazione riquadro delle informazioni nella barra degli strumenti di integrazione.
      Nota:l'opzione per selezionare un account di servizio viene visualizzata solo se hai abilitato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

      L'integrazione si apre nell'editor integrazioni.

4. Seleziona un'integrazione esistente. L'integrazione si apre nell'editor integrazioni.
5. Assicurati che l'integrazione selezionata sia configurata con uno o più trigger API.
6. Pubblica la versione dell'integrazione.
7. Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Crea strumento dell'agente conversazionale.

   Application Integration verifica che le API richieste siano abilitate. In caso contrario, ti verrà chiesto di abilitarle.

8. Nel riquadro Crea strumento dell'agente conversazionale, fornisci i seguenti input:
   1. Trigger API: per impostazione predefinita, vengono selezionati tutti i trigger API dell'integrazione. Se vuoi, puoi deselezionare i trigger API che non vuoi includere nello strumento.
   2. Tipo: seleziona Scegli agente conversazionale esistente e procedi come segue:
      1. Agente conversazionale: viene visualizzato un elenco degli agenti disponibili nel tuo progetto. Seleziona l'agente che vuoi utilizzare.
      2. Strumento: seleziona Crea nuovo strumento o Scegli strumento esistente.

         Se selezioni Crea nuovo strumento, inserisci un nome per lo strumento.

         Se selezioni Scegli strumento esistente, viene visualizzato un elenco degli strumenti disponibili nell'agente selezionato. Seleziona lo strumento che vuoi utilizzare.

   3. Service account: scegli un account di servizio con i ruoli e le autorizzazioni necessari per l'accesso alle risorse dell'agente. Se mancano, ti verrà chiesto di concederli.
9. Fai clic su Visualizza specifica per esaminare la specifica generata per i trigger selezionati. Se vuoi, puoi modificare la specifica prima di salvarla.
10. Fai clic su Salva.

    Viene visualizzato un messaggio che indica che lo strumento è stato creato correttamente. Fai clic su Visualizza per aprire l'agente nella console Dialogflow CX.

11. Nella console Dialogflow CX, vai a Playbook, fai clic sul playbook per l'agente creato e aggiungi istruzioni al playbook per utilizzare lo strumento. Per ulteriori informazioni, consulta Strumenti del playbook.

Considerazioni

Quando utilizzi gli strumenti dell'agente conversazionale, tieni presenti le seguenti considerazioni:

• Gli strumenti dell'agente conversazionale possono essere creati solo per le integrazioni pubblicate con trigger API.
• Esamina e testa l'agente nella console Dialogflow CX dopo la creazione.