Consulta los conectores compatibles con Application Integration.

Crear agentes conversacionales con Application Integration

Vista previa — Conversational agent tool

Esta función está sujetas a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Application Integration ahora simplifica la creación de experiencias conversacionales al integrarse directamente con Conversational Agents (Dialogflow CX). Esta función te permite crear chatbots y herramientas inteligentes que mejoran las interacciones de los usuarios y automatizan tareas directamente desde tus flujos de trabajo de integración mediante activadores de API.

¿Qué es un agente conversacional?

Un agente conversacional de Conversational Agents (Dialogflow CX) es un agente virtual que se comunica con los usuarios en conversaciones en lenguaje natural. Analiza las entradas de los usuarios, interpreta la intención y proporciona respuestas adecuadas, lo que permite ofrecer experiencias conversacionales interactivas y personalizadas. Estos agentes están diseñados para gestionar conversaciones en varios canales, como sitios web, aplicaciones móviles y plataformas de mensajería.

¿Qué es una herramienta de agente conversacional?

En Conversational Agents (Dialogflow CX), una herramienta representa una función o un servicio específicos a los que puede acceder el agente conversacional. Las herramientas se definen en los cuadernos de estrategias y permiten al agente realizar acciones como obtener datos, ejecutar APIs o interactuar con sistemas externos. Integración de aplicaciones genera estas herramientas en función de los activadores de la API de tu integración, lo que facilita la conexión de la lógica de tu integración con tus flujos de conversación.

Antes de empezar

Antes de crear una herramienta de agente conversacional con Integración de aplicaciones, asegúrate de que se cumplen los siguientes requisitos:

• Asigna los siguientes roles de gestión de identidades y accesos a tu principal:
  • Administrador de cuentas de servicio (roles/iam.serviceAccountAdmin)
  • Administrador de Uso de Servicio (roles/serviceusage.serviceUsageAdmin)
  • Editor de agentes de la consola de Dialogflow (roles/dialogflow.consoleAgentEditor)

  Para obtener información sobre cómo asignar roles a principales, consulta Asignar o revocar un solo rol.

Roles de gestión de identidades y accesos necesarios para las cuentas de servicio

Se necesitan los siguientes roles de gestión de identidades y accesos para las cuentas de servicio que se usan para crear una herramienta de agente conversacional:

Cuenta de servicio	Descripción	Roles obligatorios
Cuenta de servicio	Cuenta de servicio usada para crear la herramienta de agente conversacional.	Invocador de integración de aplicaciones (roles/integrations.integrationInvoker)
Agente de servicio de Dialogflow (service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com)	Cuenta de servicio que usan los agentes conversacionales (Dialogflow CX) para acceder a la integración.	Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator)

Crear una herramienta de agente conversacional

Para crear una herramienta de agente conversacional con la integración de aplicaciones, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration (Integración de aplicaciones).

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haz clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear.

      Se abrirá la integración en el editor de integraciones.

4. Selecciona una integración. Se abrirá la integración en el editor de integraciones.
5. Asegúrate de que la integración seleccionada esté configurada con uno o varios activadores de API.
6. Publica la versión de la integración.
7. En la barra de herramientas del diseñador, haz clic en (menú Acciones) y selecciona Crear herramienta de agente conversacional.

   Integración de aplicaciones verifica que las APIs necesarias estén habilitadas. Si no es así, se te pedirá que las habilites.

8. En el panel Crear herramienta de agente conversacional, proporciona los siguientes datos:
   1. Activadores de API: todos los activadores de API de tu integración están seleccionados de forma predeterminada. También puedes desmarcar los activadores de API que no quieras incluir en la herramienta.
   2. Tipo: selecciona Crear agente conversacional e introduce los siguientes detalles:
      1. Región: selecciona la región del agente.
      2. Nombre del agente: introduce un nombre para el agente.
      3. Nombre de la herramienta: introduce un nombre para la herramienta.
      Nota: El idioma predeterminado del agente es el inglés (Estados Unidos).
   3. Cuenta de servicio: elige una cuenta de servicio con los roles y permisos necesarios para que el agente pueda acceder a los recursos. Si faltan, se te pedirá que concedas los permisos.
9. Haz clic en Ver especificación para revisar la especificación generada de los activadores seleccionados. Puedes editar la especificación antes de guardarla.
10. Haz clic en Guardar.

    Aparecerá un mensaje que indica que la herramienta se ha creado correctamente. Haz clic en Ver para abrir el agente en la consola de Conversational Agents (Dialogflow CX).

11. En la consola Conversational Agents (Dialogflow CX), ve a Guías, haz clic en la guía del agente creado y añade instrucciones a la guía para usar la herramienta. Para obtener más información, consulta Herramientas de Playbook.

Crear una herramienta de agente conversacional a partir de un agente

Para crear una herramienta de agente conversacional a partir de un agente, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Application Integration (Integración de aplicaciones).

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haz clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear.

      Se abrirá la integración en el editor de integraciones.

4. Selecciona una integración. Se abrirá la integración en el editor de integraciones.
5. Asegúrate de que la integración seleccionada esté configurada con uno o varios activadores de API.
6. Publica la versión de la integración.
7. En la barra de herramientas del diseñador, haz clic en (menú Acciones) y selecciona Crear herramienta de agente conversacional.

   Integración de aplicaciones verifica que las APIs necesarias estén habilitadas. Si no es así, se te pedirá que las habilites.

8. En el panel Crear herramienta de agente conversacional, proporciona los siguientes datos:
   1. Activadores de API: todos los activadores de API de tu integración están seleccionados de forma predeterminada. También puedes desmarcar los activadores de API que no quieras incluir en la herramienta.
   2. Tipo: selecciona Elegir agente conversacional y haz lo siguiente:
      1. Agente conversacional: aparece una lista de los agentes disponibles en tu proyecto. Selecciona el agente que quieras usar.
      2. Herramienta: seleccione Crear herramienta o Elegir herramienta.

         Si seleccionas Crear herramienta, introduce un nombre para la herramienta.

         Si seleccionas Elegir herramienta, aparecerá una lista de las herramientas disponibles en el agente seleccionado. Selecciona la herramienta que quieras usar.

   3. Cuenta de servicio: elige una cuenta de servicio con los roles y permisos necesarios para que el agente pueda acceder a los recursos. Si faltan, se te pedirá que concedas los permisos.
9. Haz clic en Ver especificación para revisar la especificación generada de los activadores seleccionados. Puedes editar la especificación antes de guardarla.
10. Haz clic en Guardar.

    Aparecerá un mensaje que indica que la herramienta se ha creado correctamente. Haz clic en Ver para abrir el agente en la consola de Conversational Agents (Dialogflow CX).

11. En la consola Conversational Agents (Dialogflow CX), ve a Guías, haz clic en la guía del agente creado y añade instrucciones a la guía para usar la herramienta. Para obtener más información, consulta Herramientas de Playbook.

Cuestiones importantes

Debes tener en cuenta lo siguiente al usar las herramientas de agentes conversacionales:

• Las herramientas de agentes conversacionales solo se pueden crear para integraciones publicadas con activadores de API.
• Revisa y prueba tu agente en la consola de Conversational Agents (Dialogflow CX) después de crearlo.