Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

collections_search i file_search u Responses API-ju

Lekcija 11 od 16 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Integriraj pretraživanje izravno u razgovore
  2. Alat collections_search
  3. Alat file_search
  4. Dva mehanizma, dvije strukture troškova
  5. Kombiniraj više alata
  6. Uskladi ponašanje alata
  7. Ključne točke

Integriraj pretraživanje izravno u razgovore

Krajnja točka POST /v1/documents/search dobro funkcionira za izolirana pitanja, ali sav posao orchestracije prepušta tebi: formuliranje upita, dohvaćanje isječaka, njihovo ubacivanje u prompt i pozivanje modela. Responses API preokreće taj teret. Deklariranjem svojih kolekcija kao alata, dopuštaš Groku da odluči kada pretraživati, što tražiti i kako to pretvoriti u odgovor. Prelaziš s cjevovoda kojim upravljaš na asistenta koji samostalno pretražuje tvoje dokumente.

Da bi omogućio ovaj pristup, samo trebaš dodati objekt na popis 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"]
        }
    ]
)

Iza ovog jednog poziva, Grok analizira pitanje, formulira upit za pretraživanje prilagođen kolekciji, dohvaća relevantne odlomke, sažima ih i citira korištene dokumente. U praksi, za gornje pitanje, prevest će „rodiljni dopust“ u pretraživanje unutar col_rh_policies, zadržati odlomke iz kolektivnog ugovora tvrtke i vratiti broj dana zajedno s izvorom, a da ti ne napišeš niti jedan redak logike za dohvaćanje.

Protuteža postoji za pojedinačne datoteke, one koje nisu pohranjene u kolekciji. Nema potrebe za deklariranjem: aktivira se automatski čim tvoj zahtjev sadrži 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?"
        }
    ]
)

To je alat attachment_search, ekvivalent alatu file_search, koji se aktivira u pozadini. Ovo implicitno ponašanje objašnjava čestu zabunu: korisnici se pitaju zašto deklariranje file_search u tools nema učinka, kada je ono jednostavno suvišno.

Dva mehanizma, dvije strukture troškova

Aspektcollections_searchfile_search / attachment_search
IzvorIndeksirana kolekcija(e)Pojedinačna datoteka(e)
DeklaracijaEksplicitna u alatimaAutomatska s input_file
IndeksiranjeUnaprijed izračunatoU stvarnom vremenu
Trošak2,50 $ / 1.00010 $ / 1.000
PerformanseBrzo (postojeći indeks)Sporije (indeksiranje u stvarnom vremenu)
Slučaj upotrebeTrajna baza znanjaJednokratna analiza

Redak „indeksiranje“ pokreće sve ostale. Kolekcija se indeksira jednom zauvijek, pa svako pitanje ponovno koristi taj rad: brzo je i naplaćuje se po 2,50 $ po tisuću poziva. Priložena datoteka indeksira se sa svakim zahtjevom, što objašnjava dodatnu latenciju i cijenu od 10 $ po tisuću. Ugovor koji tvoj pravni savjetnik analizira jednom spada u drugu kategoriju; HR repozitorij koji se upituje stotinu puta dnevno očito spada u prvu.

Kombiniraj više alata

Prava korist ovog pristupa očituje se kada Groku daš nekoliko njih, dopuštajući mu da odabere one koji služe pitanju.

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"
        }
    ]
)

Ovo pitanje zahtijeva dva uzastopna poteza: Grok prvo upituje kolekciju kako bi pronašao tvoju internu politiku, zatim pokreće web pretraživanje za trenutne europske propise, a zatim suprotstavlja ta dva izvora u svom odgovoru. Nema orchestracije s tvoje strane, nema if naredbe za odluku koji je od dva izvora relevantan – i da se pitanje fokusiralo isključivo na tvoju internu politiku, web ne bi bio korišten.

Uskladi ponašanje alata

Tri parametra omogućuju ti da preciziraš pretraživanje deklarirano u tools.

tools=[
    {
        "type": "collections_search",
        "collection_ids": ["col_docs_1", "col_docs_2"],
        "max_results": 10,
        "retrieval_mode": "hybrid"
    }
]
  • collection_ids: istovremeno upituj više kolekcija
  • max_results: ograniči broj rezultata kako bi se smanjio ubrizgani kontekst
  • retrieval_mode: odaberi način pretraživanja (zadano je hibridno)

max_results zaslužuje posebnu pozornost: svaki vraćeni isječak zauzima kontekst i košta tokene. Kod asistenta za podršku gdje odgovori obično stanu u dva ili tri odlomka, smanjenje s zadane vrijednosti na pet rezultata smanjuje trošak bez narušavanja percipirane kvalitete.

Cjenik od 5. kolovoza 2026. — cijene se redovito mijenjaju: prije izračuna bilo kakvog proračuna, provjeri trenutni cjenik na službenoj stranici xAI modela i cijena.

Ključne točke

  • collections_search omogućuje Groku automatsko upitivanje tvojih kolekcija tijekom razgovora
  • file_search / attachment_search aktivira se automatski za pojedinačne datoteke
  • Kolekcije su četiri puta jeftinije i brže od privitaka datoteka
  • Možeš kombinirati collections_search s web_search i drugim alatima
  • Grok automatski odabire koje će alate koristiti na temelju pitanja