Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Instalē Mistral TypeScript SDK

Nodarbība 8 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Kāpēc izmantot TypeScript SDK?
  2. Priekšnosacījumi
  3. Instalācija
  4. TypeScript konfigurācija
  5. Vides mainīgā konfigurēšana
  6. Instalācijas pārbaude
  7. Projekta organizēšana
  8. Galvenās atziņas

Nodarbība atjaunināta 2026. gada 3. novembrī, pēc piemēru izpildes ar @mistralai/mistralai SDK 3.5.0 un TypeScript 7.0.2. Sākotnējā versija nekompilējās. Komandas npx tsc izpilde bez instalēta TypeScript lejupielādē pamesto tsc npm pakotni (versija 2.0.4) kompilatora vietā. Testa skripts atradās ārpus src mapes, kas deklarēta failā tsconfig.json. Objekts process tiek atpazīts tikai ar @types/node. Visbeidzot, stingrais režīms noraida models.data.length un model.id bez iepriekšējas validācijas. Failā tsconfig.json tagad ir ievēroti TypeScript rokasgrāmatas ieteikumi scenārijam „kompilē, tad palaid ar Node.js”, un Node.js 18 un 20, kuriem ir beidzies atbalsta laiks, vairs nav norādīti kā pietiekami. Avoti: Lejupielādēt TypeScript · Kompilatora opciju izvēle (TypeScript) · TypeScript 6.0 izmaiņas · tsx un TypeScript · SDK atbalstītās izpildvides · Node.js izlaižu grafiks.

Kāpēc izmantot TypeScript SDK?

Ja tava stack balstās uz Node.js, Deno vai Bun, Mistral TypeScript SDK ļauj integrēt modeļus tieši tavās JavaScript un TypeScript lietotnēs. Tu izvairies no starpposma Python slāņiem vai pielāgotu HTTP pieprasījumu rakstīšanas. Tas ir visizplatītākais scenārijs, pievienojot AI esošai tīmekļa lietotnei: Express API, Next.js backend vai Node darbinieks, kas apstrādā ziņojumu rindu.

TypeScript statiskā tipizēšana nodrošina drošības tīklu, kas atmaksājas jau pirmajā izstrādes stundā. Tavs redaktors pabeidz parametru nosaukumus, liekot tev neuzminēt starp maxTokens un max_tokens; kļūdas lielo un mazo burtu lietojumā vai izgudroti lauki tiek atklāti kompilācijas laikā, nevis ražošanā pulksten 3 naktī; un parametru dokumentācija parādās, uzvedot kursoru, neatstājot failu. Šis drošības tīkls ir vēl svarīgāks, jo API atbildes ir ligzdoti objekti, kuros ir viegli palaist garām kādu līmeni.

Priekšnosacījumi

SDK ir paredzēts uzturētām Node.js LTS versijām. Sākot ar 2026. gada 3. novembri, tās ir versijas 22, 24 un 26; Node.js 18 un 20 vairs nesaņem drošības labojumus. Pirms turpināšanas pārbaudi savu versiju ar node --version: SDK paļaujas uz ES moduļiem un natīvo fetch API. Tev ir nepieciešams arī pakotņu menedžeris (npm, yarn vai pnpm) un Mistral API atslēga, kas izveidota un pieejama kā vides mainīgais, kā aplūkots iepriekšējās nodarbībās.

Instalācija

Oficiālais SDK ir publicēts npm kā @mistralai/mistralai:

# Ar npm
npm install @mistralai/mistralai

# Ar yarn
yarn add @mistralai/mistralai

# Ar pnpm
pnpm add @mistralai/mistralai

TypeScript konfigurācija

Ja izmanto TypeScript — ko mēs iesakām — instalē trīs rīkus kā izstrādes atkarības: kompilatoru, tsx (kas palaiž .ts failus bez būvēšanas solia) un @types/node (kas apraksta Node.js objektus, piemēram, process, priekš TypeScript):

npm install -D typescript tsx @types/node

Neizlaid šo soli. Bez projektā instalēta TypeScript, npx tsc iegūst pakotni tsc no npm — pameotu veco kompilatoru (2.0.4) — TypeScript vietā. Tālāk deklarē projektu kā ES moduļus, kā to pieprasa TypeScript dokumentācija kodam, kas tiek kompilēts un pēc tam palaists ar Node.js:

npm pkg set type=module

Visbeidzot, izveido tsconfig.json. Tas izmanto iestatījumus, ko oficiālā TypeScript rokasgrāmata iesaka šim scenārijam (module: nodenext). Tas arī aktivizē stingro režīmu, kas liek tev apstrādāt potenciāli trūkstošas vērtības API atbildēs — veselīgs ierobežojums — un kompilē src/ uz dist/:

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

Trīs rindas ir pelnījušas skaidrojumu, jo katra novērš kļūdu, ar ko saskārāmies, testējot šo nodarbību:

  • "types": ["node"] ielādē Node.js tipus. Kopš TypeScript 6.0, @types pakotnes vairs netiek ielādētas automātiski. Bez šīs rindas process.env izraisīs kļūdu „Cannot find name ‘process’”, pat ja ir instalēts @types/node.
  • "rootDir": "src" iestata avota sakni kompilētajiem failiem: src/test-mistral.ts kļūst par dist/test-mistral.js. Bez tā TypeScript 7 ziņo par kļūdu TS5011, kad tavi avoti neatrodas projekta saknē.
  • "skipLibCheck": true izlaiž atkarību deklarāciju failu tipu pārbaudi. Tas ir arī noklusējuma iestatījums tsconfig.json, ko ģenerē npx tsc --init. Ar SDK 3.5.0 un TypeScript 7 šīs rindas izlaišana izraisa kļūdu paša SDK deklarācijās, ko tavs kods nevar labot.

