세상은 멈춰 있지 않습니다.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.

Cloudflare는 10월 9일 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를 실행하거나 지원 티켓에 대한 정확도를 측정하지 않았습니다.

모델 ID는 `@cf/cloudflare/clef-omni`는 Workers AI에서 제공됩니다. 이는 의사결정 모델입니다. 호출자는 유형이 지정된 질문과 허용 선택지를 정의하고 해당 선택지의 점수를 받습니다. 지원 답변을 작성하지는 않습니다. Cloudflare는 공개 가중치도 출시했지만, 아래 단계는 호스팅 엔드포인트를 사용합니다. Cloudflare가 제시한 속도와 벤치마크 수치는 자체 주장일 뿐, 이 워크플로가 여러분의 티켓에서 얼마나 잘 작동할지는 입증하지 않습니다.

## 접근 권한과 범위가 제한된 질문 집합 준비

Workers AI 접근 권한이 있는 Cloudflare 계정, 계정 ID, Workers AI API 토큰, 그리고 `requests`가 설치된 Python 또는 동일한 HTTP 요청을 보낼 수 있는 도구가 필요합니다. [Cloudflare REST 설정 가이드](https://developers.cloudflare.com/workers-ai/get-started/rest-api/)에는 대시보드에서 계정 ID를 복사하고 토큰을 만드는 위치가 나와 있습니다. 수동으로 만든 토큰에는 `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` 맵에는 질문 ID가 1개에서 64개까지 있어야 합니다. 각 항목에는 유형과 지침이 있으며, `choice` 및 `score`는 허용 응답을 정의하는 기준을 사용합니다.

## 텍스트 요청 보내기

환경에 `CLOUDFLARE_AUTH_TOKEN`를 설정하고 아래의 계정 ID를 바꾸세요. 이 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` ID에 해당하는 항목을 찾으세요. Cloudflare는 첫 항목을 긴급성 확률, 두 번째를 각 선택지의 확률을 포함한 선택 팀, 세 번째를 최저 단계가 0인 확률 가중 점수로 설명합니다. API는 `model` 및 `usage` 응답 필드도 문서화합니다. 애플리케이션에 매핑하기 전에 계정에 반환된 전체 JSON을 살펴보세요. 확률은 제공된 질문과 상태에 대한 모델 출력이지, 실제 티켓이 해당 대기열에 속한다는 보장이 아닙니다. 조치를 취하기 전에 사람이 티켓과 첨부파일을 제안된 라우팅 및 근거와 비교해야 합니다.

## 사진, 녹음 또는 비디오 추가

Cloudflare의 [출시 요청](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/)은 선택적 미디어를 별도의 `images`, `audio` 및 `videos` 배열에 포함된 base64 `data:` URL로 넣습니다. 예를 들어 샘플은 `data:image/png;base64,...`, `data:audio/mpeg;base64,...` 및 `data:video/mp4;base64,...`를 사용합니다. `requests.post` 전에 로컬 파일 하나를 Python 페이로드에 추가하려면 인코딩한 다음 해당 배열에 데이터 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")
```

POST 전에 `add_media`를 실행하세요. `state`는 사실에 충실하게 작성하고 각 첨부파일이 무엇인지 설명하세요. 티켓과 사용 가능한 미디어가 답할 수 있는 질문만 하세요. Cloudflare 출시 예시는 장치 사진, 소리 녹음, 팬 비디오를 사용해 눈에 보이거나 들리는 세부 정보에 관한 예/아니요 질문 세 개를 합니다. 지원 애플리케이션은 자체 티켓 필드를 `state`에, 허용 대기열을 `criteria`에 둘 수 있지만 실제 워크플로에 맞는지 확인해야 합니다. 이 서비스는 원격 미디어 URL을 받지 않습니다.

인코딩 전에 한도를 확인하세요. [모델 페이지](https://developers.cloudflare.com/workers-ai/models/clef-omni/)는 PNG, JPEG 또는 WebP 이미지 최대 4개(각각 최대 4 MiB 및 1,600만 픽셀), 디코딩된 이미지 총 8 MiB를 허용합니다. 오디오 클립은 최대 4개(각각 최대 8 MiB, 300초), 비디오는 최대 2개(각각 최대 16 MiB, 60초)입니다. 오디오와 비디오의 디코딩 크기 합계 한도는 16 MiB입니다. 비디오는 초당 2프레임으로 샘플링됩니다. 요청에 포함된 모든 비디오에 사운드가 있으면 프레임과 함께 오디오도 사용합니다. 첨부파일이 너무 크거나 길면 사람이 관련된 짧은 구간을 선택하거나 텍스트만 확인하고 원본 미디어는 별도로 살펴보게 하세요. 잘라내거나 짧게 만든 파일을 완전한 근거로 취급하지 마세요.

## 비용, 컨텍스트 및 실패 경로 확인

Cloudflare는 현재 Clef-omni 가격을 **입력 토큰 100만 개당 $0.15**로 표시하며 출력 토큰은 청구하지 않는다고 합니다. 미디어는 이 요율로 입력 토큰으로 변환됩니다. 모델 페이지에는 오디오 분당 약 780토큰, 최대 해상도 비디오 분당 최대 약 15,400토큰이 설명되어 있으며, 비디오에 소리가 있으면 오디오 토큰도 추가됩니다. 이미지 비용은 크기를 조정한 이미지에 따라 달라지며 이미지당 1,024토큰으로 제한됩니다. 이는 청구 규칙이지 첨부파일당 고정 가격이 아닙니다.

호스팅 모델의 컨텍스트는 64,000토큰입니다. 미디어와 질문도 여기에 포함됩니다. 이 범위를 초과하면 요청이 실패한다고 Cloudflare는 설명합니다. 초과하지 않으면 `state`의 긴 텍스트가 길이에 맞게 잘릴 수 있습니다. 따라서 답변이 반환되었다고 해서 모델이 긴 티켓의 모든 줄을 고려했다는 뜻은 아닙니다. 요청이 실패하면 HTTP 오류를 확인하고 문서화된 한도 안에서 첨부파일을 줄이거나 제거한 뒤 다시 시도하세요. 성공하면 예상한 질문 ID가 있는지 확인하고 원본 티켓을 검토용으로 보관하며 제안된 라우팅을 근거와 비교하세요. 모델의 확률이 검토자의 주의를 집중시키는 데 도움이 될 수 있지만, 서비스 보장이나 안전한 자동 임계값을 정하려면 자체 라벨링 티켓으로 평가해야 합니다.

## 큰 변화

Cloudflare의 10월 9일 출시는 텍스트와 이미지에 대한 유형 지정 질문에 이미 쓰이던 호스팅 Clef 의사결정 모델 경로에 오디오와 비디오를 추가합니다. 개발자는 지원되는 미디어가 포함된 티켓 상태 하나를 제출하고 단일 Workers AI 요청으로 고정 스키마에 맞춘 답변을 받을 수 있습니다. 애플리케이션 팀은 여전히 해당 스키마에 넣을 질문을 정하고 자체 티켓에서 성능을 시험하며 응답이나 라우팅 조치 전에 사람의 승인을 요구해야 합니다.

## 출처 및 추가 읽을거리

- [Cloudflare Clef-omni 모델 문서](https://developers.cloudflare.com/workers-ai/models/clef-omni/), 2026년 10월 10일 확인. 호스팅 모델 ID, API 필드와 예시, 미디어 및 컨텍스트 한도, 응답 형태, 표시된 토큰 가격의 주요 참고자료입니다. 문서는 서비스 동작을 설명하며 BIG CHANGE는 요청을 실행하지 않았습니다.
- [Cloudflare의 Clef-omni 출시 게시물](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/), 2026년 10월 9일. 출시일과 내장 미디어 요청 예시의 근거입니다. 성능 및 벤치마크 수치는 Cloudflare의 자체 주장입니다.
- [Cloudflare Workers AI REST 설정](https://developers.cloudflare.com/workers-ai/get-started/rest-api/), 2026년 9월 15일 마지막 업데이트, 10월 10일 확인. 계정 ID와 API 토큰을 얻는 방법 및 수동 생성 토큰에 필요한 권한을 보여 줍니다.
- [Cloudflare Workers AI 데이터 사용](https://developers.cloudflare.com/workers-ai/platform/data-usage/), 2026년 4월 21일 마지막 업데이트, 10월 10일 확인. Cloudflare의 고객 콘텐츠 처리, 명시적 동의가 없을 때 학습 및 서비스 개선에 사용하지 않는다는 설명, 별도 저장 서비스를 쓸 때의 잠재적 보관, 적용되는 계약상의 경계를 다룹니다. 개발자가 특정 티켓이나 녹음을 제출해도 되는지는 결정하지 않습니다.

## Sources

- [Cloudflare Clef-omni 모델 문서](https://developers.cloudflare.com/workers-ai/models/clef-omni/) — 호스팅 모델 ID, 요청 및 출력 스키마, 미디어 한도, 토큰 과금, 가격 및 컨텍스트. 문서 설명이며 BIG CHANGE 테스트가 아닙니다.
- [Introducing Clef-omni](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/) — 출시일과 내장 미디어 요청 예시를 제시합니다. 공급업체의 성능 및 벤치마크 주장은 독립된 증거가 아닙니다.
- [Get started: Workers AI REST API](https://developers.cloudflare.com/workers-ai/get-started/rest-api/) — 계정 ID, Workers AI 토큰 설정 및 수동 생성 토큰에 필요한 권한입니다.
- [Workers AI data usage](https://developers.cloudflare.com/workers-ai/platform/data-usage/) — 2026년 4월 21일 마지막 업데이트. Cloudflare는 Workers AI 제공을 위해 입력을 처리하며 명시적 동의 없이는 학습이나 서비스 개선에 사용하지 않는다고 설명합니다. 저장 서비스를 사용하면 보관할 수 있습니다. 적용되는 계약과 데이터 규칙을 확인하세요.