Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Prvý volanie a streamovanie v TypeScrite

Lekcia 9 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Pošli svoju prvú požiadavku
  2. Streamovanie
  3. Konverzácie s viacerými kolami
  4. Ladenie generovania a spracovanie chýb
  5. Kľúčové poznatky

Lekcia aktualizovaná 3. novembra 2026 po kompilácii príkladov v striktnom režime so SDK @mistralai/mistralai 3.5.0 a TypeScript 7.0.2. Typy SDK definujú content ako string | ContentChunk[]: konverzácie s viacerými kolami a streamovacie slučky sa bez kontroly typeof content === 'string' nekompilovali. Príklad konfigurácie predtým kombinoval temperature a topP, čo dokumentácia API neodporúča meniť súčasne. Spracovanie chýb teraz využíva triedu MistralError zo SDK a ruta v Express validuje otázku pred volaním API. Zdroje: Mistral TypeScript SDK (README) · parametre dokončenia chatu.

Pošli svoju prvú požiadavku

Teraz, keď máš nainštalované SDK, poďme na prax. Metóda chat.complete() v TypeScript SDK je presným ekvivalentom tej v Python SDK: rovnaké parametre, rovnaká štruktúra odpovede, až na konvencie pomenovania. Ak si sledoval lekcie o Pythone, pohybuješ sa na známej pôde; nová je len asynchrónna syntax JavaScriptu.

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

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

async function main() {
  const response = await client.chat.complete({
    model: 'mistral-small-latest',
    messages: [
      {
        role: 'user',
        content: 'Explain the concept of a closure in JavaScript in three sentences.',
      },
    ],
  });

  console.log(response.choices[0]?.message?.content);
}

main();

Otázniky v response.choices[0]?.message?.content nie sú len pre okrasu: v typoch SDK sú message a content voliteľné a choices[0] neexistuje, ak sa zoznam vráti prázdny. Bezpečný prístup vráti undefined namiesto vyvolania výnimky. Všimni si tiež, že content nie je vždy reťazec: SDK ho typuje ako string | ContentChunk[], pretože odpoveď môže prísť ako zoznam fragmentov (text, uvažovanie thinking, referencie atď.).

Pochopenie odpovede

Štruktúra odpovede je totožná s Python SDK. Jej parsovanie ti pomôže pochopiť, za čo platíš a prečo sa odpoveď zastavila. Nasledujúci príklad extrahuje text, dôvod zastavenia a počet tokenov jeden po druhom; keď ho prepíšeš, editor ti navrhne každé pole, čo dokazuje, že typovanie robí svoju prácu.

async function analyserReponse() {
  const response = await client.chat.complete({
    model: 'mistral-small-latest',
    messages: [
      { role: 'user', content: 'What is the capital of France?' },
    ],
    maxTokens: 100,
  });

  // Text odpovede
  const texte = response.choices[0]?.message?.content;

  // Dôvod zastavenia
  const finRaison = response.choices[0]?.finishReason;

  // Štatistiky tokenov
  const tokensEntree = response.usage?.promptTokens;
  const tokensSortie = response.usage?.completionTokens;

  console.log(`Response: ${texte}`);
  console.log(`Tokens: ${tokensEntree} input + ${tokensSortie} output`);
  console.log(`Stop: ${finRaison}`);
}

Všimni si veľkosť písmen: zatiaľ čo Python expose max_tokens, finish_reason a prompt_tokens, TypeScript používa maxTokens, finishReason a promptTokens. Toto je chyba číslo jedna pri manuálnom portovaní príkladov z Pythonu – a kompilátor ju okamžite označí.

Streamovanie

Streamovanie je kľúčové pre webové rozhrania: bez neho užívateľ zíza na zamrznutú obrazovku niekoľko sekúnd; s ním sa text objavuje slovo po slove a vnímaná latencia sa zrúti. TypeScript SDK expose stream ako asynchrónny generátor, ktorým iteruješ pomocou for await...of:

async function streamReponse() {
  const stream = await client.chat.stream({
    model: 'mistral-small-latest',
    messages: [
      {
        role: 'user',
        content: 'Describe the five main design patterns in JavaScript.',
      },
    ],
  });

  for await (const chunk of stream) {
    const content = chunk.data.choices[0]?.delta.content;
    if (typeof content === 'string') {
      process.stdout.write(content);
    }
  }
  console.log();
}

Dva detaily si zaslúžia tvoju pozornosť. Obsah sa nachádza v chunk.data, nie priamo v chunk: toto je obálka udalosti SDK od verzie 1.0. A kontrola typeof content === 'string' filtruje fragmenty bez obsahu, ktoré by inak zaplnili výstup hodnotou undefined, ako aj obsah typu zoznam fragmentov, ktorý process.stdout.write neprijíma: bez nej striktný režim odmietne kompiláciu.

Exponovanie streamu cez Express

Stream, ktorý nikdy neopustí terminál, nikomu nepomôže. Tu je návod, ako ho preniesť do prehliadača pomocou Server-Sent Events z API postaveného na Express. Otázka sa validuje pred akýmkoľvek volaním, aby sa predišlo odoslaniu prázdnej požiadavky na API. Tri hlavičky následne otvoria kanál, každý fragment sa odošle späť ako JSON v udalosti data: a značka [DONE] signalizuje klientovi uzavretie spojenia.

