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.

Equipo enginerIT· 2 min de lectura
Formar → Contrastar → Autorizar

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

Aplicarlo en tu empresa

Podemos revisar el entorno y acordar qué actuaciones, validaciones y mantenimiento necesitas.

Conocer el servicio relacionado →