An tairiseach cuardaigh doiciméad
Ar an leathanach seo
Do bhunachair eolais a chur faoi cheist
Go dtí seo, tá an t-ardán tógtha agat: bailiúcháin, doiciméid innéacsaithe, meiteashonraí. Níl aon mhaith sa mhéid sin mura bhfuil a fhios agat conas ceist a chur. Is é sin post POST /v1/documents/search, a ghlacann fiosrúchán i ngnáththeanga agus a thugann ar ais na míreanna ó do dhoiciméid a fhreagraíonn é is fearr. Samhlaigh foireann tacaíochta a fhaigheann “Cén tréimhse tarraingthe siar atá ann?” In ionad gníomhaire a chur ag léamh téarmaí agus coinníollacha, seolann tú an cheist chuig an tairiseach agus faigheann tú na trí mhír úsáideacha, lena scór agus lena bhfoinse san áireamh.
Struchtúr an iarratais
Is é an chéad rud le cuimhneamh air, agus is minic a thagann earráidí as seo: tá an tairiseach seo ar an API caighdeánach (api.x.ai), ní ar an API Bainistíochta a d’úsáid tú chun bailiúcháin a chruthú. Déanann tú fíordheimhniú le do eochair API gnáth. Tagann an t-iarratas íosta anuas go dtí trí réimse.
curl -X POST https://api.x.ai/v1/documents/search \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "How do I configure OAuth authentication?",
"source": {
"collection_ids": ["col_xyz789"]
},
"retrieval_mode": {
"type": "hybrid"
}
}'
Príomhpharaiméadair
- query: do cheist i ngnáththeanga. Dá sonraí an cheist, is amhlaidh is ábhartha na torthaí
- source.collection_ids: eagar d’aitheantais bhailiúcháin le cur faoi cheist. Is féidir leat cuardach a dhéanamh ar fud ilbhailiúchán in aon iarratas amháin
- retrieval_mode.type: an mód cuardaigh le húsáid (
keyword,semantic, nóhybrid)
An freagra a léamh
Ní thugann an API doiciméid iomlána ar ais ach blúirí, na smután a cruthaíodh le linn innéacsaithe, rangaithe ón ceann is ábhartha go dtí an ceann is lú ábharthachta.
{
"results": [
{
"content": "To configure OAuth, start by...",
"score": 0.92,
"document_id": "file_abc123",
"metadata": {
"filename": "security-guide.pdf",
"page": 12
}
},
{
"content": "The OAuth 2.0 flow uses...",
"score": 0.87,
"document_id": "file_def456",
"metadata": {
"filename": "api-reference.pdf",
"page": 45
}
}
]
}
Iompraíonn gach iontráil ceithre píosa eolais:
- content: an blúire téacs ón doiciméad
- score: scór ábharthachta idir 0 agus 1
- document_id: aitheantas an chomhaid fhoinsí
- metadata: meiteashonraí an doiciméid (ainm, leathanach, réimsí saincheaptha)
San sampla thuas, tagann an chéad blúire ó leathanach 12 de security-guide.pdf le scór 0.92, agus an dara ceann ó leathanach 45 de chomhad eile ag 0.87. Tá an dá luach sin leordhóthanach chun comhéadan a thógáil a thaispeánann an freagra agus, díreach faoi, nasc “féach ar an mbun-mhír, leathanach 12”. Feidhmíonn an scór mar tairseach: diúltaíonn go leor foirne aon toradh faoi 0.5 seachas ligean don mhúnla réasúnú a dhéanamh ar thorann.
Cuardach a dhéanamh ar fud ilbhailiúchán
Má is eagar é collection_ids, ní heachtra é sin. Go minic, meascann ceist chustaiméara roinnt domhan doiciméad, agus ní mhaith leat trí ghlao a dhéanamh agus na torthaí a chumasc de láimh.
{
"query": "Refund policy",
"source": {
"collection_ids": [
"col_docs_produit",
"col_faq",
"col_conditions_generales"
]
},
"retrieval_mode": {
"type": "hybrid"
}
}
Anseo, déantar doiciméadú táirge, an FAQ, agus téarmaí agus coinníollacha a chur faoi cheist le chéile. Tagann na torthaí ar ais cumaiscthe agus sórtáilte de réir scóir, beag beann ar an mbailiúchán bunaidh: beidh blúire FAQ ag 0.94 rangaithe os cionn blúire T&C ag 0.71. Trasnaíonn tú foinseí ilchineálacha i dtimthriall líonra amháin.
Costas
Costaíonn cuardach ar bhailiúcháin $2.50 in aghaidh gach 1,000 glao, agus ní athraíonn an ráta seo bunaithe ar líon na mbailiúchán a chuirtear faoi cheist ná ar mhéid na ndoiciméad innéacsaithe. Déan comparáid idir é seo agus ceangaltáin chomhad, na comhaid aonair sin a sheachadtar trí input_file, a bhilleáiltear ag $10 in aghaidh gach 1,000 glao: chomh luath agus a chuireann tú na doiciméid chéanna faoi cheist arís agus arís eile, costaíonn bailiúcháin ceithre huaire níos lú. Íocann cúntóir inmheánach a láimhseálann 20,000 ceist in aghaidh na míosa $50 le bailiúcháin i gcomparáid le $200 le ceangaltáin—agus faigheann sé torthaí níos tapúla chomh maith, ós rud é go bhfuil an t-innéacs ann cheana féin.
Praghsáil ón 5 Lúnasa 2026 — athraíonn praghsanna go rialta: sula ndéanann tú aon ríomh buiséid, seiceáil an cárta rátaí reatha ar leathanach oifigiúil samhlacha agus praghsanna xAI.
Príomhphointí
- Déanann an tairiseach
POST /v1/documents/searchceist ar do bhailiúcháin i ngnáththeanga - Trí mhód cuardaigh ar fáil: eochairfhocal, seimeantach, hibrideach
- Is féidir leat cuardach a dhéanamh ar fud ilbhailiúchán go comhuaineach
- Déantar torthaí a rangú de réir scóir ábharthachta le hábhar foinse
- Is é an costas $2.50 in aghaidh gach 1,000 glao, ceithre huaire níos saoire ná ceangaltáin chomhad