Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Első hívás és streamelés TypeScriptben

9. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Küldd el az első kérésedet
  2. Streamelés
  3. Többmenetes beszélgetések
  4. A generálás hangolása és a hibakezelés
  5. Főbb megállapítások

Lecke frissítve: 2026. november 3. A példák szigorú módban történő fordítása után az @mistralai/mistralai SDK 3.5.0-s és a TypeScript 7.0.2-es verziójával. Az SDK a content mezőt string | ContentChunk[] típusként kezeli: a többmenetes beszélgetések és a streamelési ciklusok nem fordultak le helyesen egy typeof content === 'string' ellenőrzés nélkül. A korábbi konfigurációs példa egyszerre állította be a temperature és a topP paramétert, amit az API dokumentációja kifejezetten ellenjavall. A hibakezelés most az SDK MistralError osztályát használja, az Express útvonal pedig érvényesíti a kérdést az API hívása előtt. Források: Mistral TypeScript SDK (README) · chat completion paraméterek.

Küldd el az első kérésedet

Most, hogy az SDK telepítve van, vágjunk bele a gyakorlatba. A TypeScript SDK chat.complete() metódusa pontosan megegyezik a Python SDK-éval: ugyanazok a paraméterek, ugyanaz a válaszstruktúra, eltekintve az elnevezési konvencióktól. Ha követted a Python leckéket, ismerős terepen jársz; csupán a JavaScript aszinkron szintaxisa új számodra.

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();

A kérdőjelek a response.choices[0]?.message?.content kifejezésben nem csak dísznek vannak: az SDK típusdefiníciói szerint a message és a content opcionális, és a choices[0] nem létezik, ha a lista üresen érkezik vissza. A biztonságos hozzáférés undefined értéket ad vissza kivétel dobása helyett. Vegyed észre azt is, hogy a content nem mindig sztring: az SDK string | ContentChunk[] típusként kezeli, mivel a válasz érkezhet töredékek listájaként is (szöveg, thinking gondolkodási lépések, hivatkozások stb.).

A válasz megértése

A válaszstruktúra megegyezik a Python SDK-éval. A kiértékelése segít megérteni, miért fizetsz, és miért állt le a válasz generálása. A következő példa egyesével nyeri ki a szöveget, a leállási okot és a tokenek számát; ha begépeled, a szerkesztőd minden mezőt felajánl, bizonyítva, hogy a típusozás végzi a dolgát.

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

  // Válasz szövege
  const texte = response.choices[0]?.message?.content;

  // Leállási ok
  const finRaison = response.choices[0]?.finishReason;

  // Token statisztikák
  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}`);
}

Figyeld a nagybetűket: míg a Python max_tokens, finish_reason és prompt_tokens neveket használ, addig a TypeScriptben ezek maxTokens, finishReason és promptTokens. Ez a leggyakoribb hiba Python példák manuális portolásakor – és a fordító azonnal jelezni fogja.

Streamelés

A streamelés elengedhetetlen a webes felületekhez: nélküle a felhasználó másodpercekig egy befagyott képernyőt bámul; vele viszont a szöveg szóról szóra jelenik meg, és az észlelt késleltetés drasztikusan csökken. A TypeScript SDK aszinkron generátorként teszi elérhetővé a streamet, amelyet egy for await...of ciklussal iterálhatsz:

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();
}

Két részlet deserves különös figyelmet. A tartalom a chunk.data alatt található, nem közvetlenül a chunk-ban: ez az SDK eseményburkolója az 1.0-s verzió óta. A typeof content === 'string' ellenőrzés pedig kiszűri mind a tartalom nélküli töredékeket (amelyek undefined értékekkel szemetelnék ki a kimenetet), mind a töredéklistákat, amelyeket a process.stdout.write nem fogad el: enélkül a szigorú mód megtagadja a fordítást.

A stream elérhetővé tétele Expressen keresztül

Egy stream, ami sosem hagyja el a terminált, senkinek sem használ. Íme, hogyan továbbíthatod egy böngészőbe Server-Sent Events (SSE) segítségével egy Express API-n keresztül. A kérdést érvényesítjük minden hívás előtt, hogy elkerüljük az üres kérések elküldését az API-nak. A három fejléc ezután megnyitja a csatornát, minden töredéket JSON-ként küldünk vissza egy data: eseményben, és egy [DONE] jelző szól a kliensnek a kapcsolat lezárásáról.

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'));

Többmenetes beszélgetések

Az előzmények kezelése ugyanazt az elvet követi, mint Pythonban: a modellnek nincs memóriája, ezért neked kell karbantartanod az üzenetek tömbjét, és minden körben elküldeni az egészet. TypeScriptben egy explicit Message típus deklarálása megakadályozza, hogy nem létező szerepet vagy hibásan formázott objektumot adj meg – egy olyan hibát, amit az API egyébként 400-as státuszkóddal utasítana vissza.

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();

A typeof contenu === 'string' ellenőrzés nem luxus: a válasz content mezője lehet töredékek listája is, míg a te Message típusod sztringet vár. Figyeld meg a harmadik kérdést is: a „How do I add constraints?“ csak azért értelmes, mert az előző két beszélgetés még mindig benne van a tömbben. Tedd próbára a gyakorlatot azzal, hogy törlöd a sort, amely hozzáadja az asszisztens válaszát az előzményekhez, és látni fogod, ahogy a modell elveszíti a fonalat a második körre.

A generálás hangolása és a hibakezelés

A haladó paraméterek megegyeznek a Python SDK-éval – csak a nagybetűk változnak. Egy alacsony temperature érték strukturált deliverable-okhoz, és az elvárt hosszhoz igazított maxTokens kiszámíthatóbb válaszokat eredményez. Állítsd be a temperature vagy a topP paramétert, ne mindkettőt: ez az API dokumentációjának ajánlása, amely 0 és 0,7 közötti temperature értéket javasol.

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

Végezetül, bármelyik hálózati hívás meghiúsulhat: érvénytelen kulcs, túllépett kvóta, kimaradás. Mindig burkold try/catch blokkba a hívást, és ellenőrizd a hiba típusát, mielőtt olvasnád a tulajdonságait, különben a TypeScript megtagadja a fordítást. Az API által visszaadott összes HTTP-hiba a MistralError osztályból örököl, amely exposes a statusCode és body mezőket; a hálózati hibák (ConnectionError, RequestTimeoutError stb.) nem ebből örökölnek, de továbbra is Error példányok maradnak.

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) {
    // API hiba válasz: 401 kulcs elutasítva, 429 limit elérve...
    console.error(`Mistral API Error ${error.statusCode}: ${error.message}`);
  } else if (error instanceof Error) {
    // Nincs API válasz: hálózat leállt, időtúllépés...
    console.error(`Error: ${error.message}`);
  }
}

Főbb megállapítások

  • A client.chat.complete() aszinkron – használd az await kulcsszót
  • A streamelés for await...of ciklust használ a client.chat.stream() eredményén
  • A TypeScript típusozás fordítási időben elkapja a paraméterhibákat
  • Az SSE integráció Expressszel egyszerű a valós idejű webes felületekhez
  • A beszélgetés előzményeit egy Message[] típusú tömb kezeli
  • A content vagy sztring, vagy töredékek listája: használat előtt ellenőrizd a typeof content === 'string' feltételt
  • Az SDK HTTP-hibái a MistralError osztályból örökölnek (statusCode, body)