МИР НЕ СТОИТ НА МЕСТЕ.RSS
BIG CHANGE.

Версия Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Как проверить обращение в поддержку с помощью Cloudflare Clef-omni

> Cloudflare Clef-omni принимает состояние обращения, типизированные вопросы и необязательное изображение, аудио или видео. В этом руководстве, основанном только на документации, описаны запрос к Workers AI, ответ, цена и ограничения.

By BIG CHANGE Editorial

Published: 2026-10-10T13:09:00.735Z
Updated: 2026-10-10T13:09:00.735Z
Canonical: https://bigchange.ai/blog/cloudflare-clef-omni-support-ticket-guide

![A hand rests on a mouse beside a monitor showing an unlabeled ticket and attachment list, with a printed equipment image in the foreground.](https://bigchange.ai/api/media/file/clef-omni-ticket-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

9 октября Cloudflare выпустила Clef-omni как размещённую в облаке модель принятия решений Workers AI, способную анализировать текст вместе с изображением, аудиофрагментом или видео. Разработчику приложения полезно провести узкую проверку: передать модели состояние обращения и фиксированный набор вопросов, изучить ответы и оставить решение о маршрутизации человеку. В руководстве рассматриваются [актуальная документация Cloudflare по модели](https://developers.cloudflare.com/workers-ai/models/clef-omni/) и [пример запуска](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/). BIG CHANGE не вызывал API и не измерял точность модели на обращениях в поддержку.

Идентификатор модели — `@cf/cloudflare/clef-omni` в Workers AI. Это модель принятия решений: вызывающая сторона задаёт типизированные вопросы и допустимые варианты, а затем получает оценки этих вариантов. Модель не пишет ответ пользователю. Cloudflare также выпустила открытые веса, однако инструкции ниже используют размещённую конечную точку. Данные Cloudflare о скорости и тестах производительности являются заявлениями самой компании и не показывают, насколько хорошо такой процесс сработает на ваших обращениях.

## Подготовьте доступ и ограниченный набор вопросов

Вам понадобятся учётная запись Cloudflare с доступом к Workers AI, её идентификатор, API-токен Workers AI и либо Python с установленным `requests` , либо инструмент, способный отправить такой же HTTP-запрос. [В инструкции Cloudflare по настройке REST](https://developers.cloudflare.com/workers-ai/get-started/rest-api/) показано, где в панели управления скопировать идентификатор учётной записи и создать токен. Для токена, созданного вручную, нужны разрешения `Workers AI - Read` и `Workers AI - Edit` . Не помещайте токен в обращение или систему контроля версий.

При отправке реального обращения или вложения содержимое клиента передаётся Cloudflare для обработки. [На странице Cloudflare об использовании данных Workers AI](https://developers.cloudflare.com/workers-ai/platform/data-usage/) сказано, что без явного согласия компания не использует это содержимое для обучения моделей Workers AI или улучшения сервисов; там также указано, что содержимое может сохраняться при использовании Workers AI со службой хранения, например R2 или KV. Перед отправкой обращений клиентов проверьте применимое соглашение с Cloudflare и правила вашей организации для клиентских данных; по возможности сократите или скройте персональные сведения. Одного заявления Cloudflare об отсутствии обучения недостаточно, чтобы подтвердить право отправлять данные конкретного клиента.

Начните с текста, чтобы изучить ответ перед добавлением медиа. В собственном примере Cloudflare для поддержки используется состояние `Checkout has been failing for every customer for the last hour` и задаются три вопроса: является ли случай срочным (`noul`, тип да/нет), какая команда должна им заняться (`choice`) и насколько серьёзно влияние (`score`). Это задокументированный пример, а не реальный инцидент. API принимает строку или структурированный объект/массив в качестве `state`. Карта `questions` должна содержать от 1 до 64 идентификаторов вопросов; у каждого есть тип и инструкции, а `choice` и `score` используют критерии для определения допустимых ответов.

## Отправьте текстовый запрос

Задайте `CLOUDFLARE_AUTH_TOKEN` в своей среде и замените идентификатор учётной записи ниже. Этот запрос Python повторяет [точную конечную точку и поля из примера модели Cloudflare](https://developers.cloudflare.com/workers-ai/models/clef-omni/):

```python
import os
import requests

account_id = "your-account-id"
token = os.environ["CLOUDFLARE_AUTH_TOKEN"]

payload = {
    "model": "clef-omni",
    "state": "Checkout has been failing for every customer for the last hour.",
    "questions": {
        "urgent": {
            "type": "noul",
            "instructions": "Is this support request urgent?",
        },
        "team": {
            "type": "choice",
            "instructions": "Which team should handle this request?",
            "criteria": {
                "billing": "Payments, invoices, and refunds",
                "technical": "Outages, errors, and configuration",
                "sales": "Plans and upgrades",
            },
        },
        "severity": {
            "type": "score",
            "instructions": "How severe is the customer impact?",
            "criteria": ["No impact", "Minor", "Major", "Critical"],
        },
    },
}

response = requests.post(
    f"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/@cf/cloudflare/clef-omni",
    headers={"Authorization": f"Bearer {token}"},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

При успешной проверке найдите в ответе записи `answers` с теми же идентификаторами `urgent`, `team` и `severity` . Cloudflare описывает первую как вероятность срочности, вторую — как выбранную команду с вероятностями её вариантов, а третью — как взвешенную вероятностями оценку, минимальный уровень которой равен нулю. В API также документированы поля ответа `model` и `usage` . Перед отображением данных в приложении изучите весь JSON, возвращённый вашей учётной записи. Вероятность — это выход модели для переданных вопроса и состояния, а не гарантия того, что реальное обращение следует направить в эту очередь. До любых действий попросите человека сопоставить обращение и вложения с предложенным маршрутом.

## Добавьте фотографию, запись или видео

В [запросе Cloudflare при запуске](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/) необязательные медиафайлы помещаются в отдельные массивы `images`, `audio` и `videos` в виде встроенных base64- `data:` . Например, в образце используются `data:image/png;base64,...`, `data:audio/mpeg;base64,...` и `data:video/mp4;base64,...`. Чтобы добавить локальный файл в данные Python до вызова `requests.post`, закодируйте его и добавьте URL данных в соответствующий массив:

```python
import base64
from pathlib import Path

def add_media(payload, field, file_path, mime_type):
    raw = Path(file_path).read_bytes()
    encoded = base64.b64encode(raw).decode("ascii")
    payload.setdefault(field, []).append(f"data:{mime_type};base64,{encoded}")

# Examples: use only the files present in the ticket, with their real MIME types.
# add_media(payload, "images", "photo.png", "image/png")
# add_media(payload, "audio", "recording.mp3", "audio/mpeg")
# add_media(payload, "videos", "clip.mp4", "video/mp4")
```

Выполните `add_media` до POST-запроса. Сохраняйте `state` фактическим и описывайте каждое вложение; задавайте только вопросы, на которые можно ответить по имеющемуся обращению и медиа. В примере Cloudflare используются фотография устройства, аудиозапись и видео вентилятора, чтобы задать три вопроса да/нет о видимых и слышимых деталях. Приложение поддержки может хранить собственные поля обращения в `state` и свои допустимые очереди в `criteria`, но должно сверить эти определения с реальным рабочим процессом. Сервис не принимает удалённые URL медиафайлов.

Перед кодированием проверьте ограничения. На [странице модели](https://developers.cloudflare.com/workers-ai/models/clef-omni/) разрешено до четырёх изображений PNG, JPEG или WebP размером не более 4 МиБ и 16 мегапикселей каждое; общий размер декодированных изображений — до 8 МиБ. Разрешено до четырёх аудиофрагментов размером до 8 МиБ и длительностью до 300 секунд каждый, а также два видео размером до 16 МиБ и длительностью до 60 секунд каждое. Общий предел декодированного аудио и видео составляет 16 МиБ. Видео обрабатывается с частотой два кадра в секунду; звуковая дорожка используется вместе с кадрами, если она есть у каждого видео в запросе. Стоимость изображения зависит от его размера после изменения и ограничена 1 024 токенами на изображение. Если вложение слишком велико или длинно, попросите человека выбрать подходящий короткий фрагмент либо выполните проверку только по тексту и отдельно изучите исходное медиа. Не считайте обрезанный или укороченный файл полным свидетельством.

## Проверьте стоимость, контекст и обработку ошибок

Сейчас Cloudflare указывает для Clef-omni цену **$0,15 за миллион входных токенов** и заявляет, что не берёт плату за выходные токены. Медиа преобразуются во входные токены по этому тарифу. На странице модели указано около 780 токенов на минуту аудио и до примерно 15 400 токенов на минуту видео при максимальном разрешении, плюс аудиотокены, если у видео есть звук. Стоимость изображения зависит от его изменённого размера и ограничена 1 024 токенами на изображение. Это правила выставления счетов, а не фиксированная цена за вложение.

У размещённой модели контекстное окно на 64 000 токенов. Медиа и вопросы учитываются в нём. Если они превышают окно, запрос, по словам Cloudflare, завершится ошибкой; иначе длинный текст в `state` может быть усечён, чтобы поместиться. Поэтому полученный ответ не доказывает, что модель учла каждую строку длинного обращения. При сбое изучите HTTP-ошибку и перед повтором уменьшите или удалите вложения в рамках документированных ограничений. При успехе проверьте наличие ожидаемых идентификаторов вопросов, сохраните исходное обращение для проверки и сопоставьте предложенный маршрут с доказательствами. Вероятности модели могут помочь проверяющему сосредоточить внимание, но гарантию обслуживания или безопасный автоматический порог нужно оценивать на собственных размеченных обращениях.

## Главное изменение

Выпуск Cloudflare от 9 октября добавляет аудио и видео в размещённый путь модели принятия решений Clef, уже использовавшийся для текстовых вопросов с изображениями. Разработчик может отправить состояние одного обращения с поддерживаемыми медиа и получить ответы по фиксированной схеме одним запросом Workers AI. Команде приложения всё ещё нужно решить, какие вопросы включить в схему, проверить работу на собственных обращениях и требовать одобрения человека перед ответом или маршрутизацией.

## Источники и дополнительная литература

- [Документация модели Cloudflare Clef-omni](https://developers.cloudflare.com/workers-ai/models/clef-omni/), проверена 10 октября 2026 года. Основной источник сведений об идентификаторе размещённой модели, полях и примере API, ограничениях медиа и контекста, формате ответа и указанной цене токенов. Документация описывает работу сервиса; BIG CHANGE не выполнял запрос.
- [Публикация Cloudflare о запуске Clef-omni](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/), 9 октября 2026 года. Подтверждает дату запуска и содержит пример запроса со встроенными медиа. Данные о производительности и бенчмарках — собственные заявления Cloudflare.
- [Настройка REST API Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/get-started/rest-api/), последнее обновление 15 сентября 2026 года, проверена 10 октября. Показывает, как получить идентификатор учётной записи и API-токен, и перечисляет необходимые разрешения для токена, созданного вручную.
- [Использование данных Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/platform/data-usage/), последнее обновление 21 апреля 2026 года, проверено 10 октября. Объясняет обработку клиентского содержимого Cloudflare, заявленное ограничение на использование для обучения и улучшения сервиса без явного согласия, возможное хранение при использовании отдельной службы хранения и границы применимого соглашения. Не определяет, может ли разработчик отправить конкретное обращение или запись.

## Sources

- [Документация модели Cloudflare Clef-omni](https://developers.cloudflare.com/workers-ai/models/clef-omni/) — Идентификатор размещённой модели, схема запроса и ответа, ограничения медиа, тарификация токенов, цена и контекст; документация, а не тест BIG CHANGE.
- [Introducing Clef-omni](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/) — Дата запуска и пример запроса со встроенными медиа; заявления поставщика о производительности и бенчмарках не являются независимыми доказательствами.
- [Начало работы: REST API Workers AI](https://developers.cloudflare.com/workers-ai/get-started/rest-api/) — Идентификатор учётной записи, настройка токена Workers AI и разрешения для токена, созданного вручную.
- [Использование данных Workers AI](https://developers.cloudflare.com/workers-ai/platform/data-usage/) — Последнее обновление — 21 апреля 2026 года; Cloudflare заявляет, что обрабатывает входные данные для предоставления Workers AI и без явного согласия не использует их для обучения или улучшения сервиса; при использовании службы хранения данные могут сохраняться. Проверьте применимые соглашения и правила обработки данных.