Cloudflare Clef-omni மூலம் ஆதரவு டிக்கெட்டைச் சரிபார்ப்பது எப்படி

Cloudflare அக்டோபர் 9 அன்று, உரையுடன் படம், ஒலித் துணுக்கு அல்லது காணொளியையும் ஆராயக்கூடிய Workers AI-இன் hosted decision model ஆக Clef-omni-ஐ வெளியிட்டது. பயன்பாட்டு உருவாக்குநருக்கு ஏற்ற சோதனை குறுகியது: டிக்கெட் நிலையையும் நிலையான கேள்வித் தொகுப்பையும் மாதிரிக்குக் கொடுத்து, பதில்களை ஆய்ந்து, வழிமாற்று முடிவை ஒருவரிடம் விடுங்கள். இந்த வழிகாட்டி Cloudflare-இன் தற்போதைய மாதிரி ஆவணங்கள் மற்றும் வெளியீட்டு எடுத்துக்காட்டையும்பின்பற்றுகிறது. BIG CHANGE API-ஐ இயக்கவோ ஆதரவு டிக்கெட்டுகளில் அதன் துல்லியத்தை அளவிடவோ இல்லை.

Workers AI-இல் மாதிரி ID @cf/cloudflare/clef-omni ஆகும். இது முடிவெடுக்கும் மாதிரி: அழைப்பவர் வகைப்படுத்தப்பட்ட கேள்விகளையும் அனுமதிக்கப்பட்ட தேர்வுகளையும் வரையறுக்கிறார்; பின்னர் அந்தத் தேர்வுகளுக்கான மதிப்பெண்களைப் பெறுகிறார். இது ஆதரவு பதிலை எழுதாது. Cloudflare திறந்த எடைகளையும் வெளியிட்டுள்ளது; ஆனால் கீழுள்ள படிகள் அதன் hosted endpoint-ஐப் பயன்படுத்துகின்றன. வேகம் மற்றும் benchmark குறித்த Cloudflare எண்கள் அதன் சொந்தக் கூற்றுகள்; உங்கள் டிக்கெட்டுகளில் இந்தப் பணிச்சூழல் எவ்வளவு நன்றாகச் செயல்படும் என்பதை அவை நிறுவுவதில்லை.

அணுகலையும் வரையறுக்கப்பட்ட கேள்வித் தொகுப்பையும் தயார் செய்யுங்கள்

Workers AI அணுகலுள்ள Cloudflare கணக்கு, அதன் account ID, Workers AI API token, மேலும் requests நிறுவப்பட்ட Python அல்லது அதே HTTP கோரிக்கையை அனுப்பும் கருவி தேவை. Cloudflare REST அமைப்பு வழிகாட்டி dashboard-இல் account ID-ஐ எங்கு நகலெடுப்பது, token உருவாக்குவது எப்படி என்பதைக் காட்டுகிறது. கைமுறையாக உருவாக்கிய token-க்கு Workers AI - Read மற்றும் Workers AI - Edit அனுமதிகள் தேவை. Token-ஐ டிக்கெட்டிலும் source control-லும் வைக்காதீர்கள்.

உண்மையான டிக்கெட் அல்லது இணைப்பை அனுப்பினால், வாடிக்கையாளர் உள்ளடக்கம் செயலாக்கத்திற்காக 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ஆக string அல்லது கட்டமைக்கப்பட்ட object/array-ஐ ஏற்கிறது. questions வரைபடத்தில் 1 முதல் 64 கேள்வி ID-கள் இருக்க வேண்டும்; ஒவ்வொன்றுக்கும் வகையும் வழிமுறைகளும் உண்டு; அனுமதிக்கப்பட்ட பதில்களை வரையறுக்க choice மற்றும் score அளவுகோல்களைப் பயன்படுத்துகின்றன.

உரை கோரிக்கையை அனுப்புங்கள்

உங்கள் சூழலில் CLOUDFLARE_AUTH_TOKEN அமைத்து கீழே உள்ள account ID-ஐ மாற்றுங்கள். இந்த Python கோரிக்கை Cloudflare மாதிரி எடுத்துக்காட்டில் உள்ள அதே endpoint மற்றும் புலங்களைப்பயன்படுத்துகிறது:

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 விவரிக்கிறது. model மற்றும் usage பதில் புலங்களையும் API ஆவணப்படுத்துகிறது. பயன்பாட்டில் வரைபடமாக்குவதற்கு முன் உங்கள் கணக்குக்குத் திரும்பிய முழு JSON-ஐ ஆயுங்கள். நிகழ்தகவு என்பது வழங்கிய கேள்வி மற்றும் நிலைக்கான மாதிரியின் வெளியீடு; உண்மையான டிக்கெட் அந்த வரிசைக்குச் செல்ல வேண்டும் என்ற உத்தரவாதம் அல்ல. நடவடிக்கை எடுப்பதற்கு முன் டிக்கெட்டையும் இணைப்பையும் முன்மொழியப்பட்ட வழியுடன் ஒருவர் ஒப்பிட்டுப் பார்க்க வேண்டும்.