import express from 'express';
import { Mistral } from '@mistralai/mistralai';

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

app.get('/api/chat', async (req, res) => {
  const question = typeof req.query.q === 'string' ? req.query.q : '';
  if (!question) {
    res.status(400).json({ error: 'Missing q parameter' });
    return;
  }

  res.setHeader('Content-Type', 'text/event-stream');
  res.setHeader('Cache-Control', 'no-cache');
  res.setHeader('Connection', 'keep-alive');

  const stream = await client.chat.stream({
    model: 'mistral-small-latest',
    messages: [{ role: 'user', content: question }],
  });

  for await (const chunk of stream) {
    const content = chunk.data.choices[0]?.delta.content;
    if (typeof content === 'string' && content) {
      res.write(`data: ${JSON.stringify({ text: content })}\n\n`);
    }
  }

  res.write('data: [DONE]\n\n');
  res.end();
});

app.listen(3000, () => console.log('Server on port 3000'));

Konverzácie s viacerými kolami

Správa histórie funguje na rovnakom princípe ako v Pythone: model nemá pamäť, takže udržiavaš pole správ a pri každom kole odosielaš celé znova. V TypeScrite deklarovanie explicitného typu Message zabraňuje vkládaniu neexistujúcej roly alebo chybného objektu – chybe, ktorú by API inak vrátilo ako 400.

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

type Message = {
  role: 'system' | 'user' | 'assistant';
  content: string;
};

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

const historique: Message[] = [
  {
    role: 'system',
    content: 'You are an expert TypeScript assistant. Respond in English.',
  },
];

async function poserQuestion(question: string): Promise<string> {
  historique.push({ role: 'user', content: question });

  const response = await client.chat.complete({
    model: 'mistral-small-latest',
    messages: historique,
  });

  const contenu = response.choices[0]?.message?.content;
  const reponse = typeof contenu === 'string' ? contenu : '';
  historique.push({ role: 'assistant', content: reponse });

  return reponse;
}

async function main() {
  console.log(await poserQuestion('What is a generic type?'));
  console.log(await poserQuestion('Show me a concrete example.'));
  console.log(await poserQuestion('How do I add constraints?'));
}

main();

Kontrola typeof contenu === 'string' nie je luxus: pole content v odpovedi môže byť zoznam fragmentov, zatiaľ čo tvoj typ Message očakáva reťazec. Všimni si potom tretiu otázku: „How do I add constraints?“ dáva zmysel len preto, že dve predchádzajúce výmeny sú stále v poli. Vyskúšaj si cvičenie odstránením riadku, ktorý pridáva odpoveď asistenta do histórie, a uvidíš, ako model v druhom kole stratí nit.

Ladenie generovania a spracovanie chýb

Pokročilé parametre sú totožné s Python SDK – mení sa len veľkosť písmen. Nízka hodnota temperature pre štruktúrovaný výstup a maxTokens kalibrované na očakávanú dĺžku prinášajú predvídateľnejšie odpovede. Nastav temperature alebo topP, nie obe: toto je odporúčanie dokumentácie API, ktorá radí hodnotu temperature medzi 0 a 0,7.

const response = await client.chat.complete({
  model: 'mistral-large-latest',
  messages: [
    { role: 'user', content: 'Propose an architecture for a B2B SaaS.' },
  ],
  temperature: 0.5,
  maxTokens: 1000,
});

Nakoniec, akékoľvek sieťové volanie môže zlyhať: neplatný kľúč, prekročená kvóta, výpadok. Volanie vždy obal do bloku try/catch a pred čítaním jeho vlastností skontroluj typ chyby, inak TypeScript odmietne kompiláciu. Všetky HTTP chyby vrátené API dedia od MistralError, ktorá expose statusCode a body; sieťové chyby (ConnectionError, RequestTimeoutError atď.) od nej nededajú, ale zostávajú inštanciami Error.

import * as errors from '@mistralai/mistralai/models/errors';

try {
  const response = await client.chat.complete({
    model: 'mistral-small-latest',
    messages: [{ role: 'user', content: 'Hello!' }],
  });
  console.log(response.choices[0]?.message?.content);
} catch (error) {
  if (error instanceof errors.MistralError) {
    // Chybová odpoveď API: 401 kľúč odmietnutý, 429 dosiahnutý limit...
    console.error(`Mistral API Error ${error.statusCode}: ${error.message}`);
  } else if (error instanceof Error) {
    // Žiadna odpoveď API: sieť dole, prekročený časový limit...
    console.error(`Error: ${error.message}`);
  }
}

Kľúčové poznatky

  • client.chat.complete() je asynchrónne – používaj await
  • Streamovanie používa for await...of na výsledku client.chat.stream()
  • Typovanie v TypeScrite zachytí chyby v parametroch už pri kompilácii
  • Integrácia SSE s Express je priamočiara pre webové rozhrania v reálnom čase
  • História konverzácie sa spravuje pomocou typovaného poľa Message[]
  • content je buď reťazec, alebo zoznam fragmentov: pred použitím ako text otestuj typeof content === 'string'
  • HTTP chyby SDK dedia od MistralError (statusCode, body)