Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

An tairiseach cuardaigh doiciméad

Ceacht 9 as 16 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Do bhunachair eolais a chur faoi cheist
  2. Struchtúr an iarratais
  3. An freagra a léamh
  4. Cuardach a dhéanamh ar fud ilbhailiúchán
  5. Costas
  6. Príomhphointí

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.

POST
/v1/documents/search
3 mhód
eochairfhocal, seimeantach, hibrideach
$2.50
In aghaidh gach 1,000 glao
Il
Ilbhailiúchán

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/search ceist 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