SDK ir publicēts kā ES moduļi un satur savus tipus: tam nav nepieciešama nekāda @types/ pakotne. Ja tavam redaktoram trūkst automātiskās pabeigšanas, problēma slēpjas tavā tsconfig.json, nevis trūkstošā tipu pakotnē.

Vides mainīgā konfigurēšana

Nekad neiekodē API atslēgu tieši savā pirmkodā. Node.js vidē standarta risinājums ir dotenv, kas ielādē mainīgos no lokāla faila procesa starta brīdī:

npm install dotenv

Izveido .env failu projekta saknē:

MISTRAL_API_KEY=tava-api-atslega-seit

Tūlīt pievieno šo failu savam .gitignore, pirms veic pirmo commit. Tieši šajā brīdī atslēgas noplūst:

.env
.env.local

Importam dotenv/config ir jābūt pirms jebkādas process.env lasīšanas. Pretējā gadījumā mainīgais paliek nedefinēts, kad inicializē klientu:

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

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

Instalācijas pārbaude

Pirms biznesa loģikas rakstīšanas validē visu ķēdi — instalāciju, atslēgu, tīklu — ar minimālu skriptu. Izveido src/test-mistral.ts un vienkārši pieprasi sarakstu ar modeļiem, kas pieejami tavam kontam:

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

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

  // Saraksts ar pieejamajiem modeļiem
  const models = await client.models.list();
  const liste = models.data ?? [];
  console.log(`Available models: ${liste.length}`);

  for (const model of liste.slice(0, 5)) {
    // Šai SDK versijai nezināms modeļa tips tiek atzīmēts kā 'UNKNOWN'
    if (model.type === 'UNKNOWN') continue;
    console.log(`  - ${model.id}`);
  }
}

main().catch(console.error);

Šīs divas pārbaudes nav dekoratīvas. SDK deklarē data kā opcionālu, un katra saraksta ieraksts ir vai nu bāzes modeļa karte, vai pielāgota modeļa karte, vai nezināma vērtība (type: 'UNKNOWN'). Kad API pievieno jaunu modeļa tipu, SDK saglabā to šādā formā, nevis avārijas apstājas. Bez šiem diviem testiem stingrais režīms atsakās kompilēt.

Izstrādes laikā palaid to ar tsx, kas instalēts iepriekš, kas transpilē uzreiz un ietaupa būvēšanas soli:

npx tsx src/test-mistral.ts

Brīdinājums: tsx nepārbauda tipus; tas tos noņem un izpilda. Tikai tsc ziņo par tipizēšanas kļūdām. Palaid npx tsc --noEmit, lai pārbaudītu bez kompilēšanas. Lai kompilētu un pēc tam palaistu, kā to darīs tava būvēšanas cauruļvads:

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

Derīga atslēga parāda modeļu skaitu un pirmos piecus ierakstus. Noraidīta atslēga parāda kļūdu Status 401 (Invalid API Key): ķēde strādā, vainīga ir tikai atslēga.

Projekta organizēšana

Kad pārbaude ir veiksmīga, strukturē projektu tā, lai atslēga un klients neizklīstu pa failiem:

mon-projet/
├── src/
│   ├── index.ts          # Ieejas punkts
│   ├── mistral-client.ts # Klienta inicializācija (singleton)
│   └── utils/
├── .env                  # Vides mainīgie (git-ignorēti)
├── .gitignore
├── package.json
└── tsconfig.json

Klienta inicializācijas centralizēšana atsevišķā modulī izvairās no tā atkārtotas izveides katrā failā. Vēl svarīgāk, tas liek lietotnei izgāzties starta brīdī, nevis pie pirmā lietotāja pieprasījuma, ja trūkst atslēgas:

// 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,
});

Pārējais kods vienkārši importē šo sagatavoto klientu:

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

Ņem vērā paplašinājumu .js relatīvajā importā. Ar module: nodenext, TypeScript pieprasa faila nosaukumu tādu, kāds tas būs pēc kompilēšanas, un tsx zina, kā to kartēt uz .ts failu. Importa secībai arī ir nozīme: dotenv/config izpildās pirms mistral-client.js, tāpēc atslēga tiek ielādēta, kad šis modulis pārbauda tās esamību.

Galvenās atziņas

  • Instalē TypeScript SDK ar npm install @mistralai/mistralai
  • Galvenais imports ir import { Mistral } from '@mistralai/mistralai'
  • Instalē typescript, tsx un @types/node kā izstrādes atkarības pirms npx tsc izsaukšanas
  • Izmanto module: nodenext un "type": "module" kodam, ko kompilē un pēc tam palaiž Node.js; relatīvie importi iegūst paplašinājumu .js
  • Izmanto .env failu ar dotenv, lai pārvaldītu API atslēgu
  • SDK nodrošina natīvus TypeScript tipus: izmanto automātisko pabeigšanu un ļauj tsc pārbaudīt to, ko tsx izlaiž
  • Centralizē klienta inicializāciju atsevišķā modulī