> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Chat de IA y el asistente

Hilos de chat con streaming y ejecuciones de agente de un solo paso sobre la API compartida.

## Los hilos de chat usan el contrato web

La pestaña de chat llama a la misma superficie REST que la app de navegador: listar y crear en /api/chat/threads, y leer, renombrar o eliminar en /api/chat/threads/:id. Los títulos se normalizan al límite compartido de 120 caracteres, y la lista de hilos está cubierta por la caché de lectura sin conexión.


## Respuestas en streaming

Las respuestas se transmiten mediante POST /api/chat/stream sobre expo/fetch; las tramas del servidor se convierten en eventos chunk, done o error y las tramas mal formadas se omiten. Los alias de modelo son fast, smart y cheap —fast es el predeterminado—, un flag structuredOutput reenvía el requisito correspondiente, y el control de detener aborta la petición en curso.


## Ejecuciones de agente de un solo paso

La pantalla oculta assistant envía {alias, prompt, workspaceId, maxSteps: 4} a /api/v1/agent-runs —una ejecución única presupuestada en el espacio de trabajo activo—. El cliente valida la respuesta estrictamente y rechaza una ejecución atribuida a otro espacio de trabajo. Los límites de frecuencia, el inicio de sesión, el derecho ausente y las respuestas forbidden se asignan cada uno a un estado distinto, y el historial de ejecuciones conserva las últimas diez en memoria de sesión con formato de coste exacto en microunidades.


## Verificación y solución de problemas

Prueba un stream cancelado, una sesión revocada a mitad de ejecución, un espacio de trabajo con derecho y otro bloqueado, y el comportamiento en modo avión sobre la lista de hilos en caché. Una ejecución denegada por el servidor debe mostrarse como trabajo no disponible, nunca como una respuesta vacía silenciosa.


## Siguiente

[Notificaciones y push](https://supastack.dev/es/docs/mobile/notifications.md)