Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Céad Ghlaonna agus Sruthú i TypeScript

Ceacht 9 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Seol do Chéad Iarratas
  2. Sruthú
  3. Comhráite Il-Chas
  4. Tiúnadh Giniúna agus Láimhseáil Earráidí
  5. Príomhphointí

Nuashonraíodh an ceacht ar an 3 Samhain, 2026 tar éis samplaí a thiomsú i mód dian leis an SDK @mistralai/mistralai 3.5.0 agus TypeScript 7.0.2. Déanann cineálacha an SDK típiú ar content mar string | ContentChunk[]: theip ar chomhráite il-chas agus ar lúba sruthaithe tiomsú gan seiceáil typeof content === 'string'. Chumaisc an sampla cumraíochta roimhe seo temperature agus topP, rud a mholann doiciméadú an API gan a athrú le chéile. Úsáideann láimhseáil earráidí anois an rang MistralError ón SDK, agus bailíochtaíonn an bealach Express an cheist sula nglaotar ar an API. Foinse: Mistral TypeScript SDK (README) · paraiméadair chríochnaithe comhrá.

Seol do Chéad Iarratas

Anois go bhfuil an SDK suite, déanaimis é a chur i bhfeidhm. Is ionann an modh chat.complete() sa TypeScript SDK go díreach agus é sa Python SDK: na paraiméadair chéanna, an struchtúr freagartha céanna, seachas coinbhinsiúin ainmníochta. Má lean tú ceachta Python, tá tú ar thalamh eolach; ní hionann agus sin, níl i gceist ach comhréir aisincronach JavaScript atá nua duit.

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

Níl na comharthaí ceiste i response.choices[0]?.message?.content ann gan chúis: i gcineálacha an SDK, tá message agus content roghnach, agus ní bhíonn choices[0] ann má thagann an liosta ar ais folamh. Tugann rochtain shábháilte undefined ar ais seachas eisceacht a chaitheamh. Tabhair faoi deara freisin nach teaghrán i gcónaí é content: déanann cineálacha an SDK típiú air mar string | ContentChunk[] toisc gur féidir le freagra teacht mar liosta blúirí (téacs, réasúnaíocht thinking, tagairtí, srl.).

An Freagra a Thuiscint

