Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-Ewwel Sejħa u Streaming f'TypeScript

Lezzjoni 9 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ibgħat L-Ewwel Talba Tiegħek
  2. Streaming
  3. Konversazzjonijiet b’Diversi Dawriet
  4. Aġġustament tal-Ġenerazzjoni u Ġestjoni tal-Iżbalji
  5. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 wara li kkompilajna eżempji f’mod strett bl-SDK @mistralai/mistralai 3.5.0 u TypeScript 7.0.2. L-SDK jittipja content bħala string | ContentChunk[]: konversazzjonijiet b’diversi dawriet u ċikli ta’ streaming ma kkompilawx mingħajr kontroll typeof content === 'string'. L-eżempju ta’ konfigurazzjoni preċedenti għaqqad temperature u topP, li d-dokumentazzjoni tal-API tiskoraġġixxi milli timmodifika flimkien. L-immaniġġjar tal-iżbalji issa juża l-klassi MistralError tal-SDK, u r-rotta ta’ Express tivvalida l-mistoqsija qabel ma ssejjaħ l-API. Sorsi: Mistral TypeScript SDK (README) · parametri ta’ tlestija taċ-chat.

Ibgħat L-Ewwel Talba Tiegħek

Issa li l-SDK huwa installat, ejja nsiru prattiċi. Il-metodu chat.complete() tal-SDK ta’ TypeScript huwa l-ekwivalenti eżatt ta’ dak tal-SDK tal-Python: l-istess parametri, l-istess struttura ta’ risposta, ħlief għall-konvenzjonijiet tas-smijiet. Jekk segwejt il-lezzjonijiet tal-Python, inti fuq art familjari; biss is-sintassi asinkrona ta’ JavaScript hija ġdida għalik.

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

Il-punti tal-interrogazzjoni f’response.choices[0]?.message?.content mhumiex biss għad-dekor: fit-tipi tal-SDK, message u content huma fakultattivi, u choices[0] ma jeżistix jekk il-lista terġa’ lura vojta. L-aċċess sikur jirritorna undefined minflok ma jitfgħa eċċezzjoni. Innota wkoll li content mhux dejjem stringa: l-SDK jittipjah bħala string | ContentChunk[] għax risposta tista’ tasal bħala lista ta’ frammenti (test, raġunar thinking, referenzi, eċċ.).

Nifhmu r-Risposta

