Kako proveriti tiket podrške pomoću Cloudflare Clef-omni

Cloudflare je 9. oktobra objavio Clef-omni kao hostovani Workers AI model za donošenje odluka koji može da pregleda tekst uz sliku, audio-snimak ili video. Za programera aplikacije koristan test je ograničen: modelu dati stanje tiketa i fiksni skup pitanja, pregledati odgovore i prepustiti odluku o usmeravanju osobi. Ovaj vodič prati aktuelnu Cloudflare dokumentaciju modela i primer iz objave. BIG CHANGE nije pokrenuo API niti merio njegovu tačnost na tiketima podrške.

ID modela je @cf/cloudflare/clef-omni na Workers AI. To je model za donošenje odluka: pozivalac definiše tipizirana pitanja i dozvoljene izbore, a zatim dobija ocene za te izbore. Ne piše odgovor podrške. Cloudflare je objavio i otvorene težine, ali koraci u nastavku koriste njihov hostovani endpoint. Cloudflare-ovi navodi o brzini i rezultatima testova jesu njihove tvrdnje; ne pokazuju kako će ovaj tok rada raditi na vašim tiketima.

Pripremite pristup i ograničen skup pitanja

Potreban vam je Cloudflare nalog sa pristupom Workers AI, njegov ID naloga, Workers AI API token i Python sa instaliranim requests ili alat koji može da pošalje isti HTTP zahtev. Cloudflare REST vodič za podešavanje pokazuje gde da kopirate ID naloga i napravite token na kontrolnoj tabli. Ručno napravljen token zahteva dozvole Workers AI - Read i Workers AI - Edit. Ne stavljajte token u tiket niti u kontrolu izvornog koda.

Slanje pravog tiketa ili priloga prosleđuje sadržaj korisnika Cloudflare-u na obradu. Cloudflare-ova stranica o korišćenju podataka u Workers AI navodi da se taj sadržaj bez izričitog pristanka ne koristi za obuku modela ponuđenih u Workers AI niti za unapređenje usluga; navodi i da sadržaj može biti sačuvan kada se Workers AI koristi uz uslugu skladištenja kao što su R2 ili KV. Pre slanja korisničkih tiketa proverite važeći Cloudflare ugovor i pravila organizacije o podacima korisnika, pa gde je praktično smanjite ili uklonite lične podatke. Sama Cloudflare izjava o neobuci ne utvrđuje da li smete da pošaljete podatke konkretnog korisnika.

Počnite tekstom kako biste pregledali odgovor pre dodavanja medija. Cloudflare-ov primer podrške koristi stanje Checkout has been failing for every customer for the last hour i postavlja tri pitanja: da li je hitno (noul, tip da/ne), koji tim treba da ga obradi (choice) i koliki je uticaj (score). Ovo je dokumentovani primer, a ne zabeleženi incident. API prihvata niz ili strukturisani objekat/niz kao state. Mapa questions mora da sadrži od 1 do 64 ID-a pitanja; svako ima tip i uputstva, dok choice i score koriste kriterijume za definisanje dozvoljenih odgovora.

Pošaljite tekstualni zahtev

Podesite CLOUDFLARE_AUTH_TOKEN u okruženju i zamenite ID naloga ispod. Ovaj Python zahtev prilagođava tačan endpoint i polja iz Cloudflare-ovog primera modela:

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())

Za uspešnu proveru, u odgovoru potražite stavke u answers za iste urgent, team i severity ID-ovima. Cloudflare opisuje prvo kao verovatnoću hitnosti, drugo kao izabrani tim sa verovatnoćama za njegove opcije, a treće kao ocenu ponderisanu verovatnoćom čiji je najniži nivo nula. API dokumentuje i polja odgovora model i usage. Pregledajte ceo JSON vraćen vašem nalogu pre mapiranja u aplikaciju. Verovatnoća je izlaz modela za dato pitanje i stanje, a ne garancija da pravi tiket pripada tom redu. Pre postupanja, osoba treba da uporedi tiket i priloge sa predloženim usmeravanjem i dokazima.

Dodajte fotografiju, snimak ili video

Cloudflare-ov zahtev iz objave stavlja opcione medije u zasebne nizove images, audio i videos kao ugrađene base64 podatke u data: URL-ove. Na primer, uzorak koristi data:image/png;base64,..., data:audio/mpeg;base64,... i data:video/mp4;base64,.... Da biste dodali lokalni fajl u Python payload pre requests.post, kodirajte ga i dodajte data URL odgovarajućem nizu:

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")

