collections_search a file_search v Responses API
Na tejto strane
Integrácia vyhľadávania priamo do konverzácií
Koncový bod POST /v1/documents/search funguje dobre pre izolované otázky, ale všetku prácu s orchestráciou necháva na tebe: formuláciu dopytu, získanie úryvkov, ich vloženie do promptu a volanie modelu. Responses API túto záťaž obracia. Tým, že deklarujete svoje kolekcie ako nástroj, necháte Grok rozhodnúť, kedy vyhľadávať, čo hľadať a ako z toho vytvoriť odpoveď. Prechádzate od pipeline, ktorú riadite vy, k asistentovi, ktorý sám vyhľadáva vo vašich dokumentoch.
Nástroj collections_search
Na povolenie tohto prístupu stačí pridať objekt do zoznamu tools:
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"]
}
]
)
Za týmto jediným volaním Grok analyzuje otázku, sformuluje vyhľadávací dopyt šitý na mieru pre kolekciu, získa relevantné pasáže, zhrnie ich a cituje použité dokumenty. V praxi pre vyššie uvedenú otázku preloží „materskú dovolenku“ na vyhľadávanie v col_rh_policies, zachová odseky z firemnej dohody a vráti počet dní spolu so zdrojom, pričom ty nemusíš napísať ani riadok logiky na získavanie údajov.
Nástroj file_search
Protičasť existuje pre jednotlivé súbory, ktoré nie sú uložené v kolekcii. Nie je potrebné ju deklarovať: aktivuje sa automaticky hneď, ako vaša požiadavka obsahuje 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?"
}
]
)
Je to nástroj attachment_search, ekvivalent file_search, ktorý sa aktivuje na pozadí. Toto implicitné správanie vysvetľuje častý zmätok: používatelia sa čudujú, prečo deklarácia file_search v tools nemá žiadny účinok, keď je jednoducho nadbytočná.
Dva mechanizmy, dve štruktúry nákladov
| Aspekt | collections_search | file_search / attachment_search |
|---|---|---|
| Zdroj | Indexovaná kolekcia(e) | Jednotlivý súbor(y) |
| Deklarácia | Explicitná v tools | Automatická s input_file |
| Indexovanie | Vopred vypočítané | Za behu (on the fly) |
| Náklady | 2,50 $ / 1 000 | 10 $ / 1 000 |
| Výkon | Rýchle (existujúci index) | Pomalšie (indexovanie v reálnom čase) |
| Prípad použitia | Trvalá znalostná báza | Jednorazová analýza |
Riadok „Indexovanie“ určuje všetky ostatné. Kolekcia je indexovaná raz a navždy, takže každá otázka znovu využíva túto prácu: je rýchla a účtovaná sumou 2,50 $ za tisíc volaní. Pripojený súbor sa indexuje s každou požiadavkou, čo vysvetľuje dodatočnú latenciu a cenu 10 $ za tisíc. Zmluva, ktorú váš právny poradca analyzuje raz, patrí do druhej kategórie; HR repozitár, na ktorý sa denne stokrát pýtajú, zrejme patrí do tej prvej.
Kombinácia viacerých nástrojov
Skutočný prínos tohto prístupu sa prejaví, keď dáte Grokovi niekoľko z nich a necháte ho vybrať tie, ktoré slúžia otázke.
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"
}
]
)
Táto otázka si vyžaduje dva po sebe idúce kroky: Grok najprv dopytuje kolekciu, aby našiel vašu internú politiku, potom spustí vyhľadávanie na webe pre aktuálne európske nariadenia a nakoniec obe strany v odpovedi porovná. Žiadna orchestrácia na vašej strane, žiadny príkaz if na rozhodnutie, ktorý zo zdrojov je relevantný – a keby sa otázka sústredila výlučne na vašu internú politiku, web by sa nepoužil.
Spresnenie správania nástrojov
Tri parametre vám umožňujú sprísniť vyhľadávanie deklarované v tools.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: dopytovanie viacerých kolekcií súčasne
- max_results: obmedzenie počtu výsledkov na zníženie vloženého kontextu
- retrieval_mode: výber režimu vyhľadávania (predvolene hybridný)
Parameter max_results si zasluhuje osobitnú pozornosť: každý vrátený úryvok zaberá miesto v kontexte a stojí tokeny. Pri asistentovi podpory, kde odpovede zvyčajne zapadnú do dvoch alebo troch pasáží, zníženie z predvolenej hodnoty na päť výsledkov zníži náklady bez zhoršenia vnímanej kvality.
Ceny platné k 5. augustu 2026 – ceny sa pravidelne menia: pred výpočtom akéhokoľvek rozpočtu si overte aktuálne ceny na oficiálnej stránke modelov a cien xAI.
Kľúčové poznatky
collections_searchumožňuje Grokovi automaticky dopytovať vaše kolekcie počas konverzáciefile_search/attachment_searchsa aktivuje automaticky pre jednotlivé súbory- Kolekcie sú štyrikrát lacnejšie a rýchlejšie ako prílohy súborov
- Môžete kombinovať
collections_searchsweb_searcha ďalšími nástrojmi - Grok automaticky vyberá, ktoré nástroje použiť na základe otázky