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

Cruthaigh Aighne leis an API Python

Ceacht 4 as 18 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do Chéad Aighne Mistral
  2. Réamhriachtanais
  3. Cruthaigh Aighne Íosta
  4. Iompraíocht a Shainiú le Treoracha
  5. Giniúint a Rialú
  6. An tAighne a Fheistiú le hUirlisí
  7. Saolré an Aighne a Bhainistiú
  8. Sampla Iomlán
  9. Príomhphointí

Do Chéad Aighne Mistral

Bhunaigh na trí cheacht roimhe seo an foclóir; baineann an ceacht seo úsáid as do mhéarchlár. Cruthóidh tú aighne tríd an API Python, ag saibhriú de réir a chéile é le treoracha, paraiméadair ghiniúna, agus uirlisí, sula dtosaíonn tú comhrá leis. Tá an dul chun cinn beartaithe a bheith incriminteach: athraíonn gach breiseán iompraíocht inbhraite, ag taispeáint duit conas is féidir leis an modh create() céanna cúntóir ginearálta nó saineolaí le stíl ghlasáilte a tháirgeadh.

Réamhriachtanais

Tógann an suiteáil dhá chéim. Ar dtús, an SDK oifigiúil.

pip install mistralai

Ina dhiaidh sin, déan do eochair API ar fáil sa timpeallacht seachas é a chódú go crua i do chód. Is é an chéad teagmhas slándála do thionscadal LLM ar bith ná eochair a chur i dtaisce i stór go hearráideach.

export MISTRAL_API_KEY="your-api-key"

Ansin, tógann tú an cliant in aon líne amháin. Feidhmíonn an oibiacht client seo mar an bpointe iontrála don chuid eile den cheacht.

from mistralai.client import Mistral
import os

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

Cruthaigh Aighne Íosta

Glacann an modh client.beta.agents.create() trí pharaiméadar riachtanacha agus roinnt cinn roghnacha. Tosaímid leis an íosmhéid.

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Simple Assistant",
    description="A conversational agent with persistent state."
)

print(f"Agent created: {agent.id}")

Tá an t-aighne seo íostach: gan treoracha sonracha, gan uirlisí, gan gardaí. Feidhmíonn sé cosúil le críochphointe Chat Completions feabhsaithe le buanseasmhacht. Tabhair faoi deara an t-aitheantóir a thugtar ar ais in agent.id: is é seo an rud a stórálann tú ar thaobh an fheidhmchláir, mar gurb é an t-aon tagairt chobhsaí don chumraíocht seo.

Iompraíocht a Shainiú le Treoracha

Feidhmíonn treoracha mar an leid córais agus is iad an príomhghiuirléid chun iompraíocht a rialú. Tiontaíonn an sampla thíos cúntóir ginearálta ina shaineolaí dlí a bhfuil a raon, a fhormáid agus a theorainneacha teorannaithe go soiléir.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Legal Expert",
    description="Agent specialized in French business law.",
    instructions="""You are an expert in French business law.

Rules:
- Always respond in French
- Cite relevant legal articles
- Specify when a question requires a lawyer's opinion
- Structure your responses with headings and lists
- Never give definitive legal advice"""
)

Breathnaigh ar struchtúr an leide seo: sainiú róil ag an tús, agus rialacha uimhrithe ina dhiaidh sin. Cabhraíonn an eagrú altach seo leis an múnla srianta a thosaíochtú. Bí sonrach faoin ról, faoin ton agus faoi na teorainneacha seachas “bí cabhrach” a scríobh. Os cionn gach rud, déan réamh-mheastachán ar chásanna imeallacha—cad ba chóir don aighne a dhéanamh má thiteann an cheist lasmuigh dá fhearann? Pléann an líne faoi thuairim dlíodóra a lorg é seo go beacht. Ar deireadh, déileáil le treoracha mar chód: déanfaidh tú tástáil agus athbhreithniú orthu go minic sula dtáirgeann siad an iompraíocht atá ag teastáil.

Giniúint a Rialú

