Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

collections_search u file_search fl-API tar-Risposti

Lezzjoni 11 / 16 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Integra t-tiftix direttament fil-konversazzjonijiet
  2. L-għodda collections_search
  3. L-għodda file_search
  4. Żewġ mekkaniżmi, żewġ strutturi ta’ kost
  5. Ikkombina għodod multipli
  6. Irraffina l-imġiba tal-għodda
  7. Punti Ewlenin

Integra t-tiftix direttament fil-konversazzjonijiet

L-endpoint POST /v1/documents/search jaħdem tajjeb għal mistoqsijiet iżolati, iżda iħalli x-xogħol kollu tal-orkestrazzjoni f’idejk: ifformular il-mistoqsija, tirċievi estratti, tinjettahom f’prompt, u ssejjaħ il-mudell. L-API tar-Risposti taqlib din il-piża. Billi tiddikjara l-kollezzjonijiet tiegħek bħala għodda, tħalli lil Grok jiddeċiedi meta jfittex, x’ifittex, u kif ibiddel dan f’tweġiba. Inti timxi minn pipeline li tmexxi int għal assistent li jfittex id-dokumenti tiegħek stess.

Għandek biss bżonn iżżid oġġett fil-lista tools biex tippermetti dan l-aċċess:

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"]
        }
    ]
)

Wara din is-sejħa waħda, Grok janalizza l-mistoqsija, jifformula mistoqsija ta’ tiftix adattata għall-kollezzjoni, jirkupra passi rilevanti, jagħmlilhom sommarju, u jikkwota d-dokumenti użati. Fil-prattika, għall-mistoqsija ta’ hawn fuq, se jittraduċi “paternity leave” f’tiftix fi col_rh_policies, iżomm il-paragrafi mill-ftehim tal-kumpanija, u jirritorna numru ta’ jiem flimkien mas-sors tiegħu, mingħajr ma tikteb linja waħda ta’ loġika ta’ rkupru.

Il-kontroparti teżisti għal fajls individwali, dawk li mhumiex maħżuna f’kollezzjoni. M’hemmx bżonn tiddikjarah: jattiva awtomatikament non appena t-talba tiegħek fiha input_file.

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?"
        }
    ]
)

Hija l-għodda attachment_search, ekwivalenti għal file_search, li tattiva fl-isfond. Dan l-imġiba impliċita tispjega konfużjoni komuni: l-utenti jistaqsu għaliex id-dikjarazzjoni ta’ file_search f’tools tidher li m’għandha l-ebda effett, meta sempliċiment hija superflwa.

Żewġ mekkaniżmi, żewġ strutturi ta’ kost

Aspettcollections_searchfile_search / attachment_search
SorsKollezzjoni(jiet) indiċjatiFajl(s) individwali
DikjarazzjoniEspliċita f’toolsAwtomatika ma’ input_file
IndiċjarIkkalkulat minn qabelFuq it-titjira (On the fly)
Kost$2.50 / 1,000$10 / 1,000
PrestazzjoniMgħaġġla (indiċi eżistenti)Aktar bil-mod (indiċjar f’ħin reali)
Każ ta’ użuBażi tal-għarfien permanentiAnaliżi ta’ darba

Il-linja “Indiċjar” tmexxi lill-oħrajn kollha. Kollezzjoni tiġi indiċjata darba għal dejjem, allura kull mistoqsija terġa’ tuża dak ix-xogħol: hija mgħaġġla u fatturata b’$2.50 għal kull elf sejħa. Fajl mehmuż jiġi indiċjat ma’ kull talba, għalhekk il-latenza addizzjonali u l-$10 għal kull elf. Il-kuntratt li l-kunsillier legali tiegħek janalizza darba jaqa’ fit-tieni kategorija; ir-repożitorju tar-Riżorsi Umani mistoqsi mitt darba kuljum jaqa’ ovvjament fl-ewwel waħda.

Ikkombina għodod multipli

Il-benefiċċju reali ta’ dan l-approċċ jidher meta tagħti lil Grok diversi minnhom, u tħallih jagħżel dawk li jservu lill-mistoqsija.

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"
        }
    ]
)

Din il-mistoqsija teħtieġ żewġ mossa suċċessivi: Grok l-ewwel jistaqsi lill-kollezzjoni biex isib il-politika interna tiegħek, imbagħad jnedi tiftix fuq il-web għar-regolamenti Ewropej attwali, u mbagħad iqabbel iż-żewġ partijiet fir-risposta tiegħu. L-ebda orkestrazzjoni min-naħa tiegħek, l-ebda dikjarazzjoni if biex tiddeċiedi liema miż-żewġ sorsi hija rilevanti—u kieku l-mistoqsija kienet iffukata biss fuq il-politika interna tiegħek, il-web ma kienx jintuża.

Irraffina l-imġiba tal-għodda

Tliet parametri jħalluk issaħħaħ it-tiftix iddikjarat f’tools.

tools=[
    {
        "type": "collections_search",
        "collection_ids": ["col_docs_1", "col_docs_2"],
        "max_results": 10,
        "retrieval_mode": "hybrid"
    }
]
  • collection_ids: staqsi diversi kollezzjonijiet simultanjament
  • max_results: illimita n-numru ta’ riżultati biex tnaqqas il-kuntest injettat
  • retrieval_mode: agħżel il-modalità ta’ tiftix (ibridu b’mod default)

max_results jistħoqqilu attenzjoni speċjali: kull estratt irritornat jieħu spazju fil-kuntest u jiswa tokens. Fuq assistent ta’ appoġġ fejn it-tweġibiet ġeneralment joqogħdu fi ħdan żewġ jew tliet passi, li tonqos mill-valur default għal ħames riżultati tnaqqas l-ispejjeż mingħajr ma tiddeterjora l-kwalità pperċepita.

Prezzijiet sal-5 ta’ Awwissu 2026 — il-prezzijiet jinbidlu regolarment: qabel ma tikkalkula kwalunkwe baġit, iċċekkja l-prezzijiet attwali fuq il-paġna uffiċjali tal-mudelli u l-prezzijiet ta’ xAI.

Punti Ewlenin

  • collections_search jħalli lil Grok jistaqsi awtomatikament il-kollezzjonijiet tiegħek matul konversazzjoni
  • file_search / attachment_search jattiva awtomatikament għal fajls individwali
  • Il-kollezzjonijiet huma erba’ darbiet irħas u aktar mgħaġġla mill-fajls mehmuża
  • Tista’ tikkombina collections_search ma’ web_search u għodod oħra
  • Grok jagħżel awtomatikament liema għodod juża abbażi tal-mistoqsija