Clef API
A família de modelos de decisão open-source Clef da Cloudflare: Clef (27B) e Clef Flash (9B) transformam estados e perguntas tipadas em decisões probabilísticas.
Clef API
cloudflare/clef
O Cloudflare Clef é um modelo de decisão multimodal de 27B que transforma texto, JSON, imagens ou vídeo em respostas JSON estruturadas baseadas em probabilidades.
Clef API Contexto
Visão Geral
O Clef é a família de modelos de decisão de código aberto da Cloudflare, disponibilizada no Cloudflare Workers AI. Ele transforma um estado e um esquema de perguntas tipadas em decisões, retornando uma probabilidade para cada opção permitida de cada pergunta em uma única etapa direta (forward pass). A família inclui o Clef, um modelo multimodal de 27B com ajuste fino a partir do Qwen3.8-27B, e o Clef Flash, um modelo rápido de 9B com ajuste fino a partir do Qwen3.5-9B.
Histórico de Desenvolvimento
A Cloudflare lançou publicamente os modelos de decisão Clef como modelos de pesos abertos (Apache-2.0). O Clef passa por um pós-treinamento a partir do Qwen3.8-27B com seu codificador de visão mais um cabeçote de esquema conjunto (joint schema head); o Clef Flash é a variante menor e mais rápida, pós-treinada a partir do Qwen3.5-9B. Ambos são disponibilizados no Cloudflare Workers AI.
Principais Inovações
- Uma única etapa direta (forward pass) retorna a probabilidade de cada opção de todas as perguntas
- Cabeçote de esquema conjunto avalia pontuações para todas as opções de todas as perguntas simultaneamente
- Aceita texto, JSON e imagens como entrada
- Sem geração de texto de forma livre e sem necessidade de parsing de saída
- Totalmente compatível com as APIs de decisão Jev e SystemOne
Clef API Especificações Técnicas
Arquitetura
O Clef utiliza o backbone Qwen3.8-27B com seu codificador de visão, armazenado em safetensors divididos (sharded) padrão, acrescido de um cabeçote de esquema conjunto que lê os estados ocultos finais do backbone, direciona evidências do estado para cada pergunta e pontua todas as opções conjuntamente. O Clef Flash utiliza o backbone menor Qwen3.5-9B.
Parâmetros
Clef: 27B de parâmetros. Clef Flash: 9B de parâmetros.
Capacidades
- Tomada de decisão multimodal em texto, JSON e imagens
- Tipos de pergunta de escolha (choice), pontuação (score) e verdadeiro/falso (noul)
- Roteamento de fluxo de trabalho e seleção de ferramentas
- Classificação e barreiras de proteção (guardrails)
- Decisões estruturadas e guiadas por esquemas
Limitações
- Sem geração de texto em formato livre; a saída consiste apenas em decisões
- O Clef é executado em CPU/GPU via código personalizado ou Cloudflare Workers AI
Clef API Desempenho
Pontos Fortes
- Alta precisão de decisão em benchmarks de classificação, recuperação de ferramentas e raciocínio
- Latência extremamente baixa
- Pontuação conjunta para todas as perguntas e opções
- O Clef Flash é otimizado para velocidade
Eficácia no Mundo Real
O Clef é voltado para fluxos de trabalho empresariais de ponta a ponta, como processamento de faturas, triagem de atendimento ao cliente, classificação de incidentes de segurança e observabilidade de rastros de agentes, onde decisões estruturadas rápidas e consistentes são essenciais.
Clef API Quando Usar
Cenários
- Você precisa de decisões rápidas e consistentes de roteamento ou classificação sobre textos ou imagens. A família Clef API retorna probabilidades calibradas para cada opção em vez de texto em formato livre.
- Você está construindo fluxos de trabalho baseados em agentes que precisam selecionar ferramentas ou guardrails de forma confiável. A Clef API pontua cada opção permitida em uma única etapa direta para tomada de decisão com baixa latência.
- Você processa documentos de negócios, como faturas, e precisa de decisões estruturadas. A Clef API mapeia um estado e um esquema de perguntas tipadas diretamente para probabilidades.
Melhores Práticas
- Defina cada pergunta com um tipo claro (noul, choice ou score) e critérios explícitos
- Mantenha o estado focado na decisão em questão para maximizar a precisão
- Escolha o Clef Flash quando a latência e o custo forem mais importantes do que a precisão máxima