Tá struchtúr an fhreagra comhionann le struchtúr an Python SDK. Cabhraíonn sé a pharsáil leat a thuiscint cad atá tú ag íoc as agus cén fáth ar stop freagra. Baineann an sampla seo a leanas an téacs, an chúis stoptha, agus líon na dtócan amach ceann ar cheann; má chlóscríobhann tú é, feicfidh tú do eagarthóir ag moladh gach réimse, rud a chruthaíonn go bhfuil an típiú ag déanamh a hoibre.

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

  // Téacs freagartha
  const texte = response.choices[0]?.message?.content;

  // Cúis stoptha
  const finRaison = response.choices[0]?.finishReason;

  // Staitisticí tócan
  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}`);
}

Tabhair faoi deara an cás: áit a nochtann Python max_tokens, finish_reason, agus prompt_tokens, úsáideann TypeScript maxTokens, finishReason, agus promptTokens. Seo an earráid is coitianta nuair a aistríonn tú sampla Python de láimh—agus cuirfidh an tiomsóir in iúl duit é láithreach.

Sruthú

Tá sruthú ríthábhachtach do chomhéadain ghréasáin: gan é, breathnaíonn an t-úsáideoir ar scáileán reoite ar feadh roinnt soicind; leis, feictear téacs focal ar fhocal agus laghdaítear an mhoill mheasta go mór. Nochtann an TypeScript SDK an sruth mar ghineadóir aisincronach, ar féidir leat dul tríd le 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();
}

Tá dhá shonraí ar chóir duit aird a thabhairt orthu. Tá an t-ábhar i chunk.data, ní go díreach i chunk: seo an clúdach imeachta ón SDK ó leagan 1.0 i leith. Agus scagann an seiceáil typeof content === 'string' amach blúirí gan ábhar, a líonfadh d’aschur le undefined, chomh maith le hábhar atá ina liosta blúirí, nach nglacann process.stdout.write leis: gan é, diúltaíonn mód dian tiomsú.

An Sruth a Nochtadh trí Express

Ní chuidíonn sruth nach bhfágann an teirminéal le duine ar bith. Seo conas é a chur ar aghaidh chuig brabhsálaí ag baint úsáide as Imeachtaí Seirbhíseora-Seolta (SSE) ó API Express. Déantar bailíochtú ar an gceist sula ndéantar aon ghlaonna chun seachaint iarratas folamh a sheoladh chuig an API. Osclaíonn na trí cheanntásc an chainéal ansin, seoltar gach blúire ar ais mar JSON in imeacht data:, agus cuireann marcóir [DONE] in iúl don chliant an nasc a dhúnadh.

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

Comhráite Il-Chas

Leanann bainistiú staire an prionsabal céanna le Python: níl cuimhne ag an múnla, mar sin coinníonn tú eagar teachtaireachtaí agus seolann tú an rud ar fad ar ais gach cas. I TypeScript, coscaíonn dearbhú cineáil Message sainráite botúin mar ról nach bhfuil ann nó oibiacht míchumtha a chur isteach—earráid a thabharfadh an API ar ais mar 400 murach sin.

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

Ní polais é an seiceáil typeof contenu === 'string': is féidir le réimse content an fhreagra a bheith ina liosta blúirí, cé go n-éilíonn do chineál Message teaghrán. Ansin, breathnaigh ar an tríú ceist: ní bhíonn ciall ag “How do I add constraints?” ach amháin toisc go bhfuil an dá mhalartú roimhe sin fós san eagar. Brúigh an cleachtadh trí líne a bhaineann freagra an chúntóra leis an stair a bhaint, agus feicfidh tú an múnla ag cailleadh an snáithe faoin dara cas.

Tiúnadh Giniúna agus Láimhseáil Earráidí

Tá paraiméadair chasta comhionann le paraiméadair an Python SDK—ní athraíonn ach an cás. Tugann temperature íseal do sheachadadh struchtúrtha agus maxTokens calabrtha don fhad a bhfuiltear ag súil leis freagraí níos intuartha. Socraigh temperature nó topP, ní an dá cheann: seo moladh dhoiciméadú an API, a mholann temperature idir 0 agus 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,
});

Ar deireadh, is féidir le haon ghlao líonra teipthe: eochair neamhbhailí, cuóta sáraithe, briseadh síos. Cuir an gla i gcónaí i mbloc try/catch agus seiceáil cineál na hearráide sula léann tú a hairíonna, murach sin diúltóidh TypeScript tiomsú. Oidhríonn gach earráid HTTP a thugtar ar ais ón API ó MistralError, a nochtann statusCode agus body; ní oidhríonn earráidí líonra (ConnectionError, RequestTimeoutError, srl.) uaidh ach fanann siad ina n-ábhair 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) {
    // Freagra earráide API: diúltaíodh eochair 401, sroicheadh teorainn 429...
    console.error(`Mistral API Error ${error.statusCode}: ${error.message}`);
  } else if (error instanceof Error) {
    // Gan freagra API: líonra síos, sáraíodh an t-am teorainn...
    console.error(`Error: ${error.message}`);
  }
}

Príomhphointí

  • Tá client.chat.complete() aisincronach—úsáid await
  • Úsáideann sruthú for await...of ar thoradh client.chat.stream()
  • Ghabhann típiú TypeScript earráidí paraiméadar ag am an tiomsaithe
  • Tá comhtháthú SSE le Express díreach do chomhéadain ghréasáin fíor-ama
  • Bainistítear stair chomhrá le heagar típithe Message[]
  • Is teaghrán nó liosta blúirí é content: déan tástáil ar typeof content === 'string' sula n-úsáideann tú é mar théacs
  • Oidhríonn earráidí HTTP an SDK ó MistralError (statusCode, body)