input_file a attachment_search v Responses API
Na této stránce
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.
Co dělá attachment_search
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:
- Extrakce obsahu ze souboru: text, tabulky, struktura
- Dočasné indexování tohoto obsahu po dobu trvání žádosti
- Vyhledání relevantních pasáží na základě tvé otázky
- 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érium | file_id | file_url |
|---|---|---|
| Předchozí nahrání | Ano | Ne |
| Důvěrný soubor | Doporučeno | Nedoporučeno |
| Opakované dotazy | Výkonné (1 nahrání) | Pomalé (opětovné stažení) |
| Veřejný soubor | Možné | Ideální |
| Správa životního cyklu | Ty kontroluješ | Závisí na hostiteli |
Klíčové poznatky
input_filesfile_idodkazuje na nahraný soubor,file_urlna veřejný dokument- Nástroj
attachment_searchse 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