Cloudflare: Clef
Cloudflare Clef je multimodální rozhodovací model o velikosti 27B pro klasifikaci, kontrolu pravidel a volby v pracovních postupech agentů. Vyhodnocuje dodaný stav a typované otázky a vrací pravděpodobnosti povolených alternativ, vybrané kategorie a vážená skóre. Přijímá textové a vizuální podklady bez generování textu.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Cloudflare Clef je větší hustý model z rozhodovací rodiny Clef, následně trénovaný z Qwen3.8-27B s jeho vizuálním kodérem. Cloudflare tuto základní architekturu kombinuje se společnou hlavou schématu, která směruje podklady k otázkám a společně hodnotí jejich povolené možnosti. Clef přečte situaci a v jediném dopředném průchodu vrátí omezená rozhodnutí s pravděpodobnostmi. Jeho výstupem je výsledek klasifikace, nikoli generovaný text, zpráva s volným obsahem nebo navrhovaný příkaz.
Připravte stav a schéma otázek jako samostatné vstupy. Stav může být řetězec nebo JSON představující záznam, konverzaci, obsah dokumentu či situaci v aplikaci. Otázky mají klíče v podobě stabilních názvů a stejné názvy identifikují vrácené odpovědi. Definujte, co má každá otázka zjistit, a popište příslušné možnosti. Záznam podpory se může ptát, který tým má požadavek řešit, zda je dopad naléhavý a které kritérium závažnosti platí, aniž by tato různá rozhodnutí spojoval do jedné vágní kategorie.
Otázka noul vrací pravděpodobnost pravdivosti binární podmínky. Otázka choice vrací vybranou pojmenovanou možnost, pravděpodobnosti jednotlivých možností a jistotu. Otázka score používá uspořádaný seznam popisů indexovaný od nuly a vrací očekávané skóre, legendu a pravděpodobnosti. Zlomkové skóre má význam, protože shrnuje nejistotu mezi uspořádanými úrovněmi. Prohlížejte rozdělení i vybranou odpověď; dvě blízké možnosti mohou odhalit rozdíl, který vstup nerozhoduje.
Při kontrole pravidel zahrňte skutečné znění pravidla a fakta ze záznamu. Příkladem je pracovní postup zpracování dokumentů s otázkami, zda je záznam úplný, která kategorie kontroly platí a jak silně podklady podporují potřebu okamžité pozornosti. Pro samostatné podmínky pokládejte samostatné otázky. Posouzení souladu modelem má zůstat propojené s dodaným pravidlem a podklady. Pokud důležitá podmínka chybí, schéma i aplikace mají mít záměrně určený způsob, jak s touto nejistotou zacházet.
Pro vizuální podklady poskytněte čitelný obrázek a otázku na viditelnou podmínku nebo definovanou kategorii. Kontrola kvality formuláře může vyhodnocovat čitelnost, přítomnost povinné oblasti a to, která z dodaných úrovní kvality jej nejlépe popisuje. Rozhraní výrobce pro otevřené váhy přijímá také pole snímků videa. Zachovejte pořadí snímků a určete událost k posouzení. Omezené rozhodovací schéma může tento materiál klasifikovat, zatímco požadavek na vyprávěcí popis nebo libovolná nově generovaná pole patří k jinému typu výstupu.
Referenční dokumentace hostované služby výrobce uvádí kontext 65 536 tokenů, jednu až 64 otázek a nejvýše čtyři vložené obrázky. Obrázky PNG, JPEG nebo WebP jsou omezeny na 4 MiB a 16 megapixelů každý, celkem na 8 MiB po dekódování; celé tělo požadavku má limit 13 MiB a vzdálené odkazy na obrázky nejsou přijímány. Vstupní rozpočet zahrnuje otázky a média. Dlouhý text může být zkrácen, aby se vešel, proto zachovejte rozhodující pasáže a označení zdrojů. Tyto limity popisují hostované obrazové rozhraní výrobce; kodér modelu s otevřenými vahami má vlastní reprezentace místních vstupů.
Vydání Cloudflare popisuje trénování pro hodnocení v mezích schématu a kalibraci pravděpodobností. Model získává relevantní podklady pro jednotlivé možnosti a poté zvažuje informace napříč poli. To může podpořit rozhodování o několika souvisejících otázkách v jednom záznamu, ale vysoká pravděpodobnost tím není zárukou pravdivosti základního faktu. Vyhodnocujte obtížné, neúplné i do kategorií nespadající záznamy vedle jednoznačných případů. Užitečná rozhodovací kritéria pokrývají situace, s nimiž se pracovní postup skutečně setkává, a výslovně zachycují důležité rozdíly.
V pracovním postupu agenta může výstup určit, který definovaný další krok se má zvážit. Dodejte aktuální pozorování a kandidátní akce s jasnými popisy a poté uchovejte vybranou možnost i její pravděpodobnosti. Okolní aplikace uplatní svá pravidla pro akce a zaznamená, co provedla. Tento záznam provedení oddělujte od výsledku rozhodnutí: výběr cesty ke kontrole nedokládá, že kontrolující osoba jednala, a výběr diagnostického kroku nedokládá, že krok uspěl.
Konečným artefaktem je objekt odpovědí spolu se stavem a schématem, které jej vytvořily. Pomocí těchto záznamů zkoumejte neočekávané klasifikace, identifikujte nejednoznačná kritéria a porovnávejte výsledky s prověřenými příklady z úlohy. Pokud navazující uživatel potřebuje písemné vysvětlení, mohou rozhodnutí a původní podklady vstoupit do samostatného kroku psaní odpovědi. Clef poskytuje omezené pravděpodobnostní rozhodnutí potřebné pro volbu této další fáze s jasným přehledem o tom, co bylo vyhodnoceno.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefÚvod
Cloudflare Clef je multimodální rozhodovací model o velikosti 27B pro klasifikaci, kontrolu pravidel a volby v pracovních postupech agentů. Vyhodnocuje dodaný stav a typované otázky a vrací pravděpodobnosti povolených alternativ, vybrané kategorie a vážená skóre. Přijímá textové a vizuální podklady bez generování textu.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- decisions
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · System One POST /v1/systemone
- Vstup
text,image- Výstup
decisions- Výstupní formát
- json
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity cloudflare/clef | Výchozí— |
Poleprovider | Typschema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polequestions | Typobject | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polestate | Typschema | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Poletrace | Typschema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polequestions.<id>.type | Typstring | PožadavekPovinné | Hodnoty a limity noul, choice, score | Výchozí— |
Polequestions.<id>.instructions | Typstring|object|array | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polequestions.<id>.criteria | Typobject|array | PožadavekVolitelné | Hodnoty a limity Podmínky: choice/score: povinné; noul: volitelné. Kritéria choice tvoří objekt; score je pole s minItems1. | Výchozí— |
Polequestions.<id>.criteria.true | Typstring|object|array | PožadavekPovinné | Hodnoty a limity Platí, když: Je zadán objekt kritérií noul | Výchozí— |
Polequestions.<id>.criteria.false | Typstring|object|array | PožadavekPovinné | Hodnoty a limity Platí, když: Je zadán objekt kritérií noul | Výchozí— |
Kombinace vstupních materiálů
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
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, state, questions |
Parametrmaterial_types | Kontrakttext, image |
Parametroptional_controls | Kontraktprovider, session_id, trace, user |
Parametrmultimodal_input_binding | KontraktPoužijte pouze přesně deklarovaný způsob zadání stavu či dokumentu. Samotná podpora obrázků u výrobce nepotvrzuje způsob předání obrázku přijímaný konkrétním modelem. |
Životní cyklus: synchronous
Odešlete přesné ID modelu a uchovejte celou nativní odpověď.
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Sazby Ailoot
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Tokeny kontextu, více než | Tokeny kontextu, do uvedené hodnoty včetně | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Tokeny kontextu, více než— | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.00048 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| KonfiguracePásmo délky požadavku 1 | Tabulka sazeb— | Tokeny kontextu, více než0 | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.00048 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
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
Přijímání a ukládání výsledků
Ailoot Ultra · System One
json
Uchovejte všechny dokončené výsledky
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Zachovává se každá poskytnutá odpověď přiřazená k ID otázky, její přesný typ, hodnota noul/choice/score, míra jistoty, pravděpodobnosti a legenda. Celý původní JSON se uloží a vrátí až po vyúčtování.
Pokud je nutné ověřit původní odpověď
Zachovejte původní operaci a úplnou či částečnou odpověď; požadavek POST neopakujte.
Pole odpovědi
| 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 další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatné povinné pole, způsob zadání nebo hodnota | Další krokOpravte označené pole požadavku. |
Aliasy
Aliasy modelu
Ailoot Ultra cloudflare/clef
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Cloudflare: Clef
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Jaká pole požadavek používá?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user