Skip to Content
Modelo de IA

Modelo de IA

Todo agent pensa com um modelo de IA. Os modelos rodam no Workers AI, o serviço de IA da Cloudflare. Por padrão, todos usam o modelo da plataforma — você não precisa escolher nada para o agent funcionar.

Escolher vale quando você quer algo específico: um modelo mais barato para um agent que só responde perguntas simples, um modelo mais forte para o que negocia, ou pagar o uso na sua própria conta Cloudflare.

Onde se escolhe

Em dois lugares, e o de baixo vence o de cima:

OndeVale paraQuando o campo está vazio
Organização (página da empresa)Todos os agents delaUsa o modelo da plataforma
Agent (aba do perfil)Só aquele agentHerda o da organização

Cada campo é independente. Você pode deixar a conta na organização (é ela que paga) e escolher um modelo diferente em um agent só — o agent usa o modelo dele com a conta da empresa.

A lista de modelos

O campo tem uma lista com os modelos do catálogo do Workers AI (os nomes começam com @cf/, por exemplo @cf/openai/gpt-oss-120b). Comece a digitar e ela filtra.

A lista mostra só modelos que sabem usar ferramentas. Isso não é detalhe técnico: é o que permite ao agent consultar a agenda, registrar uma proposta, olhar o cadastro do cliente. Um modelo sem isso responderia bonito e não faria nada — por isso ele nem aparece.

Ao escolher, a tela mostra:

  • o preço de entrada e de saída, por milhão de tokens;
  • “aceita foto” ou “não lê imagens”;
  • o tamanho da janela, que é quanto de conversa o modelo consegue considerar de uma vez;
  • “exige plano pago” quando o modelo só roda em conta Cloudflare com o plano Workers Paid. Na conta da plataforma isso já está resolvido; na sua conta própria, confira o plano antes.

O preço é referência do catálogo, para você comparar modelos. Ele não é a sua fatura: a Cloudflare cobra em neurons, e o relatório de uso e limites continua calculando o custo pela tabela da plataforma.

Cuidado com foto

Se o seu agent atende no WhatsApp, é quase certo que ele recebe fotos: um documento, um print, a foto do produto. Um modelo marcado como “não lê imagens” simplesmente ignora a foto — o cliente manda, o agent responde como se nada tivesse chegado, e ninguém avisa.

A plataforma não impede a escolha, porque um agent que só trabalha com texto é um caso legítimo. Mas se o agent fala com cliente pelo WhatsApp, escolha um modelo que aceita foto.

Conta Cloudflare própria (opcional)

Por padrão, a inferência é paga pela plataforma. Se você preferir pagar direto, use a sua conta Cloudflare no campo “Conta Cloudflare (Workers AI)”, no formato id-da-conta:token:

  1. O id da conta são os 32 caracteres que aparecem no painel da Cloudflare (barra lateral, “Account ID”).
  2. O token é um API token criado em My Profile → API Tokens com a permissão Workers AI dessa conta.
  3. Junte os dois com dois-pontos, sem espaço: 0123…cdef:seu-token.

A partir daí, as conversas daquele escopo são cobradas na sua conta Cloudflare.

Três coisas importam:

  1. A chave nunca volta. Depois de salva, a tela mostra só os quatro últimos caracteres do token. Para trocar, cole o par novo por cima.
  2. Token sem permissão, o agent para. Se o token estiver errado, vencido ou sem a permissão do Workers AI, a Cloudflare recusa e o agent deixa de responder.
  3. “Remover chave” é o primeiro socorro. Ele não apaga nada importante: o agent volta na hora a usar a conta da plataforma.

Se as respostas pararem logo depois de você cadastrar a sua conta, remova a chave. O agent volta a usar a da plataforma e você confere o token e o plano com calma.

Quem tinha cadastrado uma chave do OpenRouter: ela deixou de valer com a mudança para o Workers AI e foi removida. Os agents já estão usando a conta da plataforma; cadastre a sua conta Cloudflare se quiser voltar a pagar direto. Modelos escolhidos que não eram do Workers AI também voltaram para o padrão — escolha de novo na lista.

O que acontece quando o modelo escolhido falha

Se o provedor recusar o modelo que você escolheu (fora do ar, sobrecarregado, sem crédito naquele modelo), o turno cai automaticamente para o modelo da plataforma em vez de morrer. A conversa continua; a resposta pode sair com um jeito um pouco diferente.

Isso vale para o modelo. Não vale para a conta: se o token é que está errado, a tentativa seguinte usa o mesmo token errado.

Trocar de modelo

A troca vale para as próximas mensagens, em até 15 segundos. Nada do que já foi conversado muda, e o histórico continua o mesmo.

Trocar não exige parar o agent nem avisar ninguém. Se o resultado piorar, volte o campo ao anterior — ou apague o conteúdo dele, que é o mesmo que dizer “use o que a empresa usa”.

Quando algo não bate

  • O agent parou de responder logo depois da troca: o modelo pode estar recusando a conta. Volte o campo ao anterior, ou remova a conta própria.
  • O agent parou de “ver” fotos: o modelo escolhido não lê imagens. Troque por um com o selo aceita foto.
  • O agent parece esquecer o começo da conversa: o modelo tem janela menor que o anterior. Escolha um com janela maior.
  • “Modelo desconhecido” ao salvar: o id foi digitado errado, não começa com @cf/ ou o modelo não sabe usar ferramentas. Escolha pela lista em vez de digitar.

Mais em Quando algo dá errado e Uso e limites.