Clef
Cloudflare · Negócios · Outros
Clef é o modelo de decisão open source da Cloudflare para o Workers AI. Devolve probabilidades calibradas para perguntas tipadas em vez de texto, então o agente classifica, roteia e age rápido.
Sobre Clef
About
O que é o Clef
Clef é um modelo de decisão. Ele responde perguntas de sim ou não e de múltipla escolha com probabilidades, não com parágrafos. Você entrega um estado (um ticket de suporte, um registro JSON, um print de tela) e um esquema de perguntas tipadas, e recebe um número para cada opção permitida.
A Cloudflare treinou duas versões. O Clef tem 27 bilhões de parâmetros e janela de 65.536 tokens. O Clef-flash cai para 9 bilhões e 24.576 tokens, feito para decisões que ficam no caminho crítico de um agente. Os dois leem texto, JSON e imagens, e os dois rodam no Workers AI atrás de um único endpoint.
A vantagem está em latência e custo. Um LLM geral precisa gerar tokens antes de responder, e esse texto ainda passa por um parser. O Clef pontua as respostas válidas em uma única passada: não existe saída para interpretar nem token de saída para pagar. A Cloudflare mediu 209,3 ms de latência mediana no Clef e 38,8 ms no Clef-flash, contra 524,1 ms do Jev, o modelo que abriu essa categoria.
O limite é o escopo. O Clef só escolhe entre as opções que você define. Faça uma pergunta que o seu esquema não cobre e ele devolve uma resposta confiante para a pergunta errada. Ele também não explica o raciocínio, então a lógica precisa morar no seu código e nos seus logs.
Primeiros passos
- Abra uma conta na Cloudflare e ative o Workers AI. Os identificadores são
@cf/cloudflare/clefe@cf/cloudflare/clef-flash. - Monte o estado que será avaliado: uma string, um objeto JSON ou até quatro imagens colocadas antes do estado.
- Defina de uma a 64 perguntas com o tipo de cada uma:
noulpara probabilidade entre 0 e 1,choicepara um conjunto de opções nomeadas escorepara uma escala ordenada. - Envie a requisição por um binding de Workers ou pelo endpoint REST e leia
answerspara rotear, escalar ou passar o caso para uma pessoa. - Se precisar de isolamento total, baixe os pesos Apache 2.0 do Hugging Face e rode nas suas próprias GPUs.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Clef.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Engenheiros de backend e plataforma
- Times de confiança e segurança
- Coordenação de suporte
Tarefas
- Roteamento de tickets
- Classificação de conteúdo
- Decisão de agente
- Inspeção visual
Cenários
- O checkout quebra para todo mundo
- Rastreadores julgados em massa
- Um fluxo que já chama um endpoint Jev
Principais recursos
Perguntas tipadas com probabilidades
Cada requisição é um esquema. Você define os identificadores das perguntas, escolhe noul, choice ou score e escreve os critérios. O Clef devolve uma probabilidade por opção, o que deixa o seu serviço definir o próprio limite em vez de aceitar um rótulo único. Essas saídas estruturadas entram direto num switch, sem conversão no meio. A distribuição também mostra quando o modelo está dividido entre duas respostas, justamente a hora de uma pessoa olhar.
Entrada multimodal
O Clef aceita imagens além de texto e JSON. Até quatro arquivos PNG, JPEG ou WebP podem vir antes do estado: print da página de pagamento, foto de encomenda avariada ou painel de métricas. Cada imagem para em 1.024 tokens, e esses tokens contam dentro da janela de contexto.
Dois tamanhos para dois orçamentos de latência
O modelo de 27B é a escolha de precisão: 98,47 no BFCL e 94,20 de macro-F1 no BANKING77 nos testes da Cloudflare. O Clef-flash troca parte dessa exatidão por velocidade, com 38,8 ms de mediana e preço bem menor. O caminho comum é começar pelo Clef-flash e levar para o modelo grande só as perguntas em que o erro sai caro.
API compatível com Jev
O formato de requisição e resposta segue a System One API que o Jev popularizou. Quem já tem uma chamada Jev troca o identificador do modelo e mantém o código de leitura. Essa compatibilidade serve para comparar dois modelos sem reescrever o fluxo.
Pesos abertos em Apache 2.0
Os dois modelos estão no Hugging Face com licença Apache 2.0. Dá para inspecionar os pesos, rodar localmente e manter tráfego sensível fora da rede de terceiros. Em setores regulados, essa opção pesa mais do que qualquer lista de recursos.
Ajuste fino com a Cloudflare
A Cloudflare mantém um time de engenharia alocado no cliente que adapta o Clef às suas decisões rotuladas, e prepara um produto de aprendizado por reforço sobre AI Gateway, Workers AI e Containers. O ajuste fino reduz um pouco a precisão geral, então faz sentido quando existe anos de resultados rotulados em um domínio estreito.
Prós e contras
Prós
- As decisões voltam em cerca de 200 ms no Clef e abaixo de 40 ms no Clef-flash, o suficiente para caber numa requisição real e não num job em segundo plano.
- Você paga apenas tokens de entrada. Não há token de saída no orçamento e a tarifa começa em US$ 0,038 por milhão.
- O codificador visual lida com prints e digitalizações, um passo além dos modelos de decisão só texto que vieram antes.
- Pesos abertos e API compatível com Jev dão rota de saída: auto-hospedar ou trocar de provedor sem mexer no código da aplicação.
Contras
- O Clef não escreve texto nem mostra o raciocínio. Tudo que exige explicação, resumo ou chamada de ferramenta continua sendo trabalho de um LLM.
- A exatidão depende do seu esquema. Uma opção que falta, um critério vago ou dois rótulos sobrepostos geram uma resposta errada com toda a confiança, e nada na resposta avisa.
- Ele não vence todas as provas. O Jev pontuou mais no When2Call e no BRIGHT na comparação da própria Cloudflare, então vale reservar uma hora de teste com os seus dados.
- O ajuste fino self-service ainda não existe. O treino personalizado passa por um projeto com a engenharia da Cloudflare, o que hoje exclui times pequenos.
Perguntas frequentes
Clef é uma família de modelos de decisão da Cloudflare. Ele lê um estado e um conjunto de perguntas tipadas e devolve uma probabilidade para cada resposta permitida. A Cloudflare publica duas versões, Clef e Clef-flash, e hospeda as duas no Workers AI.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Clef.
Alternativas a Clef
Knocket
Knocket (Tencent RTC team) · Produtividade · Negócios · ChatbotO Knocket é uma ferramenta gratuita de chat ao vivo e página de contato: o visitante escreve pelo site, pelo app ou por um link, e você responde pelo Telegram ou por uma única caixa de entrada.
shippedit.me
Krawlup · Marketing · NegóciosO shippedit.me agora redireciona para o Krawlup, uma plataforma web que audita SEO, AEO e velocidade toda semana e entrega as correções a agentes de código via MCP.
Ayven
Alknoma · Produtividade · NegóciosAyven é uma central de controle de IA da Alknoma: transforma um objetivo escrito em linguagem comum num plano com datas, distribui as tarefas entre o time e os agentes de IA e pede sua aprovação só quando a decisão cabe a você.