Cloudflare: Clef
Cloudflare Clef je multimodálny rozhodovací model s 27B parametrami na klasifikáciu, kontroly súladu s pravidlami a voľby v pracovných postupoch agentov. Vyhodnocuje dodaný stav a typované otázky a vracia pravdepodobnosti povolených alternatív, vybrané kategórie a vážené skóre. Prijíma textové a vizuálne dôkazy bez generovania textu.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Cloudflare Clef je väčší hustý model v rodine rozhodovacích modelov Clef, dotrénovaný z modelu Qwen3.8-27B spolu s jeho vizuálnym kódovačom. Cloudflare kombinuje tento základ so spoločnou hlavou schémy, ktorá smeruje dôkazy k otázkam a hodnotí ich povolené možnosti spoločne. Clef prečíta situáciu a v jedinom doprednom prechode vráti ohraničené rozhodnutia s pravdepodobnosťami. Jeho výstupom je výsledok klasifikácie, nie generovaný text, otvorená správa ani navrhovaný príkaz.
Stav a schému otázok pripravte ako samostatné vstupy. Stav môže byť reťazec alebo JSON predstavujúci záznam, konverzáciu, obsah dokumentu alebo situáciu v aplikácii. Otázky sú kľúčované stabilnými názvami a tie isté názvy identifikujú ich vrátené odpovede. Definujte, čo má každá otázka zistiť, a opíšte relevantné možnosti. Záznam podpory sa môže pýtať, ktorý tím má požiadavku riešiť, či je dopad naliehavý a ktoré kritérium závažnosti platí, bez toho, aby sa tieto rozdielne rozhodnutia spájali do jednej vágnej kategórie.
Otázka typu noul vracia pravdepodobnosť, že binárna podmienka platí. Otázka typu choice vracia vybranú pomenovanú možnosť, pravdepodobnosti pre jednotlivé možnosti a istotu. Otázka typu score používa zoradený zoznam opisov indexovaný od nuly a vracia očakávané skóre, legendu a pravdepodobnosti. Zlomkové skóre má význam, pretože zhŕňa neistotu naprieč zoradenými úrovňami. Preskúmajte rozdelenie aj vybranú odpoveď; dve blízke možnosti môžu odhaliť rozlíšenie, ktoré vstup nerozhoduje.
Pri kontrolách pravidiel zahrňte skutočné znenie pravidla a fakty zo záznamu. Príkladom je pracovný postup spracovania dokumentov s otázkami, či je záznam úplný, ktorá kategória kontroly platí a nakoľko silno dôkazy podporujú okamžitú pozornosť. Na samostatné podmienky kladte samostatné otázky. Hodnotenie súladu modelom by malo zostať naviazané na dodané pravidlo a dôkazy. Ak dôležitá podmienka chýba, schéma a aplikácia by mali mať premyslený spôsob, ako s touto neistotou zaobchádzať.
Pri vizuálnych dôkazoch dodajte čitateľný obrázok a otázku o viditeľnom stave alebo definovanej kategórii. Kontrola kvality formulára môže hodnotiť čitateľnosť, prítomnosť povinnej oblasti a to, ktorá z dodaných úrovní kvality ju najlepšie opisuje. Rozhranie výrobcu s otvorenými váhami prijíma aj polia snímok videa. Snímky udržiavajte v poradí a určte udalosť, ktorú treba posúdiť. Ohraničená rozhodovacia schéma dokáže takýto materiál klasifikovať, zatiaľ čo požiadavka na naratívny opis alebo ľubovoľné novo generované polia patrí k inému druhu výstupu.
Hostovaná referencia výrobcu uvádza kontext 65 536 tokenov, jednu až 64 otázok a až štyri vložené obrázky. Obrázky PNG, JPEG alebo WebP sú obmedzené na 4 MiB a 16 megapixelov na kus, s celkovým objemom 8 MiB po dekódovaní; celé telo požiadavky je obmedzené na 13 MiB a vzdialené odkazy na obrázky sa neprijímajú. Vstupný rozpočet zahŕňa otázky aj médiá. Dlhý text sa môže skrátiť, aby sa zmestil, preto zachovajte rozhodujúce pasáže a označenia zdrojov. Tieto limity opisujú hostované obrazové rozhranie výrobcu; kódovač s otvorenými váhami má vlastné reprezentácie lokálnych vstupov.
Vydanie od Cloudflare opisuje tréning na hodnotenie viazané na schému a kalibráciu pravdepodobností. Model extrahuje relevantné dôkazy pre jednotlivé možnosti a potom zohľadňuje informácie naprieč poliami. To môže podporiť rozhodovanie o viacerých súvisiacich otázkach v jednom zázname, no vysoká pravdepodobnosť tým nezaručuje, že podkladový fakt je pravdivý. Vyhodnocujte zložité, neúplné a do kategórií nezapadajúce záznamy, ako aj jednoduché prípady. Užitočné rozhodovacie kritériá pokrývajú situácie, s ktorými sa pracovný postup skutočne stretáva, a dôležité rozlíšenia robia explicitnými.
V pracovnom postupe agenta môže výstup určiť, ktorý definovaný ďalší krok sa má zvážiť. Dodajte aktuálne pozorovanie a kandidátske akcie s jasnými opismi, potom uchovajte vybranú možnosť a jej pravdepodobnosti. Okolitá aplikácia uplatní svoje pravidlá pre akcie a zaznamená, čo vykonala. Tento záznam o vykonaní udržiavajte oddelene od výsledku rozhodnutia: výber cesty kontroly nepreukazuje, že kontrolór konal, a výber diagnostického kroku nepreukazuje, že krok uspel.
Konečným artefaktom je objekt odpovedí spolu so stavom a schémou, ktoré ho vytvorili. Tieto záznamy použite na preverenie neočakávaných klasifikácií, odhalenie nejednoznačných kritérií a porovnanie výsledkov s preverenými príkladmi úloh. Ak používateľ v ďalšom kroku potrebuje písomné vysvetlenie, rozhodnutie a pôvodné dôkazy môžu slúžiť ako vstupy pre samostatný krok písania odpovede. Clef poskytuje ohraničené pravdepodobnostné rozhodnutie potrebné na voľbu tejto ďalšej fázy s jasným prehľadom o tom, čo sa vyhodnocovalo.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefÚvod
Cloudflare Clef je multimodálny rozhodovací model s 27B parametrami na klasifikáciu, kontroly súladu s pravidlami a voľby v pracovných postupoch agentov. Vyhodnocuje dodaný stav a typované otázky a vracia pravdepodobnosti povolených alternatív, vybrané kategórie a vážené skóre. Prijíma textové a vizuálne dôkazy bez generovania textu.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- decisions
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · System One POST /v1/systemone
- Vstup
text,image- Výstup
decisions- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity cloudflare/clef | Predvolené— |
Poleprovider | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions | Typobject | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polestate | Typschema | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poletrace | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.type | Typstring | PožiadavkaPovinné | Hodnoty a limity noul, choice, score | Predvolené— |
Polequestions.<id>.instructions | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.criteria | Typobject|array | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: choice/score: povinné; noul: voliteľné. Kritériá pre choice tvoria objekt; score je pole s minItems1. | Predvolené— |
Polequestions.<id>.criteria.true | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Polequestions.<id>.criteria.false | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Kombinácie vstupných podkladov
noul · Povinné: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Povinné: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Povinné: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, state, questions |
Parametermaterial_types | Špecifikáciatext, image |
Parameteroptional_controls | Špecifikáciaprovider, session_id, trace, user |
Parametermultimodal_input_binding | ŠpecifikáciaPoužite iba presne deklarovanú reprezentáciu stavu alebo dokumentu. Samotná obrazová schopnosť výrobcu nepotvrdzuje prijatý spôsob prenosu obrázka pre konkrétny model. |
Životný cyklus: synchronous
Odošlite presné ID modelu a zachovajte celú natívnu odpoveď.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Počet tokenov kontextu väčší než | Tokeny kontextu, najviac (vrátane hranice) | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Počet tokenov kontextu väčší než— | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.00048 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaPásmo dĺžky požiadavky 1 | Sadzobník— | Počet tokenov kontextu väčší než0 | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.00048 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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
Prijať a uložiť výsledky
Ailoot Ultra · System One
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachováva sa každá poskytnutá odpoveď podľa ID otázky s presným typom, hodnotou noul/choice/score, mierou istoty, pravdepodobnosťami a legendou. Celý pôvodný JSON sa uloží a vráti až po zúčtovaní.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodnú operáciu a úplnú alebo čiastočnú odpoveď; POST znova neodosielajte.
Polia odpovede
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleid | Typstring |
Poleprovider | Typstring |
Poleanswers.<id>.type | Typstring |
Poleanswers.<id>.noul | Typnumber |
Poleanswers.<id>.choice | Typstring |
Poleanswers.<id>.score | Typnumber |
Poleanswers.<id>.confidence | Typnumber |
Poleanswers.<id>.probabilities | Typobject |
Poleanswers.<id>.legend | Typobject |
Poleusage.input_tokens | Typinteger |
Poleusage.output_tokens | Typinteger |
Poleusage.cost | Typnumber |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné pole, reprezentácia alebo hodnota | Ďalší krokOpravte označené pole požiadavky. |
Aliasy
Aliasy modelov
Ailoot Ultra cloudflare/clef
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Cloudflare: Clef
- Aké vstupy a výsledky sú dostupné?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Aké polia používa požiadavka?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user