Início Rápido do Construtor de IA
O Construtor de IA é a capacidade de construção assistida por IA oferecida pelo NocoBase — você descreve a necessidade do negócio em linguagem natural e um AI Agent monta o sistema para você. Ele cobre a cadeia inteira, da modelagem de dados, montagem de interfaces, orquestração de workflows e configuração de permissões até a entrada em produção.
Quando o assunto é como a interface é construída, há duas formas:
- IA + construção com Portal no-code — A IA monta a sua interface a partir das capacidades de configuração no-code do NocoBase, produzindo configuração armazenada no banco de dados. Serve para CRUD padrão e backoffices internos, e pessoas de negócio conseguem continuar ajustando pela própria interface depois
- Construção com AI Portal — O NocoBase fornece a base (dados, autenticação, permissões e mais) enquanto o AI Agent escreve código localmente, com um resultado que você pode comitar direto no Git. Depois de compilar e fazer o deploy, ele fica acessível pelo AI Portal. Serve para interações customizadas, sistemas de negócio complexos e casos com requisitos visuais específicos
De um jeito ou de outro, tabelas, permissões e workflows passam pelo mesmo conjunto de Skills — enquanto o AI Agent escreve as páginas, ele também cria as suas tabelas e configura as permissões pelo caminho, montando um sistema de negócio completo, passo a passo, pela conversa.
Como escolher entre as duas formas
Cada uma dessas duas formas corresponde a uma entrada de acesso. Uma aplicação NocoBase pode ter várias entradas compartilhando os mesmos dados, e o caminho de acesso indica qual é qual:
As diferenças:
Um Portal no-code já basta nestes casos:
- A estrutura da página é bem padrão — uma tabela comum mais um formulário, em que configurar é mais rápido do que escrever código
- Pessoas de negócio que não escrevem código precisam ajustar as páginas por conta própria
- Você só quer as capacidades de bloco nativas do NocoBase, como dashboards, visão de calendário e visão kanban
- Você está construindo sozinho, ou não precisa de várias pessoas construindo juntas
Para todo o resto, recomendamos construir com o AI Portal. Na construção com Portal no-code, a IA tem contexto demais para aprender — tipos de bloco, estruturas de configuração, regras de interação — e, para sistemas de negócio que exigem uma construção complexa, eficiência, manutenibilidade e colaboração em equipe ficam todas aquém.
Então adotamos outra abordagem: escrever código de frontend é o que a IA faz de melhor, então deixe que ela faça o que faz de melhor. O NocoBase atua como base do núcleo do sistema e o frontend fica por conta da IA. Os mesmos requisitos, mais rápido e melhor. A IA constrói com liberdade. O NocoBase garante a confiabilidade.
Os dois modos também podem ser combinados: configure rapidamente o backoffice interno com um Portal no-code e refine o portal voltado ao cliente com um AI Portal — os dois na mesma aplicação, compartilhando um único conjunto de dados e usuários.
Início rápido
Para experimentar a construção com AI Portal, instale a versão alpha do NocoBase CLI (npm install -g @nocobase/cli@alpha).
Se você já instalou o NocoBase CLI, pode pular esta etapa.
Instalação assistida por IA com um clique
Copie o prompt abaixo para o seu assistente de IA (Claude Code, Codex, Cursor, Trae etc.) e ele fará a instalação e a configuração automaticamente:
Instalação manual
O navegador abrirá automaticamente uma página de configuração visual, que vai guiar você na instalação dos NocoBase Skills, na configuração do banco de dados e na inicialização da aplicação. Para passos detalhados, consulte Início Rápido.
Substitua a configuração manual por uma conversa
Após instalar o NocoBase CLI, você pode operar o NocoBase diretamente no seu assistente de IA usando linguagem natural. Os exemplos abaixo são cenários reais — desde criar uma única tabela até montar um sistema completo. Veja como o Construtor de IA funciona na prática.
Descreva a necessidade do negócio e a IA projeta tabelas e relacionamentos
Diga à IA o tipo de sistema que você quer e ela cuida automaticamente do desenho das tabelas, dos tipos de campos e das relações — você não precisa desenhar um diagrama ER.
A IA gera automaticamente as tabelas de clientes, contatos, oportunidades, pedidos e seus relacionamentos:
Para saber mais sobre modelagem de dados, consulte Modelagem de Dados.
Construa um marco e a IA salva uma versão restaurável para você
Depois de concluir uma página, um conjunto de tabelas de dados ou um fluxo de trabalho, deixe a IA salvar o estado atual como versão — se uma configuração der errado, você sempre pode voltar ao último marco claro.
A IA não salva uma versão a cada alteração de campo; ela só salva após concluir e verificar um marco claro, o que mantém a lista de versões legível e facilita decidir para onde voltar.
Para saber mais sobre o controle de versão, consulte Controle de Versão.
Orquestre workflows automatizados com uma frase
Descreva a condição de disparo e a lógica de processamento e a IA cria o trigger e a cadeia de nós automaticamente.
Para saber mais sobre workflows, consulte Gerenciamento de Workflow.
Descreva a página em linguagem de negócio e a IA monta para você
O NocoBase oferece por padrão um AI Portal e um Portal no-code. Você não precisa aprender regras de configuração. Diga apenas que tipo de página quer — caixa de pesquisa, tabela, filtros — e ela aparece.
Para construir por um Portal no-code (o Portal padrão se chama admin):
Para construir por um AI Portal (o Portal padrão se chama main):
Para saber mais sobre configuração de interface, consulte Configuração de Interface ou Construção com AI Portal.
Segurança e auditoria
Antes de deixar um AI Agent operar o NocoBase, recomendamos que você entenda primeiro os métodos de autenticação, o controle de permissões e a auditoria de operações — para garantir que a IA faça apenas o que deve e que cada passo fique registrado. Consulte Segurança e Auditoria.
NocoBase Skills
NocoBase Skills são pacotes de conhecimento de domínio que podem ser instalados em AI Agents, permitindo que a IA entenda o sistema de configuração do NocoBase. O NocoBase oferece vários Skills, cobrindo todo o fluxo de construção:
- Gerenciamento de Ambiente — Verificação de ambiente, instalação, atualização e diagnóstico de falhas
- Modelagem de Dados — Criar e gerenciar tabelas, campos e relacionamentos
- Configuração de Interface — Criar e editar páginas, blocos, popups e interações
- Gerenciamento de Workflow — Criar, editar, ativar e diagnosticar workflows
- Configuração de Permissões — Gerenciar papéis, políticas de permissão, vínculo de usuários e avaliação de risco
- Soluções — Construir sistemas de negócio completos em lote a partir de YAML
- Gerenciamento de Plugins — Visualizar, ativar e desativar plugins
- Gerenciamento de Publicação — Publicação entre ambientes, backup, restauração e migração
- Controle de Versão — Salvar versões restauráveis após marcos concluídos
- Construção com AI Portal - Deixe o AI Agent escrever código em um AI Portal para montar as interfaces do sistema
Durante a inicialização (nb init), o NocoBase CLI instala automaticamente os Skills — você não precisa instalar manualmente.
Links relacionados
- AI Portal — A outra forma de construir, com o AI Agent escrevendo o código de frontend diretamente
- NocoBase CLI — Ferramenta de linha de comando para instalar e gerenciar o NocoBase
- Referência do NocoBase CLI — Descrição completa de todos os parâmetros dos comandos
- Plugin de Desenvolvimento com IA — Desenvolva plugins do NocoBase com auxílio de IA
- Segurança e Auditoria — Métodos de autenticação, controle de permissões e auditoria
- AI Employees — Capacidades de agente do NocoBase, com colaboração e execução de ações na interface de negócio