collections_search i file_search u Responses API-ju
Na ovoj stranici
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.
Alat collections_search
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.
Alat file_search
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
| Aspekt | collections_search | file_search / attachment_search |
|---|---|---|
| Izvor | Indeksirana kolekcija(e) | Pojedinačna datoteka(e) |
| Deklaracija | Eksplicitna u alatima | Automatska s input_file |
| Indeksiranje | Unaprijed izračunato | U stvarnom vremenu |
| Trošak | 2,50 $ / 1.000 | 10 $ / 1.000 |
| Performanse | Brzo (postojeći indeks) | Sporije (indeksiranje u stvarnom vremenu) |
| Slučaj upotrebe | Trajna baza znanja | Jednokratna 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_searchomogućuje Groku automatsko upitivanje tvojih kolekcija tijekom razgovorafile_search/attachment_searchaktivira se automatski za pojedinačne datoteke- Kolekcije su četiri puta jeftinije i brže od privitaka datoteka
- Možeš kombinirati
collections_searchsweb_searchi drugim alatima - Grok automatski odabire koje će alate koristiti na temelju pitanja