input_file u attachment_search fl-API tar-Risposti
F'din il-paġna
Żewġ toroq lejn l-istess blokk
L-API tar-Risposti ta’ Grok taċċetta dokument b’żewġ modi: permezz ta’ file_id, li jfisser fajl li tlajt qabel, jew permezz ta’ file_url, indirizz pubbliku li xAI jiġbed fil-mument tat-talba. Il-blokk juża l-istess isem fiż-żewġ każijiet, input_file, u l-ipproċessar sussegwenti huwa identiku: Grok jattiva l-għodda attachment_search u jestratti l-passaġġi li jwieġbu l-mistoqsija tiegħek. Dak li jinbidel huwa ċ-ċiklu tal-ħajja tad-dokument, il-kunfidenzjalità tiegħu, u l-ispiża ta’ kull sejħa ripetuta.
It-triq tal-file_id
Ladarba tibgħat il-fajl permezz ta’ POST /v1/files, tirreferenzjah bl-identifikatur tiegħu, flimkien mal-mistoqsija tiegħek f’test sempliċi:
{
"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?"
}
]
}
Din it-triq tagħmel sens f’tliet sitwazzjonijiet. L-ewwel hija mistoqsijiet ripetuti: jekk it-tim legali tiegħek jagħmel ħmistax-il mistoqsija suċċessiva dwar l-istess kuntratt, tlifta waħda segwita minn ħmistax-il referenza taqbeż ħmistax-il trasferiment tal-istess PDF. It-tieni hija l-kunfidenzjalità, meta d-dokument m’għandux jiġi espost wara URL aċċessibbli għal kulmin għandu l-link. It-tielet hija l-arkitettura tal-applikazzjoni tiegħek: jekk il-fajls jitilgħu minn qabel waqt l-ingestjoni ta’ kull lejl, it-talbiet tiegħek jimmanipulaw biss identifikaturi.
It-triq tal-file_url
Meta d-dokument diġà jkun ippubblikat f’xi post, it-tlifta ssir pass mhux meħtieġ u tista’ tipponta direttament lejn l-indirizz:
{
"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."
}
]
}
Każijiet ta’ użu tipiċi jinkludu dokumentazzjoni miftuħa li m’għandek l-ebda raġuni biex taħżen, fajl ospitat fuq l-infrastruttura tiegħek stess wara URL temporanju, jew test rapidu fejn tridd tivverifika ipoteżi mingħajr ma tħejji pipeline sħiħa ta’ tlifta.
Tliet limitazzjonijiet ġejjin ma’ din il-konvenjenza, u kollha jiswuk flus fil-produzzjoni. L-URL irid ikun verament pubbliku, mingħajr l-ebda awtentikazzjoni: indirizz protett b’token jew cookie jirritorna paġna ta’ żball lil xAI, li l-mudell janalizza b’diliġenza minflok id-dokument tiegħek. It-tniżżil iżid mal-ħin tal-ipproċessar tat-talba, u jagħmel PDFs kbar sinifikantament aktar bil-mod milli bil-file_id. Fl-aħħar nett, m’hemm l-ebda cache fuq in-naħa ta’ xAI: kull sejħa terġa’ tniżżel il-fajl, allura dokument wieħed mistoqsi ħamsin darba kuljum jaqsam in-netwerk ħamsin darba.
X’jagħmel attachment_search
Hekk kif input_file jidher fit-talba tiegħek, Grok jattiva attachment_search mingħajr l-ebda konfigurazzjoni min-naħa tiegħek. L-ipproċessar iseħħ f’erba’ passi:
- Estrazzjoni tal-kontenut mill-fajl: test, tabelli, struttura
- Indiċjar temporanju ta’ dan il-kontenut, għat-tul tat-talba
- Tfittxija għal passaġġi rilevanti ibbażata fuq il-mistoqsija tiegħek
- Injezzjoni ta’ estratti fil-kuntest tal-mudell
Iffoka fuq l-aġġettiv “temporanju” fit-tieni pass, għax dan jispjega differenza fl-ispiża li ħafna jiskopru tard wisq: l-indiċi jinbena mill-ġdid fuq kull sejħa u jisparixxi wara. Dan huwa preċiżament il-problema li s-soluzzjonijiet tal-kollezzjonijiet isolvu bl-indiċjar persistenti. Innota wkoll li l-mudell jikkita l-passaġġi li uża attwalment fir-risposta tiegħu, u jħallik tivverifika x-xogħol tiegħu minflok ma tieħu kelmtu bħala verità.
Tagħqid ta’ dokumenti multipli
Xejn ma jfurzak tillimita ruħek għal fajl wieħed kull talba. Billi tpoġġi bosta blokki input_file fuq xulxin, titlob lill-mudell biex jirraġuna fuq is-sett:
{
"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 janalizza ż-żewġ dokumenti u jikkrossa-referenzja l-informazzjoni biex iwieġeb, li jiftaħ il-bieb għal tqabbil trimestrali, reviżjonijiet ta’ verżjonijiet suċċessivi ta’ kuntratti, jew konfrontazzjonijiet bejn speċifikazzjoni u l-implimentazzjoni tagħha.
L-għażla bejn iż-żewġ toroq
| Kriterju | file_id | file_url |
|---|---|---|
| Tlifta minn qabel | Iva | Le |
| Fajl kunfidenzjali | Rakkomandat | Skoraġġut |
| Mistoqsijiet ripetuti | Effiċjenti (tiftla waħda) | Bil-mod (tniżżel mill-ġdid) |
| Fajl pubbliku | Possibbli | Ideali |
| Ġestjoni taċ-ċiklu tal-ħajja | Int tikkontrolla | Tiddependi fuq l-ospitant |
Punti Ewlenin
input_fileb’file_idjirreferenzja fajl imtella’,file_urldokument pubbliku- L-għodda
attachment_searchtattiva awtomatikament biex testratti kontenut rilevanti - Tista’ tgħaqqad fajls multipli f’talba waħda
- Ippreferixxi
file_idgħal fajls kunfidenzjali jew mistoqsija frekwenti - Ippreferixxi
file_urlgħal dokumenti pubbliċi jew testijiet rapidi