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

Dea-chleachtais agus na chéad chéimeanna eile

Ceacht 14 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Achoimre ar an gCúrsa
  2. Do chuid Eochracha API a Choinneáil Slán
  3. Earráidí a Láimhseáil
  4. Maireachtáil le Teorainneacha Ráta
  5. Costais a Rialú
  6. Monatóireacht a Dhéanamh ar an Méid a Tharlaíonn
  7. Cad atá le Teacht
  8. Príomhphointí
  9. Tástáil do Chuid Eolais

Achoimre ar an gCúrsa

Tá na bunúsaigh go léir bainte amach agat maidir le hAPI Mistral a úsáid: cruthú cuntais, bainistíocht eochracha, roghnú pleananna, suiteáil na n-SDK do Python agus TypeScript, sruthú, comhráite il-chasadh, imirce V1/V2, agus imlonnú ar phríomhsholáthraithe scamaill. Ní faoi fhoghlaim an API féin atá sé a thuilleadh, ach faoin difríocht idir script a oibríonn agus feidhmchlár a sheasann i dtimpeallacht táirgeachta.

Do chuid Eochracha API a Choinneáil Slán

Is é seo an chúis is coitianta le teagmhais i dtimpeallachtaí táirgeachta, beagnach i gcónaí ar an ábhar céanna: eochair chódaithe “chun tástála amháin” agus dearmadta i ngabháil (commit) ina dhiaidh sin. Ní mór d’eochair API teacht chun solais i gcód foinseach riamh; is in athróg timpeallachta a bheidh sí, nó, níos fearr fós, i mbainisteoir rúnda cosúil le AWS Secrets Manager, Azure Key Vault, nó HashiCorp Vault.

Is é an chéad chéim eile ná deighilt. Úsáid eochair amháin in aghaidh na timpeallachta—forbairt, stáitsiúnú, táirgeadh—chun a chinntiú nach gcaitheann tástáil theipthe do chuóta seirbhíse beo. Úsáid eochair amháin in aghaidh an fheidhmchláir chun an damáiste a theorannú: má sceitheann eochair, ní gá duit ach an ceann don fheidhmchlár lena mbaineann a chúlghairm. Pleanáil rothlú gach 90 lá i dtimpeallachtaí táirgeachta, agus cumraigh foláirimh sa Chonsól Mistral le haghaidh úsáide mínormálta: is minic a léiríonn eochair faoi chois é féin ar dtús mar chuar úsáide a ardaíonn gan chúis.

Earráidí a Láimhseáil

I dtimpeallacht táirgeachta, is féidir le gach glaoch API teip. Ní hé an cheist an dtarlóidh sé, ach cathain. Clúdaíonn ceithre chód stádais an chuid is mó de na rudaí a bhuaileann ort:

CódBríGníomh
401 UnauthorizedEochair API neamhbhailí nó as dátaSeiceáil d’athróg timpeallachta
429 Too Many RequestsTeorainn ráta sroichteDéan iarracht arís le moilliú easpónantúil
500 Internal Server ErrorFadhb ar thaobh MistralIarracht uathoibríoch tar éis cúpla soicind
503 Service UnavailableRóluchtú sealadachDéan iarracht arís le moilliú

Tá tábhacht leis an idirdhealú: ní shocraíonn tú earráid 401 riamh trí iarracht a dhéanamh arís; is i do chumraíocht atá an locht. Is sealadach iad an trí cinn eile, agus is é an freagra ceart ná iarracht a dhéanamh arís le moillithe a fhásann de réir a chéile—soicind amháin, ansin dhá cheann, ansin ceithre cinn. Má dhéanann tú iarracht arís láithreach i lúb ar earráid 429, ní dhéanfaidh tú ach an sáithiú atá á fhulaingt agat a mhéadú.

Seo an patrún i bPython: trí iarracht ar a mhéad, scaip an eisceacht má theipeann an ceann deireanach, agus dúbailt an t-am feithimh tar éis gach teipe ag baint úsáide as 2 ** attempt.

import time
import os
from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

