input_file ja attachment_search vastuste API-s
Sellel lehel
Kaks teed sama ploki juurde
Grok Responses API aktsepteerib dokumenti kahel viisil: kasutades file_id, mis tähistab varem üles laaditud faili, või file_url, mis on avalik aadress, mille xAI päringu esitamise hetkel alla laeb. Mõlemal juhul kannab plokk sama nime – input_file – ja edasine töötlemine on identne: Grok aktiveerib tööriista attachment_search ja ekstraheerib lõigud, mis vastavad sinu küsimusele. Muutub ainult dokumendi elutsükkel, selle konfidentsiaalsus ja iga korduvpäringu hind.
Tee läbi file_id
Kui oled faili saatnud päringuga POST /v1/files, viidad sellele selle identifikaatori abil koos oma küsimusega lihttekstina:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123"
},
{
"type": "input_text",
"text": "Millised on selles aruandes mainitud peamised riskid?"
}
]
}
See tee on mõttekas kolmes olukorras. Esiteks korduvpäringute puhul: kui sinu juriidiline meeskond esitab sama lepingu kohta viisteist järjestikust küsimust, on üks üleslaadimine ja viisteist viidet tõhusam kui sama PDF-i viisteistkordne edastamine. Teiseks konfidentsiaalsuse huvides, kui dokumenti ei tohi avaldada URL-i taga, mis on ligipääsetav kõigile, kellel on link. Kolmandaks sinu rakenduse arhitektuuri seisukohalt: kui failid laaditakse öise andmetöötluse käigus eelnevalt üles, tegelevad sinu päringud ainult identifikaatoritega.
Tee läbi file_url
Kui dokument on juba kusagil avaldatud, on üleslaadimine tarbetu samm ja saad viidata otse aadressile:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_url": "https://exemple.com/specifications-api.pdf"
},
{
"type": "input_text",
"text": "Tee kokkuvõte selles dokumentatsioonis kirjeldatud lõpp-punktidest."
}
]
}
Tüüpilised kasutusjuhtumid hõlmavad avalikku dokumentatsiooni, mida sul pole põhjust salvestada, faili, mida majutad oma taristus ajutise URL-i taga, või kiiret testi, kus soovid hüpoteesi kontrollida ilma tervet üleslaadimise torustikku seadistamata.
Selle mugavusega kaasnevad kolm piirangut ja kõik need maksavad tootmiskeskkonnas raha. URL peab olema tõeliselt avalik, ilma autentimiseta: aadress, mida kaitseb token või küpsis, tagastab xAI-le vealehe, mida mudel hoolega analüüsib sinu dokumendi asemel. Allalaadimine suurendab päringu töötlemisaega, muutes suured PDF-failid oluliselt aeglasemaks võrreldes file_id kasutamisega. Lõpuks, xAI poolt puudub vahemälu: iga päring laeb faili uuesti alla, nii et sama dokument, mida päritakse viiskümmend korda päevas, liigub võrgus viiskümmend korda.
Mida teeb attachment_search
Niipea kui sinu päringus ilmub input_file, käivitab Grok ilma sinu poolse seadistamiseta tööriista attachment_search. Töötlemine toimub neljas etapis:
- Sisu ekstraheerimine failist: tekst, tabelid, struktuur
- Selle sisu ajutine indekseerimine päringu kestuse ajaks
- Sinu küsimuse põhjal asjakohaste lõikude otsimine
- Lõikude sisestamine mudeli konteksti
Pööra tähelepanu teise sammu omadussõnale „ajutine“, sest see selgitab kulude erinevust, mille paljud avastavad liiga hilja: indeks ehitatakse iga päringu jaoks uuesti üles ja kaob seejärel. See on täpselt probleem, mida kollektsioonid lahendavad püsiva indekseerimisega. Pane tähele ka seda, et mudel tsiteerib lõike, mida ta tegelikult oma vastuses kasutas, võimaldades sul tema tööd kontrollida, mitte lihtsalt uskuda tema sõna.
Mitme dokumendi kombineerimine
Midagi ei sunni sind piirduma ühe failiga päringu kohta. Mitu input_file plokki virnastades palud mudelil põhjendada kogu komplekti ulatuses:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_rapport_q1"
},
{
"type": "input_file",
"file_id": "file_rapport_q2"
},
{
"type": "input_text",
"text": "Võrdle Q1 ja Q2 tulemusi."
}
]
}
Grok analüüsib mõlemat dokumenti ja ristviitab teavet vastuse leidmiseks, mis avab ukse kvartalivõrdlusteks, lepingu järjestikuste versioonide ülevaatamiseks või spetsifikatsiooni ja selle rakenduse vastandamiseks.
Kahe variandi vahel valimine
| Kriteerium | file_id | file_url |
|---|---|---|
| Eelnev üleslaadimine | Jah | Ei |
| Konfidentsiaalne fail | Soovitatav | Ei soovitata |
| Korduvpäringud | Tõhus (1 üleslaadimine) | Aeglane (korduv allalaadimine) |
| Avalik fail | Võimalik | Ideaalne |
| Elutsükli haldamine | Sinu kontrolli all | Sõltub hostist |
Peamised punktid
input_filekoosfile_id-ga viitab üles laaditud failile,file_urlavalikule dokumendile- Tööriist
attachment_searchaktiveerub automaatselt asjakohase sisu ekstraheerimiseks - Saad kombineerida mitut faili ühes päringus
- Eelista
file_idkonfidentsiaalsete või sageli päritavate failide puhul - Eelista
file_urlavalike dokumentide või kiirete testide puhul