படம், ஒலிப்பதிவு அல்லது காணொளியைச் சேர்க்கவும்

Cloudflare-இன் வெளியீட்டு கோரிக்கை விருப்பமான ஊடகத்தை தனித்தனி images, audio மற்றும் videos வரிசைகளில் embedded base64 data: URL-களாக வைக்கிறது. அதன் மாதிரி data:image/png;base64,..., data:audio/mpeg;base64,... மற்றும் data:video/mp4;base64,...ஆகியவற்றைப் பயன்படுத்துகிறது. POST-க்கு முன் உள்ளூர் கோப்பை Python payload-இல் சேர்க்க requests.post, அதை 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")

இயக்குங்கள் add_media POST-க்கு முன் இயக்குங்கள். state உண்மைக்கேற்ப இருக்கட்டும்; ஒவ்வொரு இணைப்பும் என்னவென்று விவரித்து, கிடைக்கும் டிக்கெட்டும் ஊடகமும் பதிலளிக்கக்கூடிய கேள்விகளை மட்டும் கேளுங்கள். கண்ணுக்குத் தெரியும், காதுக்குக் கேட்கும் விவரங்கள் குறித்து மூன்று ஆம்/இல்லை கேள்விகளைக் கேட்க Cloudflare எடுத்துக்காட்டில் சாதனப் படம், ஒலிப்பதிவு, விசிறிக் காணொளி பயன்படுத்தப்படுகின்றன. ஆதரவு பயன்பாடு தனது டிக்கெட் புலங்களை state இலும் அனுமதிக்கப்பட்ட வரிசைகளை criteriaஇலும் வைத்துக்கொள்ளலாம்; ஆனால் அவற்றை உண்மையான பணிச்சூழலுடன் சரிபார்க்க வேண்டும். தொலைநிலை ஊடக URL-களை சேவை ஏற்காது.

Encode செய்வதற்கு முன் வரம்புகளைப் பாருங்கள். மாதிரிப் பக்கம் நான்கு PNG, JPEG அல்லது WebP படங்கள் வரை அனுமதிக்கிறது; ஒவ்வொன்றும் 4 MiB, 16 megapixel வரை; மொத்த decoded படங்கள் 8 MiB வரை. நான்கு ஒலித் துணுக்குகள் வரை, ஒவ்வொன்றும் 8 MiB, 300 வினாடிகள் வரை; இரண்டு காணொளிகள் வரை, ஒவ்வொன்றும் 16 MiB, 60 வினாடிகள் வரை அனுமதிக்கிறது. ஒலி மற்றும் காணொளி ஒன்றாக 16 MiB decoded வரம்பைக் கொண்டுள்ளன. வினாடிக்கு இரண்டு frame-கள் வீதம் காணொளி மாதிரியாக்கப்படும்; கோரிக்கையில் உள்ள ஒவ்வொரு காணொளிக்கும் ஒலிப்பாதை இருந்தால் அது frame-களுடன் பயன்படுத்தப்படும். மறுஅளவிடப்பட்ட படத்தின் அடிப்படையில் படச் செலவு கணக்கிடப்பட்டு, படமொன்றுக்கு 1,024 token-களாக வரையறுக்கப்படுகிறது. இணைப்பு மிகப் பெரியதாகவோ நீண்டதாகவோ இருந்தால், தொடர்புடைய சிறிய பகுதியை ஒருவர் தேர்ந்தெடுக்கட்டும்; அல்லது உரை மட்டும் கொண்டு சரிபார்த்து அசல் ஊடகத்தைத் தனியாகப் பாருங்கள். வெட்டிய அல்லது சுருக்கிய கோப்பை முழுச் சான்றாகக் கருதாதீர்கள்.

செலவு, context, தோல்வி வழிகளைச் சரிபார்க்கவும்

Cloudflare தற்போது Clef-omni விலையை $0.15 / ஒரு மில்லியன் input token-களுக்கு எனப் பட்டியலிட்டு, output token-களுக்கு கட்டணம் இல்லை என்கிறது. ஊடகம் அதே விகிதத்தில் input token-களாக மாற்றப்படுகிறது. அதிகபட்சத் தெளிவுத்திறனில் ஒலி நிமிடத்திற்கு சுமார் 780 token-களும் காணொளி நிமிடத்திற்கு சுமார் 15,400 token-கள் வரையும், காணொளியில் ஒலி இருந்தால் கூடுதல் audio token-களும் இருக்கும் என மாதிரிப் பக்கம் கூறுகிறது. மறுஅளவிடப்பட்ட படத்தின் செலவு படத்தைப் பொறுத்தது; படமொன்றுக்கு 1,024 token வரம்பு உண்டு. இவை கட்டண விதிகள்; இணைப்பொன்றுக்கான நிலையான விலை அல்ல.

