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

Suiteil an SDK TypeScript de Mistral

Ceacht 8 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cén fáth an SDK TypeScript a úsáid?
  2. Réamhriachtanais
  3. Suiteáil
  4. Cumraíocht TypeScript
  5. Athróg Timpeallachta a Chumrú
  6. An Suiteáil a Fhíorú
  7. An Tionscadal a Eagrú
  8. Príomhphointí

Cúrsa nuashonraithe an 3 Samhain 2026 tar éis na samplaí a rith leis an SDK @mistralai/mistralai leagan 3.5.0 agus TypeScript 7.0.2. Níor thiomsaigh an leagan bunaidh. Nuair a ritheann tú npx tsc gan TypeScript suiteáilte, íoslódálann sé an pacáiste tsc npm atá tréigthe (leagan 2.0.4) in ionad an tiomsaitheora. Bhí an script tástála suite lasmuigh den fhillteán src a dearadh i tsconfig.json. Ní aithnítear an oibiacht process ach le @types/node. Ar deireadh, diúltaíonn an mód dian models.data.length agus model.id gan bailíochtú roimh ré. Leanann tsconfig.json anois an cás “tiomsaigh ansin rith le Node.js” ó threoir TypeScript, agus ní liostaítear a thuilleadh Node.js 18 agus 20, a shroich deireadh a saoil, mar leaganacha leordhóthanacha. Foinse: Íoslódáil TypeScript · Roghnaigh roghanna an tiomsaitheora (TypeScript) · Athruithe TypeScript 6.0 · tsx agus TypeScript · Rith-amaí tacaithe ag an SDK · Sceideal scaoileadh Node.js.

Cén fáth an SDK TypeScript a úsáid?

Má bhraitheann do stac ar Node.js, Deno, nó Bun, ligeann SDK TypeScript de Mistral duit samhlacha a chomhtháthú go díreach i d’fheidhmchláir JavaScript agus TypeScript. Seachnaíonn tú sraitheanna idirmheánacha Python nó glaonna HTTP saincheaptha a scríobh. Is é seo an cás is coitianta nuair a chuireann tú AI le feidhmchlár gréasáin atá ann cheana: API Express, backend Next.js, nó oibrí Node ag próiseáil ciú teachtaireachta.

Cuireann clóscríobh statach TypeScript líon sábháilteachta leis a íocann as féin laistigh den chéad uair an chloig d’fhorbairt. Críochnaíonn d’eagarthóir ainmneacha paraiméadair in ionad tú a chur faoi bhrú idir maxTokens agus max_tokens; spreagann earráidí cásaithe nó réimsí cumtha ag am an tiomsaithe, ní ag 3 a.m. sa táirgeadh; agus feictear doiciméadú paraiméadair ar chaitheamh súl gan an comhad a fhágáil. Tá an líon sábháilteachta seo níos tábhachtaí fós toisc gur oibiachtaí neadaithe iad freagraí API ina bhfuil sé furasta leibhéal a chailleadh.

Réamhriachtanais

Díríonn an SDK ar leaganacha LTS Node.js atá á gcothabháil. Ón 3 Samhain 2026, is iad seo leaganacha 22, 24, agus 26; ní fhaigheann Node.js 18 agus 20 paistí slándála a thuilleadh. Seiceáil do leagan le node --version sula dtéann tú ar aghaidh: braitheann an SDK ar mhodúil ES agus ar an API dúchasach fetch. Teastaíonn bainisteoir pacáistí (npm, yarn, nó pnpm) uait freisin, agus eochair API Mistral cruthaithe agus ar fáil mar athróg timpeallachta, mar a cumhdaíodh i gcúrsaí roimhe seo.

Suiteáil

Foilsítear an SDK oifigiúil ar npm mar @mistralai/mistralai:

# Le npm
npm install @mistralai/mistralai

# Le yarn
yarn add @mistralai/mistralai

# Le pnpm
pnpm add @mistralai/mistralai

Cumraíocht TypeScript

Má úsáideann tú TypeScript — rud a mholaimid — suiteáil trí uirlis mar spleáchais forbartha: an tiomsaitheoir, tsx (a ritheann comhaid .ts gan céim tógála), agus @types/node (a chuireann síos ar oibiachtaí Node.js cosúil le process do TypeScript):

