Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

input_file a attachment_search v Responses API

Lekcia 4 z 16 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Dve cesty k rovnakému bloku
  2. Cesta cez file_id
  3. Cesta cez file_url
  4. Čo robí attachment_search
  5. Kombinácia viacerých dokumentov
  6. Výber medzi dvoma možnosťami
  7. Kľúčové poznatky

Dve cesty k rovnakému bloku

Responses API od Groku prijíma dokument dvoma spôsobmi: cez file_id, čo znamená súbor, ktorý si predtým nahral, alebo cez file_url, verejnú adresu, ktorú xAI stiahne v čase požiadavky. Blok sa v oboch prípadoch volá rovnako, input_file, a následné spracovanie je identické: Grok aktivuje nástroj attachment_search a extrahuje pasáže, ktoré odpovedajú na tvoju otázku. Mení sa životný cyklus dokumentu, jeho dôvernosť a náklady na každé opakované volanie.

Cesta cez file_id

Akonáhle odošleš súbor cez POST /v1/files, odkazuješ naň pomocou jeho identifikátora spolu so svojou otázkou v plain texte:

{
  "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?"
    }
  ]
}

Táto cesta dáva zmysel v troch situáciách. Prvou sú opakované dotazy: ak sa tvoj právny tím opýta pätnásť po sebe idúcich otázok na tú istú zmluvu, jedno nahranie nasledované pätnástimi odkazmi je lepšie ako pätnásť prenosov toho istého PDF. Druhou je dôvernosť, keď dokument nesmie byť vystavený za URL adresou prístupnou komukoľvek, kto má odkaz. Treťou je architektúra tvojej aplikácie: ak sa súbory prednahrávajú počas nočnej ingestie, tvoje požiadavky pracujú len s identifikátormi.

Cesta cez file_url

Keď je dokument už niekde publikovaný, nahrávanie sa stáva zbytočným krokom a môžeš odkázať priamo na adresu:

{
  "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."
    }
  ]
}

Typické prípady použitia zahŕňajú otvorenú dokumentáciu, ktorú nemáš dôvod ukladať, súbor hostený na tvojej vlastnej infraštruktúre za dočasnou URL alebo rýchly test, kde chceš overiť hypotézu bez nastavovania celého pipeline na nahrávanie.

S touto výhodou prichádzajú tri obmedzenia a všetky ťa v produkcii niečo stoja. URL adresa musí byť skutočne verejná, bez autentifikácie: adresa chránená tokenom alebo cookie vráti xAI chybovú stránku, ktorú model dôkladne analyzuje namiesto tvojho dokumentu. Sťahovanie pridáva čas spracovania požiadavky, čo robí veľké PDF výrazne pomalšími v porovnaní s file_id. Nakoniec, na strane xAI neexistuje žiadna cache: každé volanie znovu sťahuje súbor, takže jeden dokument dotazovaný päťdesiatkrát denne prejde sieťou päťdesiatkrát.

Akonáhle sa v tvojej požiadavke objaví input_file, Grok bez akejkoľvek tvojej konfigurácie spustí attachment_search. Spracovanie prebieha v štyroch krokoch:

  1. Extrakcia obsahu zo súboru: text, tabuľky, štruktúra
  2. Dočasné indexovanie tohto obsahu na dobu trvania požiadavky
  3. Vyhľadanie relevantných pasáží na základe tvojej otázky
  4. Vloženie úryvkov do kontextu modelu

Sústred sa na prídavné meno „dočasné“ v druhom kroku, pretože vysvetľuje rozdiel v nákladoch, ktorý mnohí objavia príliš neskoro: index sa pri každom volaní znovu vytvorí a následne zmizne. Presne toto je problém, ktorý riešia kolekcie (collections) pomocou trvalého indexovania. Všimni si tiež, že model cituje pasáže, ktoré skutočne použil vo svojej odpovedi, čo ti umožňuje overiť jeho prácu namiesto toho, aby si mu slepo veril.

Kombinácia viacerých dokumentov

Nič ťa nenúti držať sa jedného súboru na požiadavku. Nakladením viacerých blokov input_file požiadaš model, aby uvažoval naprieč celou množinou:

{
  "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 analyzuje oba dokumenty a krížovo odkazuje informácie, aby odpovedal, čo otvára dvere štvrťročným porovnaniam, revíziám postupných verzií zmlúv alebo konfrontáciám medzi špecifikáciou a jej implementáciou.

Výber medzi dvoma možnosťami

Kritériumfile_idfile_url
Predchádzajúce nahranieÁnoNie
Dôverný súborOdporúčanéNeodporúčané
Opakované dotazyVýkonné (1 nahranie)Pomalé (opätovné sťahovanie)
Verejný súborMožnéIdeálne
Správa životného cykluTy kontroluješZávisí od hostiteľa

Kľúčové poznatky

  • input_file s file_id odkazuje na nahraný súbor, file_url na verejný dokument
  • Nástroj attachment_search sa aktivuje automaticky na extrakciu relevantného obsahu
  • V jednej požiadavke môžeš kombinovať viacero súborov
  • Pre dôverné alebo často dotazované súbory uprednostni file_id
  • Pre verejné dokumenty alebo rýchle testy uprednostni file_url