# 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.