collections_search és file_search a Responses API-ban
Ezen az oldalon
A keresés közvetlen integrálása a beszélgetésekbe
A POST /v1/documents/search végpont jól működik elszigetelt kérdések esetén, de minden szervezési feladatot rád hagy: a lekérdezés megfogalmazását, a részletek kinyerését, azok promptba való beillesztését és a modell meghívását. A Responses API megfordítja ezt a terhet. Ha eszközként deklarálod a gyűjteményeidet, engeded, hogy a Grok eldöntse, mikor keressen, mit keressen, és hogyan alakítsa át azt válasszá. Így egy általad vezérelt folyamatból olyan asszisztenssé lépsz elő, amely maga keres a dokumentumaidban.
A collections_search eszköz
Csak egy objektumot kell hozzáadnod a tools listához, hogy engedélyezd ezt a hozzáférést:
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"]
}
]
)
Egyetlen hívás mögött a Grok elemzi a kérdést, a gyűjteményre szabott keresési lekérdezést fogalmaz meg, lekéri a releváns szakaszokat, összefoglalja őket, és hivatkozik a felhasznált dokumentumokra. A gyakorlatban a fenti kérdésre válaszul a „paternity leave“ (apaszabadság) kifejezést kereséssé alakítja a col_rh_policies gyűjteményben, megtartja a vállalati megállapodás megfelelő bekezdéseit, és visszaadja a napok számát a forrásmegjelöléssel együtt, anélkül, hogy egyetlen sor kinyerési logikát is írnál.
A file_search eszköz
A megfelelője létezik az egyes fájlokhoz is, amelyek nincsenek gyűjteményben tárolva. Nem kell deklarálnod: automatikusan aktiválódik, amint a kérésed tartalmaz egy input_file elemet.
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?"
}
]
)
Valójában az attachment_search eszköz, amely a file_search megfelelője, aktiválódik a háttérben. Ez az implicit viselkedés magyarázza a gyakori zavart: a felhasználók csodálkoznak, miért nincs hatása a file_search deklarációjának a tools listában, holott ez egyszerűen felesleges.
Két mechanizmus, két költségszerkezet
| Szempont | collections_search | file_search / attachment_search |
|---|---|---|
| Forrás | Indexelt gyűjtemény(ek) | Egyedi fájl(ok) |
| Deklaráció | Kifejezett a tools-ban | Automatikus az input_file-lal |
| Indexelés | Előre kiszámított | Valós időben |
| Költség | 2,50 $ / 1000 | 10 $ / 1000 |
| Teljesítmény | Gyors (meglévő index) | Lassabb (valós idejű indexelés) |
| Használati eset | Állandó tudásbázis | Egyszeri elemzés |
Az „indexelés“ sor mindent meghatároz. Egy gyűjteményt egyszer és mindenkorra indexelnek, így minden kérdés újrahasznosítja ezt a munkát: gyors, és ezer hívásonként 2,50 dollárba kerül. Egy csatolt fájlt minden kéréssel együtt indexelnek, innen ered a plusz késleltetés és az ezerenkénti 10 dolláros költség. Az a szerződés, amelyet jogi tanácsadód egyszer elemez, a második kategóriába esik; a HR-tár, amelyet naponta százszor kérdeznek le, nyilvánvalóan az elsőbe.
Több eszköz kombinálása
Ennek a megközelítésnek az igazi előnye akkor mutatkozik meg, ha több ilyen eszközt adsz a Grok kezébe, hadd válassza ki azt, amelyik a kérdéshez illik.
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"
}
]
)
Ez a kérdés két egymást követő lépést igényel: a Grok először lekérdezi a gyűjteményt, hogy megtalálja a belső szabályzatot, majd webes keresést indít a hatályos európai szabályozásért, végül összehasonlítja a kettőt a válaszában. Nincs szükség szervezésre a részedről, nincs if utasítás annak eldöntésére, melyik forrás releváns – és ha a kérdés kizárólag a belső szabályzatra fókuszált volna, a webet nem használta volna.
Az eszközök viselkedésének finomhangolása
Három paraméterrel szigoríthatod a tools-ban deklarált keresést.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: több gyűjtemény egyidejű lekérdezése
- max_results: az eredmények számának korlátozása a beillesztett kontextus csökkentése érdekében
- retrieval_mode: a keresési mód kiválasztása (alapértelmezett a hibrid)
A max_results különös figyelmet érdemel: minden visszaadott részlet helyet foglal a kontextusban, és tokenekbe kerül. Egy ügyfélszolgálati asszisztensnél, ahol a válaszok általában két-három szakaszba férnek bele, ha az alapértelmezett értékről ötre csökkented az eredmények számát, csökkented a költséget anélkül, hogy rontanád az érzékelt minőséget.
Árak 2026. augusztus 5-i állapot szerint – az árak rendszeresen változnak: mielőtt bármilyen költségvetést számolnál, ellenőrizd az aktuális árakat a hivatalos xAI modellek és árazási oldalán.
Főbb megállapítások
- A
collections_searchlehetővé teszi, hogy a Grok automatikusan lekérdezze a gyűjteményeidet beszélgetés közben - A
file_search/attachment_searchautomatikusan aktiválódik az egyedi fájlok esetén - A gyűjtemények négyszer olcsóbbak és gyorsabbak, mint a fájlok csatolása
- Kombinálhatod a
collections_search-t aweb_search-sel és egyéb eszközökkel - A Grok automatikusan kiválasztja, mely eszközöket használja a kérdés alapján