Rootr — Team Knowledge Base

Guia do Usuário Rootr

Um guia para pessoas que estão usando o Rootr pela primeira vez. Explicamos cada termo conforme avançamos, para que você consiga acompanhar mesmo que a linguagem técnica seja nova para você. Primeiro as primeiras coisas — começamos conectando sua IA ao Rootr.

Conectar e começar

①Integração — Conecte sua IA ao Rootr

Ao final deste capítulo, a IA que você usa (por exemplo, Claude) será capaz de ler, editar, pesquisar e fazer perguntas sobre seus documentos no Rootr diretamente.

O Rootr é uma "ferramenta de documentos que sua IA escreve junto com você." Então a primeira coisa a fazer é conectar sua IA ao Rootr. Há três formas de entrar — você não precisa de todas, basta escolher uma.

Para não desenvolvedores · ~2 minCole um URLCole um endereço no Claude ou ChatGPT e faça login. Nada para instalar, sem terminal.Comece por aqui → ~5 min · copie e coleChave MCP com um cliqueCopie a configuração que o Rootr cria para você no Claude Code, Claude Desktop ou Codex no seu próprio computador.Comece por aqui → Para desenvolvedoresArquivo de configuração · CLI · APIEscreva o arquivo de configuração você mesmo, ou chame o Rootr direto do terminal ou do seu próprio código.Comece por aqui →

›Espera — MCP? Chave de API? Workspace? Aqui estão os 5 termos primeiro

• Agente de IA: uma IA que não apenas conversa com você, mas realmente executa o trabalho que você pede. Exemplos são programas como Claude Code, Claude Desktop e Codex. Ao longo deste guia, sempre que você vir "agente", pense "sua IA".
• API: um canal pelo qual os programas trocam informações. Em vez de uma pessoa clicar em botões na tela, sua IA usa esse canal para enviar solicitações ao Rootr como "mostre-me este documento" ou "adicione uma linha aqui".
• Chave de API: a "chave" que abre esse canal, e também seu crachá de identificação. É uma sequência longa que começa com rootr_, e somente uma IA que possua essa chave pode acessar seu material. Por isso, como uma senha, você nunca deve mostrá-la a ninguém.
• MCP: uma regra (uma convenção) que permite que uma IA use ferramentas externas de forma padronizada. Em termos simples, é um "adaptador universal entre sua IA e o Rootr." Conecte via MCP e sua IA tratará o Rootr como uma pasta no próprio computador dela.
• Workspace: o espaço onde seus documentos e pastas ficam. Pense nele como uma "sala de trabalho" para uma empresa. Cada workspace tem seu próprio id.

Assim que sua IA se conectar ao Rootr via MCP ou API, portando sua chave (chave de API), ela poderá trabalhar com documentos, perguntas e dados diretamente.

1.1

Cole um URL — conecte sem instalar nada

Para não desenvolvedoresMais fácil~2 minClaude · ChatGPT

Este é o caminho para não desenvolvedores. Sem instalação, sem terminal, sem arquivos de configuração. Claude e ChatGPT se conectam com este único endereço:

https://rootr.io/mcp

1. 1 Nas configurações da sua IA, abra Conectores → Adicionar conector personalizado. Cole o endereço acima no campo de endereço.
2. 2 Uma tela do Rootr abre no seu navegador: faça login e pressione Permitir. É aqui que você escolhe o workspace para conectar e um nível de permissão (somente leitura / leitura + escrita).
3. 3 As ferramentas do Rootr aparecem na sua IA — isso significa que funcionou. Tente perguntar: "Quais documentos estão no meu workspace?"

Configurações → Conectores → Adicionar conector personalizado, depois cole o endereço. É o mesmo na web e no aplicativo de desktop, e funciona no plano gratuito.

Conectar cria automaticamente uma "chave de conector remoto MCP" em Configurações → Integrações. Desconectar = revogar essa chave (o acesso para imediatamente).

Um guia passo a passo com capturas de tela para conectar Claude e ChatGPT →

1.2

Chave MCP com um clique — conecte a IA do seu computador

~5 minClaude Code · Desktop · Codex

O Rootr cria automaticamente as configurações necessárias para a conexão. Tudo o que você precisa fazer é copiá-las e colá-las na sua IA.

1. 1 Abra Configurações no menu lateral esquerdo e clique na aba Integrações.
2. 2 Em "Integração de agente de IA (MCP)", pressione o botão Criar chave MCP….
3. 3 Dê um nome à chave, escolha quanto acesso permitir (permissões) e pressione Criar. Escolha um nome que você reconhecerá depois — por exemplo, "Claude no meu notebook".
4. 4 Uma configuração com sua chave (chave de API) já preenchida aparece na caixa de código abaixo.
5. 5 Pressione o botão de copiar que corresponde à IA que você usa e cole conforme explicam as abas abaixo.

A tela de integração MCP com um clique em Configurações → Integrações. Ela mostra uma configuração pronta para copiar com a chave emitida preenchida, além de botões de copiar por destino.

Este é o Claude no terminal. Cole o comando de uma linha que você copiou diretamente em uma janela de terminal e execute — a conexão está feita.

Importante: a chave de API (sua chave) é mostrada na tela apenas uma vez, no momento da criação. Depois que você fechar a janela, não poderá vê-la novamente, então copie-a para um lugar seguro. Se você a perder ou ela vazar, basta excluir (revogar) essa chave da lista de chaves em Configurações → Integrações e criar uma nova.

A partir daqui: para desenvolvedores

1.3

Registrando MCP em um arquivo de configuração você mesmo

Para desenvolvedores

Se você se sente confortável com desenvolvimento e quer gerenciar arquivos de configuração diretamente, adicione conforme mostrado abaixo. Esta é uma configuração que diz à sua IA para "executar um pequeno programa (rootr-cli) que se conecta ao Rootr." Coloque a chave que você criou acima em ROOTR_API_KEY, e o id do seu workspace em ROOTR_WORKSPACE.

{

"mcpServers": {

"rootr": {

"command": "npx",

"args": ["-y", "rootr-cli", "mcp"],

"env": {

"ROOTR_API_KEY": "rootr_xxxxxxxxxxxxxxxx",

"ROOTR_WORKSPACE": "ws_123"

}

}

}

}

Para Claude Code, coloque isso no arquivo ~/.claude.json; para Claude Desktop, coloque na parte mcpServers do arquivo claude_desktop_config.json. Se você instalou rootr-cli globalmente no seu computador, pode encurtar command para "rootr" e args para ["mcp"].

1.4

O CLI rootr — uma pessoa, direto do terminal

Para desenvolvedores

Um CLI (ferramenta de linha de comando) é uma forma de trabalhar com o Rootr digitando comandos em uma janela de terminal preta. É útil quando uma pessoa trabalha diretamente sem uma IA, ou quando você o coloca em um script que roda automaticamente em um horário definido. Tente executar os comandos abaixo em ordem.

# 1) Instalar — adicione o comando rootr ao seu computador

npm install -g rootr-cli

rootr config --api-key rootr_xxxxxxxxxxxxxxxx --workspace ws_123

# 3) Exemplos de uso

rootr ls /notes # lista os documentos dentro da pasta /notes

rootr read /notes/todo.md # abre um documento e lê seu conteúdo

rootr append /notes/log.md "Deploy concluído" # adiciona com segurança uma linha ao final de um documento

rootr edit /notes/todo.md --find "- [ ] Deploy" --replace "- [x] Deploy" # altera uma linha específica

