Painel IA

Acelerador do processo de conhecimentos e experiências.

O Painel de IA é o potencializador do seu assistente de projetos. Ele não é um chatbot conversacional irrestrito, mas uma ferramenta pragmática que analisa as ações que estão sendo realizadas sobre Projetos, Itens, Vínculos ou Vinculações, e sugere o que pode ser criado em seguida para a obtenção dos melhores resultados no processo.

Modos

Racional e Assistido

Usuários experientes podem trabalhar no modo "Racional", fazendo o sistema funcionar apenas com seus próprios conhecimentos e experiências (Inteligência Humana). Ao ligar o modo "Assistido", as abas habilitam o impulsionamento através da Inteligência Artificial, trazendo análises e sugestões dinâmicas e evolutivas às abas onde a base de dados é operada.

• Análise de Contexto Automática: O assistente de IA lê Projetos, Itens, Vínculos e Vinculações existentes e sugere a criação de novos dados técnicos, baseando-se em padrões da construção.
• Geração Hierárquica: O assistente focará em sugerir Elementos inerentes a cada contexto.
• Controle de Aceitação (1-Click): Revise listas de sugestões. Com um clique (✓), é feita a adição do Item ao template.

Os modos Racional e Assistido são selecionados através do seletor na aba Modos.

Opções do Modo Assistido

O sistema permite selecionar individualmente sobre quais tipos de dados (templates) o Modo Assistido atuará (Projetos, Itens, Vínculos e Novo Tipo de Vínculo), através de seleção por checkbox.

Feed de Inteligência Orgânica - OIF

O Motor de Aprendizado Orgânico funciona como uma memória corporativa ou repositório de padrões exclusivo do usuário individual ou grupo/empresa (Tenant), aprendendo com a utilização da plataforma.

Cada adição ou edição em nomes e títulos da base de dados é entendida pelo sistema. Nas próximas requisições similares, o modelo sugerirá conforme os padrões já validados pela equipe técnica.

Inteligência Personalizada

Aprendizado através do histórico de correções feitas pelos usuários da respectiva conta. O aprendizado e retribuição de padrões é restrito apenas à inteligência da própria conta, sem compartilhamento externo de inteligência.

Para reforçar o carater personalizado, o nome de usuário da conta (pessoal ou empresa) pode ser atribuído ao rótulo "Padrão (usuário)" exibido no painel.

1. Para atribuir nome ao rótulo, na aba Modos, no campo de texto "Nome no badge personalizado", insira o nome.

Inteligência Global

OIF Global é o "cérebro compartilhado" da plataforma. Esta camada de inteligência fornece sugestões baseadas em padrões universais da indústria da Construção, ampliando e aprimorando constantemente a base de conhecimentos e experiências técnicas da plataforma, e qualificando resultados para seus usuários.

Ao contrário do OIF Personalizado (que aprende restrito à conta individual), o OIF Global é uma biblioteca de conhecimento técnico pré-curada. Funciona como uma enciclopédia dinâmica que entende como todo o embasamento técnico em projetos é estruturado, em diversas disciplinas.

• Fonte da Verdade: Os dados não são alimentados em tempo real pelas conversas de outros usuários (preservando o sigilo), mas sim por uma base consolidada de metodologias padrão (como guias de órgãos reguladores, padrões ISO e workflows de referência).
• Neutralidade: As sugestões "Global" são técnicas, agnósticas a empresas específicas e focadas em conformidade e boas práticas.
• Aprimoramento e Evolução Coletiva: O OIF Global é como um organismo vivo. Ele não é apenas uma base de dados estática, mas um sistema que amadurece e amplia seu repertório conforme o ecossistema da plataforma cresce.

O "Efeito de Rede"

• Identificação de Tendências: O sistema monitora continuamente quais termos técnicos estão sendo utilizados com sucesso em toda a plataforma, identificando novas terminologias e metodologias que estão se tornando padrão na indústria, mantendo atualização constante.
• Filtragem de Alta Precisão (Code-level): O sistema apenas considera dados dentro de um percentual de aceitação pelo usuário para integrar a base Global. Isso garante que apenas o conhecimento exato seja promovido.
• Promoção ao Global: Uma vez que um novo padrão é validado como "melhor prática comprovada", ele é anonimizado e incorporado à base Global. Assim, a melhoria realizada por um grupo de especialistas contribui para elevar o nível técnico de todos, sem nunca comprometer o sigilo dos dados originais.
• Agregação Estatística: O sistema agrupa esses casos de sucesso, anonimiza a origem e promove os padrões mais frequentes para o nível Global. Esse processo é puramente matemático e algorítmico, eliminando viés humano e garantindo agilidade na atualização da inteligência.

Utilize o OIF Global como base para a estrutura dos projetos e deixe o OIF Personalizado cuidar da diferenciação técnica e dos detalhes exclusivos para o aprimoramento do Empreendimento.

A ativação dos modos Inteligência Personalizada e Inteligência Global é feita através do seletor na aba Modos.

Trabalhando com o Painel IA

Ao selecionar o Modo Assistido, é ativado o botão "Painel AI" em cada aba, permitindo ainda o controle de ativação do Painel AI individualmente por aba.

O Painel IA atua em todas as abas de criação de Projeto, Itens, Vínculos e Vinculações, de maneira uniforme. O Painel IA se estende como uma extensão de cada aba, contendo:

