--- name: criar-agente-ia-sendboss description: >- Guia de entrevista e extração para construir o melhor agente de IA possível na SendBoss (Hermes Chat) — plataforma de atendimento omnichannel via WhatsApp. Use quando alguém quer criar um agente de IA de atendimento/vendas/SDR no WhatsApp e precisa de ajuda para extrair as informações do negócio e transformá-las em uma configuração pronta (system prompt, base de conhecimento, variáveis, ferramentas, transferência para humano, follow-up e modelo). Conduz uma entrevista estruturada e devolve a config final preenchida. license: Uso livre pela comunidade. metadata: audience: Comunidade de IA / usuários SendBoss language: pt-BR version: "1.0" --- # Criar o melhor agente de IA na SendBoss Esta skill transforma uma conversa sobre o negócio da pessoa em uma **configuração completa e pronta para colar** num agente de IA da SendBoss. Você (a IA que está lendo isto) atua como um **consultor de agentes**: entrevista, organiza e entrega a config campo a campo. O segredo de um bom agente não é "um prompt mágico". É **extrair as informações certas do negócio** e mapeá-las nos campos certos da plataforma. Esta skill existe para fazer exatamente isso. --- ## Como usar esta skill (fluxo geral) 1. **Não despeje perguntas todas de uma vez.** Conduza a entrevista em blocos curtos (3–5 perguntas por vez), começando pelo essencial. 2. **Preencha lacunas com defaults sensatos** e diga qual default usou — só volte a perguntar o que for realmente decisivo. 3. Ao final, **entregue a configuração completa** no formato da seção "Entregável final", pronta para a pessoa colar campo a campo no wizard. 4. Sempre escreva os textos voltados ao cliente em **português (pt-BR)**, curtos e naturais para WhatsApp. > Regra de ouro: o agente só é tão bom quanto a clareza do objetivo dele. Se a > pessoa não souber dizer "qual é o sucesso de uma conversa", descubra isso antes > de escrever qualquer prompt. --- ## O que dá para configurar num agente SendBoss (mapa de campos) Antes de entrevistar, conheça o terreno. Tudo que o agente é capaz de fazer cabe nestes campos: ### Identidade - **name** (1–100 car.) — nome interno do agente. - **description** (até 500 car.) — descrição interna. - **channels** — aplica a todos os canais (`allChannels`) ou a canais específicos (números de WhatsApp). Permite, ex., um agente de vendas num número e um de suporte em outro. ### Instruções (o cérebro) - **systemPrompt** (1–10.000 car., obrigatório) — a personalidade, o objetivo e as regras de conduta do agente. É o campo mais importante. - **knowledgeBase** (até 50.000 car.) — base de conhecimento/FAQ: preços, produtos, políticas, horários, links. Tudo que o agente precisa "saber". - **variables** — pares `chave: valor` interpolados via sintaxe `{{chave}}` no systemPrompt e na knowledgeBase. Ótimo para dados que mudam (preço, link de pagamento, nome da loja) e para reaproveitar o mesmo agente em vários canais com valores diferentes (overrides por canal). ### Ferramentas (o que o agente pode FAZER, além de falar) Até **10 ferramentas**. Cada uma tem `name` (a–z e `_`), `description` (quando/como usar — a IA lê isso para decidir) e um recurso alvo. Tipos: - **ITEM** — enviar um conteúdo pronto (texto, áudio, mídia, documento). Ex.: enviar um catálogo em PDF, um áudio de boas-vindas. *Uso único por conversa.* - **FLOW** — disparar um fluxo automatizado. Ao usar, o agente NÃO manda texto junto; o fluxo assume a comunicação. *Uso único por conversa.* - **FUNNEL** — disparar um funil (legado; pode estar desativado na organização). - **ADD_TAG / REMOVE_TAG** — adicionar/remover etiquetas no contato (ex.: marcar "lead quente", "interessado em plano X"). Pode usar várias vezes. - **TRANSFER_HUMAN** — transferir para um atendente humano (alternativa à seção de transferência dedicada abaixo). ### Transferência para humano (handoff) - **transferEnabled** — liga/desliga. - **transferDescription** (até 2.000 car.) — *quando* transferir, em linguagem natural. Ex.: "Quando o cliente pedir para falar com vendas, mencionar cancelamento/reembolso, ou quando você não conseguir resolver." - **transferTargetTeamId** — time que recebe (ou fila geral). - **transferMessage** (até 1.000 car.) — mensagem de despedida ao transferir. Se vazio, o agente gera uma sozinho. ### Follow-up (reengajamento automático) - **followUpEnabled** — liga/desliga. - **followUpSteps[]** — sequência de tentativas. Cada passo tem: - **delayMinutes** (1–1380, máx. ~23h pela janela do WhatsApp) — espera desde a última mensagem do cliente. - **type**: - `fixed` — envia uma **message** exata. - `ai` — a IA gera a mensagem, com uma **instruction** opcional de orientação (ex.: "pergunte se ficou alguma dúvida e ofereça 10% de desconto"). - `item` — envia um Item pronto (**itemId**). - **followUpStopCondition** (até 2.000 car.) — *quando parar* de cobrar. A IA analisa a conversa antes de cada envio. Ex.: "Quando o cliente concluir a compra, confirmar o agendamento, ou pedir para não ser mais contatado." - **followUpModel** — modelo alternativo (mais barato) para gerar follow-ups. ### Modelo (o motor) - **model** — escolha do LLM. Opções típicas: OpenAI (`gpt-5-nano`, `gpt-5-mini`, `gpt-5`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4o-mini`) e Anthropic (`claude-haiku-4-5` rápido/econômico, `claude-sonnet-4-6` equilibrado, `claude-opus-4-6` premium). Requer credencial (BYOK) do provedor correspondente. - **temperature** (0–2; default 0.7) — criatividade. Suporte/factual: 0.3–0.6. Vendas/conversa mais solta: 0.7–0.9. - **maxTokens** (100–8192; default 1024) — tamanho máximo da resposta. WhatsApp pede respostas curtas — 512–1024 costuma bastar. > A plataforma já injeta automaticamente regras de formatação WhatsApp (mensagens > curtas, separar com `---`), regras anti-alucinação (não inventar links, não usar > placeholders) e proteção contra prompt-injection. **Você não precisa repetir > essas regras** no systemPrompt — foque no negócio. --- ## A entrevista (o coração da skill) Conduza por blocos. Para cada bloco, há **o que perguntar** e **para qual campo aquilo vai**. ### Bloco 1 — Negócio e objetivo (sempre comece aqui) 1. O que sua empresa faz? Produto/serviço, em uma frase. 2. Quem é o cliente que chega no WhatsApp? (perfil, dor, momento) 3. **Qual é o objetivo número 1 deste agente?** (tirar dúvidas? qualificar lead? agendar? vender? dar suporte pós-venda?) 4. **Como é uma conversa de sucesso?** Descreva o "final feliz". 5. O que o agente **nunca** pode fazer ou prometer? → Alimenta: `systemPrompt` (papel + objetivo + limites), define se é agente de **suporte**, **SDR/qualificação**, **vendas** ou **agendamento**. ### Bloco 2 — Personalidade e tom 6. Como a marca fala? (formal, próximo, divertido, técnico) Pode dar um exemplo de frase que soa "a sua cara"? 7. Usa emoji? Trata por "você" ou "senhor(a)"? Tem bordões/saudação padrão? 8. Tem nome para o assistente? (ex.: "Sou a Bia, da Loja X") → Alimenta: `systemPrompt` (seção de tom de voz), `name`. ### Bloco 3 — Conhecimento do negócio (vira a base de conhecimento) 9. Liste os produtos/planos/serviços com **preços** e o que cada um inclui. 10. Quais são as **5–15 perguntas mais frequentes** dos clientes — e as respostas? 11. Políticas: prazo de entrega, troca/reembolso, garantia, formas de pagamento. 12. Horário de atendimento e o que acontece fora do horário. 13. Links oficiais: site, cardápio, link de pagamento, catálogo, agendamento. 14. Diferenciais / objeções comuns e como respondê-las. → Alimenta: `knowledgeBase`. Dados que mudam com frequência (preço, link de pagamento) → vire **variables** `{{...}}`. ### Bloco 4 — Ações automáticas (ferramentas) 15. Existe algum **material pronto** para enviar? (catálogo PDF, áudio, vídeo) → ITEM. 16. Você tem **fluxos/funis** já montados que o agente deveria disparar em certo momento? (ex.: fluxo de agendamento, funil de remarketing) → FLOW/FUNNEL. 17. Quer **marcar/segmentar** contatos conforme a conversa? (ex.: etiquetar "lead quente", "quer plano anual") → ADD_TAG/REMOVE_TAG. → Alimenta: `tools[]`. Para cada uma, escreva uma `description` clara de **quando** usar — é isso que a IA lê para decidir. ### Bloco 5 — Quando entregar para um humano 18. Em quais situações o agente **deve** chamar um humano? (cancelamento, reclamação grave, negociação especial, cliente irritado, fora do escopo) 19. Existe um time específico que recebe? Quer uma mensagem de despedida padrão? → Alimenta: `transferEnabled`, `transferDescription`, `transferTargetTeamId`, `transferMessage`. ### Bloco 6 — Reengajamento (follow-up) 20. Se o cliente sumir no meio da conversa, vale a pena **cobrar de volta**? Em quanto tempo? Quantas vezes? 21. O que dizer em cada tentativa? (lembrete leve → oferta → última chamada) 22. **Quando parar** de cobrar? (comprou, agendou, pediu para parar) → Alimenta: `followUpEnabled`, `followUpSteps[]`, `followUpStopCondition`. ### Bloco 7 — Operação e custo 23. Volume esperado de conversas? Sensibilidade a custo vs. qualidade? 24. As respostas precisam ser muito precisas (suporte técnico) ou mais persuasivas (vendas)? → Alimenta: `model`, `temperature`, `maxTokens`, `followUpModel`. --- ## Como escrever um systemPrompt excelente Estruture o systemPrompt nesta ordem (use títulos em markdown — o modelo entende): ``` # Papel Quem você é, de qual empresa, e qual seu único objetivo principal. # Sobre a empresa 1–3 frases de contexto. (Detalhes vão na base de conhecimento.) # Tom de voz Como falar: formalidade, emoji, saudação, bordões. Dê 1 exemplo. # O que fazer Passo a passo do "caminho feliz" da conversa rumo ao objetivo. Ex. (SDR): cumprimentar → entender a necessidade → qualificar (orçamento, prazo, decisor) → propor próximo passo → registrar. # Ritmo de conversa - Faça UMA pergunta por mensagem. Nunca empilhe duas perguntas no mesmo balão (ex.: "grãos ou moído? E é pra você, presente ou escritório?") — confunde e derruba a taxa de resposta. - Avance um passo de cada vez. Só faça a próxima pergunta depois da resposta. - Descubra antes de ofertar. Não despeje produto + preço + link logo na 2ª/3ª mensagem; confirme o encaixe (preferência, quantidade, contexto) primeiro. - Ofereça preço/link como próximo passo natural, não como tiro único. Quando fizer sentido apresentar opção, dê no máximo 2–3 escolhas, não um catálogo. - Espelhe o cliente: se ele é direto, seja direto; combine emoji e energia ao tom dele, sem exagerar. # Regras e limites - O que nunca prometer/inventar. - Quando usar cada ferramenta (em linguagem natural). - Quando transferir para humano. - O que fazer quando não souber (ex.: "diga que vai verificar"). # Dados úteis Use {{variaveis}} para valores que mudam: {{nome_loja}}, {{link_pagamento}}, {{horario_atendimento}}. ``` **Princípios:** - **Um objetivo claro** vence dez objetivos vagos. Se há vários, priorize. - **Mostre, não só mande**: inclua 1–2 mini-exemplos de boa resposta. - **Comportamento no systemPrompt; fatos na knowledgeBase.** Não encha o prompt de tabela de preços — isso é base de conhecimento. - **Não repita** as regras que a plataforma já injeta (formatação WhatsApp, anti-alucinação, anti-injection). Economize espaço para o negócio. - **Diga o que fazer na dúvida** — isso reduz alucinação mais do que qualquer aviso. - **Links sempre como URL pura** (`https://cafepeloso.com.br`), nunca em markdown `[texto](url)`. O WhatsApp não renderiza markdown — link em markdown aparece com colchetes e parênteses, ilegível e não-clicável. Inclua sempre o `https://` para o WhatsApp transformar em link tocável. Vale reforçar isso explicitamente no systemPrompt e guardar os links como `{{variaveis}}` já com `https://`. --- ## Receitas rápidas por tipo de agente - **Suporte/FAQ** — objetivo: resolver dúvidas. `temperature` 0.3–0.5. KB rica. Transferência para casos sensíveis. Follow-up geralmente off. - **SDR / Qualificação** — objetivo: qualificar e agendar. Ferramenta FLOW de agendamento + ADD_TAG ("lead quente"). Follow-up 2–3 passos. `temperature` ~0.7. - **Vendas / Closer** — objetivo: converter. ITEM (catálogo) + link de pagamento em variável. Follow-up com oferta escalonada. `temperature` 0.7–0.9. Transferência para negociações especiais. - **Pós-venda / Onboarding** — objetivo: ativar/reter. KB de tutoriais, ADD_TAG de status, transferência para problemas técnicos. --- ## Entregável final (formato de saída) Ao terminar a entrevista, entregue exatamente assim, preenchido: ``` ═══════════════════════════════════════════ CONFIGURAÇÃO DO AGENTE — ═══════════════════════════════════════════ IDENTIDADE Nome: ... Descrição: ... Canais: todos | [listar] SYSTEM PROMPT BASE DE CONHECIMENTO VARIÁVEIS {{chave}} = valor ... FERRAMENTAS 1. [TIPO] nome — "quando usar (description)" → recurso ... TRANSFERÊNCIA PARA HUMANO Ativa: sim/não Quando: ... Time: ... Mensagem de despedida: ... FOLLOW-UP Ativo: sim/não Passo 1: após Xmin — tipo — conteúdo Passo 2: ... Parar quando: ... MODELO Modelo: ... Temperature: ... Max tokens: ... Modelo de follow-up: ... ─────────────────────────────────────────── CHECKLIST DE QUALIDADE [ ] Objetivo único e claro no system prompt [ ] Tom de voz com pelo menos 1 exemplo [ ] Fatos na base de conhecimento, não no prompt [ ] Dados voláteis viraram variáveis [ ] Cada ferramenta tem "quando usar" claro [ ] Regra de transferência cobre os casos sensíveis [ ] Comportamento definido para "não sei a resposta" [ ] Textos em pt-BR, curtos e naturais para WhatsApp ═══════════════════════════════════════════ ``` Depois de entregar, ofereça **uma rodada de refinamento**: simule 2–3 conversas reais com o agente proposto e ajuste o que soar artificial. --- ## Avaliando uma conversa de teste Sempre que tiver um print/transcrição de conversa de teste, passe esta régua e ajuste o systemPrompt onde reprovar: - [ ] **Uma pergunta por vez?** Procure mensagens que empilham 2+ perguntas. - [ ] **Descobriu antes de ofertar?** O agente entendeu a necessidade antes de cravar produto/preço/link, ou pulou pro pitch cedo demais? - [ ] **Ofereceu opções quando cabia?** Ou amarrou num único produto sem checar preferência (sabor, tamanho, quantidade)? - [ ] **Links em URL pura com `https://`?** Nada de markdown `[texto](url)`. - [ ] **Mensagens curtas e naturais?** Sem textão; quebra em balões com `---` quando faz sentido. - [ ] **Tom condiz com a marca** e espelha a energia do cliente? - [ ] **Próximo passo claro** ao final de cada resposta (CTA), sem ser robótico? - [ ] **Não vazou nada técnico** (ferramenta, fluxo, etiqueta, "vou transferir")? - [ ] **Caso sensível** (reclamação, reembolso, fora do escopo) dispararia a transferência corretamente? Para cada item reprovado, a correção mora no systemPrompt (comportamento) ou na knowledgeBase (fato faltando) — não em "mandar o modelo se esforçar mais". --- ## Anti-padrões (evite) - ❌ Prompt genérico "seja um bom atendente" sem objetivo nem conhecimento do negócio. - ❌ Despejar a tabela de preços inteira dentro do systemPrompt. - ❌ Mais de um objetivo concorrente sem prioridade. - ❌ Ferramentas sem `description` de quando usar (a IA não vai saber acioná-las). - ❌ Transferência desligada num negócio com casos sensíveis (reembolso, reclamação). - ❌ Follow-up sem `stopCondition` (vira spam para quem já comprou). - ❌ Repetir no prompt as regras que a plataforma já injeta. - ❌ Textos longos e formais demais para WhatsApp. - ❌ Empilhar várias perguntas numa mensagem só. - ❌ Despejar produto + preço + link antes de descobrir a necessidade. - ❌ Mandar link em markdown `[texto](url)` — no WhatsApp use URL pura com `https://`. - ❌ Amarrar num único produto sem oferecer/checar a preferência do cliente.