Criar um contexto, um workspace e um painel — pela tela ou pelo Captain
Um acervo novo na plataforma (contratos, pedidos, laudos, uma lei) nasce em três passos, todos feitos sem ajuda de desenvolvedor: o contexto de dados (onde os documentos ficam), o workspace (o que a equipe vê e quais contextos ela usa) e o painel (a lista dos registros desse contexto). Este guia mostra os dois caminhos que fazem exatamente a mesma coisa: clicando pelas telas, ou pedindo ao DATTA Captain em português. O resultado é o mesmo — o Captain só chama as mesmas operações que as telas chamam, e nunca executa sem a sua confirmação.
O exemplo usado aqui é o contexto Contratos: documentos de contratos empresariais, cada um pertencendo a um registro Contrato identificado por contratoId, avaliados na triagem com as regras do Código de Processo Civil.
Antes de começar: a âncora dos dados
Todo contexto cujos documentos pertencem a um registro próprio precisa declarar dois campos, e é aqui que a maioria dos problemas nasce:
- Entidade âncora — o nome do registro no grafo, em maiúscula inicial e no singular:
Processo,Contrato,Pedido,Laudo. - Propriedade identificadora — a chave única desse registro:
processoNumero,contratoId,numeroPedido.
É por esse par que a plataforma liga cada trecho de documento ao registro certo. Sem ele, o documento é indexado, aparece na busca e no chat, mas a triagem não encontra texto ("sem texto para avaliar") e o painel não lista nada — sem nenhum erro na tela. Os tipos Processo Judicial, Dossiê Cadastral, Análise de Crédito e Investigação PLD/FT já trazem a âncora padrão; o tipo Custom — o que você usa para qualquer acervo novo — pede que você a declare (os dois campos juntos, ou nenhum).
O prompt de extração de entidades do contexto precisa emitir essa entidade com essa propriedade — um Contrato com contratoId por documento, no exemplo. A plataforma semeia prompts padrão ao criar o contexto; ajuste-os em , seção Prompts e Regras, se o acervo tiver uma entidade própria. Digite a propriedade com cuidado: um erro de grafia (conrtatoNumero em vez de contratoId) tem o mesmo efeito de não declarar nada.
Caminho 1 — pelas telas
Passo 1: o contexto
- Abra e clique em + Novo Contexto.
- Rótulo de exibição: o nome que aparece na plataforma (
Contratos). O nome interno é derivado dele e é o que as integrações usam — deixe como está, salvo motivo forte; ele não muda depois sem mover dados. - Tipo de contexto: escolha a categoria. Para um acervo novo, Custom e informe o subtipo (
Contratos). Para processos judiciais, Processo Judicial. - Identificação dos dados: para Custom, preencha Entidade âncora (
Contrato) e Propriedade identificadora (contratoId) — ver a seção anterior. Para os tipos que já trazem a âncora, confira o padrão preenchido. - Descrição e, se houver, URL de origem (para acervo baixado de um site). A descrição fica gravada no contexto e volta preenchida quando você abrir Editar. Em contexto de Processo Judicial, preencha também a Base do código processual (
cpc,clt,cpp…) — o nome do banco, não o do código: em branco, o "Gerar recurso" usa o Código de Processo Civil; com um banco que não existe no Neo4j, ele sai sem artigos. Nos dois casos a tela avisa ao salvar. - Fontes de dados: deixe sem seleção para a plataforma criar o banco de grafo e o índice de busca do contexto — o aviso amarelo mostra os nomes que serão criados. Selecione fontes existentes só quando o acervo já estiver em algum banco cadastrado.
- Contextos de regra aplicados na triagem: marque os corpora de normas que a triagem deve avaliar sobre esses documentos (
Código de Processo Civil). Sem nenhum, a triagem não avalia regra alguma — e a tela avisa. - Criar Contexto. A confirmação mostra o banco e o índice criados; as seções Schema do Grafo, Embeddings, Bancos de Dados e Prompts e Regras do contexto passam a existir na mesma tela.
Depois de criado, na Matriz de Visibilidade dos Contextos (topo da mesma tela) marque em quais funcionalidades o contexto aparece — Upload PDF é o que faz o contexto aparecer na tela de Upload. Um contexto novo nasce marcado nas funcionalidades gerais e desmarcado no upload quando a instalação restringe o upload a alguns contextos; marque a célula e pronto, não há botão de salvar.
Para conferir: envie um documento pelo Upload, escolhendo o contexto, e depois abra , Schema do Grafo: a entidade âncora tem de aparecer entre os nós. Se não aparecer, o prompt de extração não a está emitindo.
Passo 2: o workspace
- Abra e clique em Novo workspace. Informe o nome (
Contratos) e uma descrição. O workspace nasce vazio. - Aba Funcionalidades: marque o que a equipe vai usar — normalmente Upload de Documentos, Explorar Dados, Regras de Triagem e Triagem em Lote — e clique em Salvar funcionalidades. Com o workspace ativo, o menu lateral mostra essas funcionalidades de trabalho — e, sempre, Chat, Sistema, Painéis, Features, Documentação, DATTA Captain, o perfil e a troca de workspace.
- Aba Contextos de Dados: marque o contexto criado (
Contratos). A tela mostra a que corpora de regra ele está conectado. Salvar contextos. Salvar os contextos não liga painel nenhum: um contexto com âncora oferece o painel de triagem da âncora (Painel de Contratos), e a tela lembra de ligá-lo — na aba Painéis, Vincular existentes, grupo Nativo. Ligue se a equipe vai usar a triagem; o painel declarativo do passo 3 é à parte. - Aba Membros: quem tem acesso, com papel. Um workspace sem membros — ou só com administradores da plataforma — fica visível a todos os que têm permissão de leitura; o primeiro membro que não é administrador o restringe, e a tela avisa antes.
Passo 3: o painel
- Na aba Painéis do workspace, clique em Novo painel, dê o título (
Contratos) e Criar e abrir — o construtor abre com o painel vazio. - No topo do construtor, o seletor de contexto já vem no contexto do workspace quando ele tem um só; se tiver vários, escolha o certo. É esse seletor que decide de qual banco vêm as entidades da lista de origem.
- Adicione elementos pela paleta da esquerda e configure cada um à direita:
- Card de métrica: fonte Neo4j (grafo), origem = a entidade âncora (
Contrato), agregação COUNT — o total de registros. - Filtro: origem
Contrato, campotipoContrato(ou outro campo da entidade) — vira uma lista de valores que filtra a tabela. - Busca: origem
Contrato, campos pesquisadoscontratoId,titulo. - Tabela: origem
Contrato, colunas com os campos que interessam (contratoId,titulo,tipoContrato,dataAssinatura), linhas por página. Os campos oferecidos são os que existem nos registros do contexto — se a lista de campos vier vazia, o contexto ainda não tem registros dessa entidade (nada foi enviado, ou o prompt não a emite).
- Card de métrica: fonte Neo4j (grafo), origem = a entidade âncora (
- Use Pré-visualizar para ver o painel com dados reais: paginação, ordenação por clique no cabeçalho, filtro e busca acontecem no servidor.
- Marque Publicar na galeria e Salvar. O painel passa a aparecer em Painéis (a galeria do workspace) e na aba Painéis do workspace, com as ações Abrir (visualização) e Abrir no construtor (edição).
Se a galeria não mostrar o painel publicado, o administrador desligou a publicação de painéis de canvas nesta instalação — o construtor avisa isso ao lado do toggle. Por padrão ela está ligada.
Caminho 2 — pelo DATTA Captain
Abra (ou o botão do Captain no topo da tela) e descreva o objetivo inteiro em português. Um pedido completo, com os mesmos dados do caminho 1:
Crie o contexto de dados "Contratos" (nome interno Contratos), categoria custom com subtipo "Contratos", ancorado na entidade Contrato pela propriedade contratoId, com CPC como contexto de regras. Depois crie o workspace "Contratos" com esse contexto e as funcionalidades upload e explore, e nele um painel declarativo publicado chamado "Contratos" com uma tabela da entidade Contrato (colunas contratoId, titulo e tipoContrato), fonte neo4j.
O Captain procura no catálogo o que a plataforma sabe fazer, mostra o plano — um passo por operação, marcando os que alteram dados e a permissão exigida — e espera Confirmar e executar. Ele mostra também uma prévia da tela do painel antes de criar.
O que ajuda o Captain a acertar de primeira:
- Cite os contextos de regra pelo nome interno (
CPC) ou pelo rótulo exato; os dois são aceitos. - Diga a entidade âncora e a propriedade — sem elas o contexto custom nasce sem âncora, como na tela.
- Para painel de registros de um contexto, diga fonte neo4j (o grafo do contexto). Sem dizer, o Captain pode escolher uma tabela relacional que não existe, e a prévia do painel sai vazia.
- Pedidos longos podem ser divididos: "crie o contexto…", depois "crie o workspace…", depois "crie o painel…". Cada um confirma e executa sozinho.
Quando um passo falha, o Captain diz qual e por quê, e os passos seguintes que dependiam dele não rodam; os que não dependiam podem já ter rodado (um workspace criado antes de o contexto falhar, por exemplo). Confira em e complete ou exclua pela tela.
Para marcar o contexto no Upload PDF e ajustar prompts, use a tela () — são ajustes de um clique.
Checklist final
- Contexto em com banco e índice criados, âncora declarada (para custom) e corpus de regra marcado.
- Contexto marcado em Upload PDF na matriz de visibilidade.
- Workspace com funcionalidades, o contexto e (se for o caso) os membros.
- Painel publicado, aparecendo em Painéis com os registros.
- Depois do primeiro upload: entidade âncora visível no Schema do Grafo e a triagem do registro com texto avaliado (não "sem texto").