Documentação do ClickHouse Loom
Documentação do ClickHouse Loom
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Loom é um servidor de memória, documentos e índice de código para agentes de IA, armazenado no ClickHouse, com Postgres como opção para o estado de memória e conhecimento em tempo real. Agentes e pessoas o acessam por MCP, HTTP, pelos SDKs de Python e TypeScript e pelo painel. Esta página lista todas as páginas na ordem de leitura.

Comece aqui
| Etapa | Leia |
|---|---|
| 1. Decidir | Visão geral → Avaliar o Loom |
| 2. Instalar | Início rápido → Implantação |
| 3. Conectar agentes | Conectar um agente de código → Integrações |
| 4. SDK e API | Seu primeiro agente → SDK Python / API HTTP |
| 5. Namespaces e acesso | Identidades e namespaces → Tokens e concessões |
| 6. Índice de código | Índice de código → Repositórios → Operações do índice de código |
| 7. Operar | Monitoramento · Solução de problemas · Atualizações · Backup e recuperação |
Casos de uso
Uma página para cada necessidade, explicando o que o Loom faz por ela e por onde começar: memória de agente · busca em documentos e RAG · índice de código para agentes de programação · índice de código por linguagem · memória vinculada ao código · custo de modelo de agentes de programação · contexto compartilhado entre vários agentes · agentes autônomos: recuperação, auditoria, exclusão · execuções, traces e histórico de PRs · auto-hospedado no ClickHouse · todos os casos de uso.
1. Primeiros passos
- Visão geral: o que é o Loom, quando ele é adequado, pré-requisitos.
- O que está incluído: as principais capacidades do Loom, cada uma com a sua página.
- Início rápido: a stack local de ponta a ponta.
- Configurar modelos e chaves de API: assinaturas de agentes, LLMs do servidor, embeddings e configurações com um único provedor.
- Avaliar o Loom: smoke test, avaliação de carga de trabalho e benchmarks públicos reproduzíveis.
- Conectar um agente de código: plugin ou entrada MCP.
- Configurar o Loom com o seu agente de código: para um agente que instala uma versão fixada e comprova que ela funciona, com um relatório fixo.
- Seu primeiro agente: um tutorial de SDK.
2. Instalar e executar o servidor
- Implantação: formatos, ambiente, provedores, modos de identidade, proxy, imagens, checklist de produção.
- Login único: um provedor de identidade OIDC para o painel,
loom logine clientes MCP. - Usar o Loom sem o painel:
loom login,loom calle a chamada do SDK para cada visão do painel. - Atualizações · Versões suportadas · Backup e recuperação · Monitoramento · Manutenção · Configurações de runtime · Solução de problemas · Operações do índice de código · Executar N réplicas: Looms idênticos atrás de uma única URL · Postgres: a autoridade de memória em Postgres · Kubernetes: o Helm chart, com overlays para EKS e kind · ClickHouse Cloud e Managed Postgres: o chart sobre os dois serviços gerenciados · Copiar um namespace para outro Loom · Exportar o uso para um data warehouse
3. Conectar agentes
Integrações · Clientes MCP · Instruções para agentes · Claude Code · Codex · Cursor · VS Code · Estruturas de agentes · Adaptador de grep · Langfuse · ClickStack · OKF
4. SDK e API
Índice de referência · API HTTP · MCP · SDK Python · SDK TypeScript · Ambiente · Operações · Configuração · Processos de trabalho · CLI · Erros · Estado · Esquema · Contrato do extrator. As operações e os campos mudam entre versões; campos desconhecidos e removidos explica como um cliente enxerga um campo que o servidor não lê mais.
5. Namespaces, acesso e o modelo de memória
- Identidades e namespaces: a tupla, papéis, concessões e escopo de leitura.
- Memória: a linha, como uma escrita é avaliada, tempo, histórico, proveniência.
- Recuperação e ranqueamento: legs, fusão, abstenção, calibração.
Guias
Integração com agentes · Bots headless · Tokens e concessões · Rastrear e retomar execuções longas · Otimizar um namespace · Memória de agentes de investigação · Pipelines de extração · Ajuste de desempenho · Depuração · Consultar o Loom a partir do Postgres · Ensinando com o Loom
Recursos
- Planos: namespaces e compartilhamento · busca unificada · conhecimento · grafo de entidades · conversas e sessões · execuções · tarefas e decisões · painel
- Memória: escrita · busca e perguntas · conflitos e recusa · extração · histórico e proveniência · retenção e exclusão · procedimentos e aprendizados · memória de trabalho e perfis
- Observabilidade: auditoria · custo e uso · telemetria
- Tracker: visão geral · contrato de registro
6. Índice de código
Visão geral · Repositórios · Atualidade · Histórico e PRs · Operações · Runbook de operações do índice de código
Arquitetura
Visão geral do sistema · Layout do servidor · ClickHouse · Arquitetura de memória · Autoridade de armazenamento · Células · Layout de armazenamento · Arquitetura do índice de código · Extração de documentos · Fontes de documentos · LLM e embeddings · Segurança · Design do assistente · Falhas e recuperação · Atualizações graduais
Benchmarks de desempenho
Visão geral · Cobertura · Metodologia · Execução · Resultados · Adicionando um caso · Avaliação de skill
Desenvolvimento
Para quem contribui: guia do repositório · desenvolvimento local · testes · geração de código · migrações · processo de release · estilo da documentação · design do ciclo de curadoria · estendendo o Loom · adicionar uma operação · adicionar um worker · adicionar uma tabela · adicionar suporte a uma linguagem · design do painel. O CONTRIBUTING.md descreve o fluxo de pull requests.
Veja também
Glossário: os termos do Loom, definidos uma única vez. Perguntas frequentes: as primeiras perguntas, um
parágrafo para cada. llms.txt: um índice gerado da documentação para agentes;
llms-full.txt reúne, em um único arquivo, as
páginas que explicam o que é o Loom e como começar.