Implantação → IA Base de conhecimento e telas de configuração Guia de onde cada parte do “cérebro” de um Agente de IA é puxada e em qual tela se configura. Cada item segue o formato  Finalidade → Fonte da Verdade → Tela(s) para configurar . O system prompt do agente é montado em blocos. Alguns blocos são fixos (vêm do código, iguais para todo inquilino) e outros são configuráveis pelo inquilino. As Capacidades são as “ferramentas” que o agente usa para consultar ou alterar dados em tempo real. Referências de código: app/IA/Services/CompositorSystemPrompt.php (composição do prompt) e app/IA/Capacidades/ (catálogo de capacidades). Parte 1 — Blocos de contexto Blocos que formam a “cabeça” do agente. Papel e objetivo (quem o agente é) Finalidade Define a função base do agente (ex.: SDR imobiliário de pré-venda). Fonte da Verdade Código do Dommus (Modelo de Agente). Não é editável por inquilino. Tela para configurar Nenhuma — apenas a escolha do Modelo na aba Agentes IA do Conecta. Personalidade e tom de voz Finalidade Jeito de falar, estilo e tom do agente. Fonte da Verdade Campo personalidade do Agente. Tela para configurar Aba Agentes IA do Conecta (campo Personalidade). Identidade da empresa (nome e descrição) Finalidade Informa ao agente o nome da empresa e um resumo sobre ela. Fonte da Verdade Campos nome_empresa e descricao_empresa do Agente. Tela para configurar Aba Agentes IA do Conecta. Políticas da empresa Finalidade Regras e procedimentos próprios do inquilino que complementam o comportamento do agente, sem furar os guardrails do sistema. Fonte da Verdade Campo politicas_empresa do Agente. Tela para configurar Aba Agentes IA do Conecta. Dá para colocar guards aqui? Sim, mas só para endurecer a conduta. O texto do inquilino pode acrescentar exigências, proibir comportamentos, restringir ainda mais e detalhar procedimentos (ex.: “nunca prometa desconto”, “só agende visita de segunda a sexta”). O que ele não consegue é afrouxar, substituir ou criar exceção aos guardrails do sistema, nem ampliar o escopo — o compositor subordina o texto das políticas a esses blocos e manda tratar qualquer trecho conflitante como inexistente. IMPORTANTE: Políticas é instrução que orienta o modelo, não é trava técnica. É forte, mas segue no mesmo nível em que a IA obedece a qualquer instrução. Para impedir de fato que o agente faça algo, a via garantida é não ativar a capacidade correspondente: sem a ferramenta, ele não tem como executar a ação, independentemente do que o texto diga. Use políticas para reforçar conduta; use a (des)ativação de capacidades para travar o que ele pode ou não fazer. Fluxo de atendimento (roteiro/etapas) Finalidade Sequência de etapas que o agente segue (cumprimentar → identificar motivo → qualificar → encaminhar etc.). É conduta, não dá permissão nova. Fonte da Verdade Etapas de fluxo configuradas para o Agente. Se nenhuma for configurada, usa o fluxo padrão do Modelo (código). Tela para configurar Aba Agentes IA do Conecta (configuração de fluxo/etapas do agente). Bases de conhecimento (documentos próprios) Finalidade Documentos da empresa que o agente consulta via busca em arquivos ( file_search ) — ex.: manuais, tabelas, FAQs. Fonte da Verdade Bases de Conhecimento cadastradas no Conecta, vinculadas ao Agente, mais o Vector Store da OpenAI (os arquivos em si ficam indexados lá). Só entram as bases ativas, vinculadas e com Vector Store válido. Tela para configurar Aba de Bases de Conhecimento do Conecta + vínculo da base ao agente na aba Agentes IA . Guardrails, escopo, formatação WhatsApp, limite de ferramentas e confidencialidade Finalidade Regras de segurança invariáveis: o que pode e não pode, assunto permitido, formatação, teto de chamadas de ferramenta e sigilo de instruções internas. Fonte da Verdade Código do Dommus. Não editável por inquilino (o limite de ciclos de ferramenta é configuração de sistema). Tela para configurar Nenhuma. Contexto do atendimento atual Finalidade Dados do atendimento em curso: nome do contato, oportunidade, processo, empreendimento, meio de comunicação, atendente, tipo/situação, etiquetas etc. Fonte da Verdade Banco do próprio Conecta (o atendimento que está acontecendo). Tela para configurar Nenhuma — é preenchido automaticamente em tempo real.   Quais capacidades estão ativas Finalidade Liga/desliga as ferramentas que o agente pode usar. Fonte da Verdade Capacidades vinculadas ao Agente (a memória persistente é exceção: liga por flag do agente). Tela para configurar Aba Agentes IA do Conecta (seleção de capacidades) + flag de memória persistente no próprio agente.   Parte 2 — Capacidades Ferramentas que consultam ou alteram dados ao vivo. A fonte muda conforme o módulo do ecossistema Dommus que a capacidade consulta. Empreendimentos, unidades e produtos imobiliários Capacidade Consulta de Produtos / Empreendimentos. Finalidade Buscar empreendimentos, unidades, tipologias, preços, áreas, recursos e atrativos. Fonte da Verdade Dommus Vende (Gestão de Empreendimentos) e Portal do Corretor do Dommus Prospecta (CRM) . Tela para configurar Gestão de Empreendimentos no Dommus Vende e Portal do Corretor no Dommus Prospecta (dados de oferta) + ativar a capacidade na aba Agentes IA. Imóveis avulsos Capacidade Consulta de Imóveis Avulsos. Finalidade Buscar imóveis avulsos cadastrados. Fonte da Verdade Dommus Vende . Tela para configurar Cadastro de imóveis avulsos no Dommus Vende + ativar a capacidade.   Oportunidade / Lead / CRM Escopo Qualificação, visitas, etapas, questionários, PDV, desistência, comentários e histórico. Capacidades Qualificar, Consultar Contexto/Histórico/Atendimentos e Visitas, Agendar Visita, Movimentar Etapa, Preencher Questionário, Registrar Comentário, Registrar Desistência, Enviar ao PDV, Atualizar Empreendimento da Oportunidade, Enviar Lead ao Prospecta. Finalidade Ler e atualizar a oportunidade do cliente no CRM e agendar/consultar visitas. Fonte da Verdade Dommus Prospecta (CRM) . Na maioria exige que o atendimento já tenha uma oportunidade vinculada ; para agendar visita, é necessário corretor/corretora atribuído. Tela para configurar Dommus Prospecta (oportunidades, funil, questionários, agenda de visitas, corretores) + ativar as capacidades.   Identificação de unidade (pós-venda) Capacidade Identificar Unidade. Finalidade Identificar a unidade/condomínio do cliente por CPF/CNPJ e validar com código de verificação antes de liberar serviços. Fonte da Verdade Processos no Dommus Vende (por CPF); o código de verificação vai ao contato cadastrado do cliente. A sessão de identificação fica no próprio Conecta. Tela para configurar Cadastro de clientes/contatos e processos no Dommus Vende + ativar a capacidade.   Chamados / Pós-venda Capacidade Meus Chamados. Finalidade Consultar, detalhar e abrir chamados de unidade/condomínio. Fonte da Verdade Dommus Desk (Atende) . Exige vínculo autorizado de unidade/condomínio no atendimento (depende da Identificação de Unidade). Tela para configurar Dommus Desk (chamados e motivos ofertáveis) + ativar a capacidade.   Etiquetas, anotações, edição e finalização do atendimento, handoff humano, blacklist e mídia WhatsApp Capacidades Alterar Etiquetas, Inserir Anotação, Editar Atendimento, Finalizar Atendimento, Handoff Atendimento Humano, Gerenciar Blacklist, Enviar Mídia WhatsApp. Finalidade Operações sobre o próprio atendimento no Conecta. Fonte da Verdade Banco do próprio Conecta (etiquetas, tipos e situações de atendimento, filas, blacklist). Tela para configurar Configurações do próprio Conecta (etiquetas — também chamadas Tags de Atendimento —, tipos/situações de atendimento) + ativar as capacidades.   Memória persistente Capacidade Memória Persistente. Finalidade Lembrar preferências do contato entre atendimentos. Fonte da Verdade Memória por contato armazenada no Conecta . Tela para configurar Flag de memória persistente do agente na aba Agentes IA (só funciona em Modelos que suportam memória).   Resumo rápido Conteúdo Base de conhecimento Onde configurar Papel/objetivo, guardrails, escopo, formatação Código do Dommus (Modelo de Agente) Não editável; só escolher o Modelo Personalidade, nome/descrição da empresa, políticas Campos do Agente Aba Agentes IA (Conecta) Fluxo/etapas Etapas do Agente (ou padrão do Modelo) Aba Agentes IA (Conecta) Bases de conhecimento Bases do Conecta + Vector Store OpenAI Bases de Conhecimento + vínculo na aba Agentes IA Contexto do atendimento Banco do Conecta (atendimento ao vivo) Automático Empreendimentos, unidades, produtos, imóveis avulsos Dommus Vende Gestão de Empreendimentos (Vende) Oportunidade, qualificação, visitas, PDV, questionários Dommus Prospecta (CRM) Prospecta Identificação de unidade (CPF/CNPJ) Dommus Vende (processos) + contato do cliente Vende Chamados pós-venda Dommus Desk (Atende) Desk Etiquetas, anotações, edição/finalização, blacklist Conecta Configurações do Conecta Memória persistente Conecta (memória por contato) Flag no agente (aba Agentes IA) OBSERVAÇÃO SOBRE NOMES DE TELA: Os rótulos de telas/menus em Vende, Prospecta e Atende foram inferidos pelos módulos de destino das integrações no código (ClienteDommusService → Vende/DV_API, ClienteLeadsService → Prospecta/DP_API, ClienteAtendeService → Desk/DA_API). Confirmar o rótulo exato de cada tela com quem opera esses produtos.