Lähe põhisisu juurde
Eesti— Vali keel
Menüü

input_file ja attachment_search vastuste API-s

Õppetund 4 / 16 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Kaks teed sama ploki juurde
  2. Tee läbi file_id
  3. Tee läbi file_url
  4. Mida teeb attachment_search
  5. Mitme dokumendi kombineerimine
  6. Kahe variandi vahel valimine
  7. Peamised punktid

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.

Niipea kui sinu päringus ilmub input_file, käivitab Grok ilma sinu poolse seadistamiseta tööriista attachment_search. Töötlemine toimub neljas etapis:

  1. Sisu ekstraheerimine failist: tekst, tabelid, struktuur
  2. Selle sisu ajutine indekseerimine päringu kestuse ajaks
  3. Sinu küsimuse põhjal asjakohaste lõikude otsimine
  4. 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

Kriteeriumfile_idfile_url
Eelnev üleslaadimineJahEi
Konfidentsiaalne failSoovitatavEi soovitata
KorduvpäringudTõhus (1 üleslaadimine)Aeglane (korduv allalaadimine)
Avalik failVõimalikIdeaalne
Elutsükli haldamineSinu kontrolli allSõltub hostist

Peamised punktid

  • input_file koos file_id-ga viitab üles laaditud failile, file_url avalikule dokumendile
  • Tööriist attachment_search aktiveerub automaatselt asjakohase sisu ekstraheerimiseks
  • Saad kombineerida mitut faili ühes päringus
  • Eelista file_id konfidentsiaalsete või sageli päritavate failide puhul
  • Eelista file_url avalike dokumentide või kiirete testide puhul