input_file agus attachment_search san API Freagraí
Ar an leathanach seo
Dhá bhealach chun an bloc céanna a bhaint amach
Glacann API Freagraí Grok le doiciméad ar dhá bhealach: trí file_id, rud a chiallaíonn comhad a d’uaslódáil tú cheana, nó trí file_url, seoladh poiblí a fhaigheann xAI ag am na hiarrata. Úsáideann an bloc an t-ainm céanna i ngach cás, input_file, agus tá an phróiseáil ina dhiaidh sin identic: gníomhachtaíonn Grok an uirlis attachment_search agus baineann sé na pasáistí amach a fhreagraíonn do cheist. Is é an difríocht ná timthriall an doiciméid, a rúndacht, agus costas gach glaonna arís.
An bealach file_id
Nuair a sheolann tú an comhad trí POST /v1/files, tagraíonn tú dó trína aitheantóir, in éineacht le do cheist i ngnáth-théacs:
{
"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á ciall leis an mbealach seo i dtrí chás. Is é an chéad cheis ná ceisteanna arís agus arís eile: má iarrann do fhoireann dlí cúig cheist déana as a chéile faoin gconradh céanna, sáraíonn uaslódáil amháin agus cúig thagairt déag cúig aistriú den PDF céanna. Is é an dara ceis ná rúndacht, nuair nach mór an doiciméad a choinneáil slán ó URL atá inrochtana ag duine ar bith a bhfuil an nasc aige. Is é an tríú ceis ná d’ailtireacht feidhmchláir: má uaslódáiltear comhaid roimh ré le linn ionghabhála oíche, ní láimhsíonn do chuid iarratas ach aitheantóirí.
An bealach file_url
Nuair atá an doiciméad foilsithe cheana féin áit éigin, is céim riachtanach é an t-uaslódáil agus is féidir leat díriú go díreach ar an seoladh:
{
"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."
}
]
}
I measc na gcásanna úsáide tipiciúla tá doiciméadú oscailte nach bhfuil aon chúis agat a stóráil, comhad óstáilte ar do bhonneagar féin taobh thiar de URL sealadach, nó tástáil thapa ar mhaith leat hipitéis a fhíorú gan píblíne uaslódála iomlán a chur ar bun.
Tagann trí theorainn leis an áisiúlacht seo, agus costóidh siad go léir duit sa táirgeadh. Caithfidh an URL a bheith fíor-phoiblí, gan aon fíordheimhniú: filleann seoladh atá cosanta ag comhartha nó cookie leathanach earráide chuig xAI, agus déanfaidh an tsamhail anailís dhícheallach air sin in ionad do dhoiciméid. Cuireann an íoslódáil le ham próiseála na hiarrata, rud a fhágann go bhfuil PDFanna móra i bhfad níos moille ná le file_id. Ar deireadh, níl aon taisce ar thaobh xAI: íoslódálann gach glao an comhad arís, mar sin trasnaíonn doiciméad amháin a bhfuil ceist faoi chaoga uair sa lá an líonra caoga uair.
Cad a dhéanann attachment_search
Chomh luath agus a fheictear input_file in d’iarratas, spreagann Grok attachment_search gan aon chumraíocht uait. Tarlaíonn an phróiseáil i gceithre chéim:
- Eastóscadh ábhair ón gcomhad: téacs, táblaí, struchtúr
- Innéacsú sealadach den ábhar seo, ar feadh thréimhse na hiarrata
- Cuardach ar phasáistí ábhartha bunaithe ar do cheist
- Instealladh blúirí isteach i gcomhthéacs na samhla
Dírigh ar an aidiacht “sealadach” sa dara céim, toisc go míníonn sé difríocht costais a fhionnann go leor daoine ró-dhéanach: athdhéantar an t-innéacs ar gach glao agus imíonn sé ina dhiaidh sin. Is é seo go díreach an fhadhb a réitíonn bailiúcháin le hinneacsú buan. Tabhair faoi deara freisin go luaíonn an tsamhail na pasáistí a d’úsáid sí go díreach ina freagra, rud a ligeann duit a cuid oibre a fhíorú seachas glacadh lena focal.
Ilchomhad a chomhcheangal
Níl aon rud a chuireann iallach ort fanacht le comhad amháin in aghaidh na hiarrata. Trí bhlocanna input_file iolracha a charnadh, iarrann tú ar an tsamhail réasúnú a dhéanamh ar an tacar:
{
"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."
}
]
}
Déanann Grok anailís ar an dá dhoiciméad agus tras-thagraíonn sé faisnéis chun freagra a thabhairt, rud a osclaíonn an doras do chomparáidí ráthúla, athbhreithnithe ar leaganacha conarthaí leantacha, nó aighneachtaí idir sonraíocht agus a cur chun feidhme.
Roghnú idir an dá cheann
| Critéar | file_id | file_url |
|---|---|---|
| Uaslódáil roimh ré | Tá | Níl |
| Comhad rúnda | Molta | Mí-mholta |
| Ceisteanna arís agus arís eile | Feidhmíoch (1 uaslódáil) | Mall (ath-íoslódáil) |
| Comhad poiblí | Indéanta | Ideálach |
| Bainistiú timthrialla | Is tusa a rialaíonn | Braitheann ar an óstach |
Príomhphointí
- Tagraíonn
input_filelefile_iddo chomhad uaslódáilte, agusfile_urldo dhoiciméad poiblí - Gníomhachtaíonn an uirlis
attachment_searchgo huathoibríoch chun ábhar ábhartha a eastóscadh - Is féidir leat ilchomhad a chomhcheangal in iarratas amháin
- Bain úsáid as
file_iddo chomhaid rúnda nó a gcuirtear ceisteanna orthu go minic - Bain úsáid as
file_urldo dhoiciméid phoiblí nó do thástálacha tapa