En esta guía te explicaremos cómo funcionan las Acciones dentro del Agent Builder, centrándonos específicamente en la HTTP Tool. Aprenderás a configurar esta herramienta paso a paso para que tu Agente pueda consultar información externa (como precios, stock o estados) y usarla en sus respuestas.
¿Qué son las Acciones?
Las acciones permiten que tu agente deje de ser un simple chat de texto y se convierta en un asistente operativo. Mientras que el "Conocimiento" le da información estática, las "Acciones" le permiten interactuar con otros softwares.
Para comenzar, debes dirigirte a la sección de Configuración de tu agente. En el panel izquierdo, encontrarás el apartado Actions y un botón con el signo "+"
Al hacer clic en el botón +, verás el catálogo de acciones disponibles. Para esta guía, seleccionaremos HTTP Tool haciendo clic en "Agregar"
Configuración de la HTTP Tool
La HTTP Tool funciona como un navegador para tu agente: le permite ir a una dirección web (API), leer información y volver al chat con la respuesta.
Al agregar la herramienta, verás un formulario de configuración. A continuación, te mostramos cómo completarlo utilizando un ejemplo real y sencillo (consultar el precio del Bitcoin) para que entiendas la lógica.
1. Definición del "Prompt" de la herramienta
Nombre: Debe ser corto e identificable
Ej: Precio de BitcoinDescripción: Aquí debes enseñarle a tu agente cuándo debe activar esta herramienta con instrucciones claras.
Ej: Utiliza esta herramienta para obtener únicamente el precio de Bitcoin.
2. Configuración Técnica (API)
Aquí le decimos al agente dónde buscar la información. Usaremos una API pública de Coindesk que no requiere contraseñas.
Enlace de la API: La URL exacta del servicio.
Tipo de solicitud: Determina la acción a realizar.
GET: Se usa GET para consultar información. Usaríamos POST si quisiéramos enviar datos, como crear un ticket.
3. Testeo y Guardado
Así debería haber quedado completada tu Http Tool en este ejemplo
Para probar que esta conexión funciona
Haz clic crear y luego realiza el test haciendo clic en test
2. Si recibes un mensaje de "Status 200" o ves datos en formato JSON, la conexión es exitosa
Como vemos en este ejemplo la conexión API es exitosa. Presiona continuar para terminar la configuración.
Resultado de esta acción
Ingresando a la configuración de nuestro agente IA podremos ver nuestra action HTTP TOOL ya se encuentra lista y configurada. En la imagen podemos apreciar que aparece al lado del botón "+" justo debajo de "Actions"
Para ponerla a prueba, en el campo de test realice una consulta a la IA: ¿Cuál es el valor de Bitcoin actualmente? y me ha respondido con el precio exacto.
El comienzo de un agente más inteligente
Configurar la HTTP Tool es el primer gran paso para que tu agente deje de ser solo conversacional y pase a ser operativo. Ahora que dominas la conexión de APIs, tienes un mundo de posibilidades: consultar stocks, validar usuarios o revisar estados de cuenta.
Si tienes dificultades en algún paso o la API no responde te esperamos en el equipo de soporte!
¿Listo para el siguiente nivel?