Saltar al contenido principal
Las respuestas de mensajes distinguen el stop_reason del modelo, el resultado global interaction_stop_reason y los detalles de error. Comprueba cada campo para decidir si continuar, ejecutar una herramienta o reintentar. Para ver stop_reason en el esquema de respuesta, revisa Mensajes.

¿Qué es stop_reason?

stop_reason indica cómo terminó la generación del modelo. Admite null y puede omitirse; no es un tipo de error. Ejemplo de respuesta (truncada):

Valores de stop_reason

Solo los seis valores de generación siguientes son valores de stop_reason.

Resultados de la interacción

interaction_stop_reason admite null y describe el resultado global: stop, error, cancelled o refusal. Es independiente del motivo de parada del modelo. El objeto opcional stop_details tiene type obligatorio y category y explanation opcionales; usa esos detalles para explicar el resultado al usuario.

Errores

Los fallos anteriores a la generación pueden devolver un objeto de error HTTP. Durante el streaming, gestiona los eventos error; los mensajes completados también pueden incluir un array errors. Los tipos siguientes no son valores válidos de stop_reason. No reintentes negativas o cancelaciones como si fueran errores transitorios del servidor.