Dea-chleachtais agus na chéad chéimeanna eile
Ar an leathanach seo
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ód | Brí | Gníomh |
|---|---|---|
| 401 Unauthorized | Eochair API neamhbhailí nó as dáta | Seiceáil d’athróg timpeallachta |
| 429 Too Many Requests | Teorainn ráta sroichte | Déan iarracht arís le moilliú easpónantúil |
| 500 Internal Server Error | Fadhb ar thaobh Mistral | Iarracht uathoibríoch tar éis cúpla soicind |
| 503 Service Unavailable | Róluchtú sealadach | Dé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.