Modelo de IA e BYOK #

Esta página explica que modelo de IA alimenta o seu bot, por que razão apenas um fornecedor é suportado para BYOK (Bring Your Own Key) e como configurar a sua própria chave, caso o seu plano o inclua.

Que Modelo de IA Alimenta o Bot #

A plataforma utiliza o Anthropic Claude como o modelo principal para o seu bot. O Claude foi escolhido porque, após testes exaustivos em todos os principais modelos de fronteira (termo da indústria para os modelos de IA mais avançados disponíveis) no mercado, é o único que lida com o volume de mensagens de produção de forma fiável.

Não precisa de escolher um modelo. A plataforma seleciona automaticamente o modelo certo para cada tarefa e mantém o custo por conversação baixo.

Por que Apenas Anthropic para BYOK #

Os clientes perguntam frequentemente se iremos adicionar suporte para OpenAI, Google Gemini, OpenRouter ou modelos de código aberto para BYOK. A resposta honesta é: nenhum deles, quando utilizados de forma bruta e não otimizada, aguenta o volume de produção.

Para um pequeno projeto, uma taxa de sucesso de 9 em 10 por parte de uma IA é aceitável. Assim que estiver a realizar conversas reais com clientes em escala, uma taxa de falha de 10% significa reservas interrompidas, respostas erradas, seguimentos perdidos e vendas perdidas. Isso está na ordem de grandeza do que vemos mesmo nos modelos de fronteira de topo de outros fornecedores (aproximadamente 6–10% em casos limite adversários, ou seja, perguntas de teste complicadas e deliberadamente difíceis) — e isto antes de considerar os modelos mais baratos.

Os problemas dividem-se em três categorias:

• Casos limite falham de forma imprevisível. Um modelo pode funcionar perfeitamente durante centenas de chats e, de repente, alucinar uma chamada de ferramenta, afirmar que fez algo que não fez ou ignorar instruções a meio da conversação.
• O contexto longo é mal gerido. Uma única resposta do bot utiliza o histórico de chat, FAQs, lógica de seguimento, chamadas de ferramentas e raciocínio. A maioria dos modelos bloqueia com este volume e produz resultados de pior qualidade.
• “Mais barato” raramente o é. O preço de tabela mais baixo por token é compensado por mais tentativas, mais tokens de saída e pior conversão. O custo real por conversação bem-sucedida acaba por ser mais elevado.

Suportar 100 modelos diferentes é mais uma estratégia de marketing do que uma capacidade real. Preferimos oferecer-lhe um fornecedor que funcione de forma fiável do que cinco que falham, cada um à sua maneira.

Max #

Max foi criado para as conversações de vendas e apoio que a plataforma realmente executa. Custa uma fração do preço do Pro (0,25 créditos por ação) e mantém a precisão onde um modelo económico falha.

O Max não necessita de configuração: não há escolha de modelo, não há conta de fornecedor, não há chave. É o modelo mais preciso que disponibilizamos e o melhor a manter-se fiel ao que a sua empresa realmente diz. Para saber como o Max se compara ao Claude e aos modelos económicos de terceiros sobre os quais os clientes perguntam frequentemente, consulte Por que razão o Max é a melhor relação qualidade-preço.

Quem vê o nível Max #

Se o seletor de Qualidade de IA no separador Instruções de IA do seu Agente mostrar Pro mas não Max ou Mini, o Max simplesmente não está ativado na conta em que tem sessão iniciada. Duas coisas ativam-no:

• As contas num plano vitalício elegível obtêm o Max automaticamente.
• Qualquer outra conta precisa que o Max seja ativado explicitamente.

Numa conta fornecida por uma agência, o seu fornecedor pode ter escolhido o modelo por si. Se o seletor de Qualidade de IA mostrar apenas um cartão e não houver nada para onde mudar, isso é uma definição deliberada na sua conta, não uma falha — peça a quem fornece a sua conta para a alterar. Se um cartão continuar a ser apresentado com uma nota de que já não está disponível, o seu Agente está num modelo que o seu fornecedor removeu entretanto: ele continua a responder, mas num dos modelos que eles permitem, por isso escolha um desses para que o seletor corresponda ao que está realmente em execução.

