Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

input_file u attachment_search fl-API tar-Risposti

Lezzjoni 4 / 16 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Żewġ toroq lejn l-istess blokk
  2. It-triq tal-file_id
  3. It-triq tal-file_url
  4. X’jagħmel attachment_search
  5. Tagħqid ta’ dokumenti multipli
  6. L-għażla bejn iż-żewġ toroq
  7. Punti Ewlenin

Ż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.

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:

  1. Estrazzjoni tal-kontenut mill-fajl: test, tabelli, struttura
  2. Indiċjar temporanju ta’ dan il-kontenut, għat-tul tat-talba
  3. Tfittxija għal passaġġi rilevanti ibbażata fuq il-mistoqsija tiegħek
  4. 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

Kriterjufile_idfile_url
Tlifta minn qabelIvaLe
Fajl kunfidenzjaliRakkomandatSkoraġġut
Mistoqsijiet ripetutiEffiċjenti (tiftla waħda)Bil-mod (tniżżel mill-ġdid)
Fajl pubblikuPossibbliIdeali
Ġestjoni taċ-ċiklu tal-ħajjaInt tikkontrollaTiddependi fuq l-ospitant

Punti Ewlenin

  • input_file b’file_id jirreferenzja fajl imtella’, file_url dokument pubbliku
  • L-għodda attachment_search tattiva awtomatikament biex testratti kontenut rilevanti
  • Tista’ tgħaqqad fajls multipli f’talba waħda
  • Ippreferixxi file_id għal fajls kunfidenzjali jew mistoqsija frekwenti
  • Ippreferixxi file_url għal dokumenti pubbliċi jew testijiet rapidi