Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

collections_search ir file_search atsakymų API

Paskaita 11 iš 16 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Integruok paiešką tiesiai į pokalbius
  2. Įrankis collections_search
  3. Įrankis file_search
  4. Du mechanizmai, dvi kainodaros struktūros
  5. Derinkite kelis įrankius
  6. Tikslinkite įrankių elgseną
  7. Svarbiausi punktai

Integruok paiešką tiesiai į pokalbius

POST /v1/documents/search galinis punktas puikiai tinka atskiriems klausimams, tačiau visą orkestraciją palieka tau: suformuluoti užklausą, gauti ištraukas, įterpti jas į promptą ir iškviesti modelį. Atsakymų API (Responses API) šią naštą apverčia. Paskelbus savo kolekcijas kaip įrankį, leidži Grok nuspręsti, kada ieškoti, ko ieškoti ir kaip tai paversti atsakymu. Tu pereini nuo tavo valdomo konvejerio prie asistento, kuris pats ieško tavo dokumentuose.

Norėdami suteikti šią prieigą, tiesiog pridėkite objektą į tools sąrašą:

response = await client.responses.create(
    model="grok-4.5",
    input="Kokia mūsų tėvystės atostogų politika?",
    tools=[
        {
            "type": "collections_search",
            "collection_ids": ["col_rh_policies"]
        }
    ]
)

Už šio vieno kvietimo slypi tai, kad Grok analizuoja klausimą, suformuluoja kolekcijai pritaikytą paieškos užklausą, gauna atitinkamas pastraipas, jas apibendrina ir cituoja naudotus dokumentus. Praktiškai, atsakant į aukščiau pateiktą klausimą, jis išvers „tėvystės atostogas“ į paiešką col_rh_policies, atrinks pastraipas iš įmonės susitarimo ir grąžins dienų skaičių kartu su šaltiniu, tau nerašant nei eilutės gavimo logikos.

Atitikmuo egzistuoja ir atskiriems failams, kurie nėra saugomi kolekcijoje. Jo deklaruoti nereikia: jis suaktyvėja automatiškai, kai tik jūsų užklausoje yra input_file.

response = await client.responses.create(
    model="grok-4.5",
    input=[
        {
            "type": "input_file",
            "file_id": "file_contrat_abc"
        },
        {
            "type": "input_text",
            "text": "Ar šioje sutartyje yra konkurencijos draudimo sąlyga?"
        }
    ]
)

Fone suaktyvėja attachment_search įrankis, kuris yra ekvivalentus file_search. Šis numatytasis elgesys paaiškina dažną painiavą: vartotojai stebisi, kodėl file_search deklaravimas tools atrodo neturintis jokio poveikio, nors tai tiesiog nereikalinga.

Du mechanizmai, dvi kainodaros struktūros

Aspektascollections_searchfile_search / attachment_search
ŠaltinisIndeksuota (-os) kolekcija (-os)Atskiras (-i) failas (-ai)
DeklaravimasAiškus įrankiuoseAutomatinis su input_file
IndeksavimasIš anksto apskaičiuotasVykdymo metu
Kaina2,50 $ / 1 00010 $ / 1 000
NašumasGreitas (esamas indeksas)Lėtesnis (indeksavimas realiuoju laiku)
Naudojimo atvejisNuolatinė žinių bazėVienkartinė analizė

Eilutė „Indeksavimas“ lemia visas kitas. Kolekcija indeksuojama vieną kartą ir visiems laikams, todėl kiekvienas klausimas naudoja tą patį darbą: tai greita ir kainuoja 2,50 $ už tūkstantį kvietimų. Pridėtas failas indeksuojamas su kiekviena užklausa, todėl atsiranda papildoma delsos trukmė ir kaina – 10 $ už tūkstantį. Sutartis, kurią jūsų teisininkas analizuoja vieną kartą, patenka į antrąją kategoriją; HR saugykla, kurią užklausiama šimtą kartų per dieną, akivaizdžiai priklauso pirmajai.

Derinkite kelis įrankius

Tikroji šio požiūrio nauda atsiskleidžia tada, kai suteikiate Grok kelis iš jų, leisdami jam pasirinkti tuos, kurie geriausiai tinka klausimui.

response = await client.responses.create(
    model="grok-4.5",
    input="Palyginkite mūsų vidinę politiką su naujausiais Europos reglamentais šiuo klausimu.",
    tools=[
        {
            "type": "collections_search",
            "collection_ids": ["col_politiques_internes"]
        },
        {
            "type": "web_search"
        }
    ]
)

Šis klausimas reikalauja dviejų nuoseklių veiksmų: Grok pirmiausia užklausia kolekciją, kad rastų jūsų vidinę politiką, tada paleidžia žiniatinklio paiešką, kad surastų dabartinius Europos reglamentus, ir galiausiai savo atsakyme juos palygina. Jokių orkestracijos veiksmų iš jūsų pusės, jokių if sakinių sprendžiant, kuris iš dviejų šaltinių yra aktualus – ir jei klausimas būtų buvęs sutelktas tik į jūsų vidinę politiką, žiniatinklis nebūtų naudojamas.

Tikslinkite įrankių elgseną

Trys parametrai leidžia sugriežtinti paiešką, deklaruotą tools.

tools=[
    {
        "type": "collections_search",
        "collection_ids": ["col_docs_1", "col_docs_2"],
        "max_results": 10,
        "retrieval_mode": "hybrid"
    }
]
  • collection_ids: vienu metu užklauskite kelias kolekcijas
  • max_results: apribokite rezultatų skaičių, kad sumažintumėte įterptą kontekstą
  • retrieval_mode: pasirinkite paieškos režimą (pagal nutylėjimą – hibridinis)

max_results nusipelno ypatingo dėmesio: kiekviena grąžinta ištrauka užima kontekstą ir kainuoja tokenus. Pagalbos asistentui, kurio atsakymai paprastai telpa į dvi ar tris pastraipas, sumažinus reikšmę nuo numatytosios iki penkių rezultatų, sumažinamos išlaidos nesumenkinant suvokiamos kokybės.

Kainodara nuo 2026 m. rugpjūčio 5 d. – kainos keičiasi reguliariai: prieš skaičiuodami bet kokį biudžetą, patikrinkite dabartines kainas oficialiame xAI modelių ir kainodaros puslapyje.

Svarbiausi punktai

  • collections_search leidžia Grok automatiškai užklausti jūsų kolekcijas pokalbio metu
  • file_search / attachment_search automatiškai suaktyvėja atskiriems failams
  • Kolekcijos yra keturis kartus pigesnės ir greitesnės nei failų priedai
  • Galite derinti collections_search su web_search ir kitais įrankiais
  • Grok automatiškai pasirenka, kuriuos įrankius naudoti, priklausomai nuo klausimo