collections_search og file_search i Responses API
På denne side
Integrér søgning direkte i samtaler
Endpointet POST /v1/documents/search fungerer fint til isolerede spørgsmål, men det overlader alt orchestreringsarbejdet til dig: at formulere forespørgslen, hente uddrag, injicere dem i et prompt og kalde modellen. Responses API vender denne byrde på hovedet. Ved at erklære dine samlinger som et værktøj, lader du Grok beslutte, hvornår der skal søges, hvad der skal kigges efter, og hvordan det omsættes til et svar. Du skifter fra en pipeline, du styrer, til en assistent, der selv søger i dine dokumenter.
Værktøjet collections_search
Du behøver blot at tilføje et objekt til listen tools for at aktivere denne adgang:
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"]
}
]
)
Bag dette ene kald analyserer Grok spørgsmålet, formulerer en søgeforespørgsel skræddersyet til samlingen, henter relevante passager, opsummerer dem og citerer de anvendte dokumenter. I praksis vil det for spørgsmålet ovenfor oversætte „barselsorlov for fædre” til en søgning i col_rh_policies, beholde afsnittene fra virksomhedsoverenskomsten og returnere et antal dage sammen med kilden, uden at du skriver en eneste linje hentelogik.
Værktøjet file_search
Modstykket findes til individuelle filer, der ikke er gemt i en samling. Du behøver ikke at erklære det: det aktiveres automatisk, så snart din anmodning indeholder en 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?"
}
]
)
Det er værktøjet attachment_search, som svarer til file_search, der aktiveres i baggrunden. Denne implicitte adfærd forklarer en almindelig forvirring: brugere undrer sig over, hvorfor det ser ud til, at det ikke har nogen effekt at erklære file_search i tools, når det blot er overflødigt.
To mekanismer, to omkostningsstrukturer
| Aspekt | collections_search | file_search / attachment_search |
|---|---|---|
| Kilde | Indeksede samlinger | Individuelle filer |
| Erklæring | Eksplicit i tools | Automatisk med input_file |
| Indeksering | Forudberegnede | I realtid |
| Omkostning | $2,50 / 1.000 | $10 / 1.000 |
| Ydeevne | Hurtig (eksisterende indeks) | Langsommere (indeksering i realtid) |
| Brugssag | Permanent vidensbase | Engangsanalyse |
Linjen „Indeksering” driver alle de andre. En samling indekseres én gang for alle, så hvert spørgsmål genbruger dette arbejde: det er hurtigt og faktureres til $2,50 per tusind kald. En vedhæftet fil indekseres med hver anmodning, hvilket forklarer den ekstra ventetid og prisen på $10 per tusind. Kontrakten, som din juridiske rådgiver analyserer én gang, falder ind under den anden kategori; HR-arkivet, der forespørges hundrede gange om dagen, hører tydeligvis til i den første.
Kombinér flere værktøjer
Den virkelige fordel ved denne tilgang viser sig, når du giver Grok flere af dem og lader det vælge dem, der tjener spørgsmålet bedst.
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"
}
]
)
Dette spørgsmål kræver to successive træk: Grok spørger først samlingen for at finde din interne politik, lancerer derefter en websøgning efter gældende europæiske regler og holder til sidst de to op mod hinanden i sit svar. Ingen orchestrering fra din side, ingen if-sætning til at afgøre, hvilken af de to kilder der er relevant – og hvis spørgsmålet udelukkende havde fokuseret på din interne politik, ville nettet ikke være blevet brugt.
Forfin værktøjets adfærd
Tre parametre giver dig mulighed for at stramme søgningen, der er erklæret i tools.
tools=[
{
"type": "collections_search",
"collection_ids": ["col_docs_1", "col_docs_2"],
"max_results": 10,
"retrieval_mode": "hybrid"
}
]
- collection_ids: forespørg flere samlinger samtidigt
- max_results: begræns antallet af resultater for at reducere den injicerede kontekst
- retrieval_mode: vælg søgetilstand (hybrid som standard)
max_results fortjener særlig opmærksomhed: hvert uddrag, der returneres, optager kontekst og koster tokens. På en supportassistent, hvor svar generelt passer inden for to eller tre passager, reducerer et fald fra standardværdien til fem resultater omkostningerne uden at forringe den oplevede kvalitet.
Priser pr. 5. august 2026 – priserne ændres regelmæssigt: før du beregner et budget, skal du tjekke de aktuelle priser på den officielle side for xAI-modeller og priser.
Vigtige pointer
collections_searchlader Grok automatisk forespørge dine samlinger under en samtalefile_search/attachment_searchaktiveres automatisk for individuelle filer- Samlinger er fire gange billigere og hurtigere end filvedhæftninger
- Du kan kombinere collections_search med web_search og andre værktøjer
- Grok vælger automatisk, hvilke værktøjer der skal bruges, baseret på spørgsmålet