O que runtime faz?
Guia para o sistema de runtime e gerenciamento de estado do assistant-ui. Use ao trabalhar com runtimes, acessar estado ou gerenciar dados de threads/mensagens.
Visão Geral
O sistema de runtime do assistant-ui é responsável por gerenciar o estado de conversas e mensagens em interfaces de assistentes de IA. Ele fornece hooks e utilitários para integrar com provedores de IA (como OpenAI, Anthropic) e manter o estado sincronizado.
Tipos de Runtime
- useChatRuntime: Runtime base para chat, que gerencia automaticamente o ciclo de vida de mensagens e threads.
- useAssistantRuntime: Runtime para assistentes com configuração flexível.
Acessando Estado
Use o hook useAssistantState para acessar o estado atual do runtime:
import { useAssistantState } from 'assistant-ui-react'
function MyComponent() {
const state = useAssistantState()
// state contém: threads, messages, currentThreadId, etc.
}
Gerenciando Threads e Mensagens
Adicionar mensagem
import { appendMessage } from 'assistant-ui-core'
await appendMessage({
threadId: 'thread-123',
message: { role: 'user', content: 'Olá!' }
})
Definir thread ativa
import { setThread } from 'assistant-ui-core'
setThread('thread-456')
Boas Práticas
- Sempre use
useAssistantStatedentro de componentes funcionais. - Evite mutar estado diretamente; use as funções fornecidas pela API.
- Para múltiplos assistentes, crie runtimes separados com
useChatRuntime.
Compatibilidade
Este guia é compatível com:
- Claude Code
- Cursor
- Codex
Referências
- Documentação oficial do assistant-ui: https://assistant-ui.com/docs
- Repositório GitHub: https://github.com/Yonom/assistant-ui