Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

input_file a attachment_search v Responses API

Lekce 4 z 16 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Dvě cesty ke stejnému bloku
  2. Cesta přes file_id
  3. Cesta přes file_url
  4. Co dělá attachment_search
  5. Kombinace více dokumentů
  6. Volba mezi oběma možnostmi
  7. Klíčové poznatky

Dvě cesty ke stejnému bloku

Responses API od Groku přijímá dokument dvěma způsoby: přes file_id, což znamená soubor, který jsi dříve nahrál, nebo přes file_url, což je veřejná adresa, kterou xAI stáhne v okamžiku žádosti. Blok se v obou případech jmenuje stejně, input_file, a následné zpracování je totožné: Grok aktivuje nástroj attachment_search a extrahuje pasáže, které odpovídají na tvou otázku. Mění se životní cyklus dokumentu, jeho důvěrnost a náklady na každé opakované volání.

Cesta přes file_id

Jakmile odešleš soubor pomocí POST /v1/files, odkazuješ na něj pomocí jeho identifikátoru spolu se svou otázkou v prostém textu:

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

Tato cesta dává smysl ve třech situacích. První jsou opakované dotazy: pokud se tvůj právní tým zeptá patnáctkrát po sobě na stejnou smlouvu, jedno nahrání následované patnácti odkazy je lepší než patnáct přenosů téhož PDF. Druhou je důvěrnost, kdy dokument nesmí být vystaven za URL přístupnou komukoli, kdo má odkaz. Třetí je architektura tvé aplikace: pokud jsou soubory předem nahrávány během nočního zpracování, tvé požadavky pracují pouze s identifikátory.

Cesta přes file_url

Když je dokument již někde publikován, nahrávání se stává zbytečným krokem a můžeš přímo odkázat 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ými případy použití jsou otevřená dokumentace, kterou nemáš důvod ukládat, soubor hostovaný na tvé vlastní infrastruktuře za dočasnou URL, nebo rychlý test, kde chceš ověřit hypotézu bez nastavování celého pipeline pro nahrávání.

S touto výhodou přicházejí tři omezení a všechna tě v produkci něco stojí. URL musí být skutečně veřejná, bez jakékoli autentizace: adresa chráněná tokenem nebo cookie vrátí xAI chybovou stránku, kterou model pilně analyzuje místo tvého dokumentu. Stahování prodlužuje dobu zpracování žádosti, takže velká PDF jsou výrazně pomalejší než u file_id. Nakonec, na straně xAI neexistuje žádná mezipaměť: každé volání soubor znovu stahuje, takže jeden dokument dotazovaný padesátkrát denně projde sítí padesátkrát.

Jakmile se ve tvém požadavku objeví input_file, Grok bez jakékoli konfigurace z tvé strany spustí attachment_search. Zpracování probíhá ve čtyřech krocích:

  1. Extrakce obsahu ze souboru: text, tabulky, struktura
  2. Dočasné indexování tohoto obsahu po dobu trvání žádosti
  3. Vyhledání relevantních pasáží na základě tvé otázky
  4. Vložení úryvků do kontextu modelu

Soustřeď se na přídavné jméno „dočasné“ ve druhém kroku, protože vysvětluje rozdíl v nákladech, který mnozí objeví příliš pozdě: index se při každém volání znovu vytvoří a poté zmizí. To je přesně problém, který řeší kolekce (collections) díky perzistentnímu indexování. Všimni si také, že model cituje pasáže, které skutečně použil ve své odpovědi, což ti umožňuje ověřit jeho práci, než mu uvěříš.

Kombinace více dokumentů

Nic tě nenutí držet se jednoho souboru na žádost. Naskládáním více bloků input_file požádáš model, aby uvažoval napříč celou sadou:

{
  "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 křížově odkazuje informace, aby odpověděl, což otevírá dveře čtvrtletním srovnáním, revizím po sobě jdoucích verzí smluv nebo konfrontacím mezi specifikací a její implementací.

Volba mezi oběma možnostmi

Kritériumfile_idfile_url
Předchozí nahráníAnoNe
Důvěrný souborDoporučenoNedoporučeno
Opakované dotazyVýkonné (1 nahrání)Pomalé (opětovné stažení)
Veřejný souborMožnéIdeální
Správa životního cykluTy kontroluješZávisí na hostiteli

Klíčové poznatky

  • input_file s file_id odkazuje na nahraný soubor, file_url na veřejný dokument
  • Nástroj attachment_search se aktivuje automaticky pro extrakci relevantního obsahu
  • V jedné žádosti můžeš kombinovat více souborů
  • Pro důvěrné nebo často dotazované soubory upřednostni file_id
  • Pro veřejné dokumenty nebo rychlé testy upřednostni file_url