Cruthaigh Aighne leis an API Python
Ar an leathanach seo
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_argsginiú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á