Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

collections_search a file_search v Responses API

Lekcia 11 z 16 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Integrácia vyhľadávania priamo do konverzácií
  2. Nástroj collections_search
  3. Nástroj file_search
  4. Dva mechanizmy, dve štruktúry nákladov
  5. Kombinácia viacerých nástrojov
  6. Spresnenie správania nástrojov
  7. Kľúčové poznatky

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.

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.

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

Aspektcollections_searchfile_search / attachment_search
ZdrojIndexovaná kolekcia(e)Jednotlivý súbor(y)
DeklaráciaExplicitná v toolsAutomatická s input_file
IndexovanieVopred vypočítanéZa behu (on the fly)
Náklady2,50 $ / 1 00010 $ / 1 000
VýkonRýchle (existujúci index)Pomalšie (indexovanie v reálnom čase)
Prípad použitiaTrvalá znalostná bázaJednorazová 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_search umožňuje Grokovi automaticky dopytovať vaše kolekcie počas konverzácie
  • file_search / attachment_search sa 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_search s web_search a ďalšími nástrojmi
  • Grok automaticky vyberá, ktoré nástroje použiť na základe otázky