Skip to main content
Las herramientas permiten consultar datos en tiempo real o ejecutar acciones aprobadas, como comprobar disponibilidad, crear un ticket o consultar un pedido.

​
Endpoints

Scopes: tools:read, tools:write, tools:execute y tools:logs:read según la operación.

​
Definir una herramienta

Incluye:
  • Nombre y descripción que indiquen cuándo debe usarla la IA.
  • Método y endpoint HTTPS.
  • Autenticación almacenada de forma segura.
  • Parámetros definidos con JSON Schema.
  • Estado inactivo hasta completar las pruebas.

​
Requisitos del endpoint

  • Valida todos los parámetros.
  • Responde con JSON breve y estable.
  • Usa timeouts y operaciones idempotentes cuando existan mutaciones.
  • No registres tokens, contraseñas ni datos innecesarios.
  • Devuelve errores claros sin filtrar información interna.

​
Pruebas y registros

Usa /test antes de activar la herramienta. Revisa los logs para analizar entrada, salida, duración, estado y errores. Un intento de herramienta consume un crédito aunque no devuelva el resultado esperado.
Mantén credenciales y lógica sensible en el servidor. Solicita aprobación humana antes de habilitar acciones con efectos importantes.