Herramientas · · 5 mín. leyendo

Para qué sirve OpenAI Agents SDK: confirmaciones sobre argumentos ya verificados

Acordar una acción exactamente en la forma en que se ejecutará y no perder el motivo del rechazo al reanudar.

respuesta corta

¿Qué aporta la confirmación sobre argumentos ya verificados en OpenAI Agents SDK?

La versión 0.22.3, del 17 de septiembre de 2026, alinea las confirmaciones condicionales con los argumentos verificados de la llamada a la herramienta y traslada el resultado «herramienta no encontrada» al reanudar una sesión gestionada por el servidor. La confirmación se refiere a una acción concreta, así que la decisión humana debe apoyarse en los datos que realmente se usarán.

Elena Artemova · Елена Артемова · Publicado · Actualizado · Propósito de la herramienta · Con ejemplo de aplicación.

Una confirmación es un acuerdo sobre una acción concreta

Quien confirma una acción no acepta una intención, sino una llamada concreta: con el nombre de la operación y sus argumentos. Si después de la confirmación los argumentos se normalizan a otra forma, se completan con valores predeterminados o se reconstruyen, el consentimiento se refería a otra acción.

Por eso la verificación de las confirmaciones condicionales sobre argumentos ya comprobados no es una corrección cosmética. Restaura el sentido del acuerdo: a la decisión llega el mismo objeto que después se envía a la herramienta. Es una regla general para cualquier sistema en el que una persona participe en el ciclo.

Qué cambió en la versión 0.22.3

Además de las confirmaciones, la versión del 17 de septiembre de 2026 enumera: el traslado del resultado «herramienta no encontrada» al reanudar una sesión gestionada por el servidor; la conservación de las rutas de las órdenes en formato POSIX en un nodo con Windows; el arranque simultáneo correcto del almacén de sesiones; la inclusión de las llamadas al intérprete y de las ediciones de archivos en los datos de uso de herramientas; y la finalización de los procesos hijos cuando el flujo se cierra antes de tiempo.

Cada punto parece menor, pero todos giran en torno a lo mismo: el entorno de ejecución debe describir lo ocurrido del mismo modo antes y después de una interrupción.

La reanudación no debe ser silenciosa

Tras una interrupción, el estado se parte en dos: lo que se decidió antes y lo que está disponible ahora. Si al reanudar la herramienta ya no está disponible, la diferencia debe nombrarse. Una continuación silenciosa produce un informe en el que la acción figura como realizada aunque no se ejecutó.

Es una causa habitual de errores en procesos largos. La observabilidad aquí no significa volumen de registros, sino coincidencia entre la descripción y el hecho. El punto sobre los procesos hijos pertenece a la misma serie: una sesión terminada no debe dejar procesos en ejecución.

Detalles que se convierten en fallos

Registrar las llamadas al intérprete y las ediciones de archivos importa para los límites: si esas acciones no entran en el informe, el límite de consumo se calcula con datos incompletos. La diferencia de rutas entre sistemas afecta al aislamiento: una misma entrada puede llevar a directorios distintos.

La conclusión práctica es sencilla: no se pueden fijar límites ni verificar el aislamiento en un entorno donde el registro y el ciclo de vida de los procesos son aproximados. Primero la descripción debe volverse precisa, y solo después puede uno apoyarse en ella.

Ejemplo ilustrativo

Confirmación de una acción con argumentos modificados

problema
En un proceso de ejemplo el agente propone modificar un registro. La persona confirma la llamada, pero después la aplicación completa los argumentos con valores predeterminados.
El papel de la herramienta.
La confirmación se verifica contra el mismo conjunto de argumentos que se envía a la herramienta. Si tras la verificación el conjunto cambia, se vuelve a solicitar el acuerdo.
Resultado esperado
El resultado esperado es que el consentimiento de la persona se refiera a la acción efectivamente ejecutada y que la discrepancia de argumentos no pase desapercibida.
Que comprobar
Si la confirmación se verifica antes de normalizar los argumentos, la comprobación existe en la forma pero no hay decisión de fondo. El ejemplo es ilustrativo.

Una confirmación solo tiene sentido cuando se refiere a los argumentos con los que se ejecutará la acción.

Fuente y razones

fecha de lanzamiento:

La fuente principal describe el instrumento y su desarrollo. Conclusiones sobre la elección - análisis editorial del laboratorio. Un ejemplo explica el propósito de la herramienta; no se realizaron mediciones sobre él. Fecha de la fuente verificada el 8 de septiembre de 2026.

Preguntas sobre el tema

¿Qué riesgo tiene confirmar antes de verificar los argumentos?

La persona acepta una llamada y se ejecuta otra. Formalmente hay acuerdo; en el fondo, no.

¿Por qué importa un rechazo explícito al reanudar?

De lo contrario, el informe describe la acción como realizada aunque la herramienta no estaba disponible.

¿Para qué registrar las llamadas al intérprete en el informe?

De lo contrario, el límite de consumo y la evaluación del trabajo se apoyan en datos incompletos.