Motivos de parada

Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.

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):

{
  "id": "msg_abf981cf3f1c449eacb7a85c064ca505",
  "type": "message",
  "role": "assistant",
  "content": [
    { "type": "text", "text": "Aquí tienes un resumen..." }
  ],
  "stop_reason": "end_turn",
  "interaction_stop_reason": "stop"
}

Valores de `stop_reason`

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

stop_reason	Por qué ocurre	Qué hacer
`end_turn`	El modelo terminó normalmente. A veces llega vacío después de un `tool_result` si envías texto adicional junto al bloque `tool_result`.	Trátalo como completo. Si viene vacío, envía solo el `tool_result` o añade un nuevo mensaje como “Continúa”.
`max_tokens`	La respuesta llegó al límite de `max_tokens`.	Aumenta `max_tokens` o pide continuar.
`stop_sequence`	Se generó una secuencia de parada configurada por ti.	Considera la salida completa en ese punto o ajusta la secuencia.
`tool_use`	El modelo necesita que ejecutes una de tus herramientas personalizadas. Las herramientas integradas nunca paran con `tool_use`: Zylon las ejecuta y devuelve bloques `server_tool_use`.	Ejecuta la herramienta y devuelve un bloque `tool_result`.
`pause_turn`	El modelo pausó la conversación.	Continúa cuando estés listo.
`refusal`	El modelo se negó por razones de seguridad o políticas.	Muestra la negativa o re‑formula con contenido permitido.

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.

Tipo de error	Por qué ocurre	Qué hacer
`invalid_request_error`	Entradas inválidas (artefactos sin ingesta completa, configuración de herramientas inexistente, IDs incorrectos).	Corrige la entrada y reintenta.
`permission_error`	El token no tiene acceso al recurso referenciado.	Revisa la pertenencia a la organización/proyecto y la visibilidad del artefacto.
`request_too_large`	La entrada excede límites de tamaño o tokens.	Reduce la entrada, divide el contenido o baja el contexto.
`api_error`	Error interno del servidor.	Reintenta con backoff exponencial.
`overloaded_error`	El sistema está temporalmente sobrecargado.	Reintenta con backoff y algo de jitter (aleatorización).

Primeros pasos

Construye con Zylon

Coding Agents

Motivos de parada

¿Qué es `stop_reason`?

Valores de `stop_reason`

Resultados de la interacción

Errores

​¿Qué es stop_reason?

​Valores de stop_reason

​Resultados de la interacción

​Errores

¿Qué es `stop_reason`?

Valores de `stop_reason`

Resultados de la interacción

Errores