Custom HTTP Tools
Conectá tu agente a APIs propias o de terceros. El agente decide cuándo llamarlas durante la conversación.
Casos típicos
- Consultar stock en tu sistema
- Crear una orden o ticket
- Validar membresía
- Buscar cliente en CRM por DNI
- Calcular precios dinámicos
Configurar una tool
En el detalle del agente → pestaña Custom Tools → Nueva tool.
Campos:
| Campo | Descripción |
|---|---|
| Nombre | identificador interno (ej. consultar_stock) |
| Descripción | qué hace, en lenguaje natural — la IA usa esto para decidir cuándo llamarla |
| Método HTTP | GET, POST, PUT, DELETE, PATCH |
| URL | endpoint completo (debe ser HTTPS) |
| Headers | por ejemplo Authorization: Bearer xxx |
| Schema de input | JSON Schema con los parámetros que la IA debe pasar |
| Schema de output (opcional) | JSON Schema esperado de la respuesta |
Ejemplo
{
"name": "consultar_stock",
"description": "Consulta cuántas unidades hay disponibles de un producto por SKU",
"method": "GET",
"url": "https://api.minegocio.com/stock/{sku}",
"headers": {
"Authorization": "Bearer ABC123"
},
"input_schema": {
"type": "object",
"properties": {
"sku": { "type": "string", "description": "SKU del producto" }
},
"required": ["sku"]
}
}
Seguridad
Hijarvis aplica límites de seguridad:
- Solo HTTPS (no se aceptan endpoints HTTP).
- Hosts privados bloqueados (no podés llamar a
localhost,192.168.x, etc.). - Timeout 10 segundos por llamada.
- Cap de 100KB en la respuesta.
- Retry exponencial (3 intentos con backoff).
Probar la tool
Hay un Test panel donde podés:
- Definir un input de ejemplo
- Ver la request real que se va a hacer
- Ver la response del servidor
- Confirmar que el JSON parseo bien
Una vez verde, activás la tool y queda disponible para el agente.