def call_with_retry(messages, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = client.chat.complete(
                model="mistral-small-latest",
                messages=messages,
            )
            return response
        except Exception as e:
            if attempt == max_retries - 1:
                raise
            waitTime = 2 ** attempt  # 1s, 2s, 4s
            print(f"Error: {e}. Retrying in {waitTime}s...")
            time.sleep(waitTime)

Leanann an leagan TypeScript an loighic chéanna go díreach, ach tá an t-am feithimh sloinnte i millisoicind agus déantar an mhoilliú le gealltanas (promise) agus setTimeout:

async function callWithRetry(
  client: Mistral,
  messages: Array<{ role: string; content: string }>,
  maxRetries = 3
) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await client.chat.complete({
        model: 'mistral-small-latest',
        messages,
      });
    } catch (error) {
      if (attempt === maxRetries - 1) throw error;
      const waitTime = Math.pow(2, attempt) * 1000;
      console.log(`Error. Retrying in ${waitTime}ms...`);
      await new Promise((r) => setTimeout(r, waitTime));
    }
  }
}

Maireachtáil le Teorainneacha Ráta

Cosnaíonn teorainneacha ráta an API ó mhí-úsáid, agus ní leor loighic ath-iarrachta amháin chun urraim a thabhairt dóibh: ní dhéanann siad ach rudaí a shocrú tar éis an fhíric. Seiceáil do theorainneacha sa Chonsól Mistral—iarratais in aghaidh an tsoicind, tokenanna in aghaidh an nóiméid—ansin cuir cosc taobh an chliaint i bhfeidhm chun a chinntiú nach sáraíonn tú iad. Ba chóir iarratais bhreise a chur i scuaine, ní a chaitheamh: b’fhearr le húsáideoir fanacht dhá shoicind ná earráid a fháil.

Nuair a tharlaíonn earráid 429 d’ainneoin do chuid iarrachtaí is fearr, áirítear ceanntásc Retry-After sa fhreagra a léiríonn cathun is féidir iarracht a dhéanamh arís; is fearr é a léamh ná buille faoi thuairim a thabhairt. Agus má sháraíonn do úsáid dhlisteanach teorainneacha an phlean Scale go seasmhach, iarr méadú cuóta trí thacaíocht seachas bealaí seachtracha a iolrú.

Costais a Rialú

Is é an chéad ghiarlann, agus an ceann is éifeachtaí i bhfad, ná roghnú an mhúnla. Ní éilíonn aicmiú, eastóscadh réimsí, nó athfhrású réasúnaíocht chasta: déileálann mistral-small-latest leo go han-mhaith. Coinnigh mistral-large-latest do thascanna ina ndéanann cáilíocht na réasúnaíochta an difríocht—anailís, sintéis chasta, scríbhneoireacht fhada—agus úsáid codestral-latest chun cód a ghiniúint. Ná híoc as Mistral Large 3 chun an rud céanna a dhéanamh agus is féidir le Mistral Small a dhéanamh chomh maith céanna: ag méid táirgeachta, tomhaistear an difríocht in orduithe méide.

Baineann an dara giarlann le líon na tokenanna a mhalartaítear. Costóidh leid gonta, gan treoracha iomarcacha a carnadh thar iteráidí, níos lú ar gach glaoch. I gcomhráite il-chasadh, ní sheol ach na teachtaireachtaí is gá: athsheinm stair tríocha malartú do gach ceist méadaíonn an bille go han-tapa. Coigeartaigh max_tokens don rud a bhfuil súil agat leis i ndáiríre, agus déan freagraí athfhillteacha a thaisce (cache)—is é an t-iarratas is saoire ná an ceann nach ndéanann tú.

Monatóireacht a Dhéanamh ar an Méid a Tharlaíonn

I dtimpeallacht táirgeachta, déan logáil ar gach glaoch. Gan é seo, ní bheidh a fhios agat cén fáth ar gearradh freagra nó cén úsáid a mhíníonn bille na míosa. Filleann an fheidhm thíos an glaoch le dhá rian: an méid a théann amach, ansin an méid a thagann ar ais, lena n-áirítear líon iomlán na tokenanna agus an chúis stoptha.

