Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

collections_search agus file_search san Responses API

Ceacht 11 as 16 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Cuardach a chomhtháthú go díreach i gcomhráite
  2. An uirlis collections_search
  3. An uirlis file_search
  4. Dhá mheicníocht, dhá struchtúr costais
  5. Uirlisí iolracha a chomhcheangal
  6. Iompar na n-uirlisí a bheachtú
  7. Príomhphointí

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.

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.

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_searchfile_search / attachment_search
FoinseBailiúchán/bailiúcháinn innéacsaitheComhad/comhaid aonair
DearbhúSainráite i toolsUathoibríoch le input_file
InnéacsúRéamh-ríofaAr an eitilt
Costas$2.50 / 1,000$10 / 1,000
FeidhmíochtTapa (innéacs atá ann cheana)Níos moille (innéacsú fíor-ama)
Cás úsáideBonn eolais buanAnailí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_search do Grok ceist a chur ar do bhailiúcháin go huathoibríoch le linn comhrá
  • Gníomhaíonn file_search / attachment_search go 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