Cómo validar los argumentos de una llamada propuesta por un agente
Valida una llamada propuesta por el agente en tres planos: formato, significado y autorización.
Valida una llamada propuesta por el agente en tres planos: formato, significado y autorización. Un JSON bien formado puede contener un importe incorrecto o apuntar a otra empresa. La comprobación decisiva se hace en el servidor, antes de invocar la herramienta.
Comprueba la forma sin completar a ciegas
Declara tipos, campos obligatorios y valores permitidos. Rechaza campos adicionales que no deban aceptarse y distingue un dato ausente de uno vacío. La guía de OpenAI documenta un modo estricto para esquemas compatibles; no lo confundas con validación comercial. Si falta un destinatario o una referencia crítica, no inventes un valor para que la llamada pase el esquema.
Contrasta referencias y relaciones
Resuelve los identificadores contra el sistema autorizado y verifica que cliente, expediente y empresa correspondan entre sí. Un identificador existente puede pertenecer a otro ámbito. Para importes, comprueba moneda, unidades y rango acordado; para fechas, qué evento representan. La herramienta debe recibir valores normalizados según su contrato, sin aceptar como verdadera una explicación del modelo sobre por qué serían correctos.
Aplica las reglas del momento
Comprueba permisos de la sesión, operación permitida y aprobación vinculada a esa propuesta. Si un argumento determina el alcance de acceso, obtén o valida ese valor desde contexto confiable. La autorización de ayer no demuestra vigencia sobre el expediente actual. Evita reparar silenciosamente una acción aprobada: cambiar destino o contenido exige volver a presentar la nueva versión cuando esos campos son significativos.
Devuelve errores que permitan continuar
Distingue «campo inválido», «referencia ambigua» y «sin autorización» sin revelar registros ajenos. En un ejemplo hipotético, si dos contactos comparten nombre, solicita elegir una referencia en una vista autorizada. Ensaya datos del tipo correcto pero de otra empresa, una moneda no admitida y un campo extra. Verifica que ninguna llamada llegue al destino tras fallar una comprobación. Guarda el motivo y la versión del validador para reproducir el caso, con una ruta humana cuando la corrección requiere una decisión de negocio.
Comprobaciones para cerrar la tarea
- ✓ Ensayar valores válidos en formato pero fuera de alcance.
- ✓ Rechazar campos extra y referencias ambiguas.
- ✓ Confirmar ausencia de llamada al destino tras denegación.
Fuentes y documentación
- OpenAI: llamadas a funciones — La aplicación ejecuta las funciones; el ajuste al esquema no acredita autorización ni corrección comercial.
- OWASP: validación de entradas — Distingue validación sintáctica y semántica y los límites de validar una dirección o un archivo.
Aplicarlo en tu empresa
Podemos revisar el entorno y acordar qué actuaciones, validaciones y mantenimiento necesitas.
Conocer el servicio relacionado →