Agentes de Inteligência Artificial

Base de Conhecimento (Conhecimento dos agentes)

Base de Conhecimento (Conhecimento dos agentes) A Base de Conhecimento é o material que seus agentes de IA consultam para responder com informação da sua empresa — e não com o que ele "acha". É onde ficam as perguntas frequentes, as regras da operação e os dados dos imóveis. Para que serve - A IA responde com base no que você gravou, nunca inventando valores ou imóveis fora da base. - Você organiza o conhecimento em bases separadas (ex.: Financiamento, MCMV, Médio padrão) e decide qual agente usa qual. - Perguntas novas e bem respondidas podem virar aprendizados automáticos (veja Memória da IA). Antes de começar - Você é gerente ou administrador no Imobiturbo.OS. - A tela fica no menu lateral: Agentes IA → Conhecimento (ou Conhecimento direto no menu). Passo a passo Parte 1 — Ver as bases da sua conta 1. No menu lateral, abra Conhecimento (na área de IA). 2. Você vê a biblioteca de bases da sua organização: "Perguntas frequentes", "Como vocês trabalham", "Atendimentos anteriores" etc. Bases de Conhecimento da conta Lista de agentes antes de abrir a base Parte 2 — Editar o conteúdo de uma base 1. Clique na base que quiser revisar. 2. Edite as perguntas e respostas, as regras ou os textos de apoio. 3. Salve. O conteúdo passa a valer para os agentes que usam aquela base. Parte 3 — Vincular a base ao agente certo 1. No menu lateral, abra Agentes IA e clique no agente desejado. 2. Na tela do agente, abra a aba Conhecimento. 3. Associe as bases que este agente deve consultar. 4. Salve (ou publique, se o agente estiver em rascunho). ℹ️ 💡 Uma base pode atender vários agentes O vínculo é de muitos-para-muitos: a mesma base (ex.: Perguntas frequentes) pode ser usada por vários agentes, e cada agente pode usar várias bases. Como saber que deu certo - A base aparece vinculada ao agente na aba Conhecimento. - Em um teste na aba Teste do agente, pergunte algo que só a base sabe (ex.: uma regra da sua imobiliária): a resposta deve refletir o conteúdo gravado. Problemas comuns | O que aconteceu | O que fazer | |---|---| | O agente responde de forma genérica | Confirme se a base correta está vinculada ao agente na aba Conhecimento. | | Não vejo uma base | Bases são da conta; confira se você está no perfil de gerente/administrador. | | A resposta não bate com o texto gravado | Revise o texto da base — a IA segue o que está escrito; perguntas ambíguas geram respostas ambíguas. | Próximos passos - Skills da IA - Memória da IA - Configurar e ativar um agente

Configurar e Ativar um Agente de IA

Configurar e Ativar um Agente de IA Configurar um agente de IA no Imobiturbo.OS leva poucos minutos e não requer conhecimentos técnicos. Para que serve Define como a IA deve se comportar na conversa: nome, tom de voz, regras de negócio, instruções do atendimento, o número de WhatsApp em que atua e quando deve passar para um humano. Antes de começar - Você é gerente ou administrador no Imobiturbo.OS. - Já existe um número de WhatsApp conectado (Conectar por QR Code ou API Oficial). Passo a passo Parte 1 — Criar o agente 1. No menu lateral, abra Agentes IA. 2. Clique em + Criar novo agente (ou edite um agente existente). 3. A tela do agente abre na aba Configuração: Configuração de Agente de IA Lista de agentes para iniciar a configuração Parte 2 — Preencher a configuração - Identificação - Nome: como a IA se apresenta (ex.: Sofia — Consultora Imobiliária); - Descrição: uma linha sobre o papel do agente; - Prioridade: usada quando mais de um agente pode assumir. - Número de WhatsApp: selecione a sessão/número em que este agente atende. - Quando este agente responde: condições de acionamento (ex.: em qual situação ele assume a conversa). - Instruções gerais: o que a IA deve e não deve fazer — aqui você pode vincular as Skills da sua organização. - Mensagem de abertura: como o agente começa o atendimento. - Estilo de resposta: tamanho das mensagens, uso de listas, etc. - Handoff humano: ativar a passagem para corretor quando o cliente pedir ou atingir o perfil (veja Handoff humano e retomada). - Casos humanos e Follow-up: opcionais, ligam o agente aos fluxos de Follow-ups. ℹ️ 🔎 Limites técnicos (avançado) As opções de max steps, token budget, custo máximo e janela de histórico controlam recursos da IA. Para a maioria das imobiliárias, os valores padrão funcionam bem — mude apenas se a equipe Imobiturbo orientar. Parte 3 — Publicar e ativar 1. Revise as instruções e a mensagem de abertura. 2. Clique em Publicar (ou Salvar e publicar). Um agente só atende depois de publicado. 3. Confira o estado do agente (veja Estados do agente): ele deve estar Ativo e Publicado. 💡 🆕 Teste antes de ligar no número real Use a aba Teste do agente para conversar com ele antes de liberar no WhatsApp. Assim você ajusta o tom sem atender cliente de verdade. Como saber que deu certo - O agente aparece na lista de Agentes IA com o estado correto. - Uma mensagem enviada para o número conectado recebe a resposta da IA em poucos segundos, identificada com o selo de IA na Inbox. - Na aba Execuções do agente você acompanha cada atendimento e o custo/uso. Problemas comuns | O que aconteceu | O que fazer | |---|---| | O agente não responde | Confira se o número de WhatsApp está conectado e se o agente está publicado e ativo. | | O agente erra o tom | Ajuste as Instruções gerais, use as Skills e teste na aba Teste. | | Não consigo salvar | Verifique se todos os campos obrigatórios estão preenchidos (nome, sessão, instruções). | | O agente não usa o conhecimento | Vincule as bases na aba Conhecimento do agente (veja Base de Conhecimento). | Próximos passos - Base de Conhecimento - Skills da IA - Roteadores de mensagens - Memória da IA