rootr search "procedimento de deploy" # pesquisa em todo o workspace

rootr rm /notes/old.md # move um documento para a lixeira (recuperável; --yes pula a confirmação)

rootr ask "por que a latência aumentou após o deploy da semana passada?" # pergunta à IA pela causa raiz

• Como escrever caminhos: se começar com uma barra (/), é lido como um "caminho de pasta"; caso contrário, é lido como o número único (id) de um documento. O Rootr descobre isso para você.
• Recomendamos "append": ele apenas adiciona ao final de um documento em vez de reescrever tudo, então nunca gera conflitos mesmo quando outras pessoas ou outros programas editam ao mesmo tempo.
• Excluir move o documento para a lixeira, então ele pode ser restaurado. Após 30 dias, é removido definitivamente.
• Se você precisar de uma explicação linha por linha, digite rootr --help e o uso aparece.

1.5

Chamando a API REST diretamente

Para desenvolvedores

Se você está construindo seu próprio programa, pode chamar o Rootr com uma solicitação de internet (HTTP) de qualquer linguagem. O endereço é https://rootr.io/api/v1, e em cada solicitação você carrega sua chave em um rótulo chamado x-api-key. Abaixo estão exemplos que você pode testar agora mesmo no terminal.

# Adiciona com segurança uma linha ao final de um documento

curl -X POST https://rootr.io/api/v1/docs/by-path/append \

-H "x-api-key: rootr_xxxxxxxxxxxxxxxx" \

-H "content-type: application/json" \

-d '{"workspaceId":"ws_123","path":"/notes/log.md","content":"Deploy concluído"}'

# Pergunte ao seu conhecimento uma questão e obtenha uma resposta com evidências

curl -X POST https://rootr.io/api/v1/workspaces/ws\_123/ask \

-H "x-api-key: rootr_xxxxxxxxxxxxxxxx" \

-H "content-type: application/json" \

-d '{"question":"por que as falhas de pagamento aumentaram?"}'

Tudo bem se você não souber exatamente o que cada comando significa. O ponto é que você "carrega sua chave no cabeçalho e envia uma solicitação ao endereço." Você pode encontrar a lista completa de todas as solicitações que pode fazer no documento técnico (OpenAPI) vinculado em ⑩ Referência.

Referência — chaves · permissões · limites

1.6

Os dois tipos de chaves (chaves de API) e suas permissões

Existem dois tipos de chaves, e elas diferem em quão ampla é a faixa que podem abrir. Cada chave também carrega um conjunto de permissões (escopos) que decidem "quanto ela pode fazer." Permitir apenas o necessário é a escolha segura.

Tipo	Faixa que pode abrir	Quando usar
Chave de workspace	Somente dentro daquele workspace (sala de trabalho)	Ler/escrever documentos, pesquisar, perguntar e quase todas as outras conexões — geralmente isso é suficiente
Chave de conta (PAT)	Sua conta inteira (todos os seus workspaces)	Quando a IA precisa circular entre várias salas de trabalho, ou criar um workspace totalmente novo

• Exemplos de permissões (escopos): docs:read (ler documentos) · docs:write (editar documentos) · graph:read (navegar no conhecimento) · ask (fazer perguntas) · webhooks:manage (configurar notificações). Se você quer apenas leitura, ative somente docs:read.
• O princípio: para a maioria das conexões, uma chave de workspace é suficiente. Uma chave de conta tem permissões amplas, então use-a apenas quando realmente precisar.
• Para circular entre salas de trabalho: uma chave de workspace não abre nada fora da própria sala. Para a IA alternar com rootr_use_workspace, use uma chave de conta, ou emita uma chave por sala e registre-as com rootr config --add-key <key>.

As chaves são mostradas apenas uma vez. Gerenciar e revogar (excluir) é tudo feito em um só lugar — a lista de chaves em Configurações → Integrações.

1.7

Dicas para colocar sua IA para trabalhar

Depois de conectado, você apenas diz à sua IA em linguagem simples ("resuma este documento e adicione abaixo"). Para resultados mais seguros e precisos, peça que ela siga os pontos abaixo.

• Para adicionar conteúdo, peça que use "append" primeiro, e para alterações parciais, "localizar e substituir" (edit). A abordagem de reescrever o documento inteiro pode apagar conteúdo existente acidentalmente, então use-a apenas quando for realmente necessário.
• Ao construir um workspace a partir de uma estrutura, peça que a IA planeje primeiro, faça algumas perguntas, e só então crie (para que ela não construa às cegas).
• Se você configurou a IA para receber notificações de alterações (webhooks) novamente, peça que ela ignore "alterações feitas pela própria IA." Caso contrário, você terá um loop infinito em que ela reage exatamente às notificações que ela mesma criou.

1.8

A lista de ferramentas que sua IA pode usar (90+)

Depois de conectada, sua IA pode usar as ferramentas abaixo. Esta é uma tabela resumida por categoria; uma descrição detalhada de cada ferramenta está em ⑩ Referência. Por enquanto, apenas tenha uma noção de "nossa, posso fazer ela fazer tantas coisas diferentes."

›Abra a tabela completa por grupo (15 grupos)

Grupo	Contagem	Ferramentas representativas (o que fazem)
Documentos	6	listar · ler · anexar · localizar e substituir · reescrever por completo · pesquisar
Criar espaços de trabalho	4	ver meus espaços de trabalho · planejar uma estrutura · criar um novo espaço de trabalho · aplicar a um existente
Registros de dados (LOG)	5	criar um diário de bordo · adicionar uma entrada · consultar · estatísticas · editar o formato de uma entrada
Perguntas (RCA)	1	perguntar em linguagem natural e obter uma resposta com citação
Gerenciamento de problemas (tarefas/bugs)	6	criar um problema · listar · detalhar · editar · comentar · criar um rastreador
Linhas e colunas de tabela (DATABASE)	8	ler uma tabela · listar linhas · adicionar uma linha · editar uma linha · excluir uma linha · adicionar uma coluna · renomear uma coluna / definir suas opções · excluir uma coluna
Apresentações	8	criar um deck · ler · adicionar um slide · editar um slide · reordenar · configurações · desenhar um diagrama em um slide · consultar a forma de um diagrama
Notificações de alteração (webhooks)	3	listar notificações · criar uma notificação · excluir uma notificação
Versões / exclusão	2	ver o histórico de versões de um documento · enviar um documento para a lixeira
Planilhas · quadros brancos · formulários	15	cálculos · tela livre · criar um formulário e ler respostas
Gravações · CRM · anexos	20+	transformar a gravação de uma reunião em notas · acompanhar clientes e negócios · enviar arquivos
Bloqueios e alertas de tabela	4	ler/definir os bloqueios de uma tabela (colunas somente para gerentes, somente próprias linhas) · ler/definir quem é notificado quando uma linha é adicionada, alterada ou excluída
Visibilidade e acesso	4	ver quem pode abrir uma página · torná-la privada · dar acesso a uma pessoa · retirar o acesso
Respostas de formulário	3	criar a tabela/planilha que coleta respostas · corrigir uma resposta enviada · excluir uma
Propostas de alteração	3	listar propostas em uma página publicada · mesclar uma · rejeitar uma

Sua IA busca a lista exata e atual quando se conecta. A tabela acima é um resumo para dar uma ideia do que você pode pedir.

1.9

Alternando entre espaços de trabalho

