Cloudflare: Clef
Cloudflare Clef je večmodalni model za odločanje s 27B parametri za razvrščanje, preverjanje pravil in izbire v delovnih tokovih agentov. Vrednoti podano stanje in tipizirana vprašanja ter vrača verjetnosti dovoljenih alternativ, izbrane kategorije in utežene ocene. Sprejema besedilne in vizualne dokaze brez ustvarjanja besedila.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Cloudflare Clef je večji gosti model v družini odločanja Clef, dodatno učen na osnovi Qwen3.8-27B skupaj z njegovim kodirnikom za vid. Cloudflare to ogrodje združuje s skupnim modulom za shemo vprašanj, ki dokaze usmerja k vprašanjem in skupaj ocenjuje njihove dovoljene možnosti. Clef prebere situacijo in v enem prehodu naprej vrne odločitve znotraj določenih meja z verjetnostmi. Njegov izhod je rezultat razvrščanja, ne ustvarjeno besedilo, poročilo v prosti obliki ali predlagani ukaz.
Stanje in shemo vprašanj pripravite kot ločena vhoda. Stanje je lahko niz ali JSON, ki predstavlja zapis, pogovor, vsebino dokumenta ali situacijo v aplikaciji. Vprašanja imajo stabilna imena kot ključe in ista imena označujejo njihove vrnjene odgovore. Določite, kaj naj vsako vprašanje ugotovi, in opišite relevantne možnosti. Zapis za podporo lahko vpraša, katera ekipa naj obravnava zahtevek, ali posledice zahtevajo nujno pozornost in katero merilo resnosti velja, ne da bi te različne odločitve združil v eno nejasno kategorijo.
Vprašanje noul vrne verjetnost resničnosti binarnega pogoja. Vprašanje choice vrne izbrano poimenovano možnost, verjetnosti posameznih možnosti in zaupanje. Vprašanje score uporablja urejen seznam opisov z indeksi od nič ter vrne pričakovano oceno, legendo in verjetnosti. Neceloštevilska ocena je smiselna, ker povzema negotovost med urejenimi ravnmi. Poleg izbranega odgovora preglejte tudi porazdelitev; dve bližnji možnosti lahko razkrijeta razliko, ki je vhod ne razreši.
Pri preverjanju pravil vključite dejansko besedilo pravila in dejstva iz zapisa. Primer je delovni tok obdelave dokumentov z vprašanji, ali je zapis popoln, katera kategorija pregleda velja in kako močno dokazi podpirajo takojšnjo pozornost. Za ločene pogoje postavite ločena vprašanja. Modelova ocena skladnosti mora ostati povezana s podanim pravilom in dokazi. Če pomemben pogoj manjka, morata shema in aplikacija imeti premišljen način obravnave te negotovosti.
Za vizualne dokaze posredujte berljivo sliko in vprašanje o vidnem pogoju ali opredeljeni kategoriji. Preverjanje kakovosti obrazca lahko oceni čitljivost, prisotnost zahtevanega območja in katera od podanih ravni kakovosti ga najbolje opisuje. Proizvajalčev vmesnik z odprtimi utežmi sprejema tudi polja videosličic. Sličice ohranite v vrstnem redu in določite dogodek za oceno. Omejena odločitvena shema lahko to gradivo razvrsti, medtem ko zahteva po pripovednem opisu ali poljubnih na novo ustvarjenih poljih spada k drugi vrsti izhoda.
Proizvajalčeva referenca za gostovano storitev navaja kontekst 65 536 žetonov, od enega do 64 vprašanj in do štiri vdelane slike. Posamezne slike PNG, JPEG ali WebP so omejene na 4 MiB in 16 milijonov slikovnih pik, skupno dekodirane na 8 MiB; celotno telo zahteve je omejeno na 13 MiB, oddaljene povezave do slik pa niso sprejete. Vhodni proračun vključuje vprašanja in medije. Dolgo besedilo se lahko skrajša, da se prilega, zato ohranite odločilne odlomke in oznake virov. Te omejitve opisujejo proizvajalčev gostovani slikovni vmesnik; kodirnik z odprtimi utežmi ima lastne predstavitve lokalnih vhodov.
Cloudflarova objava opisuje učenje za ocenjevanje znotraj sheme in umerjanje verjetnosti. Model izlušči relevantne dokaze za posamezne možnosti in nato upošteva informacije med polji. To lahko podpira odločitve o več povezanih vprašanjih v enem zapisu, vendar visoke verjetnosti ne spremeni v jamstvo, da je osnovno dejstvo resnično. Poleg preprostih primerov ocenite tudi zahtevne in nepopolne zapise ter zapise zunaj kategorij. Koristna odločitvena merila pokrivajo situacije, s katerimi se delovni tok dejansko srečuje, in pomembne razlike izrecno določijo.
V delovnem toku agenta lahko izhod določi, kateri opredeljeni naslednji korak je treba obravnavati. Posredujte trenutno opažanje in možna dejanja z jasnimi opisi, nato ohranite izbrano možnost in njene verjetnosti. Okoliška aplikacija uporabi svojo politiko dejanj in zabeleži, kaj je storila. Ta zapis izvedbe ločite od rezultata odločitve: izbira poti pregleda ne dokazuje, da je pregledovalec ukrepal, izbira diagnostičnega koraka pa ne dokazuje, da je korak uspel.
Končni artefakt je objekt odgovorov skupaj s stanjem in shemo, ki sta ga ustvarila. Te zapise uporabite za pregled nepričakovanih razvrstitev, prepoznavanje dvoumnih meril in primerjavo rezultatov s pregledanimi primeri naloge. Če nadaljnji uporabnik potrebuje pisno razlago, sta lahko odločitev in izvirni dokazi vhoda za ločen korak pisanja odgovora. Clef zagotavlja omejeno verjetnostno odločitev, potrebno za izbiro naslednje faze z jasnim zapisom, kaj je bilo ovrednoteno.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefZačetek
Cloudflare Clef je večmodalni model za odločanje s 27B parametri za razvrščanje, preverjanje pravil in izbire v delovnih tokovih agentov. Vrednoti podano stanje in tipizirana vprašanja ter vrača verjetnosti dovoljenih alternativ, izbrane kategorije in utežene ocene. Sprejema besedilne in vizualne dokaze brez ustvarjanja besedila.
- Dovoljeni vhodi
- Besedilo · Slike
- Rezultati
- decisions
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · System One POST /v1/systemone
- Vhod
text,image- Izhod
decisions- Izhodni format
- json
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve cloudflare/clef | Privzeto— |
Poljeprovider | Vrstaschema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljequestions | Vrstaobject | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljesession_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljestate | Vrstaschema | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljetrace | Vrstaschema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljeuser | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljequestions.<id>.type | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve noul, choice, score | Privzeto— |
Poljequestions.<id>.instructions | Vrstastring|object|array | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljequestions.<id>.criteria | Vrstaobject|array | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: choice/score: obvezno; noul: neobvezno. Merila choice so objekt; score je polje z minItems1. | Privzeto— |
Poljequestions.<id>.criteria.true | Vrstastring|object|array | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: Posredovan je objekt meril noul | Privzeto— |
Poljequestions.<id>.criteria.false | Vrstastring|object|array | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: Posredovan je objekt meril noul | Privzeto— |
Kombinacije vhodnih gradiv
noul · Obvezno: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obvezno: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obvezno: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, state, questions |
Parametermaterial_types | Specifikacijatext, image |
Parameteroptional_controls | Specifikacijaprovider, session_id, trace, user |
Parametermultimodal_input_binding | SpecifikacijaUporabite samo natančno deklarirano predstavitev stanja/dokumenta. Proizvajalčeva podpora za slike sama ne potrjuje sprejetega nosilca slike za določen model. |
Življenjski cikel: synchronous
Pošljite natančni ID modela in ohranite celoten izvorni odgovor.
Cenik
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Cene Ailoot
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.00048 / 1K žetonov Izhod · Izhodni žetoni $0 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
| NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.00048 / 1K žetonov Izhod · Izhodni žetoni $0 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot Ultra · System One
{
"model": "cloudflare/clef",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cloudflare/clef'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Prejmi in shrani rezultate
Ailoot Ultra · System One
json
Ohrani vse dokončane rezultate
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohrani se vsak podani odgovor z ID-jem vprašanja, njegovo natančno vrsto, vrednostjo noul/choice/score, zaupanjem, verjetnostmi in legendo. Celoten izvirni JSON se shrani in vrne šele po obračunu.
Če je treba preveriti izvirni odgovor
Ohranite prvotno operacijo in celoten/delni odgovor; ne ponovite POST.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljemodel | Vrstastring |
Poljeid | Vrstastring |
Poljeprovider | Vrstastring |
Poljeanswers.<id>.type | Vrstastring |
Poljeanswers.<id>.noul | Vrstanumber |
Poljeanswers.<id>.choice | Vrstastring |
Poljeanswers.<id>.score | Vrstanumber |
Poljeanswers.<id>.confidence | Vrstanumber |
Poljeanswers.<id>.probabilities | Vrstaobject |
Poljeanswers.<id>.legend | Vrstaobject |
Poljeusage.input_tokens | Vrstainteger |
Poljeusage.output_tokens | Vrstainteger |
Poljeusage.cost | Vrstanumber |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavno obvezno polje, predstavitev ali vrednost | Naslednji korakPopravite navedeno polje zahteve. |
Druga imena
Druga imena modelov
Ailoot Ultra cloudflare/clef
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · Cloudflare: Clef
- Kateri vhodi in rezultati so na voljo?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Katera polja uporablja zahteva?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user