# Agente de IA: guia completo de criação e configuração Os **Agentes de IA** do SimplesDesk atendem seus clientes de ponta a ponta: respondem com base no conhecimento da sua empresa, seguem o tom de voz da sua marca, executam ações (consultar pedidos, agendar, atualizar cadastro) e transferem para um atendente humano na hora certa. Este guia mostra o caminho completo — da criação à ativação — com dicas práticas em cada etapa. ## Antes de começar Separe três coisas — elas definem 80% da qualidade do agente: > 📘 **Materiais que valem ouro**: páginas do seu site (FAQ, políticas, preços), manuais em PDF e as respostas que sua equipe mais repete no dia a dia. Tudo isso vira base de conhecimento. 1. **Escopo**: o que o agente DEVE resolver (ex.: dúvidas de produto, status de pedido) e o que ele NÃO deve tentar (ex.: negociação de dívida → humano). 2. **Tom de voz**: como sua marca fala — formal, próxima, técnica? 3. **Canal piloto**: escolha **um** canal para começar (ex.: o WhatsApp de suporte). Expandir depois é um clique. ## Criando o agente — os 8 passos Acesse **Central IA > Agentes de IA** e clique em **Criar um novo agente**. O assistente de criação é dividido em **8 passos** (abas numeradas no topo) e mostra uma **pré-visualização ao vivo** de como o agente vai soar. Tudo é **salvo automaticamente como rascunho**: se fechar a janela, ao voltar você pode **Continuar** de onde parou. ![Tela Agentes de IA com o botão Criar um novo agente](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOExFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c1ffe103bf78793119be1399e44288ed67580456/agente-ia-lista.jpg) ### 1. Identidade Defina **nome**, **função** (o papel do agente: vendedor, suporte, recepcionista...) e a **primeira frase** — a mensagem de abertura que o cliente recebe. A plataforma pode **gerar as instruções automaticamente** a partir do contexto que você descrever; revise o texto gerado e ajuste o que for específico do seu negócio. ![Passo 1 — Identidade: nome, função, idioma e primeira frase](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOFBFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f4ad9b62a062513dddb7aba0c024470b8d85f6f7/agente-ia-passo1-identidade.jpg) > ✅ **Dica**: na primeira frase, deixe claro que é um assistente virtual e o que ele sabe resolver. Isso reduz frustração e pedidos imediatos de "falar com humano". ### 2. Personalidade Escolha o **tom** em cartões com exemplos reais de resposta, defina o uso de **emojis** (nunca / espelhar o cliente / sempre) e cadastre **palavras proibidas** — termos que o agente jamais deve usar. Os **comportamentos** afinam a postura: confirmar antes de executar ações, manter-se no assunto, evitar repetição. ![Passo 2 — Personalidade: tom de voz, emojis e palavras proibidas](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOFRFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--912ac3c8e4f325141de1b55e4b28e1334518db79/agente-ia-passo2-personalidade.jpg) ### 3. Modelo e limites Aqui você escolhe o **modelo de IA** e os limites de resposta: - **Mantenha o modelo padrão** (GPT-4.1 mini) a menos que tenha um motivo forte: ele resolve a grande maioria dos atendimentos e é o que consome **menos créditos de IA** (multiplicador 1×). Modelos maiores consomem 5× a 7× mais por resposta. - **Temperatura**: quanto menor, mais previsível; quanto maior, mais criativo. Para atendimento, valores baixos/médios funcionam melhor. - **Máximo de tokens por resposta**: limita o tamanho das respostas — bom para manter mensagens objetivas no WhatsApp e controlar custo. ![Passo 3 — Modelo e limites: modelo principal, plano B e sliders](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOFhFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--772d027b8b01a7d90e79a6c499973af203342208/agente-ia-passo3-modelo.jpg) ### 4. Base de conhecimento Adicione **sites** (as páginas viram documentos automaticamente) e **documentos** (PDF, DOCX, planilhas). É daqui que o agente tira as respostas sobre o SEU negócio. > 📘 **Qualidade > quantidade**: documentos objetivos e atualizados rendem respostas melhores do que dezenas de arquivos genéricos. Remova versões antigas de tabelas de preço e políticas — o agente não sabe qual vale. ![Passo 4 — Base de conhecimento: sites e comportamento sem resposta](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOGJFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--f9dfb2c97b224c2c6f8bdcf7badce0c007694f18/agente-ia-passo4-conhecimento.jpg) ### 5. Respostas prontas Cadastre pares **gatilho → resposta** para as perguntas mais críticas e frequentes (horário de funcionamento, formas de pagamento, política de troca). Quando o assunto bate com o gatilho, o agente usa a resposta pronta como referência — padronização total no que não pode variar. ![Passo 5 — Respostas prontas](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOGZFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6c9c1e7ef3c1d80421f154d19e50c170e766e0dc/agente-ia-passo5-respostas.jpg) ### 6. Regras O passo mais importante para o comportamento no dia a dia: - **Follow-up**: o agente retoma contato com quem parou de responder (com limite de tentativas e janela de horário). - **Horário de funcionamento**: quando o agente atua. - **Validação de contato**: exigir CPF/CNPJ ou outro dado antes de prosseguir. - **Manter no assunto**: impede que o agente converse sobre temas fora do escopo. - **Tempo de inatividade** e **desistir após N tentativas**: quando encerrar ou transferir. ![Passo 6 — Regras: follow-up, horário, CPF/CNPJ, assunto e desistência](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOGpFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--543ec4a1f7c8a299d4b069843fc3e896bf5f2568/agente-ia-passo6-regras.jpg) ### 7. Roteamento Crie **regras por intenção**: se o cliente demonstra interesse X, a conversa vai para outro agente de IA, um time ou um atendente específico. É assim que você monta uma "recepção inteligente" que distribui para especialistas. ![Passo 7 — Roteamento por assunto](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOG5FQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--304f72381692863ff92916a390ef22200194a3b6/agente-ia-passo7-roteamento.jpg) ### 8. Ativar Revise o resumo e ative. Você é levado direto para a página de edição do agente. ![Passo 8 — Ativar: resumo final e botão Ativar agente](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOHJFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6b9fff752a93b837dc4dd310314b649106e669ba/agente-ia-passo8-ativar.jpg) ## Depois de criar: a página de edição A edição organiza tudo em **6 grupos**: **Perfil**, **Conhecimento**, **Instruções & Modelo**, **Ações & Integrações**, **Regras & Transferência** e **Acesso & Canais**. Use a **busca de configuração** (aceita busca sem acento) para pular direto a qualquer seção. No topo, o medidor **"% pronto"** analisa a configuração e mostra **uma dica por vez** do que falta — clique na dica para ir direto à seção. Verde = pronto para produção. ![Página de edição: 6 grupos, medidor % pronto e Playground](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOHZFQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--75671718aac0ecc8695ec7fa2485e0a5077cb075/agente-ia-edicao-grupos.jpg) ### Conectar aos canais Em **Acesso & Canais**, escolha em quais canais o agente atende. Comece pelo canal piloto; com o comportamento validado, adicione os demais. ### Transferência para humanos Em **Regras & Transferência**, configure a **mensagem de transferência** e a **detecção de pedido de humano**. Um bom agente sabe a hora de sair de cena — transferir bem vale mais do que insistir. ## Teste antes de ativar nos canais Use o **Playground** do agente para conversar com ele como se fosse um cliente. > ⚠️ **Atenção**: o Playground é uma conversa REAL — consome créditos de IA e executa as ações configuradas. Teste com objetividade: valide a primeira frase, 3-4 perguntas típicas, uma pergunta fora do escopo e um pedido de atendente humano. ## Checklist final - [ ] Instruções revisadas (não apenas o texto gerado) - [ ] Base de conhecimento com documentos atualizados - [ ] Respostas prontas para as 5 perguntas mais frequentes - [ ] Regras de horário, follow-up e transferência configuradas - [ ] Testado no Playground (incluindo pedido de humano) - [ ] Ativado em UM canal piloto Com o agente rodando, o próximo passo é otimizar qualidade e custo — veja o tutorial **[Como melhorar seu Agente de IA e economizar créditos](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/1786912670-como-melhorar-seu-agente-de-ia-e-economizar-creditos-cache-e-boas-praticas)**.