Ligar a sua própria chave Anthropic (BYOK) não tem nada a ver com a visibilidade do Max. Ambos funcionam lado a lado — consulte a nota de exceção em Configurar BYOK para saber como um Agente Max é faturado quando tem uma chave ligada. Remover a sua chave API não fará com que o Max apareça.

O escalão Mini #

Se consegue ver o Max, também consegue ver o Mini, a 0,15 créditos por ação. O Mini é a mesma IA que o Max a um preço mais baixo, com dois compromissos:

• Uma maior probabilidade de erros. O Mini é o modelo mais leve dos dois. O Max é o modelo mais preciso que disponibilizamos — otimizado ao máximo para se manter fiel ao que a sua empresa realmente diz —, enquanto com o Mini existe uma maior probabilidade de um pequeno erro ou alucinação surgir numa resposta.
• Memória mais leve. Em conversas longas, o Mini recorda menos mensagens antigas e utiliza menos fragmentos da base de conhecimento por resposta.

O Max continua a ser a escolha recomendada para tudo onde um detalhe incorreto possa custar uma venda — reservas, questões de preços, apoio com riscos reais. O Mini adequa-se a conversas de alto volume e sensíveis ao preço, onde a velocidade e o custo importam mais do que a última percentagem de precisão.

O Mini encontra-se no mesmo seletor de Qualidade de IA que o Max, em todas as contas que possuem o Max. Tal como o Max, o Mini nunca utiliza uma chave BYOK, pelo que uma chave Anthropic ligada não é utilizada (nem faturada) enquanto um Agente estiver no Mini.

O que a tarifa Mini de 0,15 cobre. O preço Mini aplica-se a tudo o que acontece dentro de uma conversa em direto: respostas de IA, chamadas de ferramentas de IA (como marcar uma reunião ou alertar um humano), avaliações de chat (decidir se uma conversa deve ser ignorada ou fechada), gestão de interrupções (quando um contacto envia uma nova mensagem enquanto o bot ainda está a compor a sua resposta), resumos de chat e etiquetagem automática por IA. Funcionalidades de IA pontuais fora da conversa — otimização de agentes (Otimizar com IA), geração de base de conhecimento e etiquetagem feita através da API — têm uma tarifa fixa única de 0,25 créditos tanto no Max como no Mini, pelo que poderá ver entradas ocasionais de 0,25 no seu histórico de créditos, mesmo quando todos os Agentes estão definidos para Mini. Trata-se dessas funcionalidades, e não do modelo Max a responder aos seus chats.

Configurar BYOK #

O BYOK está incluído nos planos Agency e Agency Unlimited, e nos níveis vitalícios do AppSumo a partir do Plan 2. Não faz parte do plano Business. Se o seu plano o incluir, pode ligar a sua própria chave de API da Anthropic (um código privado da sua conta Anthropic que permite à plataforma cobrar a utilização de IA diretamente a si, em vez de utilizar créditos da plataforma).

Apenas as chaves oficiais da Anthropic funcionam. Uma chave válida provém da sua própria conta em console.anthropic.com e começa sempre por sk-ant-. Chaves de revendedores, proxies ou sites de “API Claude com desconto” (que começam frequentemente com um prefixo diferente) não são suportadas e não serão guardadas. Tenha cuidado com ofertas de tokens Claude baratos muito abaixo dos preços da própria Anthropic — ninguém pode revender legitimamente o acesso ao Claude abaixo do que a Anthropic cobra, e essas ofertas são quase sempre burlas baseadas em chaves roubadas ou criadas para obter os seus dados de pagamento através de phishing.

