Clef API
Семейство открытых моделей принятия решений Clef от Cloudflare: Clef (27B) и Clef Flash (9B) преобразуют состояния и типизированные вопросы в вероятностные решения.
Clef API
cloudflare/clef
Cloudflare Clef — это мультимодальная модель принятия решений на 27B параметров, которая преобразует текст, JSON, изображения или видео в структурированные JSON-ответы на основе вероятностей.
Clef API Предыстория
Обзор
Clef — это семейство открытых моделей принятия решений от Cloudflare, доступное на платформе Cloudflare Workers AI. Оно преобразует состояние и схему типизированных вопросов в решения, возвращая вероятность для каждого допустимого варианта каждого вопроса за один прямой проход (forward pass). В семейство входят мультимодальная модель Clef (27B), дообученная на базе Qwen3.8-27B, и быстрая модель Clef Flash (9B), дообученная на базе Qwen3.5-9B.
История разработки
Cloudflare выпустила модели принятия решений Clef в открытый доступ с открытыми весами (лицензия Apache-2.0). Clef дообучена на базе Qwen3.8-27B с использованием её визуального кодировщика (vision encoder) и объединённого классификатора схемы (joint schema head); Clef Flash — более компактная и быстрая версия, дообученная на базе Qwen3.5-9B. Обе модели развёрнуты на Cloudflare Workers AI.
Ключевые инновации
- Один прямой проход возвращает вероятность для каждого варианта каждого вопроса
- Объединённый классификатор схемы оценивает все варианты всех вопросов совместно
- Принимает на вход текст, JSON и изображения
- Отсутствие генерации текста в свободной форме и необходимости парсинга вывода
- Полная совместимость с API принятия решений Jev и SystemOne
Clef API Технические характеристики
Архитектура
Clef использует базовую модель (backbone) Qwen3.8-27B с визуальным кодировщиком, сохранённую в стандартном шардированном формате safetensors, а также объединённый классификатор схемы, который считывает финальные скрытые состояния базовой модели, сопоставляет данные состояния с каждым вопросом и совместно оценивает все варианты. Clef Flash использует более компактную базовую модель Qwen3.5-9B.
Параметры
Clef: 27B параметров. Clef Flash: 9B параметров.
Возможности
- Мультимодальное принятие решений на основе текста, JSON и изображений
- Типы вопросов: выбор из вариантов (choice), оценка (score) и да/нет (noul)
- Маршрутизация рабочих процессов и выбор инструментов
- Классификация и защитные барьеры (guardrails)
- Структурированные решения на основе схем
Ограничения
- Отсутствие генерации текста в свободной форме; результатом являются только решения
- Запуск Clef на CPU/GPU осуществляется через пользовательский код или Cloudflare Workers AI
Clef API Производительность
Преимущества
- Высокая точность решений в бенчмарках классификации, выбора инструментов и логических рассуждений
- Очень низкая задержка (latency)
- Совместная оценка всех вопросов и вариантов
- Clef Flash оптимизирована для максимальной скорости
Эффективность в реальных условиях
Clef ориентирована на сквозные бизнес-процессы, такие как обработка счетов, триаж обращений в службу поддержки, классификация инцидентов безопасности и отслеживание трассировок агентов, где важны быстрые и согласованные структурированные решения.
Clef API Когда использовать
Сценарии
- Вам необходима быстрая и согласованная маршрутизация или классификация по тексту или изображениям. Семейство Clef API возвращает откалиброванные вероятности для каждого варианта вместо текста в свободной форме.
- Вы разрабатываете агентские рабочие процессы, требующие надежного выбора инструментов или защитных барьеров. Clef API оценивает каждый допустимый вариант за один прямой проход для принятия решений с минимальной задержкой.
- Вы обрабатываете деловые документы (например, счета) и вам нужны структурированные решения. Clef API напрямую сопоставляет состояние и схему типизированных вопросов с вероятностями.
Лучшие практики
- Задавайте каждый вопрос с четким типом (noul, choice или score) и явными критериями
- Фокусируйте состояние только на текущем решении для достижения максимальной точности
- Выбирайте Clef Flash, когда задержка и стоимость более критичны, чем максимальная точность