Hosted மாதிரிக்கு 64,000-token context உள்ளது. ஊடகமும் கேள்விகளும் அதில் கணக்காகும். அவை வரம்பை மீறினால் கோரிக்கை தோல்வியடையும் என Cloudflare கூறுகிறது; இல்லையெனில் நீண்ட உரை பொருந்துவதற்காக state இல் துண்டிக்கப்படலாம். ஆகவே நீண்ட டிக்கெட்டின் ஒவ்வொரு வரியையும் மாதிரி கருத்தில் கொண்டது என்பதற்கு திரும்பிய பதில் சான்றல்ல. கோரிக்கை தோல்வியுற்றால் HTTP பிழையைப் பார்த்து, மீண்டும் முயல்வதற்கு முன் ஆவணப்படுத்தப்பட்ட வரம்புகளுக்குள் இணைப்புகளைக் குறைக்கவும் அல்லது நீக்கவும். வெற்றி பெற்றால் எதிர்பார்த்த கேள்வி ID-கள் உள்ளனவா எனச் சரிபார்த்து, அசல் டிக்கெட்டை மதிப்பாய்வுக்காகப் பாதுகாத்து, முன்மொழியப்பட்ட வழியைச் சான்றுகளுடன் ஒப்பிடுங்கள். மாதிரியின் நிகழ்தகவுகள் மதிப்பாய்வாளர் கவனம் செலுத்த உதவும்; ஆனால் சேவை உத்தரவாதம் அல்லது பாதுகாப்பான தானியங்கி வரம்புக்கு உங்கள் சொந்த label செய்யப்பட்ட டிக்கெட்டுகளில் மதிப்பீடு தேவை.

பெரிய மாற்றம்

Cloudflare-இன் அக்டோபர் 9 வெளியீடு, உரை மற்றும் படக் கேள்விகளுக்குப் பயன்படுத்தப்பட்ட hosted Clef decision model பாதையில் ஒலியையும் காணொளியையும் சேர்க்கிறது. ஆதரிக்கப்படும் ஊடகத்துடன் ஒரு டிக்கெட் நிலையை உருவாக்குநர் ஒரே Workers AI கோரிக்கையில் சமர்ப்பித்து, நிலையான schema-வுக்கான பதில்களைப் பெறலாம். எந்தக் கேள்விகள் schema-வில் இருக்க வேண்டும் என்பதைத் தேர்ந்தெடுப்பதும், சொந்த டிக்கெட்டுகளில் செயல்திறனைச் சோதிப்பதும், பதில் அல்லது வழிமாற்றுக்கு முன் மனித ஒப்புதல் பெறுவதும் பயன்பாட்டுக் குழுவின் பொறுப்பாகவே உள்ளது.

ஆதாரங்கள் மற்றும் மேலும் வாசிக்க

• Cloudflare Clef-omni மாதிரி ஆவணங்கள், 2026 அக்டோபர் 10 அன்று சரிபார்க்கப்பட்டது. Hosted model ID, API புலங்களும் எடுத்துக்காட்டும், ஊடக மற்றும் context வரம்புகள், பதில் வடிவம், பட்டியலிடப்பட்ட token விலை ஆகியவற்றுக்கான முதன்மை ஆதாரம். ஆவணங்கள் சேவையின் நடத்தையை விவரிக்கின்றன; BIG CHANGE கோரிக்கையை இயக்கவில்லை.
• Cloudflare Clef-omni வெளியீட்டுப் பதிவு, 2026 அக்டோபர் 9. வெளியீட்டுத் தேதியை உறுதிப்படுத்தி, embedded-media கோரிக்கை எடுத்துக்காட்டை வழங்குகிறது. செயல்திறன் மற்றும் benchmark எண்கள் Cloudflare-இன் சொந்தக் கூற்றுகள்.
• Cloudflare Workers AI REST அமைப்பு, 2026 செப்டம்பர் 15 அன்று கடைசியாகப் புதுப்பிக்கப்பட்டு, அக்டோபர் 10 அன்று சரிபார்க்கப்பட்டது. Account ID மற்றும் API token பெறும் முறையையும், கைமுறையாக உருவாக்கிய token-க்குத் தேவையான அனுமதிகளையும் காட்டுகிறது.
• Cloudflare Workers AI தரவுப் பயன்பாடு, 2026 ஏப்ரல் 21 அன்று கடைசியாகப் புதுப்பிக்கப்பட்டு, அக்டோபர் 10 அன்று சரிபார்க்கப்பட்டது. வாடிக்கையாளர் உள்ளடக்கத்தை Cloudflare செயலாக்குவது, வெளிப்படையான ஒப்புதல் இல்லாமல் பயிற்சி மற்றும் சேவை மேம்பாட்டுக்குப் பயன்படுத்தாது என்ற அதன் கட்டுப்பாடு, தனி சேமிப்புச் சேவையைப் பயன்படுத்தும்போது சாத்தியமான சேமிப்பு, பொருந்தும் ஒப்பந்த வரம்பு ஆகியவற்றை விளக்குகிறது. குறிப்பிட்ட டிக்கெட் அல்லது ஒலிப்பதிவை உருவாக்குநர் சமர்ப்பிக்கலாமா என்பதை இது முடிவுசெய்யாது.