input_file ir attachment_search atsakymų API
Šiame puslapyje
Du keliai į tą patį bloką
Grok atsakymų API priima dokumentą dviem būdais: per file_id, tai yra anksčiau įkeltą failą, arba per file_url, viešą adresą, kurį xAI nusigauna užklausos metu. Abiem atvejais blokas vadinasi vienodai – input_file, o tolesnis apdorojimas yra identiškas: Grok aktyvuoja įrankį attachment_search ir ištraukia ištraukas, atsakančias į tavo klausimą. Skiriasi tik dokumento gyvavimo ciklas, jo konfidencialumas ir kiekvieno pakartotino kvietimo kaina.
Kelias per file_id
Kartą išsiuntęs failą per POST /v1/files, jį nurodai pagal jo identifikatorių kartu su savo klausimu paprastu tekstu:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123"
},
{
"type": "input_text",
"text": "What are the main risks mentioned in this report?"
}
]
}
Šis kelias prasmingas trimis atvejais. Pirmasis – pakartotinės užklausos: jei tavo teisininkų komanda užduoda penkiolika nuoseklių klausimų apie tą pačią sutartį, vienas įkėlimas ir penkiolika nuorodų yra geriau nei penkiolika to paties PDF perdavimų. Antrasis – konfidencialumas, kai dokumentas negali būti atviras už nuorodos, prieinamos bet kam, turinčiam tą nuorodą. Trečiasis – tavo programos architektūra: jei failai įkeliami iš anksto per naktinį duomenų surinkimą, tavo užklausos tvarko tik identifikatorius.
Kelias per file_url
Kai dokumentas jau kažkur paskelbtas, įkėlimas tampa nereikalingu žingsniu ir gali nukreipti tiesiai į adresą:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_url": "https://exemple.com/specifications-api.pdf"
},
{
"type": "input_text",
"text": "Summarize the endpoints described in this documentation."
}
]
}
Tipiški naudojimo atvejai apima atvirą dokumentaciją, kurios neturi priežasties saugoti, failą, talpinamą tavo infrastruktūroje už laikinos nuorodos, arba greitą testą, kai nori patikrinti hipotezę nekurdamas viso įkėlimo konvejerio.
Šis patogumas turi tris apribojimus, ir visi jie gamyboje tau kainuoja. Nuoroda turi būti tikrai vieša, be jokio autentifikavimo: adresas, apsaugotas žetono ar slapuko, xAI grąžins klaidos puslapį, kurį modelis sąžiningai analizuos vietoj tavo dokumento. Atsisiuntimas pailgina užklausos apdorojimo laiką, todėl dideli PDF failai veikia žymiai lėčiau nei naudojant file_id. Galiausiai, xAI pusėje nėra talpyklos: kiekvienas kvietimas iš naujo atsisiunčia failą, tad vienas dokumentas, užklaustas penkiasdešimt kartų per dieną, tinklu keliauja penkiasdešimt kartų.
Ką veikia attachment_search
Kai tik tavo užklausoje atsiranda input_file, Grok automatiškai, be jokio tavo konfigūravimo, suaktyvina attachment_search. Apdorojimas vyksta keturiais žingsniais:
- Turinio ištraukimas iš failo: tekstas, lentelės, struktūra
- Laikinas šio turinio indeksavimas užklausos trukmei
- Reikalingų ištraukų paieška pagal tavo klausimą
- Ištraukų įterpimas į modelio kontekstą
Atkreipk dėmesį į būdvardį „laikinas“ antrame žingsnyje, nes jis paaiškina kainų skirtumą, kurį daugelis atranda per vėlai: indeksas kuriamas iš naujo kiekvieno kvietimo metu ir po to išnyksta. Būtent šią problemą sprendžia kolekcijos, naudodamos nuolatinį indeksavimą. Taip pat pastebėk, kad modelis cituoja tas ištraukas, kurias iš tikrųjų panaudojo savo atsakyme, leisdamas tau patikrinti jo darbą, o ne tikėti jo žodžiu.
Kelių dokumentų derinimas
Niekas neverčia tavęs apsiriboti vienu failu vienoje užklausoje. Sudėjęs kelis input_file blokus, prašai modelio samprotauti visame rinkinyje:
{
"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": "Compare the Q1 and Q2 results."
}
]
}
Grok analizuoja abu dokumentus ir susieja informaciją, kad atsakytų, taip atverdamas duris ketvirtinėms palyginimams, nuoseklių sutarčių versijų peržiūroms arba specifikacijos ir jos įgyvendinimo priešpriešai.
Pasirinkimas tarp dviejų būdų
| Kriterijus | file_id | file_url |
|---|---|---|
| Išankstinis įkėlimas | Taip | Ne |
| Konfidencialus failas | Rekomenduojama | Nerekomenduojama |
| Pakartotinės užklausos | Efektyvu (1 įkėlimas) | Lėta (pakartotinis atsisiuntimas) |
| Viešas failas | Įmanoma | Idealu |
| Gyvavimo ciklo valdymas | Tu kontroliuoji | Priklauso nuo serverio |
Svarbiausi punktai
input_filesufile_idnurodo įkeltą failą,file_url– viešą dokumentą- Įrankis
attachment_searchaktyvuojamas automatiškai, kad išgautų reikiamą turinį - Vienoje užklausoje gali derinti kelis failus
- Konfidencialiems ar dažnai užklausiemiems failams teik pirmenybę
file_id - Viešiems dokumentams arba greitiems testams teik pirmenybę
file_url