> ## 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 e o assistente

Threads de chat em streaming e execuções pontuais de agente sobre a API partilhada.

## Os threads de chat usam o contrato web

O separador de chat chama a mesma superfície REST da app de browser: listar e criar em /api/chat/threads, e ler, renomear ou apagar em /api/chat/threads/:id. Os títulos normalizam para o limite partilhado de 120 caracteres, e a lista de threads está coberta pela cache de leitura offline.


## Respostas em streaming

As respostas chegam em streaming por POST /api/chat/stream sobre expo/fetch; os frames enviados pelo servidor tornam-se eventos chunk, done ou error e os frames malformados são saltados. Os aliases de modelo são fast, smart e cheap — fast é a predefinição — um flag structuredOutput reencaminha o requisito correspondente, e o controlo de paragem aborta o pedido em curso.


## Execuções pontuais de agente

O ecrã escondido do assistente envia {alias, prompt, workspaceId, maxSteps: 4} para /api/v1/agent-runs — uma única execução orçamentada no workspace ativo. O cliente valida a resposta estritamente e rejeita uma execução atribuída a outro workspace. Limites de taxa, início de sessão, entitlement em falta e respostas forbidden mapeiam cada um para um estado distinto, e o histórico de execuções guarda as últimas dez em memória de sessão com formatação de custo exata em microunidades.


## Verificação e resolução de problemas

Testa um stream cancelado, uma sessão revogada a meio de uma execução, um workspace com entitlement e um bloqueado, e o comportamento em modo avião sobre a lista de threads em cache. Uma execução negada pelo servidor tem de aparecer como trabalho indisponível, nunca como uma resposta vazia silenciosa.


## Seguinte

[Notificações e push](https://supastack.dev/pt/docs/mobile/notifications.md)