Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

input_file ir attachment_search atsakymų API

Paskaita 4 iš 16 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Du keliai į tą patį bloką
  2. Kelias per file_id
  3. Kelias per file_url
  4. Ką veikia attachment_search
  5. Kelių dokumentų derinimas
  6. Pasirinkimas tarp dviejų būdų
  7. Svarbiausi punktai

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

Kai tik tavo užklausoje atsiranda input_file, Grok automatiškai, be jokio tavo konfigūravimo, suaktyvina attachment_search. Apdorojimas vyksta keturiais žingsniais:

  1. Turinio ištraukimas iš failo: tekstas, lentelės, struktūra
  2. Laikinas šio turinio indeksavimas užklausos trukmei
  3. Reikalingų ištraukų paieška pagal tavo klausimą
  4. 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ų

Kriterijusfile_idfile_url
Išankstinis įkėlimasTaipNe
Konfidencialus failasRekomenduojamaNerekomenduojama
Pakartotinės užklausosEfektyvu (1 įkėlimas)Lėta (pakartotinis atsisiuntimas)
Viešas failasĮmanomaIdealu
Gyvavimo ciklo valdymasTu kontroliuojiPriklauso nuo serverio

Svarbiausi punktai

  • input_file su file_id nurodo įkeltą failą, file_url – viešą dokumentą
  • Įrankis attachment_search aktyvuojamas 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