npm install -D typescript tsx @types/node

Ná scipeáil an céim seo. Gan TypeScript suiteáilte sa tionscadal, faigheann npx tsc an pacáiste tsc ó npm — tiomsaitheoir oidhreachta tréigthe (2.0.4) — in ionad TypeScript. Ina dhiaidh sin, dearbh an tionscadal mar mhodúil ES, mar a éilíonn doiciméadú TypeScript do chód a thiomsaítear agus a ritheann ansin le Node.js:

npm pkg set type=module

Ar deireadh, cruthaigh tsconfig.json. Úsáideann sé na socruithe a mholann treoir oifigiúil TypeScript don chás seo (module: nodenext). Cumasaíonn sé mód dian freisin, a chiallaíonn go gcaithfidh tú luachanna a d’fhéadfadh a bheith in easnamh i bhfreagraí API a láimhseáil — srian sláintiúil — agus tiomsaíonn sé src/ go dist/:

{
  "compilerOptions": {
    "target": "esnext",
    "module": "nodenext",
    "types": ["node"],
    "strict": true,
    "skipLibCheck": true,
    "rootDir": "src",
    "outDir": "dist"
  },
  "include": ["src"]
}

Tá trí líne tuillte ag míniú, mar choscann gach ceann acu earráid a tháinig chun solais agus muid ag tástáil an chúrsa seo:

  • "types": ["node"]: Lódálann sé cineálacha Node.js. Ó TypeScript 6.0, ní lódáiltear pacáistí @types go huathoibríoch a thuilleadh. Gan an líne seo, spreagann process.env an earráid “Cannot find name ‘process’”, fiú le @types/node suiteáilte.
  • "rootDir": "src": Socraíonn sé fréamh foinse do chomhaid thiomsaithe: éiríonn src/test-mistral.ts ina dist/test-mistral.js. Gan é, tuairiscíonn TypeScript 7 earráid TS5011 nuair nach bhfuil do fhoinsí ag fréamh an tionscadail.
  • "skipLibCheck": true: Scipeálann sé seiceáil cineáil ar chomhaid dearbhaithe spleáchais. Is socruithe réamhshocraithe é seo i tsconfig.json a ghintear le npx tsc --init. Le SDK 3.5.0 agus TypeScript 7, má fhágann tú ar lár é, tarlaíonn earráid i ndearbhuithe an SDK féin nach féidir le do chód a shocrú.

Foilsítear an SDK mar mhodúil ES agus cuimsíonn sé a chineálacha féin: ní gá aon phacáiste @types/ dó. Mura bhfuil uathchríochnú ag d’eagarthóir, is i do tsconfig.json atá an fhadhb, ní i bpacáiste cineálacha in easnamh.

Athróg Timpeallachta a Chumrú

Ná crua-chódaigh an eochair API i do chód foinse. I Node.js, is é dotenv an réiteach caighdeánach, a lódálann athróga ó chomhad áitiúil ag tús an phróisis:

npm install dotenv

Cruthaigh comhad .env ag fréamh do thionscadail:

MISTRAL_API_KEY=your-api-key-here

Cuir an comhad seo le do .gitignore láithreach, sula ndéanann tú do chéad ghealltanas. Seo an t-am cruinn a sceiteann eochracha:

.env
.env.local

Caithfidh an t-allmhairiú dotenv/config teacht roimh aon léamh ar process.env. Murach sin, fanfaidh an athróg neamhshainithe nuair a chruthaíonn tú an cliant:

import 'dotenv/config';
import { Mistral } from '@mistralai/mistralai';

const client = new Mistral({
  apiKey: process.env.MISTRAL_API_KEY,
});

An Suiteáil a Fhíorú

Sula scríobhann tú loighic gnó, bailíochtaigh an slabhra iomlán — suiteáil, eochair, líonra — le script íosta. Cruthaigh src/test-mistral.ts agus iarr go simplí ar an liosta samhlacha atá inrochtana ag do chuntas:

import 'dotenv/config';
import { Mistral } from '@mistralai/mistralai';

