Qué son las herramientas
Las herramientas permiten que un agente virtual ejecute acciones durante una conversación: transferir a un humano, consultar servicios externos o aplicar lógica personalizada.Cada herramienta debe tener una descripción clara. El agente usa esa descripción para decidir cuándo invocarla y con qué datos.
Tipos disponibles
Transferencia a humano
Deriva una conversación a un operador o cola de atención con contexto estructurado.
API REST
Ejecuta solicitudes HTTP hacia sistemas externos y mapea respuestas a variables.
Código
Ejecuta lógica JavaScript para validar, transformar u orquestar pasos avanzados.
Credenciales
Recupera API keys, tokens y otros secretos desde código sin hardcodearlos en la herramienta.
Flujo de configuración
1
Define el propósito
Escribe un nombre y una descripción que indiquen exactamente cuándo debe usarse la herramienta.
2
Declara entradas
Configura parámetros en modo básico o JSON Schema para que el agente recopile los datos necesarios.
3
Configura la acción
Completa destino humano, URL REST, headers, body o código según el tipo de herramienta.
4
Prueba y publica
Valida la herramienta en Playground, revisa resultados y publica cuando el comportamiento sea consistente.
Buenas prácticas
- Usa nombres estables y descriptivos.
- Evita pedir datos que el agente no pueda obtener de la conversación o del contexto.
- Prueba casos exitosos y de error antes de publicar.
- Revisa en Historial de conversaciones cómo se ejecutó cada herramienta.
Próximos pasos
Configurar una herramienta REST
Aprende a llamar APIs externas desde una conversación.