Estados do Agente de IA

Estados do Agente de IA Para dar total controle à equipe sobre quando a inteligência artificial deve interagir com os clientes, cada conversa possui um estado de IA bem definido. Para que serve Permite que a equipe saiba exatamente se um cliente específico está sendo atendido pelo robô ou se a conversa está aguardando uma resposta humana. Estados da IA no Atendimento Na Inbox e no gerenciador de agentes, você encontrará 3 estados principais: Estados de Operação do Agente de IA Lista de agentes e status 1. 🟢 ATIVO (ACTIVE) - O que significa: O agente de IA está monitorando a conversa e responderá automaticamente às mensagens do cliente. - Quando ocorre: Leads novos entrando no funil ou conversas em triagem automática. 2. 🟡 EM ESPERA / DORMÊNCIA (DORMANT) - O que significa: O agente está aguardando o momento correto para interagir (por exemplo, aguardando resposta do cliente a uma pergunta anterior ou aguardando o prazo de follow-up programado). - Quando ocorre: Entre turnos de conversa normais. 3. 🔴 PAUSADO / ATENDIMENTO HUMANO (PAUSED) - O que significa: A IA foi desativada para aquela conversa específica. Nenhuma mensagem automática será disparada até que o corretor decida reativá-la. - Quando ocorre: Sempre que um corretor assume a conversa, quando o cliente solicita falar com um atendente ou quando a triagem foi concluída e o lead avançou para visita. Como alterar o estado de uma conversa manualmente Diretamente na tela da conversa na Inbox, clique no seletor de estado no topo do painel para alternar entre Ativo (IA) e Pausado (Humano).

Evolução da IA — o que seu agente aprendeu

Evolução da IA — o que seu agente aprendeu A tela Evolução da IA responde a pergunta do dono do negócio: "o que meu agente aprendeu no período e isso mudou meu resultado?" — em números simples, não em código. Para que serve - Ver o que o agente aprendeu no período e o que ele fez com isso. - Acompanhar resultados: negócios fechados e perdidos registrados pelo agente. - Medir o volume de atendimento: conversas, passos andados e transbordos para humano. - Enxergar as lacunas — o que ainda está travando o atendimento. ℹ️ 🔎 Como ler os números - Fechados/perdidos: contam só os casos que o agente marcou. Negócio fechado pela sua equipe, movendo o cartão no Kanban manualmente, não entra aqui. - Transbordos: conversas que o agente passou para um humano, a cada 100 mensagens. É uma estimativa de quantas vezes o agente precisou do time. Antes de começar - Você é gestor ou administrador da conta. - O menu é Evolução da IA (área de IA). Passo a passo 1. No menu lateral, abra Evolução da IA. 2. No seletor de período, escolha o intervalo (o padrão é os últimos 30 dias). 3. Leia os blocos na ordem: - O que o agente aprendeu: destaques do aprendizado no período; - O que aconteceu com os negócios: fechados × perdidos; - Volume de atendimento: mensagens, passos andados, transbordos; - O que ainda está travando: as lacunas (gaps) do atendimento. 4. Para saber se melhorou, mude as datas e compare com o período anterior (ex.: último mês). Evolução da IA — aprendizado e resultados Histórico de interações do agente Como saber que deu certo - Você consegue dizer, olhando a tela: "o agente fechou X casos, perdeu Y e passou Z conversas para o time neste mês". - Quando os transbordos caem e os passos andados sobem, o agente está qualificando melhor antes de chamar a equipe. - As lacunas mostram o que ajustar (ex.: um assunto que o agente não sabe). Problemas comuns | O que aconteceu | O que fazer | |---|---| | Tudo zerado no período | "Nada aconteceu" ≠ "foi mal": o número zero pode significar que não houve atendimento. Mude as datas para um período com movimento. | | Os fechados não batem com o Kanban | A Evolução conta apenas o que o agente registrou — os fechados manuais do time ficam de fora. | | Muitos transbordos | Revise as instruções, a Base de Conhecimento e as Skills do agente. | Próximos passos - Memória da IA - Base de Conhecimento - Skills da IA

