input_file in attachment_search v API-ju Responses
Na tej strani
Dve poti do istega bloka
API Responses za Grok sprejme dokument na dva načina: prek file_id, kar pomeni datoteko, ki ste jo predhodno naložili, ali prek file_url, javnega naslova, ki ga xAI pridobi ob času zahteve. Blok ima v obeh primerih isto ime, input_file, nadaljnja obdelava pa je enaka: Grok aktivira orodje attachment_search in izvleče odlomke, ki odgovarjajo na vaše vprašanje. Razlika je v življenjskem ciklu dokumenta, njegovi zaupnosti in stroških vsakega ponovljenega klica.
Pot prek file_id
Ko datoteko pošljete prek POST /v1/files, se nanjo sklicujete z njenim identifikatorjem, skupaj z vašim vprašanjem v navadnem besedilu:
{
"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?"
}
]
}
Ta pot ima smisel v treh situacijah. Prva so ponavljajoča se poizvedbe: če vaša pravna ekipa zastavi petnajst zaporednih vprašanj o isti pogodbi, je en sam prenos, ki mu sledi petnajst sklicevanj, boljši od petnajstih prenosov istega PDF-ja. Druga je zaupnost, ko dokument ne sme biti izpostavljen za URL-jem, dostopnim komur koli s povezavo. Tretja je arhitektura vaše aplikacije: če so datoteke vnaprej naložene med nočnim vnosom podatkov, vaši zahtevki obravnavajo le identifikatorje.
Pot prek file_url
Ko je dokument že nekje objavljen, nalaganje postane nepotreben korak in lahko neposredno navedete naslov:
{
"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čni primeri uporabe vključujejo odprto dokumentacijo, ki je ni treba shranjevati, datoteko, gostovano na vaši infrastrukturi za začasnim URL-jem, ali hiter test, kjer želite preveriti hipotezo brez vzpostavitve celotnega cevovoda za nalaganje.
S to priročnostjo so povezane tri omejitve in vse vas v proizvodnem okolju nekaj stanejo. URL mora biti resnično javen, brez avtentikacije: naslov, zaščiten s žetonom ali piškotkom, vrne xAI-ju stran z napako, ki jo bo model vestno analiziral namesto vašega dokumenta. Prenos podaljša čas obdelave zahteve, zaradi česar so veliki PDF-ji bistveno počasnejši kot pri uporabi file_id. Nazadnje, na strani xAI ni predpomnilnika: vsak klic znova prenese datoteko, zato en sam dokument, po katerem se poizveduje petdesetkrat na dan, prečka omrežje petdesetkrat.
Kaj počne attachment_search
Takoj ko se v vaši zahtevi pojavi input_file, Grok brez vaše konfiguracije sproži attachment_search. Obdelava poteka v štirih korakih:
- Izvleček vsebine iz datoteke: besedilo, tabele, struktura
- Začasno indeksiranje te vsebine za čas trajanja zahteve
- Iskanje ustreznih odlomkov na podlagi vašega vprašanja
- Vstavljanje izsekov v kontekst modela
Osredotočite se na pridevnik „začasno” v drugem koraku, saj pojasnjuje razliko v stroških, ki jo mnogi odkrijejo prepozno: indeks se ob vsakem klicu znova zgradi in nato izgine. To je ravno težava, ki jo zbirke rešujejo s trajnim indeksiranjem. Upoštevajte tudi, da model v svojem odgovoru navede odlomke, ki jih je dejansko uporabil, kar vam omogoča preverjanje njegovega dela, namesto da bi mu slepo verjeli.
Združevanje več dokumentov
Ni vam treba omejiti se na eno datoteko na zahtevo. Z zlaganjem več blokov input_file od modela zahtevate sklepanje po celotnem nizu:
{
"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 analizira oba dokumenta in navzkrižno poveže informacije za odgovor, kar odpira vrata četrtletnim primerjavam, pregledom zaporednih različic pogodb ali soočanjem med specifikacijo in njeno implementacijo.
Izbira med obema
| Merilo | file_id | file_url |
|---|---|---|
| Predhodno nalaganje | Da | Ne |
| Zaupna datoteka | Priporočljivo | Odsvetovano |
| Ponavljajoča se poizvedba | Učinkovito (1 nalaganje) | Počasno (ponovni prenos) |
| Javna datoteka | Mogoče | Idealno |
| Upravljanje življenjskega cikla | Vi nadzorujete | Odvisno od gostitelja |
Ključne ugotovitve
input_filesfile_idse sklicuje na naloženo datoteko,file_urlpa na javni dokument- Orodje
attachment_searchse samodejno aktivira za izvleček ustrezne vsebine - V eni zahtevi lahko združite več datotek
- Za zaupne ali pogosto poizvedovane datoteke raje uporabite
file_id - Za javne dokumente ali hitre teste raje uporabite
file_url