Cloudflare: Clef
Cloudflare Clef on 27B parametrin multimodaalinen päätösmalli luokitteluun, sääntötarkistuksiin ja agenttien työnkulkuvalintoihin. Se arvioi annettua tilaa ja tyypitettyjä kysymyksiä sekä palauttaa sallittujen vaihtoehtojen todennäköisyyksiä, valittuja luokkia ja painotettuja pistemääriä. Se hyväksyy tekstimuotoista ja visuaalista evidenssiä tuottamatta proosaa.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Cloudflare Clef on Clef-päätösmalliperheen suurempi tiheä malli, joka on jälkikoulutettu Qwen3.8-27B:stä sen näköenkooderin kanssa. Cloudflare yhdistää tämän perusmallin yhteiseen skeemapäähän, joka kohdistaa evidenssin kysymyksiin ja pisteyttää niiden sallitut vaihtoehdot yhdessä. Clef lukee tilanteen ja palauttaa rajatut päätökset todennäköisyyksineen yhdellä eteenpäinlaskennalla. Sen tulos on luokittelutulos, ei tuotettua proosaa, avoin raportti tai ehdotettu komento.
Valmistele tila ja kysymysskeema erillisiksi syötteiksi. Tila voi olla merkkijono tai JSON-dataa, joka kuvaa tietuetta, keskustelua, asiakirjan sisältöä tai sovelluksen tilannetta. Kysymysten avaimina ovat vakaat nimet, ja samat nimet yksilöivät niihin palautetut vastaukset. Määrittele, mitä kunkin kysymyksen pitäisi selvittää, ja kuvaa olennaiset vaihtoehdot. Tukitietueessa voidaan kysyä, minkä tiimin pitäisi käsitellä pyyntö, onko vaikutus kiireellinen ja mikä vakavuuskriteeri soveltuu, yhdistämättä näitä erillisiä päätöksiä yhdeksi epämääräiseksi luokaksi.
noul-kysymys palauttaa binäärisen ehdon totuuden todennäköisyyden. choice-kysymys palauttaa valitun nimetyn vaihtoehdon, vaihtoehtokohtaiset todennäköisyydet ja luottamusarvon. score-kysymys käyttää järjestettyä kuvausluetteloa nollasta alkavilla indekseillä ja palauttaa odotetun pistemäärän, selitteen sekä todennäköisyydet. Desimaalinen pistemäärä on mielekäs, koska se tiivistää epävarmuuden järjestettyjen tasojen välillä. Tarkastele jakaumaa valitun vastauksen lisäksi; kaksi lähes yhtä todennäköistä vaihtoehtoa voivat paljastaa eron, jota syöte ei ratkaise.
Sisällytä sääntötarkistuksiin todellinen sääntöteksti ja tietueen tosiseikat. Esimerkkinä on asiakirjankäsittelyn työnkulku, jonka kysymykset koskevat tietueen täydellisyyttä, soveltuvaa tarkastusluokkaa ja sitä, kuinka vahvasti evidenssi tukee välitöntä huomiota. Kysy eri ehdoista erilliset kysymykset. Mallin sääntöjenmukaisuusarvion tulisi pysyä sidoksissa annettuun sääntöön ja evidenssiin. Jos jokin tärkeä ehto puuttuu, skeemassa ja sovelluksessa pitäisi olla harkittu tapa käsitellä tätä epävarmuutta.
Anna visuaalista evidenssiä varten luettava kuva ja kysymys näkyvästä olosuhteesta tai määritellystä luokasta. Lomakkeen laaduntarkistus voi arvioida luettavuutta, vaaditun alueen olemassaoloa ja sitä, mikä annetuista laatutasoista kuvaa lomaketta parhaiten. Valmistajan avoimien mallipainojen rajapinta hyväksyy myös videoruutujen taulukoita. Pidä ruudut järjestyksessä ja yksilöi arvioitava tapahtuma. Rajattu päätösskeema voi luokitella tätä materiaalia, kun taas kerronnallisen kuvauksen tai mielivaltaisten uusien kenttien tuottaminen kuuluu toisenlaiseen tulostukseen.
Valmistajan isännöidyn palvelun viite ilmoittaa 65 536 tokenin kontekstin, yhdestä 64 kysymykseen ja enintään neljä upotettua kuvaa. PNG-, JPEG- ja WebP-kuvien rajat ovat 4 MiB ja 16 megapikseliä kuvaa kohti ja yhteensä 8 MiB purettua dataa; koko pyynnön rungon raja on 13 MiB, eikä etäkuvalinkkejä hyväksytä. Syötebudjettiin lasketaan kysymykset ja media. Pitkää tekstiä voidaan katkaista, jotta se mahtuu mukaan, joten säilytä ratkaisevat kohdat ja lähdetunnisteet. Nämä rajat kuvaavat valmistajan isännöityä kuvarajapintaa; avoimien mallipainojen enkooderilla on omat paikallisten syötteiden esitysmuotonsa.
Cloudflaren julkaisu kuvaa koulutusta skeemaan sidottuun pisteytykseen ja todennäköisyyksien kalibrointiin. Malli poimii yksittäisten vaihtoehtojen kannalta olennaisen evidenssin ja tarkastelee sitten tietoja kenttien välillä. Tämä voi tukea päätöksiä useista toisiinsa liittyvistä kysymyksistä samassa tietueessa, mutta suuri todennäköisyys ei takaa taustalla olevan asian olevan tosi. Arvioi vaikeita, puutteellisia ja luokkien ulkopuolelle jääviä tietueita myös suoraviivaisten tapausten lisäksi. Hyödylliset päätöskriteerit kattavat tilanteet, joita työnkulussa todella esiintyy, ja tekevät tärkeät erot selviksi.
Agentin työnkulussa tulos voi määrittää, mitä ennalta määriteltyä seuraavaa vaihetta tulisi harkita. Anna nykyinen havainto ja mahdolliset toimenpiteet selkeine kuvauksineen ja säilytä sitten valittu vaihtoehto sekä sen todennäköisyydet. Ympäröivä sovellus soveltaa toimintaperiaatteitaan ja kirjaa, mitä se teki. Pidä tämä suoritusmerkintä erillään päätöstuloksesta: tarkastusreitin valitseminen ei osoita tarkastajan toimineen, eikä diagnostiikkavaiheen valitseminen osoita vaiheen onnistuneen.
Lopullinen tuotos on answers-objekti yhdessä sen tuottaneen tilan ja skeeman kanssa. Käytä näitä tietoja odottamattomien luokitusten tutkimiseen, monitulkintaisten kriteerien tunnistamiseen ja tulosten vertaamiseen tarkastettuihin tehtäväesimerkkeihin. Jos myöhempi käyttäjä tarvitsee kirjallisen selityksen, päätös ja alkuperäinen evidenssi voivat toimia erillisen vastauksenkirjoitusvaiheen syötteinä. Clef tarjoaa rajatun todennäköisyyspohjaisen päätöksen, jonka avulla seuraava vaihe voidaan valita ja samalla säilyttää selkeä tieto siitä, mitä arvioitiin.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefAloitus
Cloudflare Clef on 27B parametrin multimodaalinen päätösmalli luokitteluun, sääntötarkistuksiin ja agenttien työnkulkuvalintoihin. Se arvioi annettua tilaa ja tyypitettyjä kysymyksiä sekä palauttaa sallittujen vaihtoehtojen todennäköisyyksiä, valittuja luokkia ja painotettuja pistemääriä. Se hyväksyy tekstimuotoista ja visuaalista evidenssiä tuottamatta proosaa.
- Hyväksytyt syötteet
- Teksti · Kuvat
- Tulokset
- decisions
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · System One POST /v1/systemone
- Syötetyypit
text,image- Tulostyypit
decisions- Tulosteen muoto
- json
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat cloudflare/clef | Oletus— |
Kenttäprovider | Tyyppischema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäquestions | Tyyppiobject | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäsession_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttästate | Tyyppischema | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttätrace | Tyyppischema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäuser | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäquestions.<id>.type | Tyyppistring | VaatimusPakollinen | Arvot & rajat noul, choice, score | Oletus— |
Kenttäquestions.<id>.instructions | Tyyppistring|object|array | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäquestions.<id>.criteria | Tyyppiobject|array | VaatimusValinnainen | Arvot & rajat Ehdot: choice/score: pakollinen; noul: valinnainen. choice-kriteerit ovat olio; score on taulukko, jossa minItems on 1. | Oletus— |
Kenttäquestions.<id>.criteria.true | Tyyppistring|object|array | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: noul-kriteeriolio annettu | Oletus— |
Kenttäquestions.<id>.criteria.false | Tyyppistring|object|array | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: noul-kriteeriolio annettu | Oletus— |
Syöteaineistojen yhdistelmät
noul · Pakollinen: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Pakollinen: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Pakollinen: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, state, questions |
Parametrimaterial_types | Sopimustext, image |
Parametrioptional_controls | Sopimusprovider, session_id, trace, user |
Parametrimultimodal_input_binding | SopimusKäytä vain täsmälleen ilmoitettua tilan tai asiakirjan esitysmuotoa. Pelkkä valmistajan kuvaominaisuus ei vahvista mallikohtaista hyväksyttyä kuvan välitysmuotoa. |
Elinkaari: synchronous
Lähetä täsmällinen mallin tunniste ja säilytä koko natiivivastaus.
Hinnoittelu
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Ailoot-hinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.00048 / 1K tokenia Tuloste · Tulostokenit $0 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.00048 / 1K tokenia Tuloste · Tulostokenit $0 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
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
Vastaanota ja tallenna tulokset
Ailoot Ultra · System One
json
Säilytä kaikki valmistuneet tulokset
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Jokainen annettu kysymystunnisteeseen sidottu vastaus säilytetään täsmällisine tyyppeineen, noul/choice/score-arvoineen, luottamusarvoineen, todennäköisyyksineen ja selitteineen. Koko alkuperäinen JSON tallennetaan ja palautetaan vasta veloituksen lopullisen kirjauksen jälkeen.
Jos alkuperäinen vastaus on tarkistettava
Säilytä alkuperäinen operaatio ja kokonainen tai osittainen vastaus; älä toista POST-pyyntöä.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttämodel | Tyyppistring |
Kenttäid | Tyyppistring |
Kenttäprovider | Tyyppistring |
Kenttäanswers.<id>.type | Tyyppistring |
Kenttäanswers.<id>.noul | Tyyppinumber |
Kenttäanswers.<id>.choice | Tyyppistring |
Kenttäanswers.<id>.score | Tyyppinumber |
Kenttäanswers.<id>.confidence | Tyyppinumber |
Kenttäanswers.<id>.probabilities | Tyyppiobject |
Kenttäanswers.<id>.legend | Tyyppiobject |
Kenttäusage.input_tokens | Tyyppiinteger |
Kenttäusage.output_tokens | Tyyppiinteger |
Kenttäusage.cost | Tyyppinumber |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheellinen pakollinen kenttä, esitysmuoto tai arvo | Seuraava vaiheKorjaa ilmoitettu pyyntökenttä. |
Aliakset
Mallin aliakset
Ailoot Ultra cloudflare/clef
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · Cloudflare: Clef
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Mitä kenttiä pyyntö käyttää?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user