A página onde constrói um enriquecimento de ponta a ponta — dados de amostra, esquema, modelos, resultados. No centro está a árvore do esquema: um editor visual com reordenação por arrastar e largar, edição inline, navegação por teclado e modificações assistidas por IA.
A árvore de schemas permite-lhe visualizar e modificar os seus schemas de enriquecimento sem escrever JSON à mão. As propriedades são apresentadas numa árvore interativa agrupada por domínio de especialidade, para que veja de imediato que campos pertencem a cada área especializada. Todas as alterações são registadas num histórico de anular/refazer e guardadas automaticamente após um debounce de 2 segundos.
Propriedades agrupadas por domínio de especialização com secções recolhíveis. Ative/desative o agrupamento.
Com a vista Ordenada desativada, reordene as propriedades dentro de um grupo ou entre grupos arrastando-as — a disposição é guardada no schema. Indicadores visuais de destino mostram onde os itens vão ficar.
Clique em qualquer propriedade para editar o nome, o tipo, a descrição e os exemplos diretamente na árvore.
Setas para navegar e para recolher ou expandir, Enter para editar, Delete para remover, Ctrl+A para selecionar tudo. Anular e refazer são botões da barra de ferramentas, e o histórico mantém-se ao mudar de schema ou ao recarregar a página.
Pesquisa de texto para encontrar campos em schemas grandes: primeiro os nomes das propriedades, recorrendo às descrições e exemplos quando nenhum nome corresponde. As correspondências aninhadas são reveladas apenas com o caminho que conduz até elas.
Pilha de histórico completa para edições manuais. As alterações geradas por IA substituem sem adicionar entradas de anulação.
Os separadores no topo contêm os tipos nomeados do esquema. O botão + cria um Objeto (uma entidade aninhada com as suas próprias propriedades) ou um Enum (uma lista fechada de valores permitidos para a qual pode apontar qualquer propriedade de texto).
A vista DIAGRAM, ao lado de SCHEMA e JSON, desenha o esquema como um diagrama de entidades — entidades nomeadas como cartões com título, objetos aninhados como cartões simples nomeados pela respetiva relação, com referências (1–1) e ligações (1–N) como arestas tracejadas. Acompanha as suas edições em tempo real e, ao clicar num cartão de entidade, este abre na vista SCHEMA.
Cada linha no editor representa uma propriedade do schema com os seus atributos principais visíveis num relance:
As propriedades aninhadas (como city dentro de headquarters) são indentadas para mostrar a hierarquia. O ícone da lupa assinala as chaves de pesquisa — campos usados para identificar a entity.
Um conjunto de valores restringe uma propriedade de texto a uma lista fixa de valores permitidos — um estado, uma nota, um código de classificação. O enriquecimento não pode então devolver nada fora dessa lista, o que evita que o mesmo conceito surja com três grafias diferentes em execuções distintas.
Prima + nos separadores de tipo, escolha Enum e dê-lhe um nome. O novo separador abre a sua lista de membros.
Adicione, mude o nome, reordene ou remova valores. Atribua uma nota a um membro quando o seu significado não for óbvio a partir do nome.
Defina o Tipo de qualquer propriedade de texto para o conjunto de valores (ou para uma matriz do mesmo) a partir do grupo Conjuntos de Valores no menu pendente de tipos.
Volte a definir o Tipo da propriedade para string, ou elimine o conjunto de valores — as propriedades que o utilizam voltam a ser propriedades de texto normais.
Use um conjunto de valores apenas para um vocabulário que consiga listar na íntegra. Se uma entidade real precisar de um valor que omitiu, o modelo é forçado a escolher o valor errado mais próximo em vez de reportar o problema — por isso, um campo aberto (um nome, uma descrição, uma categoria de texto livre) deve permanecer como texto simples. A geração de esquema propõe conjuntos de valores de forma conservadora pela mesma razão, e tudo o que propõe é editável aqui.
Clique na linha de uma propriedade ou prima Enter para mudar para o modo de edição. No modo de edição, pode modificar:
O editor de esquemas suporta um fluxo de trabalho totalmente orientado pelo teclado para uma edição eficiente:
| Atalho | Ação |
|---|---|
| Arrow Up / Down | Navegar entre propriedades (mantenha Shift premido para alargar a seleção) |
| Arrow Left / Right | Recolher ou expandir o objeto selecionado |
| Home / End | Saltar para a primeira ou última propriedade |
| Enter | Alternar o modo de edição na propriedade selecionada |
| Delete / Backspace | Remover propriedade selecionada |
| Ctrl+A / Cmd+A | Selecionar todas as propriedades |
| Escape | Sair do modo de edição ou limpar a seleção |
Reordenar manualmente exige desativar a opção Ordenado. Por predefinição, o editor lista as propriedades por ordem alfabética e o arrastamento está desativado — uma ordem feita à mão que uma definição de visualização pudesse substituir em silêncio não valeria grande coisa. Desmarcar Ordenado passa para a disposição do próprio schema e ativa o arrastamento; uma linha de inserção visual mostra exatamente onde a propriedade vai ficar, e a ordem resultante é guardada com o schema. Pode arrastar dentro de um grupo de especialidade ou entre grupos para alterar a atribuição de domínio.
Quando o agrupamento por expertise domain está ativado, arrastar uma propriedade para um grupo diferente atualiza automaticamente a respetiva atribuição de expertise domain. Isto torna intuitiva a reorganização de schemas grandes — basta arrastar um campo de “Analista Financeiro” para “Especialista Regulatório” e a sua expertise domain é atualizada em conformidade.
Abaixo da árvore de propriedades, o painel de edição por IA permite-lhe modificar o esquema usando linguagem natural. Escreva uma instrução como “adicionar uma referência parent_company” e a IA aplica a alteração preservando a sua estrutura existente.
Após cada geração ou edição, a IA fornece 5 sugestões de melhoria apresentadas como chips clicáveis. Clique numa sugestão para preencher automaticamente o campo de edição e aplicá-la. As sugestões abrangem a completude dos dados, a qualidade, as relações, a internacionalização e melhorias específicas do domínio.
Saiba mais sobre a edição de schemas por IA no guia Geração de Schemas por IA.
Leia o nome de uma propriedade no contexto do respetivo objeto pai: quantas coisas distintas poderia estar a pedir? Exatamente uma é claro. Duas ou mais e a propriedade recebe um emblema ambíguo — âmbar quando as leituras se sobrepõem quase por completo e só diferem em casos-limite, vermelho quando produziriam dados materialmente diferentes. Passe o cursor sobre o emblema para ler as interpretações concorrentes que o nome admite e a descrição reescrita que fixa exatamente uma delas. Um nome a que o elemento pai nada tem para responder também é assinalado: aí a dica lista as leituras consideradas e rejeitadas, e a correção é uma renomeação ou uma remoção — nenhuma descrição consegue dar a uma entidade uma propriedade que ela não tem.
O ícone de escudo na barra de ferramentas analisa as propriedades que ainda não têm anotação e passa a uma reanálise completa assim que tudo estiver anotado. Cada execução é uma pequena chamada de IA faturada.
Num esquema guardado, o emblema sugere uma descrição reescrita, nunca uma renomeação: o esquema está em produção, pelo que fixar o significado na descrição mantém intacto o contrato de dados. Uma descrição que se limita a repetir o nome não acrescenta nada, e a propriedade é avaliada como se não tivesse nenhuma.
Renomear uma propriedade ou editar a respetiva descrição elimina a sua anotação — o veredito baseava-se em ambos. O editor realça estas propriedades e propõe uma nova verificação.
Desative a verificação de um esquema a partir do menu de opções adicionais — os selos e avisos desaparecem, e reativá-la num esquema nunca analisado executa a verificação automaticamente.
A mecânica completa — os dois veredictos, as interpretações por detrás de cada um e porque é que a correção passa por uma renomeação antes de o esquema existir, mas por uma descrição depois de estar ativo — é abordada no guia Verificação de Ambiguidade.
O seletor de esquemas permite-lhe criar, carregar, fixar, duplicar e eliminar esquemas. Os esquemas são guardados por organização e acessíveis a todos os membros da equipa.
As alterações são guardadas automaticamente após uma pausa de 2 segundos, com desduplicação por hash de conteúdo para evitar escritas desnecessárias.
Fixe os esquemas usados com frequência para os manter no topo da lista de seleção.
Crie uma cópia de qualquer schema para experimentar alterações sem afetar o original.
Os esquemas eliminados podem ser restaurados. A eliminação permanente é uma ação separada.