collections_search agus file_search san Responses API
Ar an leathanach seo
Cuardach a chomhtháthú go díreach i gcomhráite
Oibríonn an t-easpórtáil POST /v1/documents/search go maith le haghaidh ceisteanna aonair, ach fágann sé an obair eagraíochta go léir leatsa: an cheist a fhoirmiú, blúirí a aisghabháil, iad a instealladh i leid, agus an tsamhail a ghlaowh. Casann an Responses API an t-ualach seo. Trí do bhailiúcháin a dhearbhú mar uirlis, ligean tú do Grok a chinneadh cathain a dhéanfar cuardach, cad atá le lorg, agus conas a thiontú ina fhreagra é. Bogann tú ó phíblíne a stiúrann tú féin go cúntóir a chuardaíonn do dhoiciméid leis féin.
An uirlis collections_search
Níl le déanamh agat ach oibiacht a chur leis an liosta tools chun an rochtain seo a chumasú:
response = await client.responses.create(
model="grok-4.5",
input="What is our paternity leave policy?",
tools=[
{
"type": "collections_search",
"collection_ids": ["col_rh_policies"]
}
]
)
Taobh thiar den ghlaon amháin seo, déanann Grok anailís ar an gceist, foirmíonn sé ceist chuardaigh atá oiriúnaithe don bhailiúchán, faigheann sé pasáin ábhartha, déanann sé achoimre orthu, agus luaíonn sé na doiciméid a úsáideadh. Go praiticiúil, don cheist thuas, aistríonn sé “paternity leave” go cuardach i col_rh_policies, coimeádann sé na míreanna ón gcomhaontú cuideachta, agus filleann sé líon na laethanta mar aon lena fhoinse, gan duit líne amháin loighce aisghabhála a scríobh.
An uirlis file_search
Tá an comhpháirtí ann do chomhaid aonair, iad siúd nach bhfuil stóráilte i mbailiúchán. Ní gá é a dhearbhú: gníomhaíonn sé go huathoibríoch chomh luath agus a bhíonn input_file i do iarratas.
response = await client.responses.create(
model="grok-4.5",
input=[
{
"type": "input_file",
"file_id": "file_contrat_abc"
},
{
"type": "input_text",
"text": "Does this contract contain a non-compete clause?"
}
]
)
Is í an uirlis attachment_search, atá coibhéiseach le file_search, a ghníomhaíonn sa chúlra. Míníonn an iompar implíciteach seo mearbhall coitianta: bíonn iontas ar úsáideoirí cén fáth nach bhfuil aon éifeacht ag file_search a dhearbhú i tools, nuair nach bhfuil ann ach rud atá iomarcach.
Dhá mheicníocht, dhá struchtúr costais
| Gné | collections_search | file_search / attachment_search |
|---|---|---|
| Foinse | Bailiúchán/bailiúcháinn innéacsaithe | Comhad/comhaid aonair |
| Dearbhú | Sainráite i tools | Uathoibríoch le input_file |
| Innéacsú | Réamh-ríofa | Ar an eitilt |
| Costas | $2.50 / 1,000 | $10 / 1,000 |
| Feidhmíocht | Tapa (innéacs atá ann cheana) | Níos moille (innéacsú fíor-ama) |
| Cás úsáide | Bonn eolais buan | Anailís aonuaire |
Is é an líne “innéacsú” a thiomáineann gach ceann eile. Déantar bailiúchán a innéacsú uair amháin agus go deo, mar sin athúsáideann gach ceist an obair sin: tá sé tapa agus billítear $2.50 in aghaidh gach míle glaon air. Déantar comhad ceangailte a innéacsú le gach iarratas, agus mar sin tagann an mhoill bhreise agus an $10 in aghaidh gach míle. Titeann an conradh a ndéanann do chomhairleoir dlí anailís air uair amháin sa dara catagóir; titeann an stórtha HR a ndéantar ceist air céad uair in aghaidh an lae go soiléir sa chéad cheann.
Uirlisí iolracha a chomhcheangal
Léirítear an tairbhe fhíor den cur chuige seo nuair a thugann tú roinnt uirlisí do Grok, agus ligean dó na cinn a fhreastalaíonn ar an gceist a roghnú.
response = await client.responses.create(
model="grok-4.5",
input="Compare our internal policy with the latest European regulations on the subject.",
tools=[
{
"type": "collections_search",
"collection_ids": ["col_politiques_internes"]
},
{
"type": "web_search"
}
]
)
Éilíonn an cheist seo dhá ghluaiseacht leantacha: déanann Grok ceist ar an mbailiúchán ar dtús chun do pholasaí inmheánach a aimsiú, ansin seolann sé cuardach gréasáin le haghaidh rialacháin Eorpacha reatha, agus ansin déanann sé comparáid idir an dá cheann ina fhreagra. Gan aon eagrúchán ar do thaobh, gan ráiteas if chun a chinneadh cé acu de na dhá fhoinse atá ábhartha—agus dá mbeadh an cheist dírithe go hiomlán ar do pholasaí inmheánach, ní úsáidfí an gréasán.
Iompar na n-uirlisí a bheachtú
Ligeann trí pharaiméadar duit an cuardach a dhearbhaítear i tools a dhaingniú.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: déan ceist ar bhailiúcháin iolracha go comhuaineach
- max_results: teorainn a chur le líon na dtorthaí chun an comhthéacs insteallta a laghdú
- retrieval_mode: roghnaigh an mód cuardaigh (hibrideach de réir réamhshocraithe)
Tuilleann max_results aird ar leith: glacann gach blúire a fhilltear suas comhthéacs agus costálann sé tócaí. Ar chúntóir tacaíochta ina mbíonn freagraí oiriúnach de ghnáth laistigh de dhá nó trí phas, laghdaíonn titim ón luach réamhshocraithe go cúig thoradh an costas gan cáilíocht mheasta a mheath.
Praghsáil ón 5 Lúnasa 2026 — athraíonn praghsanna go rialta: sula ndéanann tú aon bhuiséad a ríomh, seiceáil an praghsáil reatha ar leathanach oifigiúil samhlacha agus praghsanna xAI.
Príomhphointí
- Ligeann
collections_searchdo Grok ceist a chur ar do bhailiúcháin go huathoibríoch le linn comhrá - Gníomhaíonn
file_search/attachment_searchgo huathoibríoch do chomhaid aonair - Tá bailiúcháin ceithre huaire níos saoire agus níos tapúla ná ceangaltáin chomhad
- Is féidir leat collections_search a chomhcheangal le web_search agus uirlisí eile
- Roghnaíonn Grok go huathoibríoch cé na huirlisí le húsáid bunaithe ar an gceist