Cumraíonn na completion_args an samplóir, rud a chiallaíonn conas a roghnaíonn an múnla a chuid focal. Ní gá an tsaoirse chéanna d’aighne a bhfuil sé mar chúram air fíricí a athrá agus atá ag aighne brainstorming.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Precise Agent",
    description="Agent with controlled generation parameters.",
    instructions="Respond factually and concisely.",
    completion_args={
        "temperature": 0.2,    # Less creativity, more precision
        "top_p": 0.9,          # Probability nucleus
        "max_tokens": 2048     # Response length limit
    }
)
  • temperature — Raontaíonn sé ó 0.0 (cinntitheach) go 1.0 (cruthaitheach). Do thascanna fíriciúla, roghnaigh 0.1–0.3.
  • top_p — Scagadh dóchúlachta carnathaigh. Is rogha mhaith réamhshocraithe é 0.9.
  • max_tokens — Teorainn dhocht ar thokenna aschuir.

An tAighne a Fheistiú le hUirlisí

Éiríonn aighne fíor-neamhspleách nuair is féidir leis gníomhú thar théacs. Tugann an chumraíocht seo a leanas rochtain ar an ngréasán agus feidhmiú cód dó: os comhair ceiste a dhéanann comparáid idir rátaí inniu, faighidh sé na luachanna agus ríomhfaidh sé an toradh gan do chuid idirghabhála.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Research Agent",
    description="Agent with web search and code execution.",
    instructions="Use web search for current information and code for calculations.",
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ],
    completion_args={"temperature": 0.3, "top_p": 0.95}
)

I measc na n-uirlisí atá ar fáil tá: web_search, web_search_premium, code_interpreter, image_generation, document_library.

Saolré an Aighne a Bhainistiú

Is acmhainní buanacha iad do chuid aighnithe ar thaobh Mistral, agus riarfaidh tú iad mar aon acmhainn eile: faigh iad, modhnaigh iad, scrios iad. Tá liostú thar a bheith úsáideach le linn forbartha, áit a gcríochnaíonn tú go tapa le dosaen aighne tástála ar chaill tú a n-aiteantóirí.

# List all your agents
agents = client.beta.agents.list()
for a in agents.data:
    print(f"{a.name} ({a.id})")

# Retrieve an agent by its ID
agent = client.beta.agents.get(agent_id="ag-xxxxxxxx")

Tá nuashonruithe páirteach: ní mhodhnaítear ach na réimsí a soláthraíodh; fanann na cinn eile mar atá siad. Ligeann sé seo duit treoracha a bheachtú i dtáirgeadh gan an chumraíocht iomlán a athdhearbhú.

agent = client.beta.agents.update(
    agent_id=agent.id,
    instructions="New updated instructions.",
    tools=[{"type": "web_search"}, {"type": "code_interpreter"}]
)

Tá an scriosadh, áfach, buan.

client.beta.agents.delete(agent_id=agent.id)

Sampla Iomlán

Déanaimis é a chur le chéile go léir in aighne atá feidhmiúil go hiomlán: cruthú, comhrá, agus léamh an fhreagra. Is féidir leat an script seo a úsáid mar atá sí; ní gá duit ach an t-ainm agus na treoracha a athrú, agus beidh d’analaí oibríochtúil féin agat laistigh de nóiméid.

from mistralai.client import Mistral
import os

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

# Create the agent
agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Tech Analyst",
    description="Analyzes technology trends with web sources.",
    instructions="""You are a technology analyst.
- Use web search for recent data
- Always cite your sources
- Structure your analyses into key points""",
    tools=[{"type": "web_search"}],
    completion_args={"temperature": 0.3}
)

# Start a conversation
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="What are the latest advancements in agentic AI in 2026?"
)

# Display the response
for entry in response.outputs:
    if hasattr(entry, "content"):
        print(entry.content)

Tuilleann an lúb dheireanach nóiméad aire: déanann sí athrá ar response.outputs seachas réimse amháin a léamh toisc go dtáirgeann aighne atá feistithe le huirlisí il-iontrálacha—feidhmiú an chuardaigh, agus ansin an téacs. Is é seo an príomhphointe le breathnú air sa chéad cheacht eile.

Príomhphointí

  • Cruthaíonn client.beta.agents.create() aighne le múnla, ainm agus cur síos (riachtanach)
  • Sainíonn treoracha iompraíocht—is é seo an príomhghiuirléid
  • Rialaíonn completion_args giniúint (teocht, top_p, max_tokens)
  • Is féidir le haighne il-uirlisí a bheith cumasaithe ag an am céanna
  • Is cumraíochtaí in-athúsáidte iad aighnithe, ní samplaí comhrá