Crea agentes conversacionales con Application Integration

Application Integration ahora simplifica la creación de experiencias conversacionales gracias a la integración directa con Agentes conversacionales (Dialogflow CX). Esta función te permite crear chatbots y herramientas inteligentes que mejoran las interacciones del usuario y automatizan tareas, directamente desde tus flujos de trabajo de integración con activadores de API.

¿Qué es un agente conversacional?

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

¿Qué es una herramienta de agente conversacional?

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

Antes de comenzar

Antes de crear una herramienta de agente conversacional con Application Integration, asegúrate de cumplir con los siguientes requisitos:

Asigna los siguientes roles de IAM a tu principal:
- Administrador de cuentas de servicio (roles/iam.serviceAccountAdmin)
- Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin)
- Editor del agente en la consola de Dialogflow (roles/dialogflow.consoleAgentEditor)
Para obtener información sobre cómo otorgar roles a las principales, consulta Otorga o revoca un solo rol.

Roles de IAM necesarios para las cuentas de servicio

Se requieren los siguientes roles de IAM 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	Es la cuenta de servicio que se usa para crear la herramienta de agente conversacional.	Invocador de Application Integration (`roles/integrations.integrationInvoker`)
Agente de servicio de Dialogflow (`service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com`)	Es la cuenta de servicio que usan los Conversational Agents (Dialogflow CX) para acceder a la integración.	Creador de tokens de cuenta de servicio (`roles/iam.serviceAccountTokenCreator`)

Crea una nueva herramienta de agente conversacional

Para crear una nueva herramienta de agente conversacional con Application Integration, sigue estos pasos:

En la consola de Google Cloud, ve a la página Application Integration.
Ir a Application Integration
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.
Selecciona una integración existente o haz clic en Crear integración para crear una nueva.
Si creas una integración nueva, haz lo siguiente:
1. Ingresa 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 enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
3. Selecciona una cuenta de servicio para la integración. Puedes 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 en la barra de herramientas de integración.
  Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de la integración para la región seleccionada.
4. Haz clic en Crear.
  Esto abrirá la integración en la página del editor de integración.
Selecciona una integración existente. Esto abrirá la integración en la página del editor de integración.
Asegúrate de que la integración seleccionada esté configurada con uno o más activadores de API.
Publica la versión de integración.
En la barra de herramientas del diseñador, haz clic en (menú de acciones) y selecciona Create Conversational Agent Tool.
Application Integration verifica que las APIs requeridas estén habilitadas. De lo contrario, se te pedirá que los habilites.
En el panel Create Conversational Agent Tool, proporciona las siguientes entradas:
1. Activadores de API: Todos los activadores de API de tu integración están seleccionados de forma predeterminada. De manera opcional, puedes anular la selección de los activadores de API que no quieras incluir en la herramienta.
2. Tipo: Selecciona Crear un agente conversacional nuevo y, luego, ingresa los siguientes detalles:
  1. Región: Selecciona la región del agente.
  2. Nombre del agente: Ingresa un nombre para el agente.
  3. Nombre de la herramienta: Ingresa un nombre para la herramienta.
3. Cuenta de servicio: Elige una cuenta de servicio con los roles y permisos necesarios para el acceso a los recursos del agente. Si falta alguno, se te pedirá que lo otorgues.
Haz clic en Ver especificación para revisar la especificación generada para los activadores seleccionados. De manera opcional, puedes editar la especificación antes de guardarla.
Haz clic en Guardar.
Aparecerá un mensaje que indica que la herramienta se creó correctamente. Haz clic en Ver para abrir el agente en la consola de Conversational Agents (Dialogflow CX).
En la consola de Conversational Agents (Dialogflow CX), ve a Playbooks, haz clic en la guía del agente creado y agrega instrucciones a la guía para usar la herramienta. Para obtener más información, consulta Herramientas de la guía.

Crea una herramienta de agente conversacional con un agente existente

Para crear una herramienta de agente conversacional con un agente existente, sigue estos pasos:

En la consola de Google Cloud, ve a la página Application Integration.
Ir a Application Integration
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.
Selecciona una integración existente o haz clic en Crear integración para crear una nueva.
Si creas una integración nueva, haz lo siguiente:
1. Ingresa 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 enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
3. Selecciona una cuenta de servicio para la integración. Puedes 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 en la barra de herramientas de integración.
  Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de la integración para la región seleccionada.
4. Haz clic en Crear.
  Esto abrirá la integración en la página del editor de integración.
Selecciona una integración existente. Esto abrirá la integración en la página del editor de integración.
Asegúrate de que la integración seleccionada esté configurada con uno o más activadores de API.
Publica la versión de integración.
En la barra de herramientas del diseñador, haz clic en (menú de acciones) y selecciona Create Conversational Agent Tool.
Application Integration verifica que las APIs requeridas estén habilitadas. De lo contrario, se te pedirá que los habilites.
En el panel Create Conversational Agent Tool, proporciona las siguientes entradas:
1. Activadores de API: Todos los activadores de API de tu integración están seleccionados de forma predeterminada. De manera opcional, puedes anular la selección de los activadores de API que no quieras incluir en la herramienta.
2. Tipo: Selecciona Elegir un agente conversacional existente y haz lo siguiente:
  1. Agente conversacional: Aparecerá una lista de los agentes disponibles en tu proyecto. Selecciona el agente que deseas usar.
  2. Herramienta: Selecciona Crear herramienta nueva o Elegir herramienta existente.
    Si seleccionas Crear herramienta nueva, ingresa un nombre para la herramienta.
    
    Si seleccionas Elegir herramienta existente, 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 el acceso a los recursos del agente. Si falta alguno, se te pedirá que lo otorgues.
Haz clic en Ver especificación para revisar la especificación generada para los activadores seleccionados. De manera opcional, puedes editar la especificación antes de guardarla.
Haz clic en Guardar.
Aparecerá un mensaje que indica que la herramienta se creó correctamente. Haz clic en Ver para abrir el agente en la consola de Conversational Agents (Dialogflow CX).
En la consola de Conversational Agents (Dialogflow CX), ve a Playbooks, haz clic en la guía del agente creado y agrega instrucciones a la guía para usar la herramienta. Para obtener más información, consulta Herramientas de la guía.

Consideraciones

Se aplican las siguientes consideraciones cuando se usan 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.