collections_search ir file_search atsakymų API
Šiame puslapyje
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.
Įrankis collections_search
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.
Įrankis file_search
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
| Aspektas | collections_search | file_search / attachment_search |
|---|---|---|
| Šaltinis | Indeksuota (-os) kolekcija (-os) | Atskiras (-i) failas (-ai) |
| Deklaravimas | Aiškus įrankiuose | Automatinis su input_file |
| Indeksavimas | Iš anksto apskaičiuotas | Vykdymo metu |
| Kaina | 2,50 $ / 1 000 | 10 $ / 1 000 |
| Našumas | Greitas (esamas indeksas) | Lėtesnis (indeksavimas realiuoju laiku) |
| Naudojimo atvejis | Nuolatinė ž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_searchleidžia Grok automatiškai užklausti jūsų kolekcijas pokalbio metufile_search/attachment_searchautomatiškai suaktyvėja atskiriems failams- Kolekcijos yra keturis kartus pigesnės ir greitesnės nei failų priedai
- Galite derinti
collections_searchsuweb_searchir kitais įrankiais - Grok automatiškai pasirenka, kuriuos įrankius naudoti, priklausomai nuo klausimo