Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

collections_search a file_search v Responses API

Lekce 11 z 16 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Integrace vyhledávání přímo do konverzací
  2. Nástroj collections_search
  3. Nástroj file_search
  4. Dva mechanismy, dvě cenové struktury
  5. Kombinace více nástrojů
  6. Upřesnění chování nástroje
  7. Klíčové poznatky

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.

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.

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

Aspektcollections_searchfile_search / attachment_search
ZdrojIndexovaná kolekce (kolekce)Jednotlivý soubor (soubory)
DeklaraceExplicitní v toolsAutomatická s input_file
IndexováníPředpočítanéZa běhu (on the fly)
Cena2,50 $ / 1 00010 $ / 1 000
VýkonRychlé (existující index)Pomalejší (indexování v reálném čase)
Případ použitíTrvalá znalostní bázeJednorá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_search umožňuje Grokovi automaticky dotazovat tvé kolekce během konverzace
  • file_search / attachment_search se aktivuje automaticky pro jednotlivé soubory
  • Kolekce jsou čtyřikrát levnější a rychlejší než připojené soubory
  • Můžeš kombinovat collections_search s web_search a dalšími nástroji
  • Grok automaticky vybírá, které nástroje použít na základě otázky