Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

collections_search un file_search atbildes API

Nodarbība 11 no 16 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Integrē meklēšanu tieši sarunās
  2. Rīks collections_search
  3. Rīks file_search
  4. Divi mehānismi, divas izmaksu struktūras
  5. Apvieno vairākus rīkus
  6. Precizē rīka uzvedību
  7. Galvenās atziņas

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.

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.

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

Aspektscollections_searchfile_search / attachment_search
AvotsIndeksēta(-s) kolekcija(-s)Atsevišķs(-i) fails(-i)
DeklarācijaEksplicīta rīkosAutomātiska ar input_file
IndeksēšanaIepriekš aprēķinātaReāllaikā
Izmaksas2,50 USD / 100010 USD / 1000
VeiktspējaĀtra (esošais indekss)Lēnāka (indeksēšana reāllaikā)
LietojumsPastāvīga zināšanu bāzeVienreizē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 kolekcijas
  • file_search / attachment_search aktivizējas automātiski atsevišķiem failiem
  • Kolekcijas ir četras reizes lētākas un ātrākas nekā failu pielikumi
  • Tu vari apvienot collections_search ar web_search un citiem rīkiem
  • Grok automātiski izvēlas, kurus rīkus izmantot, atkarībā no jautājuma