import logging

logger = logging.getLogger("mistral")

def logged_call(client, messages, model="mistral-small-latest"):
    logger.info(f"API Call — model: {model}, messages: {len(messages)}")

    response = client.chat.complete(model=model, messages=messages)

    logger.info(
        f"Response — tokens: {response.usage.total_tokens}, "
        f"finish: {response.choices[0].finish_reason}"
    )

    return response

Freagraíonn an dá líne seo do chuid is mó de na ceisteanna a chuirfidh tú ort féin níos déanaí. Míníonn finish_reason a léiríonn teorainn faid freagra a gearradh sa lár; nochtann meánlíon tokenanna atá ag imeacht leid a d’fhás nó stair nár glanadh i gceart.

Cad atá le Teacht

Leis na bunúsaigh ina n-áit, osclaítear roinnt conairí. Ligeann glaonna feidhme don mhúnla do chuid feidhmeanna agus API féin a ghlaoch. Saibhríonn RAG (Retrieval-Augmented Generation) freagraí le do chuid sonraí inmheánacha, agus is iad leabaithe (embeddings), a chlaochlaíonn téacs ina veicteoirí, an bonn tógála do chuardach seimeantach. Oiriúnaíonn mionchoigeartú (fine-tuning) múnla do do cheantar nuair nach leor leid, déanann gníomhairí slabhrú glaoch chun córais uathrialacha a thógáil, agus tugann meastóireacht duit bealach chun cáilíocht na bhfreagraí a thomhas seachas é a mheas de réir na súl.

Tá cúrsaí tiomnaithe ag gach ceann de na topaicí seo i gcatalóg Corsen Academy.

Príomhphointí

  • Slánaigh do chuid eochracha API le bainisteoir rúnda agus rothlú rialta
  • Cuir iarracht arís le moilliú easpónantúil i bhfeidhm go córasach
  • Roghnaigh an múnla is éadroime atá in ann do thasc a láimhseáil
  • Déan logáil ar gach glaoch API chun diagnóisic agus optamú costais
  • Is é API Mistral do bhonn—tógann na chéad chéimeanna eile (glaonna feidhme, RAG, gníomhairí) ar gach rud a d’fhoghlaim tú

Tástáil do Chuid Eolais

Consól, SDK, soláthraithe scamaill: an bhfuil bonn an API ina áit?

1. Cad iad na freagairtí reflexa ba chóir duit a bheith agat don eochair API chomh luath agus a chruthaítear í?

Freagra: Stóráil go sábháilte í (taispeántar uair amháin í), coinnigh as an cód í trí athróga timpeallachta, úsáid eochair amháin in aghaidh na timpeallachta, agus rothlaigh í má tá amhras ort.

2. Cad a dhéanann idirdhealú idir na pleananna Experiment agus Scale?

Freagra: Cuótaí agus praghsáil: Experiment don fhionnachtain agus don phrótaitípiú, Scale don táirgeadh—seiceáil do theorainneacha sa chonsól sula ndéanann tú méidú.

3. Cad é creatlach an chéad ghlaoigh Python?

Freagra: Cliant tosaigh leis an eochair, glaoch comhrá leis an múnla agus liosta teachtaireachtaí, ag léamh ábhar na freagra—agus tá sruthú cumasaithe le haghaidh taispeána céim ar chéim.

4. Conas a láimhseálann tú comhrá il-chasadh tríd an API?

Freagra: Trí an stair a choinneáil leat féin: seolann gach iarratas an liosta iomlán teachtaireachtaí (úsáideoir agus cúntóir)—tá an API gan staid.

5. Cad ba chóir duit a bheith ar eolas faoi imlonnú trí Azure, Vertex, nó Bedrock?

Freagra: Tá múnlaí Mistral ar fáil ann le fíordheimhniú agus billeáil an scamaill roghnaithe—an teaghlach múnla céanna, pointe rochtana difriúil, úsáideach do shrianta bonneagair.

Eochair slánaithe, stair bhainistithe, plean oiriúnaithe: tiontaíonn dea-chleachtais dheireanacha an bonn seo ina bhonn táirgeachta.