Glosario · Herramientas
Stop reason
Campo de la respuesta que indica por qué el modelo dejó de generar y, por tanto, qué debe hacer tu código después.
También: stop_reason · motivo de parada · razón de parada
Glosariostop_reason es el campo de cada respuesta de la API de Mensajes que explica por qué terminó la generación. Tu código debe leerlo siempre: decide si el Bucle agéntico continúa, si la respuesta está completa o si algo ha ido mal.
En la práctica
| Valor | Significado | Qué hacer |
|---|---|---|
end_turn | El modelo terminó su respuesta | Mostrarla o procesarla |
tool_use | Pide ejecutar herramientas | Ejecutarlas y devolver un Tool result por cada una |
max_tokens | Se alcanzó max_tokens | Tratarla como incompleta |
stop_sequence | Apareció una secuencia de parada tuya | Procesar hasta ahí |
pause_turn | El servidor pausó un turno largo | Reenviar la respuesta para que continúe |
refusal | El modelo se negó a responder | Manejarlo sin reintentar a ciegas |
El error más común es asumir que toda respuesta es texto final y no tratar max_tokens: un JSON cortado a medias rompe el parseo.