Handoff Humano e Retomada de Atendimento

Handoff Humano e Retomada de Atendimento O Handoff (transbordo) é a passagem de bastão suave e transparente da Inteligência Artificial para um corretor humano da equipe. Para que serve Garante que as negociações de alto valor recebam o toque humano e o relacionamento de um corretor experiente no momento exato em que o cliente está pronto para negociar ou visitar um imóvel. Como funciona o transbordo automático O transbordo acontece automaticamente quando o lead: 1. Pede explicitamente para falar com uma pessoa ("quero falar com um corretor", "me passa para um atendente"). 2. Demonstra intenção de agendamento de visita ("quero ver o imóvel sábado às 10h"). 3. Apresenta perguntas complexas de documentação ou propostas de negociação fora do escopo da IA. Painel de Handoff e Retomada Transbordo humano na conversa Como o corretor assume a conversa 1. Ao identificar uma notificação de transbordo ou navegar na Inbox na aba Pausados / Humano: 2. Abra a conversa do cliente. 3. Clique no botão Assumir Conversa (ou simplesmente digite uma mensagem e envie no campo de texto). 4. O sistema automaticamente pausa a IA e atribui o atendimento ao corretor logado. Como devolver a conversa para a IA (Retomada) Se o corretor já esclareceu a dúvida pontual e deseja que a IA continue acompanhando o lead: 1. No topo da janela de chat na Inbox, clique no botão Reativar IA. 2. Uma mensagem de confirmação será exibida. 3. O status volta para 🟢 Ativo (IA) e o assistente responderá às próximas mensagens do cliente normalmente.

Memória da IA — regras da operação e aprendizados

Memória da IA — regras da operação e aprendizados A Memória da IA é o "manual de conduta" da sua operação: um documento com as regras gerais que valem para todos os agentes, somado aos aprendizados que a plataforma acumula com o tempo. Para que serve - Regras gerais da casa valem para qualquer atendimento (ex.: "nunca prometa condições sem consultar o corretor", "nunca invente imóveis ou preços", "horário de atendimento é das 9h às 18h"). - Diferente da Base de Conhecimento, que é conteúdo por assunto, a memória vale para a operação inteira — todos os agentes respeitam o mesmo documento. - A plataforma registra versões do documento, então dá para voltar atrás se uma edição der errado. Antes de começar - Você é gerente ou administrador no Imobiturbo.OS. - A tela fica no menu lateral: Memória da IA. Passo a passo Parte 1 — Editar o documento da organização 1. No menu lateral, abra Memória da IA. 2. Edite o texto livremente: escreva as regras da operação em frases claras, como daria instruções a um estagiário novo. 3. Clique em Publicar versão. Memória da IA — documento da organização Histórico usado pela memória da IA ℹ️ 💡 Dicas de redação - Use frases diretas: "Você NUNCA faz X", "quando o cliente pedir Y, avise o corretor". - Faça uma regra por linha/parágrafo. - O que for específico de um assunto vai melhor na Base de Conhecimento; o que é regra da casa vai aqui. Parte 2 — Acompanhar versões e voltar atrás 1. Abra o histórico de versões (cada publicação cria uma nova versão, ex.: v1, v2 — com data). 2. Se uma edição não ficou boa, restaure uma versão anterior: o conteúdo volta para o editor e você confirma com Publicar versão. Parte 3 — Gerenciar aprendizados Os aprendizados são anotações que a plataforma mantém sobre como a operação funciona (ex.: um atendimento exemplar registrado como prática). 1. Na seção de aprendizados, use Adicionar aprendizado (título + texto). 2. Aprenda itens podem ser arquivados quando deixarem de valer. Como saber que deu certo - Ao publicar, aparece a confirmação "Versão vN publicada — já vale para todos os agentes". - Em um teste, pergunte algo coberto por uma regra do documento e confira se o agente obedece. Problemas comuns | O que aconteceu | O que fazer | |---|---| | O agente não respeita uma regra | Revise se a regra está escrita de forma inequívoca no documento e se a versão foi publicada (rascunho não vale). | | A memória parece não estar ativa | Confirme que a versão publicada é a mais recente e que o agente está publicado/ativo. | | Regras conflitantes | Regras específicas (Base de Conhecimento) têm prioridade naquele assunto, mas regras contraditórias confundem a IA — mantenha o documento simples. | Próximos passos - Base de Conhecimento - Skills da IA - Roteadores de mensagens

