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

Do Chéad Ghlaonn API i bPython

Ceacht 5 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do Chéad Mhalartú le Múnla Mistral
  2. An Cliant a Thionscnamh
  3. Iarratas a Sheoladh le chat.complete()
  4. An Oibiacht Fhillte a Léamh
  5. Iompar an Mhúnla a Choigeartú
  6. Glaonn atá Réidh don Táirgeadh
  7. Príomhphointí

Do Chéad Mhalartú le Múnla Mistral

Tá an SDK suiteáilte agus do eochair API réidh: tá sé in am iarraidh fhíor a sheoladh agus, níos tábhachtaí fós, tuiscint a fháil ar an méid a thagann ar ais. Stopann go leor forbróirí ag an gcéad líne den fhreagra agus déanann siad neamhaird ar an gcuid eile den oibiacht a filltear. Is botún é sin, toisc go mbíonn rianú costais agus diagnóisic do fhreagraí giorraithe le fáil go díreach sa chuid eile sin den sonraí. Tosaímid le cód íosta agus déanaimid ár mbealach suas go dtí an struchtúr iomlán.

An Cliant a Thionscnamh

Is é an cliant an pointe iontrála do do chuid idirghníomhaíochtaí go léir leis an API:

import os
from mistralai.client import Mistral

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

Déileálann sé le ceangail HTTP, athiarrachtaí ar earráidí líonra, agus sraitheáil iarratas. Cruthaigh é uair amháin ag am tosaithe an fheidhmchláir. Má chruthaíonn tú cliant nua do gach glaonn, cuireann sé ort íoc as socruithe ceangail gan ghá agus is ceann de na cúiseanna is lú a fheictear de mhoill iomarcach é.

Iarratas a Sheoladh le chat.complete()

Úsáidfidh tú an modh chat.complete() is minice. Seolann sé do chuid teachtaireachtaí agus fanann sé le freagra iomlán an mhúnla sula dtugann sé an smacht ar ais:

response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "user",
            "content": "Explain the concept of tokenization in three sentences."
        }
    ]
)

print(response.choices[0].message.content)

Tá dhá pharaiméadar go leor anseo. Sonraíonn model an t-aithneoir múnla: léiríonn mistral-small-latest i gcónaí an leagan is déanaí de Mistral Small, rud a fhágann gurb é an rogha nádúrtha é chun tosú ós rud é go bhfuil sé tapa agus eacnamaíoch. Braitheann messages ar liosta de theachtaireachtaí struchtúrtha, gach ceann acu le role—system, user, nó assistant—agus réimse content ina bhfuil an téacs. D’fhéadfadh an struchtúr seo a bheith trom do cheist amháin, ach ciallaíonn sé go hiomlán a luaithe a shroicheann tú an ceacht ar chomhráite il-chasacha.

An Oibiacht Fhillte a Léamh

Tá i bhfad níos mó san oibiacht response ná an téacs ginte amháin:

# Response text
text = response.choices[0].message.content

# Role (always "assistant" for a response)
role = response.choices[0].message.role

# Stop reason
finish = response.choices[0].finish_reason  # "stop", "length", etc.

# Token statistics
input_tokens = response.usage.prompt_tokens
output_tokens = response.usage.completion_tokens
total_tokens = response.usage.total_tokens

print(f"Response ({output_tokens} tokens): {text}")
print(f"Total tokens consumed: {total_tokens}")

Tabhair aird dhian ar an réimse usage ón gcéad lá. Má logálann tú é ar gach glaonn, inseoidh sé duit go beacht cé acu gné d’fheidhmchlár atá ag dó do bhuiséid, gan ort do shonasc a ath-innealtóireacht ag deireadh na míosa.

Maidir le finish_reason, léiríonn sé cén fáth ar stop an múnla agus glacann sé ceann de na luachanna seo a leanas:

  • stop: chríochnaigh an múnla a fhreagra go nádúrtha
  • length: gearradh an fhreagra toisc gur shroich sí max_tokens
  • model_length: shroich an comhthéacs iomlán (ionchur + aschur) teorainn an mhúnla

Ní fabht múnla é freagra a stopann i lár abairte: is é finish_reason de length é nach ndearna aon duine seiceáil air. Déan seiceáil air i gcónaí sula dtugann tú conclúid go bhfuil fadhb cáilíochta ann.

Iompar an Mhúnla a Choigeartú

Ligeann trí pharaiméadar bhreise duit an ghiniúint a stiúradh:

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "user",
            "content": "Propose three names for an educational AI startup."
        }
    ],
    temperature=0.7,
    max_tokens=500,
    top_p=0.95,
)

Rialaíonn Temperature céim saoirse an mhúnla. Ag 0.0, tá freagraí cinntitheach: cruthaíonn an leid céanna an téacs céanna i gcónaí, rud atá uait le haghaidh eastóscadh nó aicmiú. Idir 0.3 agus 0.5, faigheann tú cothromaíocht mhaith do thascanna fíorasacha. Idir 0.7 agus 1.0, éiríonn freagraí níos cruthaithí agus níos éagsúla—seo an raon a úsáidtear sa sampla thuas, ós rud é go bhfuilimid ag iarraidh smaointe ainmneacha agus bheadh sé gan bhrí an smaoineamh céanna a fheiceáil trí huaire. Os cionn 1.0, éiríonn an ghiniúint an-treallach agus is annamh a bhíonn úsáid phraiticiúil léi.

Cuireann max_tokens teorainn le fad na freagra, rud a chuidíonn le costais a rialú agus aschuir a choinneáil inbhainistithe. Cuimhnigh díreach má ghearrtar an múnla, go mbeidh finish_reason mar "length". Cuireann top_p isteach ar éagsúlacht trí mheicníocht eile: scagann sé na tócan is lú dóchúlacht amach. Ciallaíonn luach 0.95 nach mbreithníonn an múnla ach tócan a léiríonn 95% den dóchúlacht charnach.

Glaonn atá Réidh don Táirgeadh

Faoi choinníollacha fíorshaol, titann an líonra, téann eochracha in éag, agus líontar cuótaí. Cuir do chuid glaonna i gcónaí i gcuimsiú láimhseála earráide:

import os
from mistralai.client import Mistral

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

try:
    response = client.chat.complete(
        model="mistral-small-latest",
        messages=[
            {"role": "user", "content": "What is the capital of France?"}
        ],
        max_tokens=100,
    )

    text = response.choices[0].message.content
    print(f"Response: {text}")
    print(f"Tokens used: {response.usage.total_tokens}")

except Exception as e:
    print(f"API call error: {e}")

Úsáid an creatlach seo do do chuid turgnamh féin trí ábhar na teachtaireachta a athrú go simplí. Is é an pointe tosaigh é do gach rud a leanas sa chúrsa seo.

Príomhphointí

  • Is é client.chat.complete() an príomhmhodh chun idirghníomhú le múnlaí
  • Tá téacs na freagra i response.choices[0].message.content
  • Inseoidh response.usage duit cé mhéad tócan a úsáideadh (úsáideach le haghaidh rianú costais)
  • Rialaíonn temperature an chruthaitheacht; cuireann max_tokens teorainn leis an bhfad
  • Tosaigh le mistral-small-latest: tá sé tapa, eacnamaíoch, agus feidhmiúil