Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

collections_search és file_search a Responses API-ban

11. lecke 16 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. A keresés közvetlen integrálása a beszélgetésekbe
  2. A collections_search eszköz
  3. A file_search eszköz
  4. Két mechanizmus, két költségszerkezet
  5. Több eszköz kombinálása
  6. Az eszközök viselkedésének finomhangolása
  7. Főbb megállapítások

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

Szempontcollections_searchfile_search / attachment_search
ForrásIndexelt gyűjtemény(ek)Egyedi fájl(ok)
DeklarációKifejezett a tools-banAutomatikus az input_file-lal
IndexelésElőre kiszámítottValós időben
Költség2,50 $ / 100010 $ / 1000
TeljesítményGyors (meglévő index)Lassabb (valós idejű indexelés)
Használati esetÁllandó tudásbázisEgyszeri 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_search lehetővé teszi, hogy a Grok automatikusan lekérdezze a gyűjteményeidet beszélgetés közben
  • A file_search / attachment_search automatikusan 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 a web_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