Está num telemóvel? A barra lateral esquerda pode estar oculta. Toque primeiro no ícone de menu (☰) e, em seguida, toque em Definições.

Não vê as Chaves API BYOK no grupo Avançadas? A secção apenas aparece em planos que incluem BYOK. Se a sua conta for gerida por um fornecedor, esta só aparece quando este tiver ativado a opção Trazer a Sua Própria Chave API para a sua conta.

1. Na barra lateral esquerda principal, clique em Definições (o ícone de engrenagem perto da parte inferior).
2. Na página de Definições, no menu esquerdo, desloque-se até ao grupo Avançadas.
3. Clique em Chaves API BYOK.

4. Clique em Add key no cartão da Anthropic. Irá aparecer um campo Secret key (espaço reservado sk-ant-…).

5. Cole a sua chave API da Anthropic no campo e, em seguida, clique em Save key.

Uma vez ativados, os Agentes no nível de Qualidade de IA Pro utilizam a sua própria chave para as suas respostas, e paga diretamente à Anthropic por essa utilização em vez de gastar créditos da plataforma nessas respostas. Os Agentes nos níveis Max ou Mini nunca utilizam a sua chave e continuam a utilizar créditos (veja a exceção abaixo). A infraestrutura de canais (servidores WhatsApp Web, números de telefone, etc.) continua a utilizar créditos como habitualmente.

Uma exceção — o nível Max. Se a Qualidade de IA de um Agente estiver definida para o nível Max, esse Agente é faturado a 0,25 créditos por ação, mesmo quando tem o BYOK ligado — o nível Max nunca utiliza a sua chave Anthropic. (O mesmo se aplica ao Mini, onde disponível: 0,15 créditos por ação, nunca a sua chave.) Para faturar as respostas na sua própria conta Anthropic, mantenha o Agente no nível Pro. Os níveis são Max, Pro e Mini; não existe um nível Standard separado. O seletor de Qualidade de IA encontra-se no separador Instruções de IA de cada Agente. A página de definições Chaves API BYOK apresenta um aviso sempre que a sua chave está registada, mas um ou mais dos seus Agentes ainda estão a funcionar no nível Max, listando quais — para que possa identificar rapidamente o motivo pelo qual os créditos ainda estão a ser utilizados.

Uma nota sobre custos: Trazer a sua própria chave já não é a opção mais barata. Com uma chave ligada, o seu Agente funciona com o Claude e paga diretamente as tarifas medidas da Anthropic (a Anthropic fatura com base no que realmente utiliza, semelhante a uma fatura de serviços públicos). Medido nas contas que utilizam a sua própria chave, uma resposta de IA custa aproximadamente 3 vezes o que a mesma resposta custa no Max e mais de 5 vezes o que custa no Mini, assim que contabiliza o trabalho de fundo que uma resposta desencadeia (pesquisa na base de conhecimento, verificação de spam, extração de nome e e-mail, avaliações de chat, etiquetagem), tudo o que está incluído na tarifa fixa do Max e do Mini, mas faturado por token na sua chave. O Max e o Mini são simplesmente muito mais baratos, e o Max é também o modelo mais preciso que disponibilizamos. Utilize BYOK quando pretender especificamente que a utilização da IA seja faturada na sua própria conta Anthropic, e não para poupar dinheiro.

Por que a primeira resposta numa conversa custa muito mais do que as restantes. O armazenamento em cache funciona ao guardar o contexto da conversa com a Anthropic na primeira vez que é enviado, reutilizando-o depois. Escrevê-lo custa mais do que um pedido normal; cada resposta que o reutiliza custa cerca de um vigésimo. Por isso, a primeira resposta parece alarmantemente cara e as que se seguem são muito baratas. Qualquer elemento grande na conversa torna essa primeira resposta maior — um documento que um visitante carrega é o principal exemplo. Um PDF de 24 páginas perfaz cerca de 70 000 tokens, porque cada página é enviada tanto como texto como sob a forma de imagem, e permanece na conversa, pelo que é reenviado (e re-armazenado em cache) a cada resposta. Se uma conversa ficar inativa durante mais de uma hora, a cópia armazenada expira e a resposta seguinte volta a pagar o custo de escrita.