O que são Agentes de IA

O que são Agentes de IA Os Agentes de Inteligência Artificial do Imobiturbo.OS são assistentes virtuais treinados para conversar diretamente com clientes pelo WhatsApp, qualificando interesses, respondendo dúvidas sobre imóveis e agendando visitas comerciais. Para que serve Garante que 100% dos contatos que chegam na sua imobiliária recebam resposta imediata, a qualquer hora do dia ou da noite, evitando que o lead busque outra opção enquanto espera atendimento. O que o Agente de IA é capaz de fazer - Qualificação Comercial: Pergunta o tipo de imóvel buscado, faixa de valor pretendida, número de quartos e localização de interesse. - Informações do Catálogo: Apresenta dados sobre empreendimentos cadastrados, valores de condomínio/IPTU e diferenciais da região. - Agendamento de Visitas: Coleta a disponibilidade de horário do cliente para visita presencial ou reunião online. - Transbordo para Corretores: Transfere o atendimento para o corretor responsável assim que o cliente atinge o perfil de compra desejado. Visão Geral dos Agentes de IA Lista de agentes disponíveis Segurança e Controle Os agentes de IA do Imobiturbo.OS seguem estritamente as instruções fornecidas no prompt da imobiliária. Eles nunca inventam valores ou imóveis que não estejam cadastrados na sua base de conhecimento. O que alimenta um agente Um agente bem configurado usa quatro fontes de conhecimento, cada uma com um papel: | Fonte | Papel | Tutorial | |---|---|---| | Instruções (prompt) | A personalidade e as regras de comportamento | Configurar e ativar | | Base de Conhecimento | Conteúdo por assunto: FAQs, imóveis, regras | Base de Conhecimento | | Skills | Habilidades ativadas pelo assunto da conversa | Skills da IA | | Memória | Regras gerais da operação, válidas para todos | Memória da IA | E, se a sua operação atende assuntos diferentes no mesmo número, os Roteadores decidem qual agente assume cada conversa.

Roteadores de mensagens (IA)

Roteadores de mensagens (IA) O Roteador é o "porteiro inteligente" do WhatsApp da sua imobiliária: ele lê a primeira mensagem do cliente, entende a intenção (comprar, alugar, anunciar imóvel...) e encaminha a conversa para o agente certo. Para que serve - Cada assunto é atendido por um agente especialista: compra, aluguel, captação (quem quer vender/annunciar), lançamento... - Quem não encaixa em nenhuma rota cai no agente padrão (fallback). - Você define como testar a leitura de intenção com uma mensagem de exemplo. Quando usar - Sua imobiliária atende mais de um tipo de demanda no mesmo número (ex.: venda e locação). - Você quer que cada agente use instruções e base de conhecimento específicas para o assunto. Antes de começar - Você é gerente ou administrador no Imobiturbo.OS. - Os agentes que vão receber as rotas já existem (veja Configurar e ativar um agente). - A tela fica no menu lateral: Roteadores. Passo a passo Parte 1 — Criar o roteador 1. No menu lateral, abra Roteadores. 2. Clique em Criar meu primeiro roteador (ou + Novo). 3. Dê um nome fácil (ex.: Roteador de vendas). 4. Selecione o número de WhatsApp no qual o roteador atua. Criação de roteador Agentes disponíveis para roteamento Parte 2 — Definir as rotas (intenção → agente) Para cada assunto que você quer separar, adicione uma rota: 1. Clique em Adicionar rota. 2. Preencha: - Intenção: o nome do assunto (ex.: Quero comprar um imóvel); - Descrição: quando a mensagem deve ser considerada essa intenção; - Exemplos: frases típicas de clientes (ex.: "tem apartamento de 2 quartos?", "quanto custa um imóvel na Barra?"). Quanto mais exemplos, melhor a leitura; - Agente: qual agente da IA deve atender essa intenção. 3. Repita para as outras intenções (ex.: Quero alugar, Quero anunciar meu imóvel). Parte 3 — Escolher o agente padrão (fallback) 1. Em Agente padrão, selecione o agente que atende quem não encaixou em nenhuma rota. 2. Ative o roteador (chave Ativo). 3. Salve o roteador e as rotas. Parte 4 — Testar 1. Na tela do roteador, use o campo teste de mensagem, digitando algo como "quero alugar um studio". 2. Confira se a conversa de teste foi para o agente da intenção certa. 3. Teste também uma mensagem fora dos exemplos para confirmar o agente padrão. Como saber que deu certo - Um cliente novo manda "quero comprar um apartamento na zona sul" e a conversa é atendida pelo agente de vendas (você vê na Inbox qual agente respondeu). - Mensagens fora dos temas caem no agente padrão sem travar. Problemas comuns | O que aconteceu | O que fazer | |---|---| | A conversa vai para o agente errado | Reforce a descrição e os exemplos da intenção; teste novamente. | | Tudo cai no agente padrão | Confira se o roteador está Ativo e se as rotas têm exemplos suficientes. | | Muitas intenções similares se confundem | Junte intenções parecidas em uma rota só, ou deixe apenas as que realmente importam. | Próximos passos - Configurar e ativar um agente - Base de Conhecimento - Memória da IA

