collections_search un file_search atbildes API
Šajā lapā
Integrē meklēšanu tieši sarunās
Beigu punkts POST /v1/documents/search labi strādā ar atsevišķiem jautājumiem, taču tas uzliek tev visu orķestrēšanas darbu: vaicājuma formulēšanu, izrakstu izgūšanu, to ievietošanu uzvednē un modeļa izsaukšanu. Atbildes API šo slogu apgriež otrādi. Deklarējot savas kolekcijas kā rīku, tu ļauj Grok pašam izlemt, kad meklēt, ko tieši meklēt un kā to pārvērst atbildē. Tu pārej no cauruļvada, ko vadi pats, uz asistentu, kas pats meklē tavos dokumentos.
Rīks collections_search
Lai aktivizētu šo piekļuvi, tev tikai jāpievieno objekts sarakstam tools:
response = await client.responses.create(
model="grok-4.5",
input="Kāda ir mūsu tēva atvaļinājuma politika?",
tools=[
{
"type": "collections_search",
"collection_ids": ["col_rh_policies"]
}
]
)
Aiz šī viena izsaukuma Grok analizē jautājumu, formulē meklēšanas vaicājumu, kas pielāgots konkrētajai kolekcijai, izgūst attiecīgos fragmentus, tos apkopo un norāda izmantotos dokumentus. Praksē iepriekš minētajam jautājumam tas pārtulkos „tēva atvaļinājums” par meklēšanu kolekcijā col_rh_policies, atlasīs rindkopas no uzņēmuma līguma un atgriezīs dienu skaitu kopā ar avotu, tev nerakstot nevienu izgūšanas loģikas rindiņu.
Rīks file_search
Pastāv arī līdzinieks atsevišķiem failiem, kas nav saglabāti kolekcijā. To nav jādeklarē: tas aktivizējas automātiski, tiklīdz tava pieprasījuma datus satur input_file.
response = await client.responses.create(
model="grok-4.5",
input=[
{
"type": "input_file",
"file_id": "file_contrat_abc"
},
{
"type": "input_text",
"text": "Vai šajā līgumā ir konkurences aizlieguma klauzula?"
}
]
)
Fona režīmā aktivizējas rīks attachment_search, kas ir līdzvērtīgs file_search. Šī implicītā uzvedība izskaidro biežu neskaidrību: lietotāji brīnās, kāpēc file_search deklarēšana sadaļā tools, šķiet, neko nedara, lai gan tas vienkārši ir lieki.
Divi mehānismi, divas izmaksu struktūras
| Aspekts | collections_search | file_search / attachment_search |
|---|---|---|
| Avots | Indeksēta(-s) kolekcija(-s) | Atsevišķs(-i) fails(-i) |
| Deklarācija | Eksplicīta rīkos | Automātiska ar input_file |
| Indeksēšana | Iepriekš aprēķināta | Reāllaikā |
| Izmaksas | 2,50 USD / 1000 | 10 USD / 1000 |
| Veiktspēja | Ātra (esošais indekss) | Lēnāka (indeksēšana reāllaikā) |
| Lietojums | Pastāvīga zināšanu bāze | Vienreizēja analīze |
Rinda „Indeksēšana” nosaka visas pārējās. Kolekcija tiek indeksēta vienreiz un uz visiem laikiem, tāpēc katrs jautājums atkārtoti izmanto šo darbu: tas ir ātrs un tiek tarifēts ar 2,50 USD par tūkstoti izsaukumu. Pievienotais fails tiek indeksēts ar katru pieprasījumu, tādējādi rodas papildu latentums un maksa 10 USD par tūkstoti. Līgums, ko tavs juridiskais padomnieks analizē vienreiz, ietilpst otrajā kategorijā; HR repozitorijs, kuram jautā simts reizes dienā, acīmredzami ietilpst pirmajā.
Apvieno vairākus rīkus
Šīs pieejas patiesais ieguvums parādās, kad tu nodrošini Grok vairākus rīkus, ļaujot tam izvēlēties tos, kas vislabāk atbilst jautājumam.
response = await client.responses.create(
model="grok-4.5",
input="Salīdzini mūsu iekšējo politiku ar jaunākajiem Eiropas noteikumiem šajā jomā.",
tools=[
{
"type": "collections_search",
"collection_ids": ["col_politiques_internes"]
},
{
"type": "web_search"
}
]
)
Šis jautājums prasa divus secīgus soļus: Grok vispirms vaicā kolekciju, lai atrastu jūsu iekšējo politiku, pēc tam uzsāk tīmekļa meklēšanu, lai iegūtu aktuālos Eiropas noteikumus, un visbeidzot savā atbildē salīdzina abus. Nekāda orķestrēšana no tavas puses, nekāds if priekšraksts, lai izlemtu, kurš no abiem avotiem ir būtisks — un, ja jautājums būtu bijis vērsts tikai uz jūsu iekšējo politiku, tīmeklis netiktu izmantots.
Precizē rīka uzvedību
Trīs parametri ļauj precizēt rīkos deklarēto meklēšanu.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: vaicā vairākas kolekcijas vienlaicīgi
- max_results: ierobežo rezultātu skaitu, lai samazinātu ievadīto kontekstu
- retrieval_mode: izvēlies meklēšanas režīmu (pēc noklusējuma hibrīds)
Parametrs max_results ir pelnījis īpašu uzmanību: katrs atgrieztais izraksts aizņem kontekstu un maksā tokenus. Atbalsta asistentam, kur atbildes parasti ietilpst divās vai trīs rindkopās, samazināšana no noklusējuma vērtības līdz pieciem rezultātiem samazina izmaksas, nepasliktinot uztverto kvalitāti.
Cenas uz 2026. gada 5. augustu — cenas mainās regulāri: pirms jebkāda budžeta aprēķināšanas pārbaudi aktuālās cenas oficiālajā xAI modeļu un cenu lapā.
Galvenās atziņas
collections_searchļauj Grok sarunas laikā automātiski vaicāt tavas kolekcijasfile_search/attachment_searchaktivizējas automātiski atsevišķiem failiem- Kolekcijas ir četras reizes lētākas un ātrākas nekā failu pielikumi
- Tu vari apvienot
collections_searcharweb_searchun citiem rīkiem - Grok automātiski izvēlas, kurus rīkus izmantot, atkarībā no jautājuma