Se está a criar algo que envolve muitos documentos — explicadores de contratos, consultas de manuais, qualquer situação em que as pessoas carreguem ficheiros — o nível Max é geralmente a melhor opção: tem um custo fixo de 0,25 créditos por resposta, independentemente do tamanho do documento, pelo que não existe um pico na primeira mensagem nem qualquer exposição por token. Consulte Por que o Max é a melhor relação qualidade-preço para saber como o Max se compara em termos de qualidade e custo.

Se a sua chave BYOK falhar (inválida, sem quota ou com limite de taxa — o que significa que a Anthropic limitou temporariamente o número de pedidos que a sua chave pode fazer), o facto de o seu bot continuar a funcionar depende do interruptor “Recurso a créditos” na mesma página de Chaves API BYOK:

• Ligado: a plataforma recorre temporariamente aos créditos da plataforma para que o seu bot continue a responder, e continua a tentar utilizar a sua chave em segundo plano — no momento em que uma chamada é bem-sucedida novamente, o sistema muda automaticamente de volta para a sua própria chave.
• Desligado (a predefinição): as respostas da IA são bloqueadas até que corrija a chave. Nada consome os seus créditos silenciosamente, mas o seu bot também deixa de responder, por isso, se preferir que continue a funcionar com créditos enquanto resolve o problema da chave, ative este interruptor com antecedência.

De qualquer forma, receberá um e-mail na primeira vez que a sua chave falhar (não um por mensagem).

Perguntas Frequentes #

Posso utilizar o OpenAI, o Gemini ou outro fornecedor para BYOK? Atualmente, não para outros fornecedores. Para a maioria das pessoas, a resposta já está aqui: Max e Mini, a 0,25 e 0,15 créditos por ação.

A minha chave BYOK será utilizada para tudo? A maioria das operações de IA está isenta de custos de créditos quando a sua própria chave Anthropic (BYOK) está ligada: as respostas de IA, a utilização de ferramentas, a otimização de agentes, a geração de bases de conhecimento e a pesquisa na Web funcionam todas com a sua chave. Quatro coisas continuam a custar créditos mesmo com uma chave ligada: o nível Max a 0,25 créditos por ação e o nível Mini a 0,15 (isto inclui uma importação de base de conhecimento ligada a um Agente definido como Max, a 0,25 por bloco); o Localizador de Leads a 0,25 por endereço de e-mail encontrado; e as Automações a 0,25 por execução mais 0,25 por passo de IA. Para manter um Agente totalmente na sua própria chave a 0 créditos, deixe-o no nível Pro. As taxas de canal (taxa mensal do WhatsApp Web, taxas de entrega e de modelo do WhatsApp por mensagem) são faturadas separadamente da utilização da IA em qualquer dos casos. Se a chave falhar numa chamada que teria sido executada com ela, o facto de a plataforma recorrer a créditos depende do seu interruptor Recorrer a créditos — consulte o interruptor “Recorrer a créditos” descrito acima nesta página.

Quando é que as respostas de IA custam exatamente 0 créditos? O BYOK é por conta. As respostas de IA custam 0 créditos apenas quando esta conta ligou a sua própria chave Anthropic. Sem a sua própria chave, as respostas consomem créditos à taxa normal.

O BYOK afeta a entrega de mensagens ou a fiabilidade do canal? Não. O BYOK apenas altera a forma como as chamadas de IA do seu bot são faturadas. Tudo o resto — encaminhamento de mensagens, infraestrutura de canal, seguimentos e Broadcasts — funciona exatamente da mesma forma.

Veja também: Porque é que o Max é a melhor relação qualidade-preço · Configurar o seu Bot de IA · Agentes de IA