Cloudflare merilis Clef-omni pada 9 Oktober sebagai model keputusan yang dihosting di Workers AI dan dapat memeriksa teks bersama gambar, klip audio, atau video. Bagi pengembang aplikasi, uji yang berguna memiliki cakupan sempit: berikan status tiket dan kumpulan pertanyaan tetap kepada model, periksa jawabannya, dan serahkan keputusan perutean kepada seseorang. Panduan ini mengikuti dokumentasi model Cloudflare saat ini dan contoh peluncurannya. BIG CHANGE belum menjalankan API atau mengukur akurasinya pada tiket dukungan.
ID modelnya adalah @cf/cloudflare/clef-omni di Workers AI. Ini model keputusan: pemanggil menentukan pertanyaan bertipe dan pilihan yang diizinkan, lalu menerima skor untuk pilihan tersebut. Model ini tidak menulis balasan dukungan. Cloudflare juga merilis bobot terbuka, tetapi langkah berikut menggunakan endpoint yang dihosting. Angka kecepatan dan tolok ukur Cloudflare adalah klaim mereka sendiri; angka tersebut tidak membuktikan seberapa baik alur kerja ini akan bekerja pada tiket Anda.
Siapkan akses dan kumpulan pertanyaan yang terbatas
Anda memerlukan akun Cloudflare dengan akses Workers AI, ID akun, token API Workers AI, serta Python dengan requests terpasang atau alat yang dapat membuat permintaan HTTP yang sama. Panduan penyiapan REST Cloudflare menunjukkan tempat menyalin ID akun dan membuat token di dasbor. Token yang dibuat secara manual memerlukan izin Workers AI - Read dan Workers AI - Edit. Jangan masukkan token ke tiket atau kontrol kode sumber.
Mengirim tiket nyata atau lampiran berarti mengirim konten pelanggan ke Cloudflare untuk diproses. Halaman penggunaan data Workers AI Cloudflare menyatakan bahwa konten tersebut tidak digunakan untuk melatih model yang ditawarkan di Workers AI atau meningkatkan layanan tanpa persetujuan eksplisit; halaman itu juga menyatakan bahwa konten dapat disimpan jika Workers AI digunakan bersama layanan penyimpanan seperti R2 atau KV. Sebelum mengirim tiket pelanggan, periksa perjanjian Cloudflare yang berlaku dan aturan data pelanggan organisasi Anda, lalu minimalkan atau samarkan informasi pribadi bila praktis. Pernyataan Cloudflare tentang tidak adanya pelatihan saja tidak menetapkan izin untuk mengirim data pelanggan tertentu.
Mulailah dengan teks agar Anda dapat memeriksa respons sebelum menambahkan media. Contoh dukungan Cloudflare sendiri menggunakan status Checkout has been failing for every customer for the last hour dan mengajukan tiga pertanyaan: apakah mendesak (noul, tipe ya/tidak), tim mana yang harus menanganinya (choice), dan seberapa parah dampaknya (score). Ini contoh yang didokumentasikan, bukan insiden yang diamati. API menerima string atau objek/array terstruktur sebagai state. Peta questions harus memuat 1 hingga 64 ID pertanyaan; masing-masing memiliki tipe dan instruksi, sedangkan choice dan score menggunakan kriteria untuk menentukan respons yang diizinkan.
Kirim permintaan teks
Atur CLOUDFLARE_AUTH_TOKEN di lingkungan Anda dan ganti ID akun di bawah. Permintaan Python ini menyesuaikan endpoint dan kolom persis dari contoh model 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())Untuk pemeriksaan yang berhasil, cari entri respons dalam answers dengan ID urgent, team dan severity IDs. Cloudflare menjelaskan yang pertama sebagai probabilitas urgensi, yang kedua sebagai tim terpilih dengan probabilitas untuk opsinya, dan yang ketiga sebagai skor berbobot probabilitas dengan tingkat terendah nol. API juga mendokumentasikan kolom respons model dan usage. Periksa seluruh JSON yang dikembalikan ke akun Anda sebelum memetakannya ke aplikasi. Probabilitas adalah keluaran model untuk pertanyaan dan status yang diberikan, bukan jaminan bahwa tiket sungguhan termasuk dalam antrean tersebut. Sebelum mengambil tindakan, seseorang harus membandingkan tiket dan lampirannya dengan rute yang diusulkan serta buktinya.
Tambahkan foto, rekaman, atau video
Permintaan peluncuran menempatkan media opsional dalam array terpisah images, audio dan videos sebagai data base64 tertanam di data: URL. Misalnya, sampelnya menggunakan data:image/png;base64,..., data:audio/mpeg;base64,... dan data:video/mp4;base64,.... Untuk menambahkan satu berkas lokal ke payload Python sebelum requests.post, enkode berkas itu dan tambahkan URL data ke array yang sesuai:
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")Jalankan add_media sebelum POST. Pertahankan state tetap faktual dan jelaskan isi setiap lampiran; tanyakan hanya hal yang dapat dijawab oleh tiket dan media yang tersedia. Contoh peluncuran Cloudflare memakai foto unit, rekaman suara, dan video kipas untuk mengajukan tiga pertanyaan ya/tidak tentang detail yang terlihat dan terdengar. Aplikasi dukungan dapat menyimpan kolom tiketnya sendiri di state dan antrean yang diizinkan di criteria, tetapi harus mencocokkan definisi tersebut dengan alur kerja nyata. Layanan ini tidak menerima URL media jarak jauh.
Periksa batas sebelum melakukan enkode. Lihat halaman model mengizinkan hingga empat gambar PNG, JPEG, atau WebP, masing-masing paling besar 4 MiB dan 16 megapiksel, dengan total gambar terdekode 8 MiB. Halaman itu mengizinkan hingga empat klip audio, masing-masing paling besar 8 MiB dan 300 detik, serta dua video, masing-masing paling besar 16 MiB dan 60 detik. Batas total terdekode untuk audio dan video adalah 16 MiB. Video diambil sampelnya pada dua bingkai per detik; suara videonya digunakan bersama bingkai jika setiap video dalam permintaan memiliki suara. Jika lampiran terlalu besar atau panjang, minta seseorang memilih cuplikan relevan yang lebih kecil atau gunakan pemeriksaan teks saja dan tinjau media asli secara terpisah. Jangan perlakukan berkas yang dipotong atau dipersingkat sebagai bukti lengkap.
Periksa biaya, konteks, dan jalur kegagalan
Cloudflare saat ini mencantumkan harga Clef-omni sebesar $0,15 per satu juta token masukan dan menyatakan tidak mengenakan biaya untuk token keluaran. Media dikonversi menjadi token masukan dengan tarif tersebut. Halaman model menyebut sekitar 780 token per menit audio dan hingga sekitar 15.400 token per menit video pada resolusi maksimum, ditambah token audio jika video memiliki suara. Biaya gambar bergantung pada gambar yang diubah ukurannya dan dibatasi hingga 1.024 token per gambar. Ini adalah aturan penagihan, bukan harga tetap per lampiran.
Model yang dihosting memiliki konteks 64.000 token. Media dan pertanyaan ikut dihitung. Jika melebihi jendela itu, Cloudflare menyatakan permintaan gagal; jika tidak, teks panjang di state dapat dipotong agar muat. Karena itu, jawaban yang diterima tidak membuktikan bahwa model mempertimbangkan setiap baris tiket panjang. Jika permintaan gagal, periksa kesalahan HTTP dan kurangi atau hapus lampiran sesuai batas yang didokumentasikan sebelum mencoba lagi. Jika berhasil, pastikan ID pertanyaan yang diharapkan tersedia, simpan tiket asli untuk ditinjau, dan bandingkan rute yang diusulkan dengan bukti. Probabilitas model dapat membantu peninjau memusatkan perhatian, tetapi jaminan layanan atau ambang otomatis yang aman memerlukan evaluasi pada tiket berlabel milik Anda sendiri.
Perubahan besar
Rilis Cloudflare pada 9 Oktober menambahkan audio dan video ke jalur model keputusan Clef yang dihosting, yang sebelumnya digunakan untuk pertanyaan bertipe atas teks dan gambar. Pengembang dapat mengirim satu status tiket dengan media yang didukung dan menerima jawaban berkunci pada skema tetap melalui satu permintaan Workers AI. Tim aplikasi tetap harus menentukan pertanyaan yang masuk ke skema tersebut, menguji kinerja pada tiketnya sendiri, dan mewajibkan persetujuan manusia sebelum mengirim balasan atau mengambil tindakan perutean.
Sumber dan bacaan lanjutan
- Dokumentasi model Cloudflare Clef-omni, diperiksa pada 10 Oktober 2026. Rujukan utama untuk ID model yang dihosting, kolom dan contoh API, batas media dan konteks, bentuk respons, serta harga token yang tercantum. Dokumentasi menjelaskan perilaku layanan; BIG CHANGE tidak menjalankan permintaan tersebut.
- Tulisan peluncuran Clef-omni dari Cloudflare, 9 Oktober 2026. Menetapkan tanggal peluncuran dan memberikan contoh permintaan media tersemat. Angka performa dan tolok ukur merupakan klaim Cloudflare sendiri.
- Penyiapan REST Cloudflare Workers AI, terakhir diperbarui 15 September 2026 dan diperiksa 10 Oktober. Menunjukkan cara mendapatkan ID akun dan token API serta mengidentifikasi izin yang diperlukan untuk token buatan manual.
- Penggunaan data Cloudflare Workers AI, terakhir diperbarui 21 April 2026 dan diperiksa 10 Oktober. Menjelaskan pemrosesan konten pelanggan oleh Cloudflare, batasan yang dinyatakan terhadap pelatihan dan peningkatan layanan tanpa persetujuan eksplisit, kemungkinan penyimpanan saat layanan penyimpanan terpisah digunakan, serta batas perjanjian yang berlaku. Halaman ini tidak menentukan apakah pengembang boleh mengirim tiket atau rekaman tertentu.