Se você tiver vários espaços de trabalho, pode alternar entre eles no meio da conversa sem reconfigurar nada — basta dizer à IA "mude para o espaço de trabalho de vendas" (pelo nome ou pelo ID).

• Com uma chave de conta (PAT): você pode alternar para qualquer espaço de trabalho do qual faça parte.
• Com uma chave separada por espaço de trabalho: registre cada chave uma vez (rootr config --add-key <key> --label "Sales") e a chave correta é selecionada — e lembrada — sempre que você alternar.
• Um conector remoto (a opção de colar uma URL) permanece vinculado ao único espaço de trabalho que você aprovou, por design. Emita outro conector para outro espaço de trabalho.

1.10

Quanto você pode usar (limites de taxa)

Apenas leituras, pesquisas e perguntas contam contra um limite. Escrever documentos e enviar arquivos nunca conta (esses são limitados pelo armazenamento).

Plano	Limite
Gratuito	180 / dia (recarrega à meia-noite KST)
Equipe	5.000 / hora
Empresa	50.000 / hora
Plataforma	Ilimitado

• A 80% do uso, sua IA informa quantas consultas restam hoje — para que você nunca seja interrompido no meio de uma tarefa sem aviso.
• Quando a cota acaba, sua IA informa e aponta para a página de upgrade. Ela recarrega à meia-noite.

②Comece em 5 minutos

Do cadastro ao seu primeiro documento, e construindo um espaço de trabalho inteiro com IA — leva apenas cinco minutos.

Se o Rootr é novo para você, basta seguir esta ordem. Nenhum conhecimento de desenvolvimento é necessário.

2.1 Cadastre-se e faça login

• Você pode se cadastrar com e-mail e senha, ou começar com um clique usando uma conta do Google.
• Na primeira vez que fizer login, verá um aviso: "Crie seu primeiro espaço de trabalho." Um espaço de trabalho é o seu próprio ambiente que contém documentos e pastas.

2.2 Criando documentos e pastas

À esquerda da tela há uma árvore (uma lista que se desdobra como galhos). Aqui você cria pastas para organizar as coisas e cria documentos dentro delas. Pense nisso como as pastas e arquivos do seu computador.

Um espaço de trabalho recém-criado e a árvore de documentos (lista de pastas e documentos) à esquerda.

2.3 Construindo tudo de uma vez com "Criar com IA"

Você não precisa construir tudo peça por peça a partir de uma tela em branco. Escreva em uma frase "o que você quer fazer" (por exemplo, "crie um espaço para preparar o lançamento de um novo produto"), e depois de fazer algumas perguntas, a IA constrói automaticamente uma estrutura pronta para uso, completa com pastas, documentos e tabelas.

A janela "Criar com IA". Escreva o que deseja fazer como uma frase e ela gera automaticamente uma estrutura de espaço de trabalho.

Quando você salva um documento, seu conteúdo é automaticamente organizado em um "grafo de conhecimento" em segundo plano (detalhes no capítulo ⑥). Depois, vá direto ao capítulo ① e conecte sua IA — é aí que começa o verdadeiro poder do Rootr.

Documentos e estrutura

③Escrevendo documentos juntos (básico)

Muitas pessoas podem escrever confortavelmente ao mesmo tempo, e apenas salvando, o conteúdo se torna automaticamente conhecimento pesquisável e consultável.

Os documentos do Rootr são feitos de peças chamadas "blocos." Um título, um parágrafo, uma lista, uma tabela, uma imagem — cada um é um bloco. Você pode soltá-los onde quiser e reordená-los, o que torna a escrita muito mais flexível.

• Coedição em tempo real: mesmo quando várias pessoas abrem o mesmo documento e o editam ao mesmo tempo, as alterações de todos aparecem instantaneamente. Você também pode ver quem está olhando o quê.
• Histórico de versões (um registro de salvamento automático): toda vez que você edita um documento, seu estado anterior é salvo automaticamente. Mesmo se você excluir algo por engano, pode voltar a uma versão anterior (o ícone de relógio no canto superior direito).
• Blocos especiais: você pode adicionar caixas de destaque (callouts), tags (etiquetas) e diagramas mermaid — imagens como fluxogramas desenhados com código. Mesmo quando a IA escreve um documento, ela desenha esses diagramas automaticamente.
• Conteúdo adicionado de fora também aparece em tempo real: quando uma IA ou um programa adiciona texto a um documento via API, ele aparece imediatamente na tela de quem tem esse documento aberto.

A tela do editor de blocos. Ao lado de um título e uma lista, um fluxograma (diagrama mermaid) é desenhado.

Abaixo está a tela de histórico de versões. Os momentos em que você editou o documento permanecem como uma lista, para que você possa verificar ou voltar ao conteúdo em qualquer um desses pontos a qualquer momento.

O painel de histórico de versões do documento. Os momentos de edição são listados em ordem cronológica.

O que "/" insere

Digite / em uma linha vazia e o menu de blocos aparece. Ele também pesquisa em coreano, então /토글 encontra o alternador.

Bloco	O que faz
Título · lista · citação · tabela · código	A estrutura de um documento
Alternador	Recolhe detalhes. O estado recolhido sobrevive a uma atualização
Callout	Um parágrafo que precisa se destacar — "nota", "resumo"
Tag	Colore uma frase inline
Sumário	Reúne os títulos deste documento; atualiza conforme eles mudam
Marcador	Um link como cartão com título e site, não uma URL simples
Incorporar	Outro documento, tabela, planilha, deck, quadro branco, formulário, gravação ou rastreador, inline
Diagrama (mermaid)	Fluxogramas e diagramas de sequência escritos como texto. Agentes podem desenhá-los para você
Imagem · vídeo · arquivo	Arraste ou cole para enviar (vídeo até 75MB)

Um cartão incorporado mostra uma prévia das primeiras linhas de uma tabela, das células do canto superior esquerdo de uma planilha ou da contagem de slides de um deck. Qualquer coisa que você não possa abrir normalmente também não abrirá aqui — incorporar nunca amplia permissões.

O menu de blocos aberto com "/" dentro de um documento.

Comentários e subpáginas

• Comentários: selecione um parágrafo e comente sobre ele. @name notifica essa pessoa.
• Subpáginas: clique com o botão direito em um documento na árvore e escolha "Novo subdocumento" — ele se aninha sob esse documento. Tabelas também podem conter subpáginas.
• Confirmações de leitura: para anúncios que precisam ser lidos, nomeie o público e o Rootr mostra quantos leram.

④Tipos de documento (tipos de nó) em detalhe

Não force tudo em um documento simples. Escolher o tipo que se adequa ao seu propósito torna as coisas muito mais fáceis.

"Nó" é a palavra para cada item que entra na árvore (a lista à esquerda). Um documento é um nó, uma pasta é um nó, uma tabela é um nó. O Rootr tem vários tipos de nós, como abaixo, e você escolhe o que se adequa ao que está tentando fazer. Primeiro, aqui está o panorama geral de uma olhada; depois explicamos os importantes um por um.

