Lähe põhisisu juurde
Eesti— Vali keel
Menüü

collections_search ja file_search vastuste API-s

Õppetund 11 / 16 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Integreeri otsing otse vestlustesse
  2. Tööriist collections_search
  3. Tööriist file_search
  4. Kaks mehhanismi, kaks kulustruktuuri
  5. Kombineeri mitut tööriista
  6. Täpsem tööriistade käitumine
  7. Peamised punktid

Integreeri otsing otse vestlustesse

Lõpp-punkt POST /v1/documents/search sobib hästi üksikutele küsimustele, kuid jätab kogu orkestratsiooni sinu hooleks: päringu formuleerimine, lõikude hankimine, nende sisestamine vihjesse ja mudeli kutsumine. Vastuste API pöörab selle koorma ümber. Määratledes oma kogud tööriistana, lased Grokil otsustada, millal otsida, mida täpselt otsida ja kuidas sellest vastus vormistada. Liigud torustikult, mida juhid ise, assistendi juurde, mis otsib sinu dokumente iseseisvalt.

Selle juurdepääsu lubamiseks piisab, kui lisad objekti loendisse 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"]
        }
    ]
)

Selle ühe väljakutse taga analüüsib Grok küsimust, formuleerib kogule kohandatud otsingupäringu, toob välja asjakohased lõigud, võtab need kokku ja tsiteerib kasutatud dokumente. Praktikas tõlgib see ülaltoodud küsimuse puhul „isapuhkuse“ otsinguks kogus col_rh_policies, säilitab ettevõtte kokkuleppe asjakohased lõigud ning tagastab päevade arvu koos allikaga, ilma et peaksid kirjutama ühtegi rida päringuloogikat.

Samaväärne lahendus on olemas üksikute failide jaoks, mida ei hoita kogus. Seda ei pea eraldi deklareerima: see aktiveerub automaatselt niipea, kui sinu päring sisaldab väärtust 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?"
        }
    ]
)

Taustal aktiveerub tööriist attachment_search, mis on samaväärne file_search-iga. See implitsiitne käitumine selgitab levinud segadust: kasutajad imestavad, miks file_search deklareerimine tools-is näib mõjutu olevat, kuigi tegelikult on see lihtsalt üleliigne.

Kaks mehhanismi, kaks kulustruktuuri

Aspektcollections_searchfile_search / attachment_search
AllikasIndekseeritud kogudÜksikud failid
DeklareerimineEksplitsiitne tööriistadesAutomaatne koos input_file-ga
IndekseerimineEelnevalt arvutatudReaalajas
Hind2,50 $ / 100010 $ / 1000
JõudlusKiire (olemasolev indeks)Aeglasem (reaalajas indekseerimine)
KasutusjuhtumPüsiv teadmiste baasÜhekordne analüüs

Rida „indekseerimine“ määrab kõik ülejäänud. Kogu indekseeritakse üks kord ja lõplikult, nii et iga küsimus kasutab seda tehtud tööd uuesti: see on kiire ja maksab 2,50 dollarit tuhande väljakutse kohta. Manustatud fail indekseeritakse iga päringuga eraldi, mistõttu tekib lisaviivitus ja hind on 10 dollarit tuhande kohta. Leping, mida sinu jurist analüüsib üks kord, kuulub teise kategooriasse; personaliosakonna hoidla, mida päritakse sadu kordi päevas, kuulub ilmselgelt esimesse.

Kombineeri mitut tööriista

Selle lähenemise tegelik eelis avaldub siis, kui annad Grokile mitu tööriista, lastes tal valida need, mis küsimusele vastamiseks sobivad.

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

See küsimus nõuab kahte järjestikust sammu: Grok pärib kõigepealt kogust, et leida teie sisepoliitika, seejärel käivitab veebiotsingu kehtivate Euroopa määruste kohta ja võrdleb seejärel neid kahte oma vastuses. Sinu poolt pole vaja mingit orkestratsiooni, ühtegi if-lause allika asjakohasuse otsustamiseks – ja kui küsimus oleks keskendunud ainult teie sisepoliitikale, ei oleks veebi kasutatud.

Täpsem tööriistade käitumine

Kolm parameetrit võimaldavad sul tools-is deklareeritud otsingut täpsustada.

tools=[
    {
        "type": "collections_search",
        "collection_ids": ["col_docs_1", "col_docs_2"],
        "max_results": 10,
        "retrieval_mode": "hybrid"
    }
]
  • collection_ids: päri mitmest kogust samaaegselt
  • max_results: piira tulemuste arvu, et vähendada sisestatavat konteksti
  • retrieval_mode: vali otsingurežiim (vaikimisi hübriidne)

max_results väärib erilist tähelepanu: iga tagastatud lõik võtab konteksti ruumi ja maksab tokeneid. Tugiassistendi puhul, kus vastused mahutuvad üldjuhul kahe või kolme lõigu sisse, vähendab vaikeväärtuselt viie tulemuseni langetamine kulusid, halvendamata tajutavat kvaliteeti.

Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve arvutamist kontrolli kehtivaid hindu xAI ametlikul mudelite ja hindade lehel.

Peamised punktid

  • collections_search võimaldab Grokil vestluse käigus automaatselt sinu kogudes päringuid teha
  • file_search / attachment_search aktiveerub üksikute failide puhul automaatselt
  • Kogud on neli korda odavamad ja kiiremad kui failimanused
  • Saad kombineerida collections_search-i web_search-i ja teiste tööriistadega
  • Grok valib automaatselt, milliseid tööriistu küsimuse põhjal kasutada