> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Motivos de parada

> Entiende por qué terminó una respuesta y cómo manejar errores de ZylonGPT.

<Warning>
  **Próxima versión — Zylon 1.58**

  Esta 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](/es/v1.57/overview).
</Warning>

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](/es/v1.58/developer-manual/build-with-zylon/working-with-messages).

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

```json theme={null}
{
  "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). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.