collections_search a file_search v Responses API
Na této stránce
Integrace vyhledávání přímo do konverzací
Koncový bod POST /v1/documents/search funguje dobře pro izolované dotazy, ale veškerou práci s orchestrací nechává na tobě: formulaci dotazu, získání úryvků, jejich vložení do promptu a zavolání modelu. Responses API tuto zátěž obrací. Když deklaruješ své kolekce jako nástroj, necháš Groka rozhodnout, kdy vyhledat, co hledat a jak z toho vytvořit odpověď. Přecházíš od pipeline, kterou řídíš ty, k asistentovi, který sám prohledává tvé dokumenty.
Nástroj collections_search
Pro povolení tohoto přístupu stačí přidat objekt do seznamu 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 voláním Grok analyzuje otázku, zformuluje vyhledávací dotaz přizpůsobený kolekci, získá relevantní pasáže, shrne je a cituje použité dokumenty. V praxi pro výše uvedenou otázku přeloží „rodičovskou dovolenou“ do vyhledávání v col_rh_policies, zachová odstavce z firemní dohody a vrátí počet dní spolu se zdrojem, aniž bys musel napsat jediný řádek logiky pro získávání dat.
Nástroj file_search
Protějšek existuje pro jednotlivé soubory, které nejsou uloženy v kolekci. Není třeba jej deklarovat: aktivuje se automaticky, jakmile žádost 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, který se aktivuje na pozadí. Toto implicitní chování vysvětluje častý zmatek: uživatelé se diví, proč deklarace file_search v tools nemá žádný efekt, když je ve skutečnosti zbytečná.
Dva mechanismy, dvě cenové struktury
| Aspekt | collections_search | file_search / attachment_search |
|---|---|---|
| Zdroj | Indexovaná kolekce (kolekce) | Jednotlivý soubor (soubory) |
| Deklarace | Explicitní v tools | Automatická s input_file |
| Indexování | Předpočítané | Za běhu (on the fly) |
| Cena | 2,50 $ / 1 000 | 10 $ / 1 000 |
| Výkon | Rychlé (existující index) | Pomalejší (indexování v reálném čase) |
| Případ použití | Trvalá znalostní báze | Jednorázová analýza |
Řádek „Indexování“ určuje všechny ostatní. Kolekce je indexována jednou provždy, takže každý dotaz znovu využívá tuto práci: je rychlý a účtován za 2,50 $ za tisíc volání. Připojený soubor je indexován s každým požadavkem, což vysvětluje dodatečnou latenci a cenu 10 $ za tisíc. Smlouva, kterou právník analyzuje jednou, spadá do druhé kategorie; HR repozitář dotazovaný stokrát denně samozřejmě do první.
Kombinace více nástrojů
Skutečný přínos tohoto přístupu se projeví, když dáš Grokovi několik z nich a necháš ho vybrat ty, které slouží dané otázce.
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"
}
]
)
Tato otázka vyžaduje dva po sobě jdoucí kroky: Grok nejprve dotáže kolekci, aby našel vaši interní politiku, poté spustí vyhledávání na webu pro aktuální evropské předpisy a nakonec obě strany v odpovědi porovná. Žádná orchestrace na tvé straně, žádný příkaz if pro rozhodování, který ze dvou zdrojů je relevantní – a kdyby se otázka zaměřovala pouze na vaši interní politiku, web by se nepoužil.
Upřesnění chování nástroje
Tři parametry ti umožní zpřísnit vyhledávání deklarované v tools.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: dotazování více kolekcí současně
- max_results: omezení počtu výsledků pro snížení injektovaného kontextu
- retrieval_mode: výběr režimu vyhledávání (výchozí je hybridní)
Parametr max_results si zaslouží zvláštní pozornost: každý vrácený úryvek zabírá kontext a stojí tokeny. U asistenčního nástroje pro podporu, kde odpovědi obvykle zapadnou do dvou či tří pasáží, snížení z výchozí hodnoty na pět výsledků sníží náklady bez zhoršení vnímané kvality.
Ceny platné k 5. srpnu 2026 – ceny se pravidelně mění: před výpočtem jakéhokoli rozpočtu si ověř aktuální ceník na oficiální stránce modelů a cen xAI.
Klíčové poznatky
collections_searchumožňuje Grokovi automaticky dotazovat tvé kolekce během konverzacefile_search/attachment_searchse aktivuje automaticky pro jednotlivé soubory- Kolekce jsou čtyřikrát levnější a rychlejší než připojené soubory
- Můžeš kombinovat
collections_searchsweb_searcha dalšími nástroji - Grok automaticky vybírá, které nástroje použít na základě otázky