# Configuração do Bot de IA O seu bot de IA é o coração da plataforma. Ele lê as mensagens dos seus clientes, compreende o que eles precisam e responde de forma natural - como um membro da equipa qualificado que nunca dorme. Este guia acompanha-o passo a passo na configuração do seu bot. **A boa notícia:** Não precisa de quaisquer competências técnicas. Se consegue descrever como quer que uma conversa decorra, consegue configurar o seu bot. > **Onde isto se encontra.** Tudo nesta página está no passo **Instruções de IA** do seu [Agente de IA](../ai-agents/ai-agents.md) — o primeiro no editor de agentes. --- ## O que o seu Bot de IA pode fazer Uma vez configurado, o seu bot pode: - **Responder a perguntas** sobre os seus produtos, serviços, preços e políticas - **Marcar reuniões** e gerir o seu calendário - **Qualificar leads** ao fazer as perguntas certas e recolher detalhes de contacto - **Ligar-se a outras ferramentas** como o seu CRM, sistema de encomendas ou plataforma de agendamento - **Fazer seguimento automaticamente** quando as conversas ficam inativas - **Passar a conversa para a sua equipa** quando encontra algo que não consegue resolver Cada Agente tem a sua própria configuração de bot, pelo que pode configurar bots diferentes para fins diferentes - um bot de apoio, um bot de vendas, um bot de eventos, e assim por diante - e reutilizar cada um em todos os canais ou Transmissões que dele necessitem. --- ## Fornecedores de IA (Como o Bot pensa) A plataforma utiliza os modelos de IA mais recentes para potenciar o seu bot. O nível **Pro** funciona com o **Anthropic Claude (Sonnet)** — que se destaca no seguimento de instruções e na compreensão do contexto. A maioria das contas também tem o **Max**, o nosso nível interno mais rápido e de menor custo, que oferece a melhor relação qualidade-preço para quase todos (ver [Porque é que o Max é a melhor opção](ai-model-comparison.md)), e o **Mini** ao seu lado — a mesma família interna numa configuração mais leve, para o preço mais baixo por resposta. Pode escolher o nível por Agente na definição **Qualidade da IA**. Até escolher um nível e guardar, o Agente funciona no **Pro** e fatura 1 crédito por ação, mesmo que o Max esteja disponível na sua conta. (O nível **Economy** mais antigo está a ser descontinuado — utilize o Max em alternativa.) **Não precisa de escolher um fornecedor de IA.** Escolhe um nível de **Qualidade da IA** no Agente (Pro, Max ou Mini) e a plataforma executa o modelo por trás desse nível para si. Apenas tem de se concentrar em dizer ao bot o que fazer. --- ## Início Rápido: Configuração Automática via Integração (Onboarding) Se está a configurar a aplicação pela primeira vez, o **assistente de integração guiada** pode configurar o seu bot automaticamente. Durante a integração, introduz o URL do seu site e a IA da plataforma analisa o seu site para: - **Gerar instruções para o bot** adaptadas ao seu negócio, incluindo tom, objetivos e fluxo de conversação - **Criar FAQs** a partir do conteúdo do seu site para que o bot já conheça os seus produtos, preços e políticas - **Configurar as informações da sua empresa** com base no que encontra no seu site Isto dá-lhe um bot totalmente funcional em minutos. Pode sempre refinar a configuração gerada automaticamente mais tarde, utilizando os passos abaixo. --- ## O Fluxo de Trabalho Recomendado (Playbook) Não tem de (e não deve) escrever o manual de instruções perfeito no primeiro dia. Os bots de maior sucesso na plataforma — incluindo aqueles que fecharam **milhões de dólares em receitas** — seguem o mesmo ciclo de iteração simples. Eis o fluxo de trabalho que funciona: ### 1. Gere o primeiro rascunho a partir de um URL Crie o Agente apontando-o para um website (a sua página de vendas, página de produto, página de destino). A plataforma gera o playbook inicial a partir do conteúdo da página — isto preenche automaticamente as Instruções de IA do Agente. Não edite demasiado ainda — apenas dê uma vista de olhos pelos campos gerados, corrija algo que esteja obviamente errado e siga em frente. ### 2. Refinar com Otimizar com IA Abra o Agente e clique em **Otimizar com IA** — num Agente, esta opção encontra-se no cabeçalho da conversa **Experimentar**, e está presente em todos os Agentes. Em vez de reescrever o playbook à mão, dê ao Otimizador o **objetivo geral** em linguagem simples, por exemplo: > "Estamos a realizar uma promoção de Black Friday — 30% de desconto no nosso pacote anual até 1 de dezembro. Ajuste o manual para mencionar isto e incentive as inscrições antes do prazo." A IA reescreve todo o manual para corresponder ao novo objetivo. Quando termina, obtém um **ecrã de revisão** antes de qualquer alteração entrar em vigor: cada alteração proposta é apresentada lado a lado — como o campo está agora versus o que a IA pretende alterar. Mantenha as alterações de que gosta e desative as que não quer; as adições, edições e remoções sugeridas para as FAQ são listadas separadamente, e cada uma só é aplicada se a aceitar explicitamente. **Aplicar** guarda a sua seleção, **Rejeitar tudo** repõe o manual exatamente como estava, e fechar a revisão mantém-no à espera que decida mais tarde. Num Agente, o que aplica é guardado como um **rascunho**: teste algumas mensagens no separador **Experimentar** para garantir que tudo parece correto, depois clique em **Publicar** na faixa âmbar no topo do editor para o disponibilizar. A maioria dos manuais deve entrar em vigor com cerca de **20 000 caracteres** — bem abaixo do limite. ### 3. Itere a partir de conversas em direto Assim que o bot estiver ativo, observe as conversas reais que chegam. Quando uma resposta do bot não está bem correta: 1. Abra essa conversa na [Interface de Chat](../chats/chat-interface.md). 2. Utilize o ciclo **chat → playground → corrigir → guardar** documentado em [Chat Playground](../chats/playground.md#fixing-a-live-chat-with-try-out-replay-loop): dê um polegar para baixo na interação incorreta, edite o manual no painel lateral, reinicie, guarde. Cada correção adiciona ou ajusta uma pequena regra no manual de instruções. Ao longo das **1–2 semanas** seguintes — normalmente após 20 a 50 conversas ao vivo — o manual de instruções converge. Depois disso, raramente voltará a tocar-lhe. Alguns dos bots com mais tempo de funcionamento na plataforma não foram editados em dois anos. ### Mantenha o seu Manual Simplificado Os limites de caracteres existem para serem **generosos**, não para serem preenchidos. Os manuais de sucesso tendem a situar-se no intervalo de **10 000–30 000 caracteres** — não no teto de 80 000+. Um manual denso e focado supera sempre um manual extenso. **Porque é que a densidade importa (a analogia do funcionário):** Imagine que está a formar um novo funcionário. Se lhe der um objetivo claro, ele executa-o bem. Se lhe der dez objetivos diferentes, centenas de regras para cada mensagem possível e um dossier de contexto com 50 páginas — ele irá desviar-se do objetivo principal, ficará confuso e cometerá mais erros. A IA comporta-se da mesma forma. Orientação concreta: - **Um Agente = um objetivo claro.** Se tiver objetivos muito diferentes (vendas, suporte, recrutamento, agendamento), crie Agentes separados para eles. Um bot especialista por objetivo tem um desempenho superior a um bot generalista. - **Não despeje artigos de blogue inteiros, apresentações de vendas ou white papers no manual de instruções.** Extraia os factos de que o bot realmente precisa para fechar o negócio. Tudo o resto vai para as FAQs (onde a pesquisa inteligente apenas carrega o que é relevante por mensagem). - **Pare de adicionar regras preventivamente.** Espere até que uma conversa ao vivo corra mal, depois adicione uma regra para esse caso específico. As regras que imagina que vai precisar raramente correspondem às regras de que realmente precisa. - **Metade do limite é suficiente.** Se está a atingir o limite de caracteres, isso é normalmente um sinal de que o manual de instruções perdeu o foco — não um sinal para aumentar o limite. --- ## Configurar o seu Bot (Passo a Passo) 1. Na barra lateral principal, em **Estúdio de IA**, clique em **Agentes de IA**. 2. Abra o Agente que pretende configurar. 3. Clique no seu separador **Instruções de IA**. **Idioma principal** encontra-se no topo do separador, acima de tudo o resto. É o idioma em que a sua IA escreve por predefinição e o idioma que utiliza para as notas que lhe escreve — alertas de transferência para humanos, tarefas, sugestões de FAQ. Não é um bloqueio: o seu bot continua a responder a cada contacto no idioma em que esse contacto escreve. Escolha um novo e este é guardado imediatamente — este campo não espera pela opção **Publicar para o live** como o resto do separador. O que ele *não* faz é reescrever algo que já esteja escrito: as suas instruções e FAQs existentes permanecem na língua em que foram escritas, por isso, se quiser que o agente mude completamente de língua, retraduza-as também. Duas verificações de script são executadas automaticamente, não havendo nada para ativar. Um agente definido como **Chinês (Tradicional)** ou **Chinês (Hong Kong)** tem qualquer caractere simplificado disperso reescrito para a sua forma tradicional antes de uma resposta ser enviada (请问 torna-se 請問), enquanto o texto que já está em Tradicional permanece exatamente como foi escrito. Um agente que escreve em **Japonês** tem cada resposta verificada quanto a caracteres que apenas existem em Chinês (simplificações do continente, como 这, 现 e 们, e formas antigas que o Japonês já não utiliza); se algum se infiltrar, a resposta é regenerada uma vez com uma correção e a versão limpa é enviada. Os kanji comuns, incluindo nomes como 達也, nunca são alterados. A verificação de Japonês é executada nos níveis Max e Mini, que é onde isto aconteceu; também abrange seguimentos e respostas a comentários. Se o seu idioma principal for **Chinês (Tradicional)** ou **Chinês (Hong Kong)**, cada resposta é verificada antes de ser enviada e qualquer caractere de Chinês Simplificado que a IA tenha introduzido é reescrito para a sua forma Tradicional (请问 torna-se 請問, 适合 torna-se 適合). O texto que já está em Tradicional é deixado exatamente como foi escrito, incluindo o 台 em 台北 ou 台灣 e o 里 numa morada, pelo que isto apenas remove caracteres Simplificados dispersos. Abrange respostas normais, seguimentos, respostas a comentários e legendas de fotografias, e não há nada para ativar. O resto do separador está organizado em quatro secções expansíveis — Persona e Objetivo, Contexto de Negócio, Comportamento de Conversação e Escalação e Conclusão. Se utilizou o assistente de integração, muitos destes campos já estarão preenchidos para si. (O passo 5 abaixo, adicionar FAQ e recursos, ocorre no separador separado **FAQ e Conhecimento**.) > **Os novos Agentes obtêm um conjunto de campos mais simplificado.** Cada novo Agente começa com o formato atual, que mantém cada secção nos seus campos principais (abaixo). Agentes mais antigos, criados antes desta alteração, podem ainda apresentar alguns campos adicionais — **Fonte do Contacto** (Persona e Objetivo), **Pontos de Venda Únicos**, **Posicionamento de Mercado** e **Informações de Preços** (Contexto Empresarial), e **Tratamento de Objeções** e **Perguntas** (Comportamento da Conversação). Se os vir, funcionam exatamente da mesma forma — basta utilizá-los para o contexto adicional que solicitam. ### 1. Persona e Objetivo Quem é a IA e o que pretende. | Campo | O que escrever | Exemplo | |-------|--------------|---------| | **Persona** | O nome e a função do bot — a sua personalidade. | "És a Sarah, uma assistente de vendas na GreenFit Supplements. Amigável, direta, nunca insistente." | | **Objetivo** | O que define o sucesso desta conversação. | "Ajudar os clientes a encontrar o suplemento certo e guiá-los para a realização de uma encomenda." | **Pense nisto como treinar um novo funcionário:** Dir-lhe-ia qual a sua função, como cumprimentar os clientes, o que recomendar e quando pedir ajuda. Mantenha as mensagens curtas — diga ao bot para escrever como uma pessoa real a enviar mensagens de texto, 2 a 3 frases por mensagem. ### 2. Contexto do Negócio Factos sobre a sua empresa nos quais a IA se pode apoiar. | Campo | O que escrever | Exemplo | |-------|--------------|---------| | **Informações da Empresa** | O nome da sua empresa, o que faz e quem são os seus clientes | "A GreenFit Supplements vende suplementos de fitness premium à base de plantas para adultos preocupados com a saúde, com idades entre os 25 e os 45 anos." | ### 3. Comportamento na Conversa Como a IA deve conduzir e proteger o chat. | Campo | O que escrever | Exemplo | |-------|--------------|---------| | **Regras** | O que o bot nunca deve fazer ou dizer | "Nunca faças alegações médicas. Nunca inventes informações que não estejam nas informações da empresa ou nas FAQs." | | **Fluxo de Conversação** | O que deve acontecer primeiro, em segundo, em terceiro | "1. Cumprimenta pelo primeiro nome. 2. Pergunta sobre objetivos de saúde. 3. Recomenda 1-2 produtos. 4. Partilha a ligação do produto. 5. Oferece-te para responder a perguntas. 6. Guia para o checkout." | **Exemplo de uma regra que também cobre objeções comuns:** ``` Never give a final quote in chat — share only the published starting price. If someone says "it's too expensive," mention the money-back guarantee and compare it to the cost of not solving the problem, instead of dropping price. ``` ### 4. Escalada e Conclusão Quando passar a um humano e quando parar. | Campo | O que escrever | Exemplo | |-------|--------------|---------| | **Alertar Humano Quando** | As condições que devem pausar o bot e notificar a sua equipa | "O contacto pede para falar com um gestor. O contacto tem uma reclamação de faturação. O contacto parece frustrado ou chateado." | | **Concluir Quando** | Quando o bot deve considerar o seu trabalho concluído para esta conversa | "O contacto marcou uma reunião ou diz explicitamente que não está interessado." | Quando o bot alerta um humano, o chat é pausado e recebe uma notificação. O bot não enviará mais mensagens até que o retome. ### 5. Adicionar FAQs e Recursos - **FAQs** dão ao bot respostas precisas a perguntas comuns. Consulte o guia de [Gestão de FAQs](faq-management.md). - **Recursos** são links que o bot pode partilhar durante as conversas (o seu website, página de preços, página de marcação, catálogo de produtos, etc.). - **Outras informações** (na secção **Contexto extra** na parte inferior do separador FAQs e Conhecimento) é um campo de texto livre que a IA lê para além das suas instruções. Utilize-o para qualquer coisa temporária ou substituível — uma promoção a decorrer esta semana, ou contexto específico da indústria para o nicho que está a visar — para que as suas instruções permanentes permaneçam intocadas. --- ## Tornar o seu bot humano (Definições de Resposta) Mais abaixo no mesmo separador **Instruções da IA**, as secções **Temporização de Resposta** e **Limites de Resposta** controlam o ritmo e o estilo das mensagens do seu bot para que pareçam vir de uma pessoa real, não de uma máquina. | Definição | O que faz | Predefinição | |---------|-------------|---------| | **Atraso Mínimo de Resposta** | Segundos mínimos antes de o bot começar a "escrever" | 15 segundos | | **Atraso Máximo de Resposta** | Segundos máximos antes de o bot começar a "escrever" | 30 segundos | | **Usar Atraso Mínimo para Novos Contactos** | Acelera a primeira resposta para que um contacto novo receba uma resposta mais rápida | Ligado | | **Velocidade de Escrita** *(não é um campo que possa editar)* | A pausa entre cada mensagem dividida, com base no tempo que essa mensagem demoraria a ser escrita por uma pessoa. Está sempre ligada e não a pode desligar; é definida pela **velocidade de resposta da IA** que escolher mais abaixo no separador (Humana escreve de forma mais lenta e natural, Rápida e Muito Rápida enviam as mensagens seguidas) | Humana | | **Comprimento da Resposta** *(definido durante a configuração, não editável aqui)* | Comprimento pretendido para cada mensagem (em palavras) | 30-60 palavras | | **Comprimento da Frase** *(definido durante a configuração, não editável aqui)* | Número pretendido de frases por mensagem | 2-4 | | **Máximo de Mensagens por Resposta** *(designado como "Máximo de Blocos" em alguns Agentes mais antigos)* | Máximo de balões de mensagem separados por resposta | 6 | | **Impor máximo de mensagens** | Impõe rigorosamente o limite acima: se a IA escrever mais mensagens do que o permitido, as extra são combinadas na última mensagem em vez de serem enviadas separadamente | Desligado | > **Quando utilizar Impor máximo de mensagens:** Por predefinição, o limite é uma instrução forte para a IA, que ela quase sempre respeita — mas, ocasionalmente, uma resposta mais longa pode surgir como balões extra. Ativar esta opção garante o limite, com um pequeno custo: as mensagens combinadas podem parecer mais densas e menos naturais do que o ritmo próprio da IA. Deixe-a desligada, a menos que as respostas divididas estejam a causar problemas. > **Não avalie o ritmo no Teste.** A conversa de **Teste** é deliberadamente acelerada para que não fique à espera: ignora totalmente a espera antes da primeira mensagem e coloca apenas alguns segundos entre as mensagens divididas. Nunca utiliza os atrasos de resposta acima. As suas conversas reais utilizam. Se quiser ver o ritmo real, observe uma conversa real. **Como funciona:** Em vez de enviar um parágrafo longo, o bot divide a sua resposta em várias mensagens curtas - tal como uma pessoa real a enviar mensagens. Também faz pausas entre as mensagens e mostra um indicador de "a escrever..." (no WhatsApp Web) para tornar a conversa natural. Não precisa de ligar nada disto: é automático em todas as respostas em tempo real. Definir o **Máximo de mensagens por resposta** para 1 ou 2 é o que o desliga na prática, uma vez que não resta nada para dividir. Uma exceção: uma resposta muito longa (aproximadamente 1.500 caracteres ou mais) é enviada como uma única mensagem, independentemente do que o limite indique. **Que valor é utilizado?** O bot não escolhe um número aleatório entre os dois. Ele analisa há quanto tempo a conversa está inativa desde a sua última mensagem: uma resposta que surge dentro de um minuto obtém a espera **Mínima**, e uma conversa que esteja inativa há 30 minutos ou mais obtém a espera **Máxima** completa, com tudo o que está entre estes valores a ser ajustado de forma gradual. Portanto, se definir um Máximo elevado (por exemplo, 300 segundos), a primeira resposta após um longo período de inatividade aguardará os 5 minutos completos. Isso é esperado, não é uma falha; diminua o Máximo se pretender respostas iniciais mais rápidas após uma pausa. Se um Agente não tiver qualquer atraso de resposta configurado, o bot recorre a um atraso predefinido de 30-60 segundos. > **Porquê um atraso predefinido tão longo?** Os clientes pedem constantemente para reduzir o atraso. Não o faça. Respostas instantâneas sinalizam "bot" e a guarda dos potenciais clientes sobe. A janela de 15-30 segundos, juntamente com mensagens divididas e um tom casual, faz com que a IA pareça humana, que é o que realmente fecha negócios. > **Mantenha-se próximo da predefinição de 15–30 segundos.** Não defina o mínimo para 0 ou 1 — as respostas que chegam instantaneamente parecem robóticas, e a pausa é o que faz com que a IA pareça um humano a escrever. Se precisar mesmo de respostas mais rápidas, reduza o mínimo para 5 segundos, mas nunca o coloque a zero. Ir para o extremo oposto também é prejudicial: um mínimo de um minuto ou mais significa que um potencial cliente que fez uma pergunta rápida fica à espera sem nada, e aumenta o intervalo de tempo em que as suas mensagens de seguimento são fundidas na mesma resposta. ### Como funciona o processamento de mensagens rápidas Se um contacto enviar várias mensagens curtas seguidas ("olá", "estás aí?", "queria perguntar sobre os preços"), o bot espera que termine, agrupa todas as mensagens e responde uma única vez com uma resposta coerente. Isto é uma funcionalidade, não um atraso. Impede que a IA se interrompa a meio do pensamento e evita que envie três respostas separadas para o que era, na verdade, uma única pergunta. A espera é parte do motivo pelo qual a conversa parece natural — uma pessoa real também esperaria que o outro lado terminasse de escrever antes de responder. > **O tempo de espera é o seu atraso de resposta.** O processamento em lote não é ilimitado: o bot apenas funde as mensagens que chegam antes de começar a responder, e essa janela é o **Atraso de Resposta Mín/Máx** que definiu acima. Com os 15-30 segundos predefinidos, uma mensagem de seguimento enviada 45 segundos depois chega após a resposta já ter sido enviada, pelo que recebe a sua própria resposta separada. Isto funciona conforme o esperado, não é uma falha. Se os contactos pensam habitualmente em voz alta através de várias mensagens e pretende que mais delas sejam fundidas numa única resposta, aumente o atraso de resposta; se pretende respostas mais rápidas, espere menos fusões. Não pode ter ambos. --- ## Transparência da IA (Informar os contactos de que estão a falar com uma IA) Muitos países exigem agora que as empresas informem as pessoas quando estão a conversar com uma IA — na UE, esta é a regra de transparência do Regulamento da IA, que se aplica a partir de 2 de agosto de 2026. O Your AI Connector trata disto por si com o interruptor **Dizer aos contactos que estão a conversar com uma IA**, no passo **Capacidades de IA** do seu agente. O assistente de configuração mostra o mesmo botão enquanto o seu primeiro agente está a ser criado e, sempre que estiver ligado, os editores de **Instruções de IA** e a conversa de teste **Experimentar** contêm uma nota com o seu próprio interruptor — para que possa ver que está ativo, compreender porque é que a IA se apresenta como uma IA, e desligá-lo ali mesmo sem ter de procurar a definição. Quando está ligado, a primeira resposta da IA que um contacto recebe inclui naturalmente uma breve menção de que se trata de um assistente de IA — integrada na saudação, não como um banner legal. É tudo: todas as respostas seguintes, incluindo seguimentos automáticos e qualquer conversa futura que o mesmo contacto tenha consigo, permanecem completamente inalteradas, e o bot mantém o seu tom e ritmo normais durante todo o processo. Uma menção de uma linha no início não prejudica uma conversa bem conduzida e mantém-no do lado certo das regras. Algumas coisas a saber: - **Os novos agentes têm esta opção ligada por predefinição.** Os agentes que existiam antes desta definição chegar permanecem exatamente como estavam — ligue-a por agente sempre que estiver pronto. - **Pode desligá-la.** Se o seu público não estiver abrangido pelas regras de transparência, desligue-a — o editor mostra uma pequena nota a lembrar-lhe que a conformidade para o seu público é então da sua responsabilidade. - **O interruptor entra em funcionamento quando publica.** Tal como qualquer outra alteração no editor do Agente, alternar este botão cria um rascunho: a conversa de Experimentar utiliza-o imediatamente, mas as conversas reais mantêm a definição antiga até clicar em **Publicar para o live** (o banner âmbar no topo do editor lembra-o). Se a IA continuar a apresentar-se depois de ter desligado o botão, um rascunho não publicado é quase sempre a razão. - **Com esta opção ligada, o bot não finge ser humano quando questionado.** Se um contacto perguntar "estou a falar com um bot?", a IA responde honestamente em vez de o negar, mesmo que o seu playbook lhe diga para dizer o contrário. Com o botão desligado, essa garantia desaparece, pelo que qualquer coisa que o seu playbook diga sobre alegar ser humano é da sua responsabilidade. De qualquer forma, não o instrua a alegar ser humano: é isso que as leis de transparência punem. - **Se uma instrução como "diga que é um membro da equipa" parecer ignorada, esta definição é a razão.** Enquanto o botão estiver ligado, as instruções sobre apresentar a IA como um humano ou membro da equipa são deliberadamente ignoradas — é a definição a fazer o seu trabalho, não a IA a falhar o seu playbook. Os editores de Instruções de IA mostram uma nota com o seu próprio interruptor sempre que isto está ativo, para que possa desligá-lo no momento (e a nota de conformidade acima aplica-se). - As mensagens de abertura que escreveu não são tocadas — são as suas palavras, não as da IA, pelo que não é adicionada qualquer divulgação às mesmas. --- ## Modos de velocidade da IA (Quão profundamente o bot pensa) Os modos de velocidade da IA controlam o quanto o bot "pensa" antes de responder. Pense nisto como fazer uma pergunta a alguém — por vezes uma resposta rápida é suficiente, e outras vezes quer que a pessoa reflita bem sobre o assunto. | Modo | Como funciona | Ideal para | |------|-------------|----------| | **Rápido** | Mais rápido. O bot responde sem um passo de reflexão alargado. | Perguntas e respostas simples, conversas de alto volume, apoio ao estilo FAQ | | **Rápido (Fast)** | Um passo de reflexão curto. Inteligente e rápido. | A maioria dos casos de utilização geral que não necessitam de raciocínio profundo | | **Pensativo** | Um passo de reflexão equilibrado. Ligeiramente mais cuidadoso do que o Rápido. | Conversas onde a precisão importa, mas não quer gastar com o modo Semelhante a Humano | | **Semelhante a Humano** | Passo de reflexão mais profundo. Analisa cuidadosamente toda a conversa antes de responder. | Vendas de alto valor, apoio técnico, qualquer situação em que cada resposta realmente importa. **Predefinição**. | **Recomendado:** Mantenha em Humano, a menos que tenha um motivo específico para o alterar. O ganho de precisão compensa, geralmente, a ligeira latência extra. --- ## Qualidade da IA (Qualidade vs Custo) Independentemente da Velocidade da IA, também pode escolher o modelo de IA subjacente. No separador **Instruções de IA**, esta definição é designada por **Qualidade da IA**. É puramente um botão de controlo de custo/qualidade. | Escalão | Ideal para | |------|------| | **Max** | A nossa IA interna, criada especificamente para mensagens de alto volume. Iguala o Pro em qualidade, é mais rápida na maioria das conversas e é a opção mais económica. Disponível em contas elegíveis. | | **Mini** | O "irmão" mais leve do Max — a mesma família de IA interna numa configuração mais leve, a um preço mais baixo por resposta. Excelente para conversas de alto volume onde cada crédito conta; tem uma probabilidade ligeiramente maior de pequenos erros do que o Max, por isso, para conversas onde um detalhe errado pode custar uma venda, escolha o Max. Aparece em contas que têm o Max. | | **Pro** | O modelo premium original da Anthropic (Claude Sonnet). Testado em batalha, com anos de histórico de produção. A qualidade está ao nível do Max. | | **Economy** *(descontinuado)* | **Já não disponível para novos Agentes.** Os Agentes que já utilizam o Economy continuarão a funcionar com ele por enquanto, mas a opção não pode ser selecionada novamente após a alteração. Mude para o Max (ou Pro, se o Max não estiver disponível na sua conta). | O **Max** funciona inteiramente na nossa infraestrutura — sem chaves de API de terceiros para gerir, sem limites de taxa com que se preocupar e sem faturas externas inesperadas — e é o escalão mais económico. Está disponível em contas elegíveis; para todos os outros, o escalão Standard (Pro) é a predefinição. **Mini** aparece logo abaixo do Max em contas elegíveis. Funciona na mesma infraestrutura que o Max a um preço por ação mais baixo — a contrapartida é uma pequena redução na precisão em questões factuais complexas. Para consultar os preços exatos por ação de ambos, veja o guia do [Sistema de Faturação](../billing/billing-system.md). O **Pro** continua disponível para utilizadores que pretendam especificamente o modelo original da Anthropic com anos de experiência em produção. Em termos de qualidade, o Max e o Pro são intercambiáveis para a grande maioria dos casos de uso. Se já utiliza o Pro e está satisfeito, não há motivo para mudar. Pode alterar os escalões a qualquer momento com base na sua preferência de custo/qualidade. **O Economy está descontinuado.** Foi substituído pelo Max, que utiliza um modelo de nova geração. Os Agentes Economy existentes não são afetados — continuam a funcionar com o Economy até alterar o escalão — mas a opção Economy no seletor aparece a cinzento, a menos que o Agente já a esteja a utilizar. Assim que mudar um Agente para Pro ou Max, não pode voltar ao Economy. > **"Pro" aqui é um nível de Qualidade de IA, não um plano de subscrição.** Define apenas o custo de uma ação de IA; não tem qualquer relação com o plano em que se encontra. Para o custo exato em créditos de cada nível, consulte o guia do [Sistema de Faturação](../billing/billing-system.md). --- ## Limites de Mensagens do Bot Cada Agente tem uma definição de **Mensagens de IA Máximas** (em **Limites de Resposta**) que limita o número de respostas de IA que o bot pode enviar a um único contacto antes de fazer uma pausa: - **Predefinido**: 20 respostas de IA por contacto - **Configurável** para valores mais elevados, ou ilimitado quando o seu plano o permite - **Quando o limite é atingido**: O bot é pausado para esse contacto. Numa conta direta, receberá um **e-mail e uma notificação push** para que um humano possa assumir a conversa. **Contas geridas:** este alerta segue as definições de notificação do seu fornecedor, por isso, se tiverem esses e-mails desativados, não será enviado qualquer e-mail. Esta é uma rede de segurança para que um único contacto demasiado falador não esgote os seus créditos indefinidamente. Apenas as respostas da IA contam para este limite, não as mensagens recebidas do contacto. Separadamente, alguns planos têm um limite rígido sobre quantas respostas de IA são possíveis por chat. Quando **esse** limite é atingido, o bot simplesmente para de responder a esse contacto — sem qualquer e-mail. Pode continuar a enviar mensagens ao contacto manualmente. | Funcionalidade do Plano | Limite Rígido | |-------------|------------| | 20 respostas por chat | Até 20 respostas por contacto | | 50 respostas por chat | Até 50 respostas por contacto | | 100 respostas por chat | Até 100 respostas por contacto | | Respostas ilimitadas | Sem limite rígido | Assim que o limite rígido é atingido para um contacto específico, o bot para de responder automaticamente. --- ## Orçamento de Instruções do Bot (Quanto Pode Escrever) O **Orçamento de Contexto** apresentado no separador Instruções de IA é um orçamento de caracteres que distribui pela maioria dos campos de instrução do seu bot — persona, objetivo, informações da empresa, e assim por diante. Um nível de 20K significa aproximadamente 20.000 caracteres no total nesses campos (cerca de 3.000-4.000 palavras). Isto refere-se à quantidade que pode *escrever* nas suas instruções, e não à quantidade da conversa que o bot memoriza — o bot vê sempre o histórico recente da conversa, independentemente do nível, e as conversas muito longas são automaticamente resumidas em segundo plano sem custos adicionais. **Cada campo de instrução nas quatro secções acima conta para o orçamento**, incluindo Regras e Fluxo de Conversação. O que não conta é a sua **base de conhecimento** — FAQs, documentos importados, detalhes de produtos e preços, tudo reside separadamente e nunca afeta este orçamento. Esse é o local ideal para material de referência volumoso e específico do cliente: a IA apenas extrai as entradas relevantes para cada conversação, pelo que a sua base de conhecimento pode crescer muito para além do seu orçamento de caracteres. | Funcionalidade do Plano | Orçamento Total de Caracteres | |-------------|------------| | Contexto de 20K | Cerca de 20.000 caracteres em todos os campos de instrução | | Contexto de 50K | Cerca de 50.000 caracteres | | Contexto de 75K | Cerca de 75.000 caracteres | | Contexto de 100K | Cerca de 100.000 caracteres | A opção que recebe depende do seu plano. Todos os três planos vendidos atualmente — Business, Agency e Agency Unlimited — incluem os 100.000 caracteres completos. Nos níveis vitalícios do AppSumo, o orçamento aumenta conforme o nível: 20.000 no Plano 1, 50.000 no Plano 2, 75.000 no Plano 3 e os 100.000 completos a partir do Plano 4. O seu valor é o que aparece no medidor de Orçamento de Contexto. Para a maioria dos Agentes, 20.000 caracteres são mais do que suficientes. Como lembrete, os orçamentos pretendem ser generosos — um manual simples e focado, bem abaixo do limite, tem um desempenho superior a um que o preenche na totalidade. Não precisa de contar por si próprio. Enquanto edita as suas instruções, uma barra mostra quanto do seu orçamento já utilizou ("12 340 / 50 000 caracteres utilizados"). Fica cor de âmbar à medida que se aproxima do limite e vermelha quando está quase a esgotar, e conta todos os campos de instruções em conjunto, em vez de cada um separadamente. --- ## Quanto da conversa a IA recorda A IA lê a conversa recente na íntegra sempre que responde — o suficiente para cobrir quase todas as conversas reais do início ao fim. As mensagens mais antigas também não são descartadas. Quando uma conversa se torna muito longa, a plataforma resume a parte mais antiga em segundo plano e a IA continua a utilizar esses resumos juntamente com as mensagens recentes, para que continue a saber o que foi acordado há semanas. O Mini funciona com uma memória de conversação mais leve do que o Max — isso faz parte do seu preço mais baixo — e mudar um Agente de volta para o Max restaura a memória completa imediatamente. A duração da conversa nunca altera o que paga: uma resposta da IA custa a mesma taxa fixa de créditos, quer a conversa tenha 10 mensagens ou 1.000. Não há nada para configurar — a memória não é uma definição. --- ## Editar o Manual de Instruções como um Bloco de Texto Depois de escrever um manual de instruções de que gosta, não precisa de o escrever novamente para o Agente seguinte, nem precisa de editar campo a campo se preferir trabalhar num editor de texto. Clique em **Editar como Texto** na parte superior do separador Instruções de IA para mudar dos campos estruturados para um bloco de texto simples, com cada secção sob o seu próprio cabeçalho `#`: ``` #personality Friendly, direct, never pushy... #goal Book a demo call... ``` Isto significa que também pode copiar todo o bloco, editá-lo em qualquer editor de texto ou documento e, em seguida, colá-lo novamente — útil para copiar um manual de instruções de que gosta para um novo Agente. Clique em **Editar como Campos** para voltar atrás. Antes de qualquer gravação, ser-lhe-á mostrado exatamente que secções seriam alteradas — nada é escrito até confirmar. Qualquer cabeçalho que não seja reconhecido é sinalizado em vez de ignorado silenciosamente, pelo que um erro de digitação num cabeçalho não pode apagar uma secção sem aviso. --- ## Como Funcionam os Créditos de IA A plataforma utiliza um sistema de créditos simples para monitorizar a utilização da IA: **O que consome créditos - a taxa é o nível de Qualidade da IA do seu Agente (Pro 1 crédito, Max 0,25, Mini 0,15, Economy 0,5, e 0 com a sua própria chave Anthropic, exceto Max e Mini, que faturam sempre 0,25 e 0,15):** - Cada vez que a IA gera uma resposta (um ciclo de "pensamento", mesmo que envie várias bolhas de mensagem) - Cada vez que a IA utiliza uma ferramenta (como marcar uma reunião, pesquisar no seu site ou chamar uma função personalizada) - Cada vez que a IA realiza uma tarefa em segundo plano (como extrair o nome de um contacto ou avaliar a conversa) **O que NÃO custa créditos:** - Enviar uma mensagem manualmente - Receber mensagens de contactos - Mensagens de modelo (estas têm o seu próprio custo separado) **Créditos incluídos no seu plano:** O seu plano inclui um conjunto de créditos de IA. O mosaico Subsídio Mensal em **Definições → Faturação** é o único valor oficial para a sua conta. Pode comprar créditos adicionais a qualquer momento ou ativar a **recarregamento automático** para que o seu bot nunca fique sem créditos a meio de uma conversa. **Traga a Sua Própria Chave (BYOK):** O BYOK permite-lhe ligar a sua própria chave de API da Anthropic (um código privado da Anthropic que permite à sua conta enviar pedidos diretamente para o serviço de IA deles) para que as respostas da IA sejam faturadas diretamente na sua conta Anthropic em vez de consumirem créditos da plataforma. Se o BYOK estiver ativado na sua conta, pode configurá-lo em **Definições → Avançadas → Chaves de API BYOK**. Os custos de infraestrutura do canal (como a taxa mensal de proxy do WhatsApp Web ou as taxas de entrega de mensagens do WhatsApp) continuam a aplicar-se. --- ## Testar o seu Bot em Experimentar Antes de entrar em funcionamento, teste sempre o seu bot no separador **Experimentar**. Simula uma conversa real para que possa ver exatamente como o seu bot se comportará. **Como utilizar:** 1. Abra o Agente. 2. Clique no seu passo **Experimentar** — o último no editor. 3. Escreva uma mensagem na caixa de entrada na parte inferior, como se fosse um cliente real. 4. Prima Enter. O bot responde utilizando a configuração completa do Agente (instruções, FAQs, tom, modelo, tudo). 5. Se uma resposta não estiver correta: volte ao separador **Instruções de IA** ou ao separador **FAQs e Conhecimento**, faça as suas alterações e clique em **Guardar**. 6. Volte a **Experimentar** e teste novamente. As alterações guardadas aplicam-se à conversa de teste imediatamente — mas **ainda não estão em direto**: as conversas reais continuam a utilizar a sua configuração anterior enquanto testa. 7. Repita até estar satisfeito com as respostas. 8. Clique em **Publicar para o live** no banner âmbar no topo do editor. Esse é o momento em que as suas alterações entram em vigor para os clientes reais. Mudou de ideias? **Descartar** no mesmo banner repõe tudo para a configuração em direto. **O que testar:** - Perguntas comuns que os seus clientes fazem - Casos limite (perguntas fora do tópico, texto sem sentido, menções a concorrentes) - Se o bot alerta corretamente um humano quando deve fazê-lo - Fluxos de marcação de agendamentos (se aplicável) - Se o bot se mantém dentro dos limites que definiu O Experimentar utiliza exatamente a mesma IA que as conversas em direto, pelo que o que vê nos testes é o que os seus contactos irão experienciar. --- ## Dicas para Obter os Melhores Resultados 1. **Preencha tudo.** Quanto mais informações der ao bot (informações da empresa, FAQs, recursos), melhor será o seu desempenho. Não deixe secções vazias. 2. **Estruture as suas instruções claramente.** Utilize listas numeradas e secções claras. A IA segue instruções estruturadas muito melhor do que parágrafos longos. 3. **Adicione FAQs para perguntas comuns.** Se os contactos continuam a fazer as mesmas perguntas, adicione-as como FAQs. O bot encontra automaticamente a FAQ correta para cada pergunta. Consulte [Gestão de FAQs](faq-management.md). 4. **Utilize "Outras informações" para conhecimento temporário ou específico de um nicho.** O campo encontra-se na secção **Contexto extra** do separador FAQs e Conhecimento. Vai realizar uma promoção esta semana ou visar uma indústria específica? Adicione esse contexto aí para que o bot saiba sem ter de alterar as suas instruções permanentes. 5. **Adicione links de recursos.** Inclua links para o seu website, página de preços, página de reservas ou catálogo de produtos. O bot partilha-os naturalmente durante as conversas. 6. **Reveja as conversas regularmente.** Verifique as suas conversas em direto para ver como o bot se está a comportar. Se este lidar mal com algo, atualize as suas instruções ou FAQs. 7. **Utilize "Otimizar com IA".** Clique nesta opção no cabeçalho do painel Experimentar, descreva o que deve ser melhorado (ou dê um "gosto negativo" a uma resposta que não atingiu o objetivo) e reveja a reescrita proposta lado a lado antes de aceitar qualquer alteração. Funciona com base no que lhe indica, não nas suas conversas em direto anteriores. Para essas, leia os seus [Resumos Diários](../daily-summaries/daily-summaries.md) e traga as conclusões para aqui. Consulte [Otimizar com IA](../chats/playground.md#optimize-with-ai). 8. **Configure a etiquetagem automática para ações chave.** A etiquetagem automática encontra-se no passo **Etiquetas** do próprio Agente. Clique em **+ Adicionar Etiqueta** e preencha dois campos por etiqueta: um **Nome da Etiqueta** (por exemplo, `booked`) e uma **Descrição da Etiqueta e Quando Atribuir** (por exemplo, "Atribuir esta etiqueta quando o contacto confirmar uma marcação com uma data e hora específicas"). O bot utiliza a sua descrição como regra e aplica a etiqueta automaticamente quando uma conversa corresponde. As etiquetas que cria aqui podem então acionar webhooks (notificações automáticas enviadas para outra aplicação ou sistema) ou alterações de fase de negócio noutros locais da plataforma. 9. **Se estiver a utilizar marcações com IA, instrua o bot a pedir o e-mail do contacto ANTES de marcar.** Caso contrário, o convite do Google Calendar não tem ninguém para quem enviar a confirmação e o contacto nunca recebe a ligação para a reunião. Adicione um passo ao seu **Fluxo de Conversação** como: "Antes de marcar qualquer reunião, peça ao contacto o seu endereço de e-mail e confirme-o de volta." 10. **Vai mudar o nome de algo em todo o playbook?** Se mudar o nome de uma linha de produtos, de um escalão de preços ou de um membro da equipa, precisa de atualizar todas as referências ao mesmo em todo o playbook, instruções, FAQs e recursos. Duas formas de lidar com isto: - **Mude para Editar como Texto.** Copie o texto do playbook para uma ferramenta como Notas, Word ou VS Code e utilize a função localizar e substituir. Cole-o de volta quando terminar. - **Utilize "Otimizar com IA".** A IA reescreverá o playbook por si, mas isto **custa créditos** — por isso, guarde-o para reestruturações maiores, não para mudanças de nomes de uma única palavra. 11. **Não despeje todo o conteúdo do blog no playbook ou nas FAQs.** É tentador colar todas as publicações de blog, white papers ou apresentações de vendas que tem, mas **o excesso de contexto prejudica a precisão**. A IA funciona melhor quando o playbook é focado e as FAQs são diretas. Se tiver vários objetivos muito diferentes — vendas, suporte, marcações, recrutamento — **crie vários Agentes**, em vez de sobrecarregar um único bot com tudo. Cada Agente especialista terá um desempenho superior a um generalista gigante. 12. **Se escrever mensagens de exemplo, escreva-as em todos os idiomas que serve.** As frases de exemplo são a influência mais forte na forma como o seu bot escreve — ele copia a sua redação muito mais de perto do que segue uma regra escrita. Portanto, se todos os seus exemplos estiverem num idioma, o bot voltará a esse idioma a meio da conversação. Isto acontece mesmo quando lhe disse para corresponder ao idioma do contacto, e mesmo depois de ter respondido corretamente durante várias mensagens. O sinal revelador é que ele muda exatamente num passo para o qual escreveu um exemplo (confirmar detalhes, oferecer horários de reunião), enquanto as partes de formato livre permanecem no idioma correto. Ou forneça cada exemplo em todos os idiomas que suporta, ou reduza-os a esqueletos curtos e adicione uma linha como "estes exemplos estão escritos em catalão — escreva sempre no idioma do contacto." Faça o mesmo para qualquer mensagem de transferência ou de reserva que tenha escrito. 13. **Esteja atento a instruções que conflituam com uma definição.** Algumas coisas são controladas por uma definição, não pelas suas instruções, e a definição ganha sempre. O caso mais comum: escrever "nunca divida uma resposta em duas mensagens" enquanto **Max Chunks** está definido para 6. Se pretende mensagens únicas, defina Max Chunks para 1 — consulte [Definições de Resposta](#making-your-bot-feel-human-response-settings). --- ## Perguntas Frequentes **Editei o Agente — porque é que nada mudou?** Guardar uma edição já não a coloca em direto — guarda um rascunho que apenas a conversa **Experimentar** utiliza. Quando existe um rascunho não publicado, aparece um banner âmbar no topo do editor; clique em **Publicar para o live** aí e a alteração entra em vigor imediatamente em todos os locais onde o Agente é utilizado. **Podem dois Agentes partilhar a mesma biblioteca de FAQ, mas responder a partir de partes diferentes da mesma?** Sim — as FAQ residem na sua biblioteca partilhada e são associadas por Agente, pelo que cada Agente pode associar o seu próprio conjunto. Consulte [Gestão de FAQ](faq-management.md#global-faqs-vs-agent-specific-faqs). **O meu agente de Japonês colocou um caractere chinês numa resposta. Tenho de corrigir isso eu mesmo?** Não. As respostas em Japonês são verificadas antes de serem enviadas e uma resposta que contenha um caractere exclusivo do Chinês é regenerada uma vez com uma correção, nos níveis Max e Mini. Mantenha o **Idioma principal** do agente em Japonês e escreva as suas mensagens de exemplo também em Japonês — a IA copia o idioma dos seus exemplos mais fielmente do que qualquer regra que escreva. Consulte [Idioma principal](#setting-up-your-bot-step-by-step) acima. **O meu Agente ainda não está a responder a ninguém — posso testá-lo e melhorá-lo na mesma?** Sim, tudo. O chat **Experimentar** funciona no próprio Agente, pelo que um Agente acabado de criar pode ser testado no momento em que escreve a sua primeira instrução, e a funcionalidade **Otimizar com IA** e o polegar para baixo em cada resposta também funcionam aí. O que decide que conversas reais chegam ao Agente são os seus **Pontos de Entrada** — consulte [Pontos de Entrada](../ai-agents/entry-points.md). --- ## Próximos Passos - [Agentes de IA](../ai-agents/ai-agents.md) — o que é um Agente e como os separadores se encaixam. - [Gerir FAQs](faq-management.md) — dê ao seu Agente respostas prontas a usar. - [Porque é que o Max é a melhor relação qualidade-preço](ai-model-comparison.md) — o argumento completo a favor do escalão Max. - [Modelo de IA & BYOK](ai-model-and-byok.md) — traga a sua própria chave Anthropic.