Első hívás és streamelés TypeScriptben
Ezen az oldalon
Lecke frissítve: 2026. november 3. A példák szigorú módban történő fordítása után az
@mistralai/mistralaiSDK 3.5.0-s és a TypeScript 7.0.2-es verziójával. Az SDK acontentmezőtstring | ContentChunk[]típusként kezeli: a többmenetes beszélgetések és a streamelési ciklusok nem fordultak le helyesen egytypeof content === 'string'ellenőrzés nélkül. A korábbi konfigurációs példa egyszerre állította be atemperatureés atopPparamétert, amit az API dokumentációja kifejezetten ellenjavall. A hibakezelés most az SDKMistralErrorosztá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 azawaitkulcsszót - A streamelés
for await...ofciklust használ aclient.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
contentvagy sztring, vagy töredékek listája: használat előtt ellenőrizd atypeof content === 'string'feltételt - Az SDK HTTP-hibái a
MistralErrorosztályból örökölnek (statusCode,body)