input_file un attachment_search Responses API
Šajā lapā
Divi ceļi uz vienu bloku
Grok Responses API pieņem dokumentu divos veidos: izmantojot file_id, kas apzīmē failu, ko esi iepriekš augšupielādējis, vai file_url, kas ir publiska adrese, ko xAI izgūst pieprasījuma brīdī. Abos gadījumos bloks tiek saukts vienādi – input_file, un turpmākā apstrāde ir identiska: Grok aktivizē rīku attachment_search un izgūst fragmentus, kas atbild uz tavu jautājumu. Mainās tikai dokumenta dzīves cikls, tā konfidencialitāte un katra atkārtota izsaukuma izmaksas.
Ceļš caur file_id
Kad esi nosūtījis failu, izmantojot POST /v1/files, tu to norādi, izmantojot tā identifikatoru kopā ar savu jautājumu parastā tekstā:
{
"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 ceļš ir jēdzīgs trīs situācijās. Pirmkārt, atkārtoti vaicājumi: ja tava juridiskā komanda uzdod piecpadsmit secīgus jautājumus par vienu un to pašu līgumu, viena augšupielāde un piecpadsmit atsauces ir izdevīgākas nekā viena un tā paša PDF piecpadsmit pārsūtīšanas. Otrkārt, konfidencialitāte, ja dokuments nedrīkst būt pieejams aiz URL, ko var atvērt jebkurš, kam ir saite. Treškārt, tavas lietotnes arhitektūra: ja faili tiek iepriekš augšupielādēti nakts ingestēšanas laikā, tavi pieprasījumi apstrādā tikai identifikatorus.
Ceļš caur file_url
Ja dokuments jau ir publicēts kādā vietā, augšupielāde kļūst par lieku soli, un tu vari norādīt tieši uz adresi:
{
"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."
}
]
}
Tipiski lietojumi ietver atvērtu dokumentāciju, ko nav iemesla glabāt, failu, kas mitināts tavā infrastruktūrā aiz pagaidu URL, vai ātru testu, kurā vēlies pārbaudīt hipotēzi, neizveidojot visu augšupielādes cauruļvadu.
Šai ērtībai ir trīs ierobežojumi, un visi tie production vidē tev izmaksā dārgi. URL ir jābūt patiesi publiskam, bez autentifikācijas: adrese, kas aizsargāta ar token vai sīkdatni, xAI atgriezīs kļūdas lapu, ko modelis centīgi analizēs tava dokumenta vietā. Lejupielāde palielina pieprasījuma apstrādes laiku, padarot lielus PDF failus ievērojami lēnākus nekā ar file_id. Visbeidzot, xAI pusē nav kešatmiņas: katrs izsaukums atkārtoti lejupielādē failu, tāpēc viens dokuments, ko vaicā piecdesmit reizes dienā, šķērso tīklu piecdesmit reizes.
Ko dara attachment_search
Tiklīdz tavā pieprasījumā parādās input_file, Grok automātiski, bez tavas papildu konfigurācijas, aktivizē attachment_search. Apstrāde notiek četros soļos:
- Satura izgūšana no faila: teksts, tabulas, struktūra
- Pagaidu indeksēšana šim saturam uz pieprasījuma laiku
- Atbilstošu fragmentu meklēšana, pamatojoties uz tavu jautājumu
- Ievilkumu injicēšana modeļa kontekstā
Pievērs uzmanību īpašvārdam „pagaidu” otrajā solī, jo tas izskaidro izmaksu atšķirību, ko daudzi atklāj par vēlu: indekss tiek pārbūvēts katrā izsaukumā un pēc tam pazūd. Tieši šo problēmu risina kolekcijas ar pastāvīgu indeksēšanu. Ņem vērā arī to, ka modelis citē fragmentus, ko tas faktiski izmantoja savā atbildē, ļaujot tev pārbaudīt tā darbu, nevis ticēt uz vārda.
Vairāku dokumentu kombinēšana
Nekas neliek tev aprobežoties ar vienu failu vienā pieprasījumā. Saskaitot vairākus input_file blokus, tu liec modelim spriest pār visu kopu:
{
"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 analizē abus dokumentus un savstarpēji sasaista informāciju, lai sniegtu atbildi, kas paver durvis ceturkšņu salīdzinājumiem, secīgu līguma versiju apskatiem vai specifikācijas un tās implementācijas salīdzināšanai.
Izvēle starp abiem
| Kritērijs | file_id | file_url |
|---|---|---|
| Iepriekšēja augšupielāde | Jā | Nē |
| Konfidenciāls fails | Ieteicams | Nav ieteicams |
| Atkārtoti vaicājumi | Efektīvi (1 augšupielāde) | Lēni (atkārtota lejupielāde) |
| Publisks fails | Iespējams | Ideāli |
| Dzīves cikla pārvaldība | Tu kontrolē | Atkarīgs no mitinātāja |
Galvenās atziņas
input_filearfile_idatsaucas uz augšupielādētu failu,file_url– uz publisku dokumentu- Rīks
attachment_searchaktivizējas automātiski, lai izgūtu atbilstošu saturu - Vienā pieprasījumā vari kombinēt vairākus failus
- Konfidenciāliem vai bieži vaicātiem failiem dod priekšroku
file_id - Publiskiem dokumentiem vai ātriem testiem dod priekšroku
file_url