L-istruttura tar-risposta hija identika għal dik tal-SDK tal-Python. L-analiżi tagħha tgħinek tifhem għal xiex qed tħallas u għaliex waqfet risposta. L-eżempju li ġej joħroġ it-test, ir-raġuni tal-waqfien, u n-numru ta’ tokens wieħed wieħed; billi tiktbu, l-editur tiegħek jissuġġerixxi kull qasam, u jipprova li t-tipar qed jagħmel ix-xogħol tiegħu.

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

  // Test tar-risposta
  const texte = response.choices[0]?.message?.content;

  // Raġuni tal-waqfien
  const finRaison = response.choices[0]?.finishReason;

  // Statistika tat-tokens
  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}`);
}

Innota l-kapitalizzazzjoni: fejn il-Python jesponi max_tokens, finish_reason, u prompt_tokens, TypeScript juża maxTokens, finishReason, u promptTokens. Dan huwa l-iżball numru wieħed meta timporta manwalment eżempju tal-Python—u l-kompilatur jindika dan immedjatament.

Streaming

L-istreaming huwa essenzjali għall-interfaċċi web: mingħajru, l-utent iħares lejn skrin iffriżat għal diversi sekondi; bih, it-test jidher kelma b’kelma u l-latenza perċepita tonqos drastikament. L-SDK ta’ TypeScript jesponi l-istreaming bħala ġeneratur asinkronu, li tista’ tgħaddi minnu b’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();
}

Żewġ dettalji jistħoqqilhom attenzjoni. Il-kontenut jinsab f’chunk.data, mhux direttament f’chunk: dan huwa l-wrapper tal-avvenimenti tal-SDK mill-verżjoni 1.0 ‘l hawn. U l-kontroll typeof content === 'string' jiffiltra kemm il-frammenti mingħajr kontenut, li kieku jimlew l-output tiegħek b’undefined, kif ukoll il-kontenut li huwa lista ta’ frammenti, li process.stdout.write ma jaċċettax: mingħajru, il-modalità stretta tirrifjuta li tikkompila.

Tesponi l-Istreaming permezz ta’ Express

Istreaming li qatt ma joħroġ mit-terminal ma jgħin lil ħadd. Hawnhekk tara kif tgħaddih lejn browser bl-użu ta’ Server-Sent Events minn API ta’ Express. Il-mistoqsija tiġi vvalidata qabel kwalunkwe sejħa biex tevita li tibgħat talba vojta lill-API. It-tliet headers imbagħad jiftħu l-kanal, kull framment jintbagħat lura bħala JSON f’avveniment data:, u markatur [DONE] jissinjala lill-klijent biex jagħlaq il-konnessjoni.

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

Konversazzjonijiet b’Diversi Dawriet

L-immaniġġjar tal-istorja jsegwi l-istess prinċipju bħal fil-Python: il-mudell m’għandux memorja, allura inti żżomm array ta’ messaġġi u terġa’ tibgħathom kollha f’kull dawra. F’TypeScript, id-dikjarazzjoni ta’ tip Message espliċitu tipprevjeni li tidħol rwol li ma jeżistix jew oġġett malformat—żball li l-API kieku tirritorna bħala 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();

Il-kontroll typeof contenu === 'string' mhuwiex lussu: il-qasam content tar-risposta jista’ jkun lista ta’ frammenti, filwaqt li t-tip Message tiegħek jistenna stringa. Imbagħad osserva t-tielet mistoqsija: “Kif nista’ nżid restrizzjonijiet?” tagħmel sens biss għax iż-żewġ skambji preċedenti għadhom fl-array. Ipprova l-eżerċizzju billi tneħħi l-linja li żżid ir-risposta tal-assistent mal-istorja, u se tara l-mudell jitlif il-fil tal-konversazzjoni fit-tieni dawra.

Aġġustament tal-Ġenerazzjoni u Ġestjoni tal-Iżbalji

Il-parametri avvanzati huma identiċi għal dawk tal-SDK tal-Python—biss tinbidel il-kapitalizzazzjoni. temperature baxxa għal deliverable strutturat u maxTokens ikkalibrat għat-tul mistenni jipproduċu risposti aktar prevedibbli. Issettja temperature jew topP, mhux it-tnejn: din hija r-rakkomandazzjoni tad-dokumentazzjoni tal-API, li tissuġġerixxi temperature bejn 0 u 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,
});

Fl-aħħar nett, kwalunkwe sejħa tan-network tista’ tfalli: ċavetta invalida, kwota maqbura, ħsara fis-servizz. Dejjem poġġi s-sejħa f’try/catch u iċċekkja t-tip tal-iżball qabel ma taqra l-proprjetajiet tiegħu, inkella TypeScript jirrifjuta li jikkompila. L-iżbalji HTTP kollha rritornati mill-API jwirtu minn MistralError, li jesponi statusCode u body; l-iżbalji tan-network (ConnectionError, RequestTimeoutError, eċċ.) ma jwirtux minnu iżda jibqgħu istanzi ta’ 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) {
    // Risposta ta' żball tal-API: 401 ċavetta miċħuda, 429 limitu milħuq...
    console.error(`Mistral API Error ${error.statusCode}: ${error.message}`);
  } else if (error instanceof Error) {
    // L-ebda risposta mill-API: network 'l isfel, limitu ta' żmien maqbuż...
    console.error(`Error: ${error.message}`);
  }
}

Punti Ewlenin

  • client.chat.complete() huwa asinkronu—uża await
  • L-istreaming juża for await...of fuq ir-riżultat ta’ client.chat.stream()
  • It-tipar ta’ TypeScript jaqbad żbalji fil-parametri waqt il-kompilazzjoni
  • L-integrazzjoni SSE ma’ Express hija sempliċi għal interfaċċi web f’ħin reali
  • L-istorja tal-konversazzjoni tiġi ġestita b’array ittipjat Message[]
  • content huwa jew stringa jew lista ta’ frammenti: ittestja typeof content === 'string' qabel ma tużah bħala test
  • L-iżbalji HTTP tal-SDK jwirtu minn MistralError (statusCode, body)