Pokrenite add_media pre POST zahteva. Neka state bude činjeničan i opiše svaki prilog; pitajte samo ono na šta dostupni tiket i mediji mogu da odgovore. Cloudflare-ov primer iz objave koristi fotografiju uređaja, audio-snimak i video ventilatora da postavi tri pitanja da/ne o vidljivim i čujnim detaljima. Aplikacija za podršku može da čuva svoja polja tiketa u state i svoje dozvoljene redove u criteria, ali te definicije treba proveriti prema stvarnom toku rada. Usluga ne prihvata udaljene URL-ove medija.

Proverite ograničenja pre kodiranja. Stranica modela dozvoljava do četiri PNG, JPEG ili WebP slike, svaku do 4 MiB i 16 megapiksela, uz ukupno 8 MiB dekodiranih slika. Dozvoljava do četiri audio-klipa, svaki do 8 MiB i 300 sekundi, i dva videa, svaki do 16 MiB i 60 sekundi. Zajedničko ograničenje dekodiranog zvuka i videa je 16 MiB. Video se uzorkuje sa dva kadra u sekundi; zvučni zapis se koristi uz kadrove kada ga ima svaki video u zahtevu. Ako je prilog prevelik ili predugačak, neka osoba izabere relevantan kraći isečak ili upotrebi proveru samo tekstom i posebno pregleda originalni medij. Isečen ili skraćen fajl ne smatrajte potpunim dokazom.

Proverite cenu, kontekst i postupanje pri grešci

Cloudflare trenutno navodi cenu Clef-omni od 0,15 USD za milion ulaznih tokena i kaže da ne naplaćuje izlazne tokene. Mediji se po toj tarifi pretvaraju u ulazne tokene. Stranica modela navodi približno 780 tokena po minutu zvuka i do oko 15.400 tokena po minutu videa u maksimalnoj rezoluciji, uz dodatne audio tokene ako video ima zvuk. Cena slike zavisi od umanjene slike i ograničena je na 1.024 tokena po slici. To su pravila naplate, a ne fiksna cena po prilogu.

Hostovani model ima kontekst od 64.000 tokena. Mediji i pitanja ulaze u taj limit. Ako ga premaše, Cloudflare kaže da zahtev ne uspeva; u suprotnom, dugačak tekst u state može biti skraćen da stane. Zato vraćeni odgovor ne dokazuje da je model razmotrio svaki red dugog tiketa. Kada zahtev ne uspe, pregledajte HTTP grešku i smanjite ili uklonite priloge u okviru dokumentovanih ograničenja pre ponovnog pokušaja. Kada uspe, proverite da li su prisutni očekivani ID-ovi pitanja, sačuvajte originalni tiket za pregled i uporedite predloženo usmeravanje sa dokazima. Verovatnoće modela mogu pomoći recenzentu da usmeri pažnju, ali bi garancija usluge ili bezbedan automatski prag zahtevali procenu na vašim sopstvenim označenim tiketima.

Velika promena

Cloudflare-ova objava od 9. oktobra dodaje zvuk i video hostovanoj Clef putanji modela za odlučivanje koja se već koristi za tipizirana pitanja nad tekstom i slikama. Programer može da pošalje stanje jednog tiketa sa podržanim medijima i dobije odgovore prema fiksnoj šemi kroz jedan Workers AI zahtev. Tim aplikacije i dalje mora da odluči koja pitanja ulaze u tu šemu, testira performanse na sopstvenim tiketima i zahteva ljudsko odobrenje pre odgovora ili usmeravanja.

Izvori i dodatna literatura

• Dokumentacija Cloudflare Clef-omni modela, pregledana 10. oktobra 2026. Glavni izvor za ID hostovanog modela, API polja i primer, ograničenja medija i konteksta, oblik odgovora i navedenu cenu tokena. Dokumentacija opisuje ponašanje usluge; BIG CHANGE nije izvršio zahtev.
• Cloudflare-ova objava o lansiranju Clef-omni, 9. oktobar 2026. Potvrđuje datum lansiranja i daje primer zahteva sa ugrađenim medijima. Tvrdnje o performansama i benchmarku su Cloudflare-ove.
• Cloudflare Workers AI REST podešavanje, poslednji put ažurirano 15. septembra 2026. i pregledano 10. oktobra. Pokazuje kako pribaviti ID naloga i API token i navodi potrebne dozvole za ručno napravljen token.
• Korišćenje podataka u Cloudflare Workers AI, poslednji put ažurirano 21. aprila 2026. i pregledano 10. oktobra. Objašnjava obradu korisničkog sadržaja od strane Cloudflare-a, njihovo navedeno ograničenje obuke i unapređenja usluge bez izričitog pristanka, moguće čuvanje pri korišćenju zasebne usluge skladištenja i granicu važećeg ugovora. Ne utvrđuje da li programer sme da pošalje određeni tiket ili snimak.