Agentes en Dialogflow CX
Una introducción a los agentes de dialogflow CX y cómo interactuar con ellos usando la consola y la CXCLI
Agentes en Dialogflow CX
Requisitos previos
Estas son las tecnologías utilizadas en este proyecto
- Google Cloud Account - Regístrate aquí de forma gratuita
- Dialogflow API enabled - Cómo habilitarla
- Dialogflow CX CLI - Instala y configura Dialogflow CX CLI
¿De qué se trata?
En Dialogflow CX, un agente es la entidad que maneja todas las conversaciones que hemos definido en la consola de Dialogflow CX.
Un agente es básicamente un asistente que gestiona el estado de la conversación de cada usuario cuando interactúan con el agente a través de texto o audio en múltiples canales.
Dialogflow Console
Dialogflow CX Console es una interfaz web que permite diseñar tus conversaciones creando agentes, así como dentro de un agente, creando flows, intents, entity types, etc. En la consola de Dialogflow puedes crear e interactuar fácilmente con tus agentes. Para ello, solo necesitas acceder a la consola de Dialogflow CX: https://dialogflow.cloud.google.com/cx. This is what it looks like:
Dialogflow CX Console
Una vez creado un agente, ¡ya puedes empezar a crear conversaciones! Lo que puedes hacer en la consola es:
- Exportar un agente: en formato blob o JSON
- Eliminar un agente
- Crear componentes conversacionales como flows o pages
- Modificar tu NLU creando intents y entity types
- Testear tu agente
Agente en Dialogflow CX
Dialogflow CX CLI
La Dialogflow CX CLI o cxcli ies una herramienta de línea de comandos que puedes utilizar para interactuar con tus proyectos en Dialogflow CX en un terminal. Es un proyecto de código abierto creado por Xavier Portilla Edo. Con la cxcli ypuedes interactuar fácilmente con tus agentes en Dialogflow CX.
Todos los comandos disponibles en la cxcli para interactuar con tus agentes se encuentran en el subcomando cxcli agent.
Restaurar
Puedes restaurar un agente utilizando un archivo blob. Ahora mismo, la API de Dialogflow CX que utiliza la cxcli funciona solamente con el formato blob.
La cxcli cuenta con un comando que permite restaurar un agente.
Este es un ejemplo del comando cxcli agent restore:
cxcli agent restore test-agent --project-id test-cx-346408 --location-id us-central1 --input agent.blob
El comando anterior te proporcionará un output como este:
$ cxcli agent restore test-agent --project-id test-cx-346408 --location-id us-central1 --input agent.blob
INFO Agent restored
Exportar
Asimismo, puedes exportar un agente como un archivo blob. Ahora mismo, la API de Dialogflow CX que utiliza la cxcli funciona solamente en formato blob.
La cxcli cuenta con un comando que permite restaurar un agente.
Este es un ejemplo simple del comando cxcli agent restore:
cxcli agent export test-agent --project-id test-cx-346408 --location-id us-central1
El comando anterior te proporcionará un output como este:
$ cxcli agent export test-agent --project-id test-cx-346408 --location-id us-central1
INFO Agent exported to file: agent.blob
Eliminar
La cxcli cuenta con un comando que permite eliminar un agente.
A continuación, tenemos un ejemplo del comando cxcli agent delete:
cxcli agent delete test-agent --project-id test-cx-346408 --location-id us-central1
El comando anterior te proporcionará un output como este:
$ cxcli agent delete test-agent --project-id test-cx-346408 --location-id us-central1
INFO Agent deleted
Recursos
Si deseas ver el uso completo del comando cxcli agent, puedes consultar esta página.
Si deseas saber más sobre agentes en Dialogflow CX, consulta la documentación oficial.
Conclusión
Este es un tutorial básico para aprender qué es un Agente en Dialogflow CX. Como hemos visto en este ejemplo, es muy sencillo crear un agente e interactuar con él, ya sea mediante la consola o la cxcli.
Espero que este tutorial te resulte útil.
¡Eso es todo, amigos!
Happy coding!