Skills da IA — habilidades especializadas

Skills da IA — habilidades especializadas As Skills são como "manuais de bolso" que o agente de IA consulta só quando o assunto da conversa pede. Em vez de decorar tudo o tempo todo, ele carrega a skill certa no momento certo — como triagem de atendimento, qualificação de comprador ou agendamento de visita. Para que serve - A IA responde melhor em cada assunto sem que você reescreva um prompt gigante. - Cada skill só entra em ação quando o cliente toca no tema: palavras-chave na mensagem ativam a skill. - Você instala prontas do catálogo ou cria as suas (ex.: regras específicas da sua região ou empreendimento). Antes de começar - Você é gerente ou administrador no Imobiturbo.OS. - A tela fica no menu lateral: Skills da IA. Passo a passo Instalar uma skill do catálogo 1. No menu lateral, abra Skills da IA. 2. Na seção Catálogo, veja as skills prontas mantidas pela plataforma. 3. Clique em Instalar na skill desejada. Ela passa a aparecer em Skills instaladas. Skills da IA instaladas e catálogo Agentes que usam as skills Criar ou editar uma skill 1. Em Skills instaladas, clique em Abrir e editar na skill que quiser ajustar. 2. Preencha: - Para que serve: uma linha descrevendo a função — é por aqui que o agente decide se a skill é a certa; - Quando acionar: palavras-chave separadas por vírgula (ex.: financiamento, entrada, parcela). Se alguma aparecer na mensagem, o agente usa estas instruções; - Sinais fracos (opcional): palavras que sugerem o assunto sem cravar — servem para a plataforma descobrir skills que faltam, não acionam sozinhas; - Instruções: o passo a passo que o agente deve seguir neste assunto (até 200 linhas; acima disso, quebre em skills menores). 3. Clique em Salvar. A skill passa a valer para os agentes da sua organização. ℹ️ ✏️ Skill do catálogo editada Ao salvar uma skill do catálogo, ela vira uma cópia da sua organização. O catálogo e as outras organizações não mudam. Enviar uma skill pronta (arquivo .zip) 1. Clique em Enviar skill (.zip) no topo da tela. 2. Selecione o arquivo da skill (formato da plataforma) e confirme o envio. Ela entra na sua lista de Skills instaladas. Desinstalar uma skill 1. Em Skills instaladas, clique em Desinstalar na skill desejada. 2. Confirme a remoção. O agente deixa de usar aquela skill. Como saber que deu certo - A skill aparece em Skills instaladas com a data de atualização. - Durante um atendimento de teste no tema da skill, a IA segue o comportamento descrito nas Instruções (use a aba Teste do agente ou converse pelo WhatsApp). Problemas comuns | O que aconteceu | O que fazer | |---|---| | A IA não usa a skill | Confira as palavras-chave de "Quando acionar" — o agente precisa ver um desses termos na conversa. | | A skill não aparece na lista | Verifique se você salvou a skill e se está na sua organização (gerentes e administradores veem a área completa). | | O catálogo está vazio | Isso significa que você já instalou tudo o que a plataforma oferece — crie a sua própria skill. | Próximos passos - O que são Agentes de IA - Base de Conhecimento - Memória da IA