collections_search ja file_search vastuste API-s
Sellel lehel
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.
Tööriist collections_search
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.
Tööriist file_search
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
| Aspekt | collections_search | file_search / attachment_search |
|---|---|---|
| Allikas | Indekseeritud kogud | Üksikud failid |
| Deklareerimine | Eksplitsiitne tööriistades | Automaatne koos input_file-ga |
| Indekseerimine | Eelnevalt arvutatud | Reaalajas |
| Hind | 2,50 $ / 1000 | 10 $ / 1000 |
| Jõudlus | Kiire (olemasolev indeks) | Aeglasem (reaalajas indekseerimine) |
| Kasutusjuhtum | Pü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_searchvõimaldab Grokil vestluse käigus automaatselt sinu kogudes päringuid tehafile_search/attachment_searchaktiveerub üksikute failide puhul automaatselt- Kogud on neli korda odavamad ja kiiremad kui failimanused
- Saad kombineerida
collections_search-iweb_search-i ja teiste tööriistadega - Grok valib automaatselt, milliseid tööriistu küsimuse põhjal kasutada