async function main() {
  const client = new Mistral({
    apiKey: process.env.MISTRAL_API_KEY,
  });

  // Liostaigh na samhlacha atá ar fáil
  const models = await client.models.list();
  const liste = models.data ?? [];
  console.log(`Available models: ${liste.length}`);

  for (const model of liste.slice(0, 5)) {
    // Marcáiltear cineál samhail nach bhfuil ar eolas ag an leagan SDK seo mar 'UNKNOWN'
    if (model.type === 'UNKNOWN') continue;
    console.log(`  - ${model.id}`);
  }
}

main().catch(console.error);

Níl an dá sheiceáil seo maisiúil. Dearbhaíonn an SDK go bhfuil data roghnach, agus is cárta samhail bhunúsach, cárta samhail fine-tuned, nó luach anaithnid (type: 'UNKNOWN') gach iontráil sa liosta. Nuair a chuireann an API cineál samhail nua leis, coinníonn an SDK é sa fhoirm seo in ionad titim amach. Gan an dá thástáil seo, diúltaíonn an mód dian tiomsú.

I bhforbairt, rith é le tsx, a suiteáladh cheana, a thras-chumasaíonn ar an eitilt agus a shábhálann céim tógála duit:

npx tsx src/test-mistral.ts

Rabhadh: Ní sheiceálann tsx cineálacha; baintear iad agus déantar iad a fhorghníomhú. Ní thuairiscíonn tsc ach earráidí clóscríofa. Rith npx tsc --noEmit chun seiceáil gan tiomsú. Chun tiomsú agus ansin rith, mar a dhéanfaidh do phíblíne tógála:

npx tsc && node dist/test-mistral.js

Taispeánann eochair bailí líon na samhlacha agus na chéad chúig iontráil. Taispeánann eochair diúltaithe earráid Status 401 (Invalid API Key): oibríonn an slabhra, níl locht ach ar an eochair.

An Tionscadal a Eagrú

Nuair a éiríonn leis an bhfíorú, struchtúraigh an tionscadal ionas nach scaipeann an eochair agus an cliant ar fud comhad:

mon-projet/
├── src/
│   ├── index.ts          # Pointe iontrála
│   ├── mistral-client.ts # Túsú an chliaint (singilteán)
│   └── utils/
├── .env                  # Athróga timpeallachta (git-ignored)
├── .gitignore
├── package.json
└── tsconfig.json

Seachnaíonn lárnú túsaithe an chliaint i modúl tiomanta é a athchruthú i ngach comhad. Níos tábhachtaí fós, cúisíonn sé leis an bhfeidhmchlár teipthe ag am tosaithe seachas ag an gcéad ghla ó úsáideoir má tá an eochair in easnamh:

// src/mistral-client.ts
import { Mistral } from '@mistralai/mistralai';

if (!process.env.MISTRAL_API_KEY) {
  throw new Error('The MISTRAL_API_KEY variable is required.');
}

export const mistral = new Mistral({
  apiKey: process.env.MISTRAL_API_KEY,
});

Ní dhéanann an chuid eile den chód ach an cliant réamhdhéanta seo a allmhairiú:

// src/index.ts
import 'dotenv/config';
import { mistral } from './mistral-client.js';

Tabhair faoi deara an leathnú .js san allmhairiú coibhneasta. Le module: nodenext, éilíonn TypeScript an t-ainm comhaid mar a bheidh sé tar éis tiomsaithe, agus tá a fhios ag tsx é a mhapáil don chomhad .ts. Tá tábhacht le hord allmhairithe freisin: forghníomhaíonn dotenv/config roimh mistral-client.js, mar sin lódáiltear an eochair nuair a sheiceálann an modúl sin a láithreacht.

Príomhphointí

  • Suiteáil an SDK TypeScript le npm install @mistralai/mistralai
  • Is é an príomh-allmhairiú ná import { Mistral } from '@mistralai/mistralai'
  • Suiteáil typescript, tsx, agus @types/node mar spleáchais forbartha sula nglaoíonn tú ar npx tsc
  • Úsáid module: nodenext agus "type": "module" do chód a thiomsaítear agus a ritheann ansin le Node.js; glacann allmhairithe coibhneasta an leathnú .js
  • Úsáid comhad .env le dotenv chun an eochair API a bhainistiú
  • Soláthraíonn an SDK cineálacha dúchasacha TypeScript: bain leas as uathchríochnú, agus lig do tsc seiceáil a dhéanamh ar na rudaí a scipeálann tsx
  • Lárnigh túsú an chliaint i modúl tiomanta