Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

collections_search in file_search v API-ju Responses

Lekcija 11 od 16 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Neposredna integracija iskanja v pogovore
  2. Orodje collections_search
  3. Orodje file_search
  4. Dva mehanizma, dve strukturi stroškov
  5. Kombiniranje več orodij
  6. Izpopolnitev vedenja orodij
  7. Ključne ugotovitve

Neposredna integracija iskanja v pogovore

Končna točka POST /v1/documents/search dobro deluje za izolirana vprašanja, vendar vso orchestracijo prepušča tebi: oblikovanju poizvedbe, pridobivanju izsekov, njihovem vstavljanju v poziv in klicanju modela. API Responses to breme obrne. Z deklariranjem svojih zbirk kot orodja Groku prepustiš odločitev, kdaj iskati, kaj iskati in kako iz tega sestaviti odgovor. Preideš iz cevovoda, ki ga poganjaš ti, na asistenta, ki sam išče po tvojih dokumentih.

Za omogočitev tega dostopa moraš le dodati objekt na seznam 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 tem enim klicem Grok analizira vprašanje, oblikuje poizvedbo za iskanje, prilagojeno zbirki, pridobi ustrezne odlomke, jih povzame in navede uporabljene dokumente. V praksi bo za zgornje vprašanje „očetovski dopust” prevedel v iskanje po col_rh_policies, obdržal odstavke iz podjetniškega sporazuma in vrnil število dni skupaj z virom, ne da bi ti napisal vrstico logike za pridobivanje.

Protiteža obstaja za posamezne datoteke, ki niso shranjene v zbirki. Ni je treba deklarirati: aktivira se samodejno, takoj ko tvoja zahteva vsebuje 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?"
        }
    ]
)

V ozadju se aktivira orodje attachment_search, ki je enakovredno file_search. To implicitno vedenje pojasnjuje pogosto zmedo: uporabniki se sprašujejo, zakaj deklaracija file_search v tools nima učinka, čeprav je preprosto odvečna.

Dva mehanizma, dve strukturi stroškov

Vidikcollections_searchfile_search / attachment_search
VirIndeksirana zbirka(e)Posamezna datoteka(e)
DeklaracijaIzrecna v toolsSamodejna z input_file
IndeksiranjeVnaprej izračunanoSproti (on the fly)
Strošek2,50 $ / 1.00010 $ / 1.000
ZmogljivostHitro (obstoječi indeks)Počasneje (indeksiranje v realnem času)
Primer uporabeTrajna baza znanjaEnkratna analiza

Vrstica „indeksiranje” poganja vse ostale. Zbirka je indeksirana enkrat za vselej, zato vsako vprašanje ponovno uporabi to delo: hitro je in zaračunano po 2,50 $ na tisoč klicev. Priložena datoteka se indeksira z vsako zahtevo, kar povzroča dodatno zakasnitev in strošek 10 $ na tisoč. Pogodba, ki jo pravni svetovalec analizira enkrat, spada v drugo kategorijo; kadrovska zbirka, ki jo dnevno poiščejo stokrat, očitno spada v prvo.

Kombiniranje več orodij

Prava prednost tega pristopa pride do izraza, ko Groku daš več orodij in mu prepustiš izbiro tistih, ki služijo vprašanju.

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

To vprašanje zahteva dva zaporedna koraka: Grok najprej poizveduje po zbirki, da najde tvojo interno politiko, nato sproži spletno iskanje za trenutne evropske predpise in nazadnje v odgovoru primerja oba. Na tvoji strani ni orchestracije, ni stavka if za odločitev, kateri vir je relevanten – in če bi se vprašanje osredotočalo izključno na tvojo interno politiko, splet ne bi bil uporabljen.

Izpopolnitev vedenja orodij

Trije parametri ti omogočajo natančnejše določanje iskanja, deklariranega v tools.

tools=[
    {
        "type": "collections_search",
        "collection_ids": ["col_docs_1", "col_docs_2"],
        "max_results": 10,
        "retrieval_mode": "hybrid"
    }
]
  • collection_ids: sočasno poizvedovanje po več zbirkah
  • max_results: omejitev števila rezultatov za zmanjšanje vstavljenega konteksta
  • retrieval_mode: izbira načina iskanja (privzeto hibridno)

Parametru max_results nameni posebno pozornost: vsak vrnjeni izsek zavzame kontekst in stane žetone. Pri asistentu za podporo, kjer odgovori običajno ustrezajo dvema ali trem odlomkom, znižanje privzete vrednosti na pet rezultatov zmanjša stroške brez poslabšanja zaznane kakovosti.

Cene z dne 5. avgusta 2026 — cene se redno spreminjajo: pred izračunom katerega koli proračuna preveri trenutne cene na uradni strani modelov in cen xAI.

Ključne ugotovitve

  • collections_search omogoča Groku samodejno poizvedovanje po tvojih zbirkah med pogovorom
  • file_search / attachment_search se samodejno aktivira za posamezne datoteke
  • Zbirke so štirikrat cenejše in hitrejše od prilog datotek
  • collections_search lahko kombiniraš z web_search in drugimi orodji
  • Grok samodejno izbere, katera orodja uporabi, glede na vprašanje