Cloudflare అక్టోబర్ 9న Clef-omniని Workers AIలో హోస్ట్ చేసిన నిర్ణయ మోడల్‌గా విడుదల చేసింది. ఇది వచనంతో పాటు చిత్రం, ఆడియో క్లిప్ లేదా వీడియోను పరిశీలించగలదు. అప్లికేషన్ డెవలపర్‌కు ఉపయోగకరమైన పరీక్ష పరిమితమైనది: మోడల్‌కు టికెట్ స్థితి, స్థిర ప్రశ్నల సమితిని ఇవ్వండి, సమాధానాలను పరిశీలించండి, రూటింగ్ నిర్ణయాన్ని వ్యక్తి వద్దే ఉంచండి. ఈ మార్గదర్శి Cloudflare ప్రస్తుత మోడల్ డాక్యుమెంటేషన్ మరియు విడుదల ఉదాహరణను అనుసరిస్తుంది. BIG CHANGE APIని అమలు చేయలేదు లేదా సపోర్ట్ టికెట్లపై దాని ఖచ్చితత్వాన్ని కొలవలేదు.
మోడల్ ID @cf/cloudflare/clef-omni; ఇది Workers AIలో ఉంటుంది. ఇది నిర్ణయ మోడల్: కాల్ చేసే వ్యక్తి రకం నిర్దేశించిన ప్రశ్నలు, అనుమతించిన ఎంపికలను నిర్వచిస్తారు; ఆ ఎంపికలకు స్కోర్లు వస్తాయి. ఇది సపోర్ట్ సమాధానాన్ని రాయదు. Cloudflare ఓపెన్ వెయిట్లను కూడా విడుదల చేసింది, కానీ కింది దశలు దాని హోస్ట్ చేసిన ఎండ్‌పాయింట్‌ను ఉపయోగిస్తాయి. వేగం, బెంచ్‌మార్క్ గణాంకాలు Cloudflare స్వంత వాదనలు; మీ టికెట్లలో ఈ వర్క్‌ఫ్లో ఎంత బాగా పనిచేస్తుందో అవి నిరూపించవు.
ప్రవేశాన్ని, పరిమిత ప్రశ్నల సమితిని సిద్ధం చేయండి
మీకు Workers AI యాక్సెస్ ఉన్న Cloudflare ఖాతా, దాని ఖాతా ID, Workers AI API టోకెన్, అలాగే requests ఇన్‌స్టాల్ చేసిన Python లేదా అదే HTTP అభ్యర్థన చేయగల సాధనం అవసరం. Cloudflare REST సెటప్ గైడ్ డాష్‌బోర్డ్‌లో ఖాతా IDని ఎక్కడ కాపీ చేయాలో, టోకెన్‌ను ఎలా సృష్టించాలో చూపిస్తుంది. చేతితో సృష్టించిన టోకెన్‌కు Workers AI - Read మరియు Workers AI - Edit అనుమతులు అవసరం. టోకెన్‌ను టికెట్‌లో లేదా సోర్స్ కంట్రోల్‌లో పెట్టవద్దు.
నిజమైన టికెట్ లేదా జోడింపును పంపితే, కస్టమర్ కంటెంట్ ప్రాసెసింగ్ కోసం Cloudflareకు వెళ్తుంది. Cloudflare Workers AI డేటా-వినియోగ పేజీ స్పష్టమైన సమ్మతి లేకుండా ఆ కంటెంట్‌ను Workers AIలో అందించే మోడళ్ల శిక్షణకు లేదా సేవల మెరుగుదలకు ఉపయోగించదని చెబుతుంది; R2 లేదా KV వంటి నిల్వ సేవతో Workers AI ఉపయోగించినప్పుడు కంటెంట్ నిల్వ కావచ్చని కూడా చెబుతుంది. కస్టమర్ టికెట్లు పంపే ముందు వర్తించే Cloudflare ఒప్పందం, మీ సంస్థ కస్టమర్-డేటా నియమాలను పరిశీలించండి; సాధ్యమైనప్పుడు వ్యక్తిగత సమాచారాన్ని తగ్గించండి లేదా దాచండి. Cloudflare శిక్షణకు ఉపయోగించదన్న ప్రకటన ఒక్కటే నిర్దిష్ట కస్టమర్ డేటాను పంపడానికి అనుమతి ఉందని నిర్ధారించదు.
మీడియా జోడించే ముందు ప్రతిస్పందనను పరిశీలించగలిగేలా వచనంతో ప్రారంభించండి. Cloudflare స్వంత సపోర్ట్ ఉదాహరణలో స్థితి Checkout has been failing for every customer for the last hour మరియు మూడు ప్రశ్నలు అడుగుతుంది: ఇది అత్యవసరమా (noul, అవును/కాదు రకం), ఏ బృందం దీన్ని చూసుకోవాలి (choice), ప్రభావం ఎంత తీవ్రంగా ఉంది (score). ఇది డాక్యుమెంట్‌లో ఉన్న ఉదాహరణ మాత్రమే, గమనించిన ఘటన కాదు. API stateగా స్ట్రింగ్ లేదా నిర్మిత ఆబ్జెక్ట్/అర్రేను అంగీకరిస్తుంది. questions మ్యాప్‌లో 1 నుంచి 64 ప్రశ్న IDలు ఉండాలి; ప్రతి ప్రశ్నకు రకం, సూచనలు ఉంటాయి; అనుమతించిన సమాధానాలను నిర్వచించడానికి choice మరియు score ప్రమాణాలను ఉపయోగిస్తాయి.
వచన అభ్యర్థనను పంపండి
మీ వాతావరణంలో CLOUDFLARE_AUTH_TOKEN ను సెట్ చేసి, కింద ఖాతా IDని మార్చండి. ఈ Python అభ్యర్థన Cloudflare మోడల్ ఉదాహరణలోని ఖచ్చితమైన ఎండ్‌పాయింట్, ఫీల్డ్‌లను అనుసరిస్తుంది:
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 వివరిస్తుంది. API model మరియు usage ప్రతిస్పందన ఫీల్డ్‌లను కూడా డాక్యుమెంట్ చేస్తుంది. అప్లికేషన్‌లో మ్యాప్ చేయడానికి ముందు మీ ఖాతాకు వచ్చిన పూర్తి JSONను పరిశీలించండి. సంభావ్యత అనేది ఇచ్చిన ప్రశ్న, స్థితికి మోడల్ ఇచ్చిన ఫలితం; నిజమైన టికెట్ ఆ క్యూకే చెందుతుందని హామీ కాదు. చర్యకు ముందు ఒక వ్యక్తి టికెట్, జోడింపును ప్రతిపాదిత రూట్, ఆధారాలతో పోల్చాలి.
ఫోటో, రికార్డింగ్ లేదా వీడియోను జోడించండి
Cloudflare విడుదల చేసిన అభ్యర్థన ఐచ్ఛిక మీడియాను వేర్వేరు images, audio మరియు videos అర్రేలలో పొందుపరిచిన base64 data: URLలుగా ఉంచుతుంది. ఉదాహరణకు, నమూనా data:image/png;base64,..., data:audio/mpeg;base64,... మరియు data:video/mp4;base64,...ను ఉపయోగిస్తుంది. requests.postకు ముందు Python payloadలో స్థానిక ఫైల్‌ను జోడించడానికి దాన్ని encode చేసి, సరిపడే అర్రేలో data URLను జతచేయండి:
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లను అంగీకరించదు.
ఎన్‌కోడ్ చేయడానికి ముందు పరిమితులను తనిఖీ చేయండి. మోడల్ పేజీ ఒక్కొక్కటి గరిష్ఠంగా 4 MiB, 16 మెగాపిక్సెల్‌లున్న PNG, JPEG లేదా WebP చిత్రాలు నాలుగు వరకు, మొత్తం 8 MiB డీకోడ్ చేసిన చిత్రాలను అనుమతిస్తుంది. ఒక్కొక్కటి గరిష్ఠంగా 8 MiB, 300 సెకన్ల నాలుగు ఆడియో క్లిప్‌లు, ఒక్కొక్కటి గరిష్ఠంగా 16 MiB, 60 సెకన్ల రెండు వీడియోలను అనుమతిస్తుంది. ఆడియో, వీడియో కలిపిన డీకోడ్ పరిమితి 16 MiB. వీడియోను సెకనుకు రెండు ఫ్రేముల చొప్పున నమూనా తీస్తారు; అభ్యర్థనలోని ప్రతి వీడియోకు శబ్దం ఉంటే ఫ్రేములతో పాటు ఆడియోను ఉపయోగిస్తారు. జోడింపు చాలా పెద్దదైనా లేదా పొడవైనదైనా, సంబంధిత చిన్న భాగాన్ని వ్యక్తి ఎంచుకోవాలి లేదా వచన-మాత్రమే తనిఖీ చేసి అసలు మీడియాను విడిగా పరిశీలించాలి. కత్తిరించిన లేదా కుదించిన ఫైల్‌ను పూర్తి ఆధారంగా భావించవద్దు.
ఖర్చు, సందర్భ పరిమితి, వైఫల్య మార్గాలను చూడండి
Cloudflare ప్రస్తుతం Clef-omni ధరను మిలియన్ ఇన్‌పుట్ టోకెన్లకు $0.15 గా చూపుతోంది; అవుట్‌పుట్ టోకెన్లకు ఛార్జ్ చేయదని చెబుతోంది. మీడియా అదే రేటుతో ఇన్‌పుట్ టోకెన్లుగా మారుతుంది. గరిష్ఠ రిజల్యూషన్ వీడియోకు నిమిషానికి సుమారు 15,400 వరకు, ఆడియోకు నిమిషానికి సుమారు 780 టోకెన్లు అని మోడల్ పేజీ చెబుతుంది; వీడియోలో శబ్దం ఉంటే ఆడియో టోకెన్లు కూడా చేరతాయి. చిత్ర ఖర్చు పరిమాణం మార్చిన చిత్రంపై ఆధారపడి, ఒక్కో చిత్రానికి 1,024 టోకెన్ల గరిష్ఠ పరిమితి ఉంది. ఇవి బిల్లింగ్ నియమాలు, ఒక్కో జోడింపుకు స్థిర ధర కాదు.
హోస్ట్ చేసిన మోడల్‌కు 64,000 టోకెన్ల సందర్భ పరిమితి ఉంది. మీడియా, ప్రశ్నలు కూడా అందులో లెక్క. దాన్ని మించినప్పుడు అభ్యర్థన విఫలమవుతుందని Cloudflare చెబుతుంది; లేకపోతే state లోని పొడవైన వచనం సరిపోయేలా కత్తిరించబడవచ్చు. కాబట్టి సమాధానం రావడం వల్ల పొడవైన టికెట్‌లోని ప్రతి పంక్తిని మోడల్ పరిశీలించిందని రుజువు కాదు. అభ్యర్థన విఫలమైతే HTTP లోపాన్ని పరిశీలించి, డాక్యుమెంట్ పరిమితులలో జోడింపులను తగ్గించండి లేదా తీసివేసి మళ్లీ ప్రయత్నించండి. విజయవంతమైతే ఆశించిన ప్రశ్న IDలు ఉన్నాయో చూడండి, అసలు టికెట్‌ను సమీక్ష కోసం ఉంచండి, ప్రతిపాదిత రూట్‌ను ఆధారాలతో పోల్చండి. మోడల్ సంభావ్యతలు సమీక్షకుడి దృష్టిని కేంద్రీకరించడంలో తోడ్పడవచ్చు; కానీ సేవా హామీ లేదా సురక్షిత ఆటోమేటిక్ పరిమితికి మీ స్వంత లేబుల్ చేసిన టికెట్లపై మూల్యాంకనం అవసరం.
పెద్ద మార్పు
Cloudflare అక్టోబర్ 9 విడుదలలో, వచనం మరియు చిత్రాలపై రకం-నిర్దేశిత ప్రశ్నలకు ఇప్పటికే ఉపయోగిస్తున్న హోస్ట్ చేసిన Clef నిర్ణయ మోడల్ మార్గానికి ఆడియో, వీడియోను జోడించింది. డెవలపర్ మద్దతున్న మీడియాతో ఒక టికెట్ స్థితిని పంపి, ఒక Workers AI అభ్యర్థనలో స్థిర స్కీమాకు అనుసంధానమైన సమాధానాలను పొందవచ్చు. ఆ స్కీమాలో ఏ ప్రశ్నలు ఉండాలో నిర్ణయించడం, స్వంత టికెట్లపై పనితీరును పరీక్షించడం, సమాధానం లేదా రూటింగ్ చర్యకు ముందు మానవ ఆమోదం కోరడం అప్లికేషన్ బృందం బాధ్యతగానే ఉంటుంది.
మూలాలు మరియు మరింత చదవండి
- Cloudflare Clef-omni మోడల్ డాక్యుమెంటేషన్, 2026 అక్టోబర్ 10న తనిఖీ చేశారు. హోస్ట్ చేసిన మోడల్ ID, API ఫీల్డ్‌లు, ఉదాహరణ, మీడియా మరియు సందర్భ పరిమితులు, ప్రతిస్పందన రూపం, సూచించిన టోకెన్ ధరకు ప్రధాన ఆధారం. డాక్యుమెంటేషన్ సేవ ప్రవర్తనను వివరిస్తుంది; BIG CHANGE అభ్యర్థనను అమలు చేయలేదు.
- Cloudflare Clef-omni విడుదల పోస్ట్, 2026 అక్టోబర్ 9. విడుదల తేదీని నిర్ధారించి, ఎంబెడ్ చేసిన మీడియా అభ్యర్థన ఉదాహరణను ఇస్తుంది. పనితీరు, బెంచ్‌మార్క్ గణాంకాలు Cloudflare స్వంత వాదనలు.
- Cloudflare Workers AI REST సెటప్, చివరిగా 2026 సెప్టెంబర్ 15న నవీకరించారు; అక్టోబర్ 10న తనిఖీ చేశారు. ఖాతా ID, API టోకెన్ పొందే విధానం, చేతితో సృష్టించే టోకెన్‌కు అవసరమైన అనుమతులను చూపుతుంది.
- Cloudflare Workers AI డేటా వినియోగం, చివరిగా 2026 ఏప్రిల్ 21న నవీకరించారు; అక్టోబర్ 10న తనిఖీ చేశారు. Cloudflare కస్టమర్ కంటెంట్‌ను ఎలా ప్రాసెస్ చేస్తుంది, స్పష్టమైన సమ్మతి లేకుండా శిక్షణ లేదా సేవ మెరుగుదలకు ఉపయోగించబోమన్న ప్రకటన, వేరే నిల్వ సేవ వాడినప్పుడు నిల్వ అవకాశం, వర్తించే ఒప్పంద పరిమితిని వివరిస్తుంది. నిర్దిష్ట టికెట్ లేదా రికార్డింగ్‌ను డెవలపర్ పంపవచ్చా అని ఇది నిర్ణయించదు.
