Cloudflare: Clef
Cloudflare Clef er en multimodal beslutningsmodell på 27B parametere for klassifisering, regelkontroll og valg i agenters arbeidsflyter. Den vurderer en innsendt tilstand og typede spørsmål og returnerer sannsynligheter for tillatte alternativer, valgte kategorier og vektede skårer. Den godtar tekstlig og visuell evidens uten å generere prosa.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Cloudflare Clef er den større tette modellen i Clef-familien av beslutningsmodeller, ettertrent fra Qwen3.8-27B med dens visuelle enkoder. Cloudflare kombinerer denne grunnmodellen med et felles skjemahode som knytter evidens til spørsmålene og skårer de tillatte alternativene samlet. Clef leser en situasjon og returnerer avgrensede beslutninger med sannsynligheter i én fremoverpassering. Resultatet er en klassifisering, fremfor generert prosa, en åpen rapport eller en foreslått kommando.
Forbered tilstanden og spørsmålsskjemaet som separate inndata. Tilstanden kan være en streng eller JSON som representerer en post, en samtale, dokumentinnhold eller en situasjon i applikasjonen. Spørsmålene har stabile navn som nøkler, og de samme navnene identifiserer de returnerte svarene. Definer hva hvert spørsmål skal avklare, og beskriv de relevante alternativene. En supportpost kan spørre hvilket team som skal håndtere forespørselen, om konsekvensen er akutt, og hvilket alvorlighetskriterium som gjelder, uten å samle disse ulike beslutningene i én vag kategori.
Et noul-spørsmål returnerer sannsynligheten for sann for en binær betingelse. Et choice-spørsmål returnerer et valgt navngitt alternativ, sannsynligheter per alternativ og konfidens. Et score-spørsmål bruker en ordnet liste med beskrivelser, indeksert fra null, og returnerer en forventet skår, en tegnforklaring og sannsynligheter. En skår med desimaler er meningsfull fordi den oppsummerer usikkerhet på tvers av ordnede nivåer. Undersøk både fordelingen og det valgte svaret; to alternativer som ligger nær hverandre, kan avdekke et skille inndataene ikke avklarer.
Ved regelkontroll inkluderer du den faktiske regelteksten og faktaene i posten. Et eksempel er en arbeidsflyt for dokumentbehandling med spørsmål om posten er fullstendig, hvilken gjennomgangskategori som gjelder, og hvor sterkt evidensen støtter umiddelbar oppmerksomhet. Still separate spørsmål for separate betingelser. En modellvurdering av etterlevelse bør forbli knyttet til den innsendte regelen og evidensen. Hvis en viktig betingelse mangler, bør skjemaet og applikasjonen ha en bevisst utformet måte å håndtere usikkerheten på.
For visuell evidens sender du inn et lesbart bilde og et spørsmål om et synlig forhold eller en definert kategori. En skjemakvalitetskontroll kan vurdere leselighet, om et påkrevd område er til stede, og hvilket av de angitte kvalitetsnivåene som beskriver det best. Produsentens grensesnitt med åpne modellvekter godtar også arrayer med videobilder. Hold bildene i rekkefølge og identifiser hendelsen som skal vurderes. Et avgrenset beslutningsskjema kan klassifisere materialet, mens en forespørsel om en fortellende beskrivelse eller vilkårlige nygenererte felter tilhører en annen type resultat.
Produsentens vertsbaserte referanse oppgir en kontekst på 65 536 tokener, ett til 64 spørsmål og opptil fire innebygde bilder. PNG-, JPEG- eller WebP-bilder er begrenset til 4 MiB og 16 megapiksler per bilde, med totalt 8 MiB dekodede data; hele forespørselskroppen er begrenset til 13 MiB, og eksterne bildelenker godtas ikke. Inndatabudsjettet omfatter spørsmålene og mediene. Lang tekst kan bli avkortet for å få plass, så bevar avgjørende avsnitt og kildemerking. Disse grensene beskriver produsentens vertsbaserte bildegrensesnitt; enkoderen med åpne modellvekter har sine egne representasjoner av lokale inndata.
Cloudflares utgivelse beskriver trening for skjemabundet skåring og sannsynlighetskalibrering. Modellen trekker ut relevant evidens for de enkelte alternativene og vurderer deretter informasjon på tvers av felter. Dette kan støtte beslutninger om flere relaterte spørsmål i én post, men gjør ikke en høy sannsynlighet til en garanti for at det underliggende forholdet er sant. Vurder vanskelige, ufullstendige og kategorifremmede poster i tillegg til enkle tilfeller. Nyttige beslutningskriterier dekker situasjonene arbeidsflyten faktisk møter, og gjør viktige skiller uttrykkelige.
I en agents arbeidsflyt kan resultatet avgjøre hvilket definert neste trinn som bør vurderes. Send inn den gjeldende observasjonen og mulige handlinger med tydelige beskrivelser, og behold deretter det valgte alternativet og sannsynlighetene. Applikasjonen rundt modellen anvender sin handlingspolicy og registrerer hva den gjorde. Hold denne utførelsesregistreringen atskilt fra beslutningsresultatet: Å velge en rute for gjennomgang fastslår ikke at en kontrollør handlet, og å velge et diagnostisk trinn fastslår ikke at trinnet lyktes.
Det endelige produktet er answers-objektet sammen med tilstanden og skjemaet som frembrakte det. Bruk disse registreringene til å undersøke uventede klassifiseringer, identifisere tvetydige kriterier og sammenligne resultater med gjennomgåtte oppgaveeksempler. Hvis en senere bruker trenger en skriftlig forklaring, kan beslutningen og den opprinnelige evidensen være inndata til et separat trinn for svarskriving. Clef leverer den avgrensede sannsynlighetsbaserte beslutningen som trengs for å velge neste trinn med en tydelig redegjørelse for hva som ble vurdert.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefStart
Cloudflare Clef er en multimodal beslutningsmodell på 27B parametere for klassifisering, regelkontroll og valg i agenters arbeidsflyter. Den vurderer en innsendt tilstand og typede spørsmål og returnerer sannsynligheter for tillatte alternativer, valgte kategorier og vektede skårer. Den godtar tekstlig og visuell evidens uten å generere prosa.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- decisions
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · System One POST /v1/systemone
- Inndatatyper
text,image- Utdatatyper
decisions- Utdataformat
- json
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser cloudflare/clef | Standard— |
Feltprovider | Typeschema | KravValgfritt | Verdier & grenser | Standard— |
Feltquestions | Typeobject | KravPåkrevd | Verdier & grenser | Standard— |
Feltsession_id | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Feltstate | Typeschema | KravPåkrevd | Verdier & grenser | Standard— |
Felttrace | Typeschema | KravValgfritt | Verdier & grenser | Standard— |
Feltuser | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Feltquestions.<id>.type | Typestring | KravPåkrevd | Verdier & grenser noul, choice, score | Standard— |
Feltquestions.<id>.instructions | Typestring|object|array | KravPåkrevd | Verdier & grenser | Standard— |
Feltquestions.<id>.criteria | Typeobject|array | KravValgfritt | Verdier & grenser Vilkår: choice/score: påkrevd; noul: valgfritt. Kriteriene for choice er et objekt; score er en matrise med minItems1. | Standard— |
Feltquestions.<id>.criteria.true | Typestring|object|array | KravPåkrevd | Verdier & grenser Gjelder når: Kriterieobjektet noul er angitt | Standard— |
Feltquestions.<id>.criteria.false | Typestring|object|array | KravPåkrevd | Verdier & grenser Gjelder når: Kriterieobjektet noul er angitt | Standard— |
Kombinasjoner av inngående materialer
noul · Påkrevd: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Påkrevd: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Påkrevd: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, state, questions |
Parametermaterial_types | Avtaletext, image |
Parameteroptional_controls | Avtaleprovider, session_id, trace, user |
Parametermultimodal_input_binding | AvtaleBruk bare den eksakte deklarerte representasjonen av tilstand eller dokument. Produsentens bildefunksjon alene fastslår ikke en modellspesifikk godkjent måte å overføre bilder på. |
Livssyklus: synchronous
Send den eksakte modell-ID-en og behold hele svaret i det opprinnelige formatet.
Priser
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Ailoot-satser
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Konteksttokener, mer enn | Konteksttokener, opptil og med | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Konteksttokener, mer enn— | Konteksttokener, opptil og medIngen øvre grense | Kostnad Inndata · Inngående tokener $0.00048 / 1K tokener Utdata · Utgående tokener $0 / 1K tokener Inndata · Lesing fra hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time — / 1K tokener |
| KonfigurasjonNivå 1 for forespørselslengde | Prisplan— | Konteksttokener, mer enn0 | Konteksttokener, opptil og medIngen øvre grense | Kostnad Inndata · Inngående tokener $0.00048 / 1K tokener Utdata · Utgående tokener $0 / 1K tokener Inndata · Lesing fra hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time — / 1K tokener |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
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
Motta og lagre resultater
Ailoot Ultra · System One
json
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Hvert oppgitt svar knyttet til en spørsmåls-ID bevares med sin eksakte type, noul/choice/score-verdi, konfidens, sannsynligheter og tegnforklaring. Hele det opprinnelige JSON-svaret lagres og returneres først etter oppgjør.
Hvis det opprinnelige svaret må kontrolleres
Behold den opprinnelige operasjonen og hele eller deler av svaret; ikke gjenta POST.
Svarfelter
| Felt | Type |
|---|---|
Feltmodel | Typestring |
Feltid | Typestring |
Feltprovider | Typestring |
Feltanswers.<id>.type | Typestring |
Feltanswers.<id>.noul | Typenumber |
Feltanswers.<id>.choice | Typestring |
Feltanswers.<id>.score | Typenumber |
Feltanswers.<id>.confidence | Typenumber |
Feltanswers.<id>.probabilities | Typeobject |
Feltanswers.<id>.legend | Typeobject |
Feltusage.input_tokens | Typeinteger |
Feltusage.output_tokens | Typeinteger |
Feltusage.cost | Typenumber |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldig påkrevd felt, representasjon eller verdi | Neste trinnKorriger det angitte forespørselsfeltet. |
Aliaser
Modellaliaser
Ailoot Ultra cloudflare/clef
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Cloudflare: Clef
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Hvilke felt bruker forespørselen?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user