Tipo	Use quando	Principais recursos
DOCUMENTO	Escrever — descrições, planos, atas de reunião, etc.	Editor de blocos · coedição · versões · construção automática de conhecimento
PASTA	Agrupar vários itens para organizá-los	Agrupamento + repasse de permissões aos filhos
DATABASE (tabela)	Gerenciar coisas como uma lista — tarefas, requisitos, problemas	Uma tabela com formato definido por coluna + 4 visualizações
PLANILHA	Tabelas que precisam de cálculo — orçamentos, cotações	Uma tabela com fórmulas (=soma, etc.)
QUADRO BRANCO	Esboçar ideias livremente com desenhos e formas	Posicionamento livre em uma tela infinita
FORMULÁRIO (pesquisa/formulário)	Obter respostas de pessoas externas	Um formulário para preencher → coletado automaticamente em uma tabela
ISSUE_TRACKER (problemas)	Rastrear bugs e tarefas por número	Problemas estilo GitHub (#número · status · etiqueta · comentários)
APRESENTAÇÃO	Materiais de apresentação em slides	Um deck de slides (16:9)
LOG (registros de dados)	Registrar métricas, incidentes, eventos	Um diário de bordo formatado → linhagem de dados (⑦)
ASSINADO (documento assinado)	Registros que precisam ser comprováveis — aprovações, notas de pesquisa	Congela ao enviar → assinado em ordem → verificação de adulteração

DATABASE (tabela) — uma lista com formato definido

Pense nisso como uma planilha cruzada com um banco de dados estruturado. Para cada célula (coluna), você define um formato — "esta coluna é texto, aquela é uma data, esta é um status (uma escolha)." Você pode ver os mesmos dados de quatro maneiras — como tabela, como quadro kanban (onde os cartões formam colunas por status), como calendário e como linha do tempo. Você pode adicionar e editar linhas tanto na tela quanto pedindo à IA para fazer isso.

Clicar em um cartão abre a linha à direita, onde você pode escrever uma nota de detalhe sob as propriedades. Essa nota é um documento próprio abaixo da tabela, então sua IA também pode escrevê-la — passe body quando ela adicionar ou atualizar uma linha.

Um nó DATABASE visualizado como quadro kanban. Os cartões ficam nas colunas A fazer / Em andamento / Concluído.

Colunas que o servidor preenche — sempre corretas, nunca editadas manualmente

Essas colunas contêm fatos, não valores que você digita. O servidor as recalcula a cada leitura, então elas não podem divergir e ninguém pode editá-las para discordar da realidade.

Tipo de coluna	O que contém	Use para
Fórmula	Um valor calculado a partir de outras colunas, ex.: {Qtd} * {Preço}	Valores, dias restantes, níveis
Acumulação	Valores reunidos por meio de uma relação (contagem, soma, média, percentual concluído)	"Quantas tarefas neste projeto e quanto elas somam"
Criado por / Última edição por	Quem criou a linha e quem a tocou por último	Manter um registro honesto de quem inseriu uma linha
Hora de criação / Hora da última edição	Quando a linha apareceu e quando mudou por último	Saber a idade de uma linha
ID	Um número único dentro da tabela, ex.: TAREFA-42	O nome que as pessoas usam em voz alta nas reuniões

As fórmulas suportam if, concat, round, min, max e dateBetween (dias entre duas datas), entre outras — por exemplo if(dateBetween({Due}, now()) < 0, "overdue", "on time"). Os IDs nunca são reutilizados: a TAREFA-42 que você mencionou ontem não deve apontar para uma linha diferente hoje.

Bloqueando uma tabela (o Notion não tem equivalente)

O botão "Permissões" acima de uma tabela oferece três bloqueios. Nenhum deles se aplica a gerentes, e uma tabela que você nunca configura se comporta exatamente como antes.

• Somente gerentes alteram colunas e visualizações: editores ainda preenchem linhas. Isso impede que alguém exclua uma coluna da qual todos dependem.
• As pessoas veem apenas as linhas que criaram: para formulários de inscrição ou caixas de relatórios em que as submissões devem permanecer privadas. Gerentes veem tudo.
• Colunas que somente gerentes podem editar: flags de aprovação, pontuações finais — as células que não podem ser alteradas.

Colocando outras coisas dentro de um documento (mais amplo que o Notion)

O Notion permite incorporar um banco de dados em uma página. O Rootr permite incorporar uma tabela, planilha, apresentação, quadro branco, formulário, gravação ou rastreador de problemas — porque uma nota de reunião é mais útil quando a gravação, a tabela de decisões e a apresentação dessa reunião estão na mesma página.

Digite "/" em um documento, escolha Incorporar e pesquise pelo nome. O cartão mostra uma prévia das primeiras linhas de uma tabela, das células do canto superior esquerdo de uma planilha, da contagem de slides de uma apresentação. Qualquer coisa que você não possa abrir, também não poderá pré-visualizar na incorporação — incorporar nunca amplia o que alguém pode ver.

O mesmo menu adiciona um Sumário (construído a partir dos títulos do próprio documento) e um Marcador (um link exibido como cartão em vez de uma URL simples).

QUADRO BRANCO · APRESENTAÇÃO · FORMULÁRIO

• Quadro branco: uma tela ampla onde você desenha livremente com formas e conectores. Ótimo para diagramas de estrutura ou organização de ideias.
• Apresentação (APRESENTAÇÃO): onde você cria slides. O "texto" que você escreve no título, no corpo e nas notas de um slide é vinculado automaticamente ao grafo de conhecimento, então sempre escreva conteúdo importante como texto e adicione descrições (legendas) às imagens.
• Pesquisa/formulário (FORMULÁRIO): um formulário para solicitações e pesquisas. Os membros podem preenchê-lo dentro do espaço de trabalho (por exemplo, uma solicitação de licença), e você também pode enviá-lo como link para pessoas de fora. As respostas são coletadas automaticamente em uma tabela (BANCO DE DADOS), e cada pessoa vê apenas o que enviou.

Uma tela de quadro branco de canvas livre.

Uma tela de edição de apresentação de slides.

Peça à IA para "desenhar isso como um diagrama e colocá-lo em um slide" e ela escolhe o tipo certo entre cinco — arquitetura, fluxo de trabalho, sequência, fluxo de dados ou ciclo de vida — e o desenha. O desenho também sobrevive à exportação: ele aparece no PDF e no PPTX, não apenas na tela. O texto dentro do desenho não é pesquisável, no entanto, então mantenha os pontos importantes também no título e no corpo do slide.

ASSINADO (documento assinado) — aprovações e notas de pesquisa em um só lugar

Parece um documento comum, mas no momento em que você pressiona [Enviar], o corpo congela. Depois disso, ninguém pode alterá-lo — nem na tela, nem por IA, nem restaurando uma versão antiga. As pessoas na linha de aprovação assinam em ordem, e cada assinatura carrega um carimbo de data/hora de uma autoridade externa, além de um hash que a vincula à assinatura anterior. Então, meses depois, "isso é realmente o que dizia naquela época?" é respondido em uma única tela, em vez de uma discussão.

As três coisas que uma nota de pesquisa eletrônica de P&D nacional coreana deve ter — ① uma assinatura eletrônica ② um horário registrado automaticamente ③ uma verificação de adulteração — são exatamente essas três. Aprovações e notas de pesquisa não são recursos separados aqui, porque fazem o mesmo trabalho. Um documento que carrega uma assinatura não pode ser excluído (retenção de 30 anos); excluir a pasta em que ele está também é recusado pelo mesmo motivo.

• Criar: [Novo] na árvore → "Novo documento assinado". Edite o corpo normalmente até enviar.
• Quem assina: adicione-os em ordem no painel de assinatura à direita. Para uma nota de pesquisa, escolher apenas o revisor (o pesquisador principal) cria as duas etapas — autor e depois revisor — para você.
• Assinar: pressionar [Enviar] envia um código de confirmação de 6 dígitos para seu e-mail. Um código, não sua senha — pessoas que se cadastraram com o Google não têm senha alguma.
• Devolver: rejeite com um motivo e o documento é desbloqueado para que o autor possa corrigi-lo.
• Alterar um documento assinado: você não o edita, cria uma revisão. O original permanece, marcado como substituído — a diretriz exige que tanto a correção quanto o original permaneçam visíveis.
• Comprovação: [Mostrar verificação] recalcula o hash do corpo, cada assinatura, cada carimbo de data/hora e os links do livro-razão, e mostra o resultado. Imprima para envio.

Você recebe um e-mail quando é sua vez. No momento em que a pessoa anterior assina, o próximo signatário recebe um e-mail de "por favor, assine" cujo link abre exatamente aquele documento. Não há fila separada para verificar — abra o documento e assine pelo painel à direita.

Obtendo uma assinatura de alguém fora da sua empresa

Ao adicionar um signatário, insira apenas um endereço de e-mail e essa pessoa não precisa de uma conta Rootr. Ao enviar, um link é enviado para esse endereço; abri-lo permite que ela leia o documento e assine ali mesmo. Use isso para acordos e ordens de alteração com um cliente ou fornecedor.

• O link sozinho não assina nada. Ele apenas permite a leitura. Assinar ainda exige um código de 6 dígitos enviado para o mesmo e-mail, então um link encaminhado ou vazado não é suficiente.
• Os endereços dos outros signatários são mascarados nessa página (ki *@corp.com), então um link de assinatura nunca se torna uma lista de contatos.
• O link abre apenas aquele documento e nada mais no espaço de trabalho.
• Eles podem devolvê-lo — com um motivo, o que desbloqueia o documento para que você possa corrigi-lo.

Quando todas as assinaturas estiverem presentes, uma cópia em PDF é enviada automaticamente por e-mail — para o signatário externo e para todos do seu lado que assinaram. A cópia inclui o corpo, quem assinou quando, a impressão digital do conteúdo (hash) e o endereço onde qualquer pessoa pode verificar posteriormente que é genuíno. Imprima e arquive como está.

Abra uma linha de BANCO DE DADOS e escolha documento assinado e essa linha se torna um registro com assinaturas e carimbos de data/hora. Use isso para registros de experimentos e registros de inspeção — tabelas em que uma linha é um registro que precisa ser assinado. Para fazer uma tabela inteira funcionar assim, peça à sua IA (isso se torna o padrão da tabela). Linhas cuja página já está assinada não podem ser excluídas.

A IA pode conduzir tudo isso — criar o documento, montar a linha de aprovação, listar o que está pendente, verificar a integridade. A única coisa que ela não fará é assinar por você. O código de confirmação vai apenas para o e-mail de uma pessoa, e esse código é a única evidência de que um humano pressionou assinar; a IA pede que você forneça os seis dígitos.

RASTREADOR_DE_PROBLEMAS (problemas) · REGISTRO (registros de dados)

• Rastreador de problemas: transforme cada bug ou tarefa em um "problema" e acompanhe-o com um número (#1, #2…), um status (aberto/fechado), etiquetas, um responsável e comentários. Funciona da mesma forma que os problemas em uma ferramenta de colaboração de desenvolvimento (GitHub).
• REGISTRO (livro de registro de dados): um lugar para colocar registros que se acumulam ao longo do tempo (por exemplo, tempos de resposta do servidor ou eventos de incidentes) em um formato definido. Ao usar uma coluna de "relação" aqui, uma "linhagem de dados" é criada automaticamente, rastreando a origem de cada registro (capítulo ⑦).

A tela de lista de problemas de um RASTREADOR_DE_PROBLEMAS.

Uma tela de REGISTRO (livro de registro de dados). Uma tabela de registros preenchida com nível, mensagem e valores de dados.

⑤Bancos de dados (tabelas), de ponta a ponta

Qualquer coisa que você gerencie como uma lista — tarefas, requisitos, inscrições — pertence a uma tabela, não a um documento. Digite cada coluna uma vez e visualize as mesmas linhas de seis maneiras.

Uma tabela Rootr é uma planilha e um banco de dados Notion em um só. Dê a cada coluna um tipo e cada célula recebe o editor certo — um seletor de data, uma pílula de status, um seletor de membro — e valores errados simplesmente não podem ser inseridos. Crie uma pelo ＋ ao lado de "Documentos" na barra lateral → Novo banco de dados.

Uma tabela na visualização de tabela, com colunas de título, status, responsável e data de vencimento preenchidas.

Adicionando uma coluna — vinte tipos para escolher

O ＋ no extremo direito da linha do cabeçalho abre o diálogo de nova coluna no meio da tela. Escolha um tipo à esquerda; preencha apenas o que esse tipo precisa à direita. Há vinte tipos, então uma caixa de pesquisa os filtra, e cada um traz uma descrição de uma linha. No celular, o diálogo sobe pela parte inferior como uma folha e avança para uma etapa de configurações depois que você escolhe um tipo.

O diálogo de nova coluna: lista de tipos com ícones e descrições à esquerda, nome e configurações à direita.

Os tipos vêm em dois grupos. Você preenche o primeiro grupo; o segundo é preenchido pelo servidor e não pode ser editado, o que é exatamente o motivo de nunca se desatualizar.

Você preenche	O que contém
Texto	Texto livre
Número	Valores que você pode totalizar ou calcular a média
Seleção / Seleção múltipla	Um ou vários de um conjunto fixo, exibidos como pílulas coloridas
Status	Agrupado automaticamente em a fazer / em andamento / concluído (as colunas do quadro usam esses grupos)
Data	Uma data, opcionalmente com hora, opcionalmente um intervalo
Caixa de seleção	Ativado ou desativado
URL · E-mail · Telefone	Clique para abrir / enviar e-mail / ligar
Pessoa	Membros do espaço de trabalho — contém <b>várias pessoas</b> (participantes de reunião, proprietários compartilhados). Pessoas recém-adicionadas recebem notificações
Arquivos	Imagens e documentos anexados
Relação	Links para linhas em outra tabela

Preenchido pelo servidor	O que contém
Fórmula	Calculado a partir de outras colunas — ex.: {qty} * {price}
Acumulação	Contado ou somado entre linhas relacionadas
Hora de criação / última edição	Quando a linha foi criada e alterada pela última vez
Criado por / Última edição por	Quem criou e alterou pela última vez
ID	Um número nunca reutilizado — ex.: TASK-42

IDs nunca são reutilizados. O TASK-42 que alguém mencionou ontem não deve apontar para uma linha diferente hoje.

Fórmulas — nada para memorizar

Escolha o tipo de fórmula e as funções disponíveis aparecem abaixo do campo de entrada com uma descrição e um exemplo. Comece a digitar um nome e a lista é filtrada; clique em uma e o parêntese é inserido para você. Digite { e os nomes das colunas desta tabela aparecem, então você nunca precisa transcrevê-los. Funções desconhecidas e nomes de colunas desconhecidos são sinalizados antes de você salvar.

Criando uma coluna de fórmula, com a lista de funções aberta abaixo do campo de entrada.

Função	O que faz	Exemplo
if	Escolhe um de dois valores	if({amount} >= 5000, "large", "small")
concat	Junta valores em um texto	concat({name}, " · ", {team})
round · floor · ceil	Arredonda, arredonda para baixo, arredonda para cima	round({price} * 1.1, 0)
min · max	Menor / maior valor	max({r1}, {r2}, {r3})
dateBetween · now	Dias entre duas datas · hora atual	dateBetween({due}, now())
empty · contains · length	Vazio? · contém? · contagem de caracteres	if(empty({owner}), "unassigned", {owner})

As fórmulas permanecem ativas: altere uma coluna de entrada e o resultado segue imediatamente. Tabelas importadas do Notion carregam a definição da fórmula, não um número congelado, então linhas adicionadas após a importação também são calculadas.

Relações e acumulações

Uma coluna de relação aponta para linhas em outra tabela — dê a cada tarefa uma relação "Projeto" e cada tarefa saberá a qual projeto pertence. Então, uma coluna de acumulação na tabela de projetos reúne as tarefas vinculadas: conte-as, totalize um valor, calcule a média de uma pontuação ou mostre a porcentagem marcada. Edite uma linha vinculada e a acumulação acompanha.

Uma acumulação precisa de uma relação primeiro. Escolha acumulação em uma tabela sem uma e o Rootr avisa e oferece criar a relação ali mesmo.

Criando uma coluna de acumulação: escolhendo qual relação seguir e como agregar.

Seis visualizações sobre as mesmas linhas

Adicione uma visualização com o ＋ ao lado das abas de visualização. As visualizações nunca copiam dados — elas mostram as mesmas linhas de maneiras diferentes, então uma edição em qualquer lugar aparece em todos os lugares.

Visualização	Use quando
Tabela	Para escanear e editar valores rapidamente. A padrão
Quadro (kanban)	Para arrastar cartões entre status
Lista	Para folhear por título
Galeria	Para navegar por itens que têm imagens
Calendário	Para posicionar linhas em uma grade mensal por uma coluna de data
Linha do tempo	Para ver intervalos de início a fim como barras

Visualização de quadro com cartões nas colunas a fazer, em andamento e concluído.

Arrastar um cartão para outra coluna salva esse status imediatamente. Ative o modo agrupado e muitas opções se resumem aos três estágios, o que mantém um quadro amplo legível. A escolha é lembrada por tabela. Cada visualização mantém seus próprios filtros, ordenação e colunas visíveis. Os filtros reduzem as linhas (o botão mostra quantos estão ativos), o menu de propriedades oculta colunas apenas nesta visualização — os valores nunca são excluídos — e clicar em um cabeçalho ordena. A visualização ativa fica na URL, então um refresh retorna a ela e um link compartilhado a abre.

A barra de ferramentas da visualização com os menus de filtro e propriedades abertos.

Detalhe da linha — um documento sob cada linha

Abra uma linha e um painel desliza da direita: valores das colunas no topo, uma nota de corpo embaixo. Essa nota é o mesmo editor de blocos de um documento normal, então aceita listas, tabelas e imagens, e entra no grafo de conhecimento. Agentes também podem escrevê-la ao criar ou atualizar uma linha.

Painel de detalhe da linha: valores no topo, editor da nota de corpo embaixo.

O detalhe não precisa ser um documento simples. Abra uma linha que ainda não tem nada anexado e o painel à direita oferece oito opções — documento, documento assinado, planilha, quadro branco, apresentação, gravação, formulário, rastreador de tarefas — e um clique cria. Cada linha pode ser uma diferente, então uma tabela de reuniões pode conter gravações das reuniões ao lado de circulares enviadas para assinatura. Documentos são escritos ali mesmo no painel; o restante abre na própria tela.

Você também pode anexar algo que já escreveu — "Vincular uma página existente" no mesmo painel, encontrado pelo nome. Não copie e cole. Uma página vinculada permanece onde está e a linha apenas aponta para ela, então excluir a linha depois não afeta a página. Para desvincular, use "Desvincular" no menu da linha — isso também não exclui a página.

Peça à sua IA por "uma tabela de reuniões onde cada linha é uma gravação" e a tabela ganha um padrão. Nessa tabela, a opção padrão é marcada como "padrão" no painel — e você ainda pode escolher outra coisa para uma linha específica.

Selecionar muitos, alterar muitos, excluir muitos

A caixa à esquerda de uma linha a seleciona; a caixa na linha do cabeçalho seleciona todas as linhas atualmente visíveis (apenas as filtradas, se houver um filtro ativo). Shift-clique estende a seleção a partir da última linha escolhida.

Uma barra aparece na parte inferior mostrando quantas você selecionou, além de Alterar data e Excluir. Se a tabela tiver uma coluna de data, escolher uma data move todas as linhas selecionadas para ela. Excluir pede confirmação uma vez e é tudo ou nada — se ao menos uma linha já estiver assinada, nada é excluído e você é informado sobre qual linha bloqueou. Um lote nunca tem sucesso parcial.

Três bloqueios que o Notion não tem

Abra o botão "Permissões" (cadeado) acima da tabela. Nenhum dos três se aplica a gerentes, e uma tabela que você nunca configurou se comporta exatamente como antes. Cada um é aplicado no servidor, não apenas oculto na interface — chamar a API diretamente não os contorna.

• Apenas gerentes alteram colunas e visualizações — editores nem veem os botões de adicionar coluna ou visualização. Ninguém exclui uma coluna que outra pessoa criou.
• Ver apenas suas próprias linhas — para formulários de inscrição e caixas de relatórios onde as submissões devem permanecer privadas. Linhas de outras pessoas nunca aparecem na lista.
• Colunas exclusivas para gerentes — bloqueie apenas o sinal de aprovação ou a pontuação final. Colunas bloqueadas mostram um cadeado no cabeçalho e não podem ser editadas.

Diálogo de permissões da tabela: bloqueio de esquema, apenas próprias linhas e colunas exclusivas para gerentes.

Notificações — avise as pessoas certas (o Notion não consegue)

O botão "Notificações" em formato de sino acima da tabela contém as regras. Quando uma linha é adicionada, alterada ou excluída, as pessoas que você indicou são notificadas. No Notion, cada pessoa precisa ativar o acompanhamento por conta própria, o que significa que o responsável pelo trabalho precisa lembrar de abrir aquela tabela primeiro — nada bom para formulários de inscrição, caixas de relatórios ou registros de incidentes onde o responsável é fixo.

• Quem — qualquer membro do espaço de trabalho, quantos quiser.
• Quando — linha adicionada, linha alterada, linha excluída.
• Somente quando — escolha uma coluna e uma condição: status igual a urgente, título contém indisponibilidade, responsável alterado.

As pessoas desativam notificações quando tudo as notifica, por isso o filtro acompanha o recurso. Suas próprias edições nunca notificam você, e corresponder a várias regras ainda envia uma única notificação. Apenas gerentes podem alterar as regras.

Regras de notificação da tabela: quem notificar, quando e o filtro opcional.

Trabalhando juntos

• Atualizações ao vivo — quando duas pessoas têm a mesma tabela aberta, a edição de uma aparece na tela da outra sem refresh. O mesmo vale para novas linhas, linhas excluídas e novas colunas.
• Edições simultâneas são seguras — uma pessoa alterando o responsável enquanto outra altera o status mantém ambas as alterações.
• Notificações de atribuição — preencher uma coluna de pessoa notifica aquele membro.

Outras formas de trabalhar com uma tabela

• Reordene colunas arrastando um cabeçalho ou pelo menu do cabeçalho. A coluna de título também se move.
• Colete por formulário — aponte um FORMULÁRIO para esta tabela e submissões externas chegam como linhas.
• Peça a um agente — "adicione uma linha", "mova para concluído" (capítulo ①).
• Exportar para .xlsx.

⑥Permissões · compartilhamento · publicação pública

Decida facilmente, no nível da pasta, quem pode ver o quê — e, se precisar, publique um documento específico na internet.

Quando você usa em equipe, o mais importante é "quem pode ver o quanto." O Rootr lida com isso de forma muito simples.

Papéis (níveis de permissão)

• Proprietário: gerencia tudo no espaço de trabalho. Administrador: gerencia membros e configurações. Membro: cria e edita documentos. Visualizador: só pode visualizar.
• As permissões são herdadas automaticamente de uma pasta para os documentos dentro dela. Em outras palavras, defina as permissões uma vez em uma pasta e elas se aplicam a tudo dentro dela. Você também pode abrir uma exceção para um documento específico e defini-lo separadamente.

Privado · compartilhado · público

• Nós privados: ative o interruptor "Apenas pessoas convidadas" e você pode ocultar um documento/pasta que criou para que apenas você (e as pessoas que convidou) possam vê-lo.
• Convite por link de compartilhamento: envie um link para convidar pessoas de fora do espaço de trabalho.
• Publicação pública: você pode tornar um documento específico visível para qualquer pessoa em um endereço da internet (/p/document-name). Pessoas de fora podem propor edições em um documento público ("que tal mudar assim?"), e o proprietário pode aceitar (mesclar) ou rejeitar essas propostas — como colaboração em documentos (Git).

A janela de compartilhamento, o interruptor privado "Apenas pessoas convidadas" e a tela de publicação pública.

Não apenas documentos — publique qualquer coisa

Tabelas, planilhas, quadros brancos, formulários, rastreadores de tarefas, registros, CRM e gravações também podem ficar públicos (apenas pastas não podem). Publique uma tabela e visitantes podem pesquisá-la e pressionar "clonar" para levá-la ao próprio espaço de trabalho — como uma tabela real, com colunas, visualizações (kanban incluído) e linhas intactas.

Você escolhe se subpáginas vão junto. Ative e tudo abaixo — incluindo sub-subpáginas — ganha sua própria URL e é listado na página pai. Desative e apenas as páginas que saíram por causa dela são fechadas; qualquer coisa que você publicou separadamente permanece. Fechar a página pai, mover uma subpágina para fora ou excluir a página pai fazem o mesmo. Mover algo PARA DENTRO de uma página publicada não a publica.

Algumas coisas nunca saem: colunas de pessoa, anexo e relação de uma tabela, os documentos anexados às suas linhas, respostas de formulários, áudio de gravações, contatos e valores de negócio do CRM e nomes de signatários em um documento assinado. Após 500 linhas, a página mostra o que consegue e informa quantos de quantos.

Uma tabela publicada não precisa parecer uma tabela — nove formas de exibi-la

Publique uma tabela e você escolhe como ela é exibida. Os dados não mudam; apenas a apresentação difere. Tabela (todas as colunas como estão) · Cartões (uma grade para leitura rápida) · Galeria (blocos grandes — cor substitui quando não há foto) · Lista (lê como artigos: título grande, resumo de uma linha) · Quadro (kanban por status) · Linha do tempo (uma sequência vertical em ordem de data) · Calendário (uma grade mensal) · Resumo (barras de contagem mais soma, média e máximo) · Ranking (maiores números primeiro).

Cada visualização precisa de uma coluna específica — calendário e linha do tempo precisam de data, quadro precisa de seleção/status, ranking precisa de número. Em uma tabela sem ela, a opção fica esmaecida e explica o motivo. Você nunca escolhe uma visualização e cai em uma página vazia.

Há também seis estilos — Limpo, Papel, Escuro, Vívido, Bento, Brutal. Fundo, cartões, cantos e tipografia mudam juntos, então a mesma tabela vira uma página completamente diferente. Layout e estilo são armazenados separadamente, então mudar a cor não altera o layout. Você escolhe ambos em Compartilhar → Publicar na web.

Publicar na web — o que você pode configurar

Compartilhar → Publicar na web dá ao documento um endereço estável. A página pública serve o conteúdo do momento em que você publicou — edições posteriores permanecem privadas até você pressionar "Republicar", então você pode continuar refinando um rascunho sem vazamentos.

Configuração	O que controla
Permitir duplicação	Se visitantes podem copiar a página para o próprio espaço de trabalho. Desative para orçamentos e contratos em rascunho
Permitir comentários	Se visitantes podem comentar. Desativado por padrão
Permitir propostas de alteração	Se pessoas de fora podem propor edições (exige login)
Bloqueio por senha	Apenas quem sabe o link e a senha pode ler. Plano Team e acima
Expiração do link	A página se fecha sozinha após o período
Ocultar de mecanismos de busca	Remove a página dos resultados de busca. Plano Team e acima
Design (skin)	Dezesseis skins — clássico, revista, e-book … além de capa, sumário, largura do corpo e modo paginado

Definir uma senha desativa automaticamente a exposição em buscas, e ela não pode ser reativada enquanto a página permanecer bloqueada: uma tela de bloqueio nos resultados de busca ainda revela que o documento existe, título e tudo. Remova a senha e a escolha é sua novamente.

Uma página bloqueada nunca envia seu corpo ao navegador — ocultá-la na interface vazaria tudo para qualquer um que chamasse o endereço diretamente. Altere a senha e qualquer pessoa já dentro é bloqueada novamente.

As configurações públicas: bloqueio por senha, permitir duplicação, permitir comentários.

Propostas de alteração — colaboração estilo Git para documentos

Com propostas permitidas, a página pública ganha uma ação "Propor uma alteração". Uma pessoa de fora edita e envia; o proprietário recebe uma notificação e a revisa em "Revisar N propostas" na janela de compartilhamento, depois mescla ou rejeita (motivos de rejeição chegam ao autor).

Mesclar combina, não sobrescreve. O Rootr usa a versão que o proponente estava vendo como base e aplica apenas as alterações dele sobre o documento atual, então qualquer coisa que o proprietário mudou enquanto isso sobrevive. Somente quando ambos os lados tocaram as mesmas linhas ele para e diz "N conflitos" primeiro.

A tela de revisão de propostas, mostrando o que muda com ações de mesclar e rejeitar.

IA e dados

⑦O grafo de conhecimento e perguntar à IA (RCA)

Apenas salvando documentos, informações dispersas se tornam um "grafo de conhecimento" conectado, e quando você pergunta "por quê?" sobre ele, obtém uma resposta respaldada por evidências.

O que é um grafo de conhecimento?

Quando você salva um documento, o Rootr extrai automaticamente as "coisas importantes" e "relacionamentos" dentro dele em segundo plano. Por exemplo, ele encontra pessoas, equipes, serviços, sistemas, incidentes e decisões, e cria conexões como "este incidente aconteceu naquele serviço." Um mapa conectado dessa forma, com pontos (coisas) e linhas (relacionamentos), é chamado de "grafo de conhecimento" ou, em termos simples, "mapa de conhecimento." Vários documentos dispersos se tornam uma imagem conectada.

Coisas mencionadas em documentos diferentes são conectadas em um único mapa de conhecimento — então você pode rastrear em torno de "falha de pagamento" para encontrar a causa.

• Mini-map: abra um único documento e você pode ver imediatamente, como um pequeno mapa, as coisas que esse documento menciona.
• Explorando o mapa completo: na tela de grafo, você pode pesquisar por uma coisa específica, ver o que está conectado ao redor dela e seguir os caminhos que existem entre duas coisas.

A tela de exploração do grafo de conhecimento. As coisas são conectadas como pontos e os relacionamentos como linhas.

Ask — perguntando "por quê?" (análise de causa raiz)

Quando você faz uma pergunta ao recurso Ask em linguagem cotidiana (por exemplo, "por que o pagamento continua falhando desde a semana passada?"), o Rootr pesquisa tanto o grafo de conhecimento quanto seus documentos e fornece uma resposta com as evidências anexadas (qual frase de qual documento ela veio). Ele é especialmente forte em análise de causa raiz (RCA) — rastreando "qual é a causa". Você pode fazer a mesma pergunta pela CLI ou API ask que aprendeu anteriormente.

O painel Ask mostrando uma resposta a uma pergunta em linguagem natural com evidências (fontes) anexadas.

⑧Registros de dados e linhagem (LOG)

Acumule registros de números e eventos, e "de onde veio esse resultado" é conectado automaticamente, como uma imagem.

O que é um LOG (diário de dados)?

Um LOG é uma tabela especial que mantém registros acumulados ao longo do tempo. O que o diferencia de uma tabela comum é que você define "o formato de cada coluna" antes de inserir qualquer coisa — esta coluna é texto, esta é um número, esta é uma severidade (info/aviso/erro), esta é um carimbo de data/hora, e assim por diante. Ele então filtra valores estranhos que chegam e sinaliza automaticamente valores que diferem muito do normal (outliers). É ótimo para registrar coisas como tempos de resposta de servidores, eventos de incidentes ou contagens de processamento de tarefas.

O que é "linhagem"?

Linhagem (linhagem de dados) é a conexão de "de onde vieram esses dados e o que veio deles aqui". Imagine uma árvore genealógica e fica fácil. Quando você usa uma coluna de formato "relação" em um LOG, um registro aponta para outro e, no momento em que isso acontece, uma linha de linhagem é desenhada automaticamente entre os dois. Assim, você pode rastrear depois, como uma imagem, "qual evento anterior foi a causa deste incidente?"

Vincule registros com uma coluna "relação" e a linhagem é executada automaticamente do evento causador até o resultado final.

• Como inserir dados: suporta entrada na tela, upload de arquivo (CSV/Excel) e até envio em tempo real a partir de um programa ou sensor.
• Conexão automática: coloque um valor em uma coluna de relação e uma linha de linhagem aparece sozinha. Não há nada para gerenciar separadamente.
• Estatísticas: você pode ver resumos como contagem, média e máximo, por tempo e por item.

Um grafo de linhagem de dados criado pelas colunas de relação de um LOG. As setas vão de um registro para outro.

Automação e administração

⑨Automação (notificações de alteração · CLI · issues)

Você pode fazer a próxima tarefa avançar automaticamente sempre que algo mudar.

O que é um webhook (notificação de alteração)?

Um webhook é um recurso que "informa automaticamente outro programa que você designou sempre que algo acontece no Rootr". Por exemplo, "quando um documento nesta pasta mudar, envie uma notificação para o nosso chat da equipe". Ele permite que as coisas reajam a mudanças sem que uma pessoa fique monitorando constantemente.

• Restringindo o escopo: em vez do workspace inteiro, você pode limitar a uma pasta ou documento específico, ou filtrar por tag (etiqueta) para ser notificado apenas sobre o que deseja (as tags de uma pasta pai também se aplicam dentro dela).
• O que mudou: é categorizado como documento / comentário / sistema, e envia apenas "a parte que mudou (o diff)" em vez do conteúdo inteiro, o que é mais seguro.
• Chave de assinatura: uma chave que verifica se a notificação realmente veio do Rootr é emitida uma vez, no momento da criação. Armazene-a no seu servidor receptor.

O rastreador de issues também atualiza a tela em tempo real (SSE) e pode se conectar a sistemas externos em ambas as direções. Se você configurar as conexões CLI/IA que aprendeu anteriormente para serem executadas automaticamente em horários definidos, poderá criar fluxos automáticos também, como "quando um documento mudar → o aplicativo de IA anexa um resumo".

A tela de criação de webhook (notificação de alteração). Você escolhe o escopo, o filtro de tags e os eventos a enviar.

⑩Conta · workspaces · planos

Alterne entre várias contas, aumente seu plano para corresponder ao tamanho da sua equipe e traga seu material existente.

• Usando várias contas ao mesmo tempo: como uma conta de empresa e uma conta pessoal, você pode estar conectado a várias contas juntas e alternar entre elas com um clique.
• Planos: uma combinação de número de pessoas (assentos) · espaço de armazenamento · uso de IA. Os recursos de IA podem ser usados até um valor definido de "créditos de grafo" por plano. Verifique os preços exatos e o que está incluído na página de Planos. Você pode começar gratuitamente para até 3 pessoas.
• Importação: você pode trazer documentos que estavam em outro lugar para um workspace. O Notion (um ZIP exportado ou um token de integração) e o Confluence Cloud (endereço do site, e-mail da conta, token da API) são suportados, e a estrutura de pastas, anexos e links entre documentos são todos transferidos. O token é usado para essa importação única e nunca é armazenado.

A tela de configurações para alternância de contas, planos e importação.

⑪Referência (material detalhado para desenvolvedores)

A especificação exata que você precisa para conectar por programa e o guia de erros para consultar quando ficar preso.

Esta é uma coleção de material de referência para pessoas que constroem seus próprios programas. Se você usa apenas o Rootr pela tela, pode pular este capítulo.

• Especificação completa da API REST: um documento listando cada solicitação que você pode fazer em um formato legível por máquina — /api/api-docs-json.
• Esquema GraphQL: a estrutura completa de outra forma de consulta — /api/graphql/sdl.
• Detalhes das 152 ferramentas de IA: o manual (README) para rootr-cli descreve em detalhes o que cada ferramenta faz.

Erros comuns e como corrigi-los

Número	Significado	Faça isto
401 / 403	A chave está ausente ou as permissões são insuficientes	Verifique se a chave da API está correta e se a chave tem a permissão (escopo) necessária ativada
409	A frase para "localizar e substituir" está ausente ou há várias, então é ambígua	Especifique a frase a alterar com mais precisão (de forma única) ou releia o documento e tente novamente
412	O documento mudou enquanto você o lia	Releia o documento para atualizá-lo e tente novamente

Quando uma conexão não funciona, geralmente é resolvida no capítulo ① "Chaves e permissões". Verifique isso primeiro.

Informando o que está quebrado ou incômodo

Se algo estiver quebrado ou atrapalhar, envie de onde você estiver. Não é necessário login nem chave de API — passa mesmo quando sua chave está errada. Nunca conta contra seu limite de uso e não gasta créditos.

# Pela linha de comando

rootr feedback "O botão anexar em um formulário publicado não faz nada" --kind bug --email me@example.com

# De um programa (funciona sem chave)

curl -X POST https://rootr.io/api/v1/feedback -H 'Content-Type: application/json' \

-d '{"body":"O que você estava fazendo e o que aconteceu em vez disso","kind":"BUG"}'

Se você usa o Rootr por meio de um agente de IA, não precisa pedir para ele fazer isso — os agentes conectados já são instruídos a relatar problemas por conta própria, então quando uma ferramenta se comporta de maneira diferente da descrição ou força uma solução alternativa, o agente envia um relatório ele mesmo (rootr_send_feedback). Escolha um tipo — bug, atrito, ideia ou elogio — e relatórios idênticos enviados em 10 minutos são mesclados em um.