Przejdź do głównej treści
Polski— Wybierz język
Menu

Pierwsze wywołanie i strumieniowanie w TypeScript

Lekcja 9 z 14 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Wyślij swoje pierwsze żądanie
  2. Strumieniowanie
  3. Rozmowy wielowątkowe
  4. Dostrajanie generowania i obsługa błędów
  5. Kluczowe wnioski

Lekcja zaktualizowana 3 listopada 2026 r. po skompilowaniu przykładów w trybie ścisłym przy użyciu SDK @mistralai/mistralai w wersji 3.5.0 oraz TypeScript 7.0.2. Typy SDK określają pole content jako string | ContentChunk[]: rozmowy wielowątkowe i pętle strumieniowania nie kompilowały się bez sprawdzenia typeof content === 'string'. Przykład konfiguracji wcześniej łączył parametry temperature i topP, czego dokumentacja API odradza robić jednocześnie. Obsługa błędów korzysta teraz z klasy MistralError z SDK, a ruta Express waliduje pytanie przed wywołaniem API. Źródła: Mistral TypeScript SDK (README) · parametry uzupełniania czatu.

Wyślij swoje pierwsze żądanie

Skoro SDK jest już zainstalowane, przejdźmy do praktyki. Metoda chat.complete() w SDK TypeScript jest dokładnym odpowiednikiem tej z SDK Python: te same parametry, ta sama struktura odpowiedzi, z wyjątkiem konwencji nazewnictwa. Jeśli realizowałeś lekcje z Pythona, poruszasz się po znajomym terenie; nowa jest jedynie asynchroniczna składnia 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();

Znaki zapytania w wyrażeniu response.choices[0]?.message?.content nie są tam dla ozdoby: w typach SDK pola message i content są opcjonalne, a choices[0] nie istnieje, jeśli lista przyjdzie pusta. Bezpieczny dostęp zwraca undefined, zamiast wyrzucać wyjątek. Zauważ też, że content nie zawsze jest ciągiem znaków: SDK typuje je jako string | ContentChunk[], ponieważ odpowiedź może nadejść jako lista fragmentów (tekst, rozumowanie thinking, odniesienia itp.).

Zrozumienie odpowiedzi

Struktura odpowiedzi jest identyczna jak w SDK Python. Jej parsowanie pomaga zrozumieć, za co płacisz i dlaczego odpowiedź się zatrzymała. Poniższy przykład wydobywa tekst, przyczynę zatrzymania i liczbę tokenów po kolei; wpisanie go ręcznie sprawi, że edytor zasugeruje każde pole, co dowodzi, że typowanie wykonuje swoją pracę.

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

  // Tekst odpowiedzi
  const texte = response.choices[0]?.message?.content;

  // Przyczyna zatrzymania
  const finRaison = response.choices[0]?.finishReason;

  // Statystyki tokenów
  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}`);
}

Zwróć uwagę na wielkość liter: tam gdzie Python udostępnia max_tokens, finish_reason i prompt_tokens, TypeScript używa maxTokens, finishReason i promptTokens. To najczęstszy błąd przy ręcznym przenoszeniu przykładów z Pythona – kompilator natychmiast go wykryje.

Strumieniowanie

Strumieniowanie jest kluczowe dla interfejsów webowych: bez niego użytkownik wpatruje się w zamarznięty ekran przez kilka sekund; z nim tekst pojawia się słowo po słowie, a postrzegane opóźnienie drastycznie maleje. SDK TypeScript udostępnia strumień jako generator asynchroniczny, po którym iterujesz za pomocą 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();
}

Dwa szczegóły zasługują na Twoją uwagę. Zawartość znajduje się w chunk.data, a nie bezpośrednio w chunk: to wrapper zdarzeń SDK od wersji 1.0. Sprawdzenie typeof content === 'string' filtruje zarówno fragmenty bez zawartości, które zaśmieciłyby wyjście wartością undefined, jak i zawartość będącą listą fragmentów, której process.stdout.write nie akceptuje: bez tego tryb ścisły odmówi kompilacji.

Udostępnianie strumienia przez Express

Strumień, który nigdy nie opuszcza terminala, nikomu nie pomaga. Oto jak przekazać go do przeglądarki, używając Server-Sent Events z API opartego na Express. Pytanie jest walidowane przed jakimkolwiek wywołaniem, aby uniknąć wysyłania pustego żądania do API. Trzy nagłówki otwierają kanał, każdy fragment jest odsyłany jako JSON w zdarzeniu data:, a znacznik [DONE] sygnalizuje klientowi zamknięcie połączenia.

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

Rozmowy wielowątkowe

Zarządzanie historią遵循 tę samą zasadę co w Pythonie: model nie ma pamięci, więc utrzymujesz tablicę wiadomości i za każdym razem wysyłasz całość. W TypeScript zadeklarowanie jawnego typu Message zapobiega przemyceniu nieistniejącej roli lub błędnie sformatowanego obiektu – błędu, który API zwróciłoby inaczej jako kod 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();

Sprawdzenie typeof contenu === 'string' nie jest luksusem: pole content odpowiedzi może być listą fragmentów, podczas gdy Twój typ Message oczekuje ciągu znaków. Zauważ też trzecie pytanie: „How do I add constraints?“ ma sens tylko dlatego, że dwie poprzednie wymiany nadal znajdują się w tablicy. Spróbuj usunąć linię dodającą odpowiedź asystenta do historii, a zobaczysz, jak model zgubi wątek już przy drugiej turze.

Dostrajanie generowania i obsługa błędów

Zaawansowane parametry są identyczne jak w SDK Python – zmienia się tylko wielkość liter. Niska wartość temperature dla strukturalnego deliverable oraz maxTokens skalibrowane do oczekiwanej długości dają bardziej przewidywalne odpowiedzi. Ustaw temperature lub topP, ale nie oba: to rekomendacja dokumentacji API, która sugeruje wartość temperature między 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,
});

Na koniec, każde wywołanie sieciowe może się nie powieść: nieprawidłowy klucz, przekroczony limit, awaria. Zawsze opakowuj wywołanie w blok try/catch i sprawdzaj typ błędu przed odczytem jego właściwości, w przeciwnym razie TypeScript odmówi kompilacji. Wszystkie błędy HTTP zwracane przez API dziedziczą po MistralError, które udostępnia statusCode i body; błędy sieciowe (ConnectionError, RequestTimeoutError itp.) nie dziedziczą po nim, ale nadal są instancjami 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) {
    // Błąd odpowiedzi API: 401 odrzucony klucz, 429 osiągnięty limit...
    console.error(`Mistral API Error ${error.statusCode}: ${error.message}`);
  } else if (error instanceof Error) {
    // Brak odpowiedzi API: sieć niedostępna, przekroczony czas oczekiwania...
    console.error(`Error: ${error.message}`);
  }
}

Kluczowe wnioski

  • client.chat.complete() jest asynchroniczne – użyj await
  • Strumieniowanie używa for await...of na wyniku client.chat.stream()
  • Typowanie w TypeScript wykrywa błędy parametrów w czasie kompilacji
  • Integracja SSE z Express jest prosta dla interfejsów webowych w czasie rzeczywistym
  • Historia rozmowy jest zarządzana za pomocą typowanej tablicy Message[]
  • content to albo ciąg znaków, albo lista fragmentów: sprawdź typeof content === 'string' przed użyciem go jako tekstu
  • Błędy HTTP SDK dziedziczą po MistralError (statusCode, body)