Tools HTTP personalizadas

​

Escenario

GET https://api.tuempresa.com/products/{sku}/stock
Authorization: Bearer tu-token-interno

{
  "sku": "PROD-001",
  "name": "Camiseta Azul",
  "stock": 42,
  "warehouse": "Lima Central"
}

​

Paso 1: Crear la tool en la plataforma

1. Ve a Tools > Crear Tool
2. Configura:

3. En Headers, agrega:
   • Authorization: Bearer tu-token-interno
4. Guarda la tool

​

Paso 2: Probar en el Studio

1. Ve a Studio (click en “Studio” desde la configuracion del agente)
2. En el panel derecho, selecciona la tab Probar agente
3. Escribe: “¿Tienen stock de la camiseta PROD-001?”
4. El agente deberia:
   • Detectar que necesita consultar stock
   • Ejecutar consultar_stock con SKU=PROD-001
   • Responder con la informacion del stock

​

Paso 3: Verificar en el widget

​

Ejemplo: Tool POST

{
  "subject": "{asunto}",
  "description": "{descripcion}",
  "priority": "medium"
}

​

Ejemplo: Tool con Human-in-the-Loop

1. Crea la tool crear_ticket como arriba
2. Ve a Instrucciones > Crear instruccion
3. Configura:
   • Trigger: INTENT
   • Condicion: “El usuario quiere crear un ticket de soporte”
   • Tool asociada: crear_ticket
   • Accion: Confirm con mensaje “¿Confirmas que quieres crear el ticket de soporte?”

Usuario: "Quiero reportar un bug en la facturacion"
Agente: Detecta intent → Se activa instruccion
Widget: "¿Confirmas que quieres crear el ticket?" [No] [Si]
Usuario: "Si"
Agente: Ejecuta crear_ticket → "Tu ticket #1234 ha sido creado exitosamente"

​

Tips

• Prueba siempre en el Studio (tab “Probar agente”) antes de publicar
• Usa requiresAuth: true para tools que acceden a datos sensibles del usuario
• Configura custom headers si tu API necesita headers adicionales (version, region, etc.)