Consulta los conectores compatibles para Application Integration.
Crea agentes conversacionales con Application Integration
La integración de aplicaciones ahora simplifica la creación de experiencias de conversación, ya que se integra directamente con los agentes conversacionales (Dialogflow CX). Esta función te permite crear chatbots y herramientas inteligentes que mejoren las interacciones de los usuarios y automaticen 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 con los usuarios en conversaciones de lenguaje natural. Analiza la entrada del usuario, interpreta el intent y proporciona respuestas adecuadas, lo que permite experiencias de conversación interactivas y personalizadas. Estos agentes están diseñados para controlar 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ífico al que puede acceder el agente conversacional. Las herramientas se definen dentro de los libros de jugadas y permiten que el agente realice acciones como recuperar datos, ejecutar APIs o interactuar con sistemas externos. La 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 tu lógica de integración a tus flujos de conversación.
Antes de comenzar
Asegúrate de lo siguiente antes de crear una herramienta de agente conversacional con la integración de aplicaciones:
- 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.
- Administrador de cuentas de servicio (
Roles de IAM necesarios para las cuentas de servicio
Los siguientes roles de IAM son obligatorios 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 que se usa para crear la herramienta de agente conversacional. | Invocador de Application Integration (roles/integrations.integrationInvoker ) |
Agente de servicio de Dialogflow
( |
Cuenta de servicio que usan 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 de conversación
Para crear una nueva herramienta de agente conversacional con la integración de aplicaciones, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Application Integration.
- En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones, en la que se enumeran 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:
- Ingresa un nombre y una descripción en el panel Crear integración.
- Selecciona una región para la integración.
- 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 la integración.
- 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
La integración de aplicaciones verifica que las APIs requeridas estén habilitadas. De lo contrario, se te pedirá que los habilites.
(menú de acciones) y selecciona Create Conversational Agent Tool.
- En el panel Create Conversational Agent Tool, proporciona las siguientes entradas:
- Activadores de API: Todos los activadores de API de tu integración están seleccionados de forma predeterminada. De forma opcional, puedes anular la selección de los activadores de API que no quieras incluir en la herramienta.
- Tipo: Selecciona Create new Conversational Agent y, luego, ingresa los siguientes detalles:
- Región: Selecciona la región del agente.
- Nombre del agente: Ingresa un nombre para el agente.
- Nombre de la herramienta: Ingresa un nombre para la herramienta.
- 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 de los activadores seleccionados. De forma 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 Agentes conversacionales (Dialogflow CX), ve a Guías, 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 Playbook.
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.
- En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones, en la que se enumeran 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:
- Ingresa un nombre y una descripción en el panel Crear integración.
- Selecciona una región para la integración.
- 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 la integración.
- 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
La integración de aplicaciones verifica que las APIs requeridas estén habilitadas. De lo contrario, se te pedirá que los habilites.
(menú de acciones) y selecciona Create Conversational Agent Tool.
- En el panel Create Conversational Agent Tool, proporciona las siguientes entradas:
- Activadores de API: Todos los activadores de API de tu integración se seleccionan de forma predeterminada. De forma opcional, puedes anular la selección de los activadores de API que no quieras incluir en la herramienta.
- Tipo: Selecciona Elegir agente conversacional existente y haz lo siguiente:
- Agente conversacional: Aparecerá una lista de los agentes disponibles en tu proyecto. Selecciona el agente que deseas usar.
- Herramienta: Selecciona Crear herramienta nueva o Elegir herramienta existente.
Si seleccionas Crear una 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.
- 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 de los activadores seleccionados. De forma 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 Agentes conversacionales (Dialogflow CX), ve a Guías, 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 Playbook.
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.