collections_search u file_search fl-API tar-Risposti
F'din il-paġna
Integra t-tiftix direttament fil-konversazzjonijiet
L-endpoint POST /v1/documents/search jaħdem tajjeb għal mistoqsijiet iżolati, iżda iħalli x-xogħol kollu tal-orkestrazzjoni f’idejk: ifformular il-mistoqsija, tirċievi estratti, tinjettahom f’prompt, u ssejjaħ il-mudell. L-API tar-Risposti taqlib din il-piża. Billi tiddikjara l-kollezzjonijiet tiegħek bħala għodda, tħalli lil Grok jiddeċiedi meta jfittex, x’ifittex, u kif ibiddel dan f’tweġiba. Inti timxi minn pipeline li tmexxi int għal assistent li jfittex id-dokumenti tiegħek stess.
L-għodda collections_search
Għandek biss bżonn iżżid oġġett fil-lista tools biex tippermetti dan l-aċċess:
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"]
}
]
)
Wara din is-sejħa waħda, Grok janalizza l-mistoqsija, jifformula mistoqsija ta’ tiftix adattata għall-kollezzjoni, jirkupra passi rilevanti, jagħmlilhom sommarju, u jikkwota d-dokumenti użati. Fil-prattika, għall-mistoqsija ta’ hawn fuq, se jittraduċi “paternity leave” f’tiftix fi col_rh_policies, iżomm il-paragrafi mill-ftehim tal-kumpanija, u jirritorna numru ta’ jiem flimkien mas-sors tiegħu, mingħajr ma tikteb linja waħda ta’ loġika ta’ rkupru.
L-għodda file_search
Il-kontroparti teżisti għal fajls individwali, dawk li mhumiex maħżuna f’kollezzjoni. M’hemmx bżonn tiddikjarah: jattiva awtomatikament non appena t-talba tiegħek fiha input_file.
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?"
}
]
)
Hija l-għodda attachment_search, ekwivalenti għal file_search, li tattiva fl-isfond. Dan l-imġiba impliċita tispjega konfużjoni komuni: l-utenti jistaqsu għaliex id-dikjarazzjoni ta’ file_search f’tools tidher li m’għandha l-ebda effett, meta sempliċiment hija superflwa.
Żewġ mekkaniżmi, żewġ strutturi ta’ kost
| Aspett | collections_search | file_search / attachment_search |
|---|---|---|
| Sors | Kollezzjoni(jiet) indiċjati | Fajl(s) individwali |
| Dikjarazzjoni | Espliċita f’tools | Awtomatika ma’ input_file |
| Indiċjar | Ikkalkulat minn qabel | Fuq it-titjira (On the fly) |
| Kost | $2.50 / 1,000 | $10 / 1,000 |
| Prestazzjoni | Mgħaġġla (indiċi eżistenti) | Aktar bil-mod (indiċjar f’ħin reali) |
| Każ ta’ użu | Bażi tal-għarfien permanenti | Analiżi ta’ darba |
Il-linja “Indiċjar” tmexxi lill-oħrajn kollha. Kollezzjoni tiġi indiċjata darba għal dejjem, allura kull mistoqsija terġa’ tuża dak ix-xogħol: hija mgħaġġla u fatturata b’$2.50 għal kull elf sejħa. Fajl mehmuż jiġi indiċjat ma’ kull talba, għalhekk il-latenza addizzjonali u l-$10 għal kull elf. Il-kuntratt li l-kunsillier legali tiegħek janalizza darba jaqa’ fit-tieni kategorija; ir-repożitorju tar-Riżorsi Umani mistoqsi mitt darba kuljum jaqa’ ovvjament fl-ewwel waħda.
Ikkombina għodod multipli
Il-benefiċċju reali ta’ dan l-approċċ jidher meta tagħti lil Grok diversi minnhom, u tħallih jagħżel dawk li jservu lill-mistoqsija.
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"
}
]
)
Din il-mistoqsija teħtieġ żewġ mossa suċċessivi: Grok l-ewwel jistaqsi lill-kollezzjoni biex isib il-politika interna tiegħek, imbagħad jnedi tiftix fuq il-web għar-regolamenti Ewropej attwali, u mbagħad iqabbel iż-żewġ partijiet fir-risposta tiegħu. L-ebda orkestrazzjoni min-naħa tiegħek, l-ebda dikjarazzjoni if biex tiddeċiedi liema miż-żewġ sorsi hija rilevanti—u kieku l-mistoqsija kienet iffukata biss fuq il-politika interna tiegħek, il-web ma kienx jintuża.
Irraffina l-imġiba tal-għodda
Tliet parametri jħalluk issaħħaħ it-tiftix iddikjarat f’tools.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: staqsi diversi kollezzjonijiet simultanjament
- max_results: illimita n-numru ta’ riżultati biex tnaqqas il-kuntest injettat
- retrieval_mode: agħżel il-modalità ta’ tiftix (ibridu b’mod default)
max_results jistħoqqilu attenzjoni speċjali: kull estratt irritornat jieħu spazju fil-kuntest u jiswa tokens. Fuq assistent ta’ appoġġ fejn it-tweġibiet ġeneralment joqogħdu fi ħdan żewġ jew tliet passi, li tonqos mill-valur default għal ħames riżultati tnaqqas l-ispejjeż mingħajr ma tiddeterjora l-kwalità pperċepita.
Prezzijiet sal-5 ta’ Awwissu 2026 — il-prezzijiet jinbidlu regolarment: qabel ma tikkalkula kwalunkwe baġit, iċċekkja l-prezzijiet attwali fuq il-paġna uffiċjali tal-mudelli u l-prezzijiet ta’ xAI.
Punti Ewlenin
collections_searchjħalli lil Grok jistaqsi awtomatikament il-kollezzjonijiet tiegħek matul konversazzjonifile_search/attachment_searchjattiva awtomatikament għal fajls individwali- Il-kollezzjonijiet huma erba’ darbiet irħas u aktar mgħaġġla mill-fajls mehmuża
- Tista’ tikkombina
collections_searchma’web_searchu għodod oħra - Grok jagħżel awtomatikament liema għodod juża abbażi tal-mistoqsija