1. Área de "Descrição de Contexto"
2. Botão "Gerar com IA"
3. Lista de resultados com checkboxes individuais para seleções
4. Botão de confirmação "Adicionar"

Ao Adicionar os resultados selecionados, eles são armazenados no respectivo template.

Infraestrutura de Modelos

Chave de API própria

A Infraestrutura Própria de IA permite que administradores substituam o agente padrão da plataforma (Gemini) por suas próprias modelos de agente através de credenciais de API. Ao utilizar este recurso, o consumo de tokens passa a ser contabilizado diretamente por sua provedora escolhida, suspendendo as regras de limite de uso atreladas ao plano da plataforma Checklister.

1. Acessar Configurações. Navegue até a aba Modos (ou Configurações de IA) no painel de controle do seu ambiente.
2. Abrir Seletor de Motor de IA. Localize a seção Infraestrutura de Modelos e clique no interruptor ao lado de "Chave de API própria".
3. Selecionar o Modelo. A interface exibirá duas opções no seletor:
   • Gemini: É o modelo nativo de fábrica. Nenhuma configuração ou chave é necessária.
   • Modelo externo: Permite plugar modelos de agentes de IA externos. O campo de chave será exibido.
4. Inserir Credencial e integrar Modelo Externo. Insira a chave de API (sk-...) no campo de texto. Em seguida, clique em Integrar. A chave recebe criptografia AES-256-GCM antes da gravação no banco de dados.

O sucesso será indicado por uma faixa verde (ex: ✓ Modelo "OpenAI" integrado). O interruptor será sinalizado permanentemente com o título do seu modelo (ex: Modelo OpenAI).

Remoção e Retorno ao Padrão

Para desativar a infraestrutura própria e retornar ao modelo de consumo padrão (via cotas do seu plano atual):

1. Retornar ao seletor abrindo o painel.
2. Clique na aba Gemini.
3. Clique em Confirmar no popover que aparecerá na tela.

A sua chave externa será descartada imediatamente, o painel será fechado e o tráfego retornará de forma transparente à infraestrutura nativa da aplicação.

Integrações Externas MCP

O Modo MCP (Model Context Protocol) é a funcionalidade que permite conectar agentes de inteligência artificial de plataformas e ferramentas de automação diretamente ao sistema CLL. Em vez de copiar e colar informações manualmente entre o painel e uma IA, o MCP cria uma ponte segura e automatizada: a IA acessa os dados do sistema com sua permissão, entende o contexto do seu trabalho e pode executar diversas ações, como criar itens, projetos e vínculos; atualizar anotações ou gerar relatórios.

Checklister como Servidor (Entrada)

Quando o MCP está ativo, o Checklister funciona automaticamente como um servidor. Disponibiliza seus dados e permite que agentes externos realizem ações com segurança.

Para conectar uma IA ao sistema, você precisará de dois dados exibidos nessa seção:

• URL do servidor — o endereço que a IA usará para se conectar. Basta copiar clicando no ícone ao lado do campo.
• Token de acesso — uma senha temporária que identifica você perante o agente externo. Copie também.

Abaixo desses dois campos há um bloco de configuração pronta no formato JSON. Se a ferramenta de IA que você usa aceitar esse formato de configuração, basta copiar e colar diretamente em suas configurações.

Servidores Externos (Saída)

Esta seção é para o caso contrário: quando você quer que o Checklister se conecte a outra ferramenta que também fala MCP, por exemplo, um sistema BIM, um ERP ou qualquer plataforma que disponibilize essa integração.

Para registrar um servidor externo:

1. Clique no botão + no canto superior direito da seção.
2. Preencha o nome que ajudará a identificar o servidor (ex.: "Archicad").
3. Informe a URL do servidor externo. Esse endereço é fornecido pela plataforma que você quer conectar.
4. Se o servidor exigir autenticação, informe o token correspondente (também fornecido pela plataforma parceira).
5. Clique em Registrar.

O servidor aparecerá na lista. O indicador de cor ao lado do nome mostra o status da conexão:

• 🟢 Verde pulsando — conectado e respondendo normalmente.
• 🔴 Vermelho — houve uma falha na tentativa de conexão.
• ⚫ Cinza — ainda não foi testado desde o cadastro.

Para testar a conexão e ver quais recursos o servidor disponibiliza, clique no ícone { } ao lado do servidor. Um painel lateral se abre mostrando as Ações (o que a IA pode fazer naquele sistema) e os Dados (o que ela pode consultar).

Para remover um servidor da lista, clique no ícone de lixeira ao lado dele.

API Keys

As API Keys são credenciais permanentes para agentes que precisam se conectar ao Checklister de forma autônoma e recorrente, por exemplo, um assistente de IA configurado no computador de um colaborador.

Para gerar uma nova API Key:

1. Clique no botão + no canto superior direito da seção.
2. Informe um label para identificar o agente que usará essa chave (ex.: "Agente Revit").
3. Clique em Gerar API Key.

A chave gerada aparecerá em destaque com fundo amarelo. Copie imediatamente; por segurança, ela não será exibida novamente após você fechar ou recarregar a tela.

Para revogar uma API Key:

1. Localize a key na lista e clique no ícone de bloqueio (🚫) ao lado dela. A revogação é imediata: o agente que usava essa chave perde o acesso instantaneamente. Keys revogadas permanecem visíveis na lista para fins de auditoria, mas ficam marcadas em vermelho.

Dicas rápidas