Dea-chleachtais agus na chéad chéimeanna eile
Ar an leathanach seo
An méid a chlúdaigh tú
Tá tú tar éis dul tríd an API Mistral Agents ina iomláine. Déanaimis achoimre sula dtéimid i mbun cleachtais táirgeachta, ós rud é go mbraitheann gach cuid den chúrsa seo ar an gcuid roimhe.
Leag na chéad trí cheacht an bonn: is córas neamhspleách é gníomhaire AI a bhfuil lúb braite-gníomhaíochta aige; tá an API bunaithe ar trí oibiacht—Agent, Conversation, agus Entry; agus is iad an mharthanacht, na huirlisí, agus na haistrithe láimhe (handoffs) a dhealaíonn gníomhaire ó chatbot. Rinne ceachtaí 4 go 7 na hoibiachtaí seo inúsáidte: gníomhairí a chruthú agus a chumrú le client.beta.agents.create(), comhráite marthanacha a choinneáil le conversations.start() agus conversations.append(), agus an mód díreach a úsáid gan gníomhaire nuair atá tú ag déanamh samhaltaithe agus nach bhfuil aon luach sa mharthanacht.
Chuir ceachtaí 8 go 11 acmhainní leis. Tugann web_search rochtain duit ar fhaisnéis reatha le luachan uathoibríocha; rithíonn code_interpreter Python i ngaineamhlann, rud a thugann torthaí cruinne don ghníomhaire nuair a dhéanfadh an tsamhail amháin meastachán; cruthaíonn image_generation íomhánna ó leideanna téacs; agus tugann document_library RAG comhtháite do do chuid doiciméad féin. Ansin, léirigh ceachtaí 12 go 16 conas a oibríonn gníomhairí iolracha le chéile: aistríonn handoffs an smacht ó ghníomhaire amháin go ceann eile, péireálann an ailtireacht tagartha ródaire lárnach le saineolaithe, uathoibríonn mód freastalaí áit a gcoinníonn mód cliant tú sa lúb, agus briseann slabhrú gan teorainn síos i bpatrúin líneacha, réalta, agus hibrideacha. Ar deireadh, chríochnaigh Ceacht 17 an t-iomlán le gardaí (guardrails), prionsabal na pribhléide is lú, agus measúnú suas an srutha.
Gníomhairí a dhearadh a mhaireann
Gabhlann aon abairt amháin an cúrsa iomlán: gníomhaire amháin, freagracht amháin, cur síos amháin a deir cathain ba chóir glaoch air. Déanann an chodarsnacht thíos an difríocht ina rud intangible.
# MAITH — gníomhaire speisialaithe le cur síos cruinn
agent = client.beta.agents.create(
model="mistral-large-latest",
name="invoice-processor",
description="Processes invoices: extracts amounts, dates, vendors.",
instructions="Extract invoice information into structured JSON.",
tools=[{"type": "document_library", "library_ids": [invoices_lib.id]}]
)
# OLc — gníomhaire ginearálta, doiléir
agent = client.beta.agents.create(
model="mistral-large-latest",
name="helper",
description="A helpful agent.",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}, {"type": "image_generation"}]
)
Teipfidh ar an dara gníomhaire ar dhá bhealach ag an am céanna. Ní bheidh a fhios ag aon ródaire cathun ba chóir iarratas a aistriú chuige, toisc nach dtugann “gníomhaire cabhrach” cur síos ar aon staid. Agus nuair a ghlaofar air, ligeann a thrí uirlis dó gréasán a chuardach le haghaidh rud ar chóir dó a ríomh, nó rud a iarradh air a anailísiú a mhaisiú.
Earráidí a láimhseáil
Teipeann glaonna líonra sooner nó later. Súnn iarracht athfhillteach le cúlú easpónantúil teagmhais thrasánacha gan moilliú sealadach a thiontú ina mhíchumas infheicthe.
import time
def safe_conversation(agent_id, query, max_retries=3):
"""Comhrá le láimhseáil earráide agus athiarracht."""
for attempt in range(max_retries):
try:
response = client.beta.conversations.start(
agent_id=agent_id,
inputs=query
)
return response
except Exception as e:
if attempt == max_retries - 1:
raise
time.sleep(2 ** attempt) # Cúlú easpónantúil
return None
Déanann cúlú easpónantúil—soicind amháin, ansin dhá cheann, ansin ceathair—idirdhealú idir athiarracht shibhialta agus seirbhís a bhuaileadh atá cheana féin ag streachailt. Tabhair faoi deara freisin go n-ardaíonn an iarracht dheireanach an eisceacht arís in ionad None a thabhairt ar ais: ní mór don ghlaóir a bheith ar an eolas go dteip ar an oibríocht.
A fheiceáil cad atá ar siúl
Sa táirgeadh, éiríonn sreabhadh oibre il-ghníomhaire nach féidir leat a bhreathnú dodhéanta a dhífhabhtú. Tugann mód cliant na crúcaí go díreach atá uait.
import logging
import time
logger = logging.getLogger("agents")
def monitored_conversation(agent_id, query):
"""Comhrá le monatóireacht."""
start = time.time()
response = client.beta.conversations.start(
agent_id=agent_id,
inputs=query,
handoff_execution="client"
)
handoff_count = 0
tool_count = 0
for entry in response.outputs:
if entry.type == "agent.handoff":
handoff_count += 1
logger.info(f"Handoff #{handoff_count}: → {entry.next_agent_id}")
elif entry.type == "tool.execution":
tool_count += 1
logger.info(f"Tool #{tool_count}: {entry.tool_name}")
duration = time.time() - start
logger.info(f"Finished in {duration:.1f}s — {handoff_count} handoffs, {tool_count} tools")
return response
Tá níos mó luacha sna dhá chomhaireamh sin ná a thugann a simplíocht le fios: léiríonn claonadh sa mheánlíon handoffs ródaire atá ag leisce; léiríonn buaic i nglaotha uirlisí ceisteanna costasacha.
Ansin, tagann rialú costais síos go cinntí concreiteacha. Déan monatóireacht ar thócaí in aghaidh an chomhrá, ós rud é gurb é sin an t-aonad billeála fíor. Úsáid mistral-medium-latest i ngach áit nach gcuireann mistral-large-latest aon rud leis—is sampla leabhair é an chéad leibhéal tacaíochta. Cuir teorainn le max_tokens in completion_args chun freagraí gan chríoch ar cheisteanna simplí a sheachaint, agus díghníomhachtaigh stóráil le store=False nuair nach bhfuil gá le marthanacht.
Ródú a thástáil
Déan tástáil ar chóras il-ghníomhaire mar a dhéanfá ar chlár comhlaiste: beathaigh cásanna isteach a bhfuil aonad ceann scríbe ar eolas agat, agus fíoraigh cá dtéann siad i dtír.
def test_agent_routing():
"""Fíoraíonn go ndáileann an ródaire i gceart é."""
test_cases = [
("What is the price of Bitcoin?", "web-search-agent"),
("Calculate 25 * 48", "calculator-agent"),
("Summarize this document", "doc-agent"),
]
for query, expected_agent_name in test_cases:
response = client.beta.conversations.start(
agent_id=router.id,
inputs=query,
handoff_execution="client"
)
for entry in response.outputs:
if entry.type == "agent.handoff":
target = client.beta.agents.get(agent_id=entry.next_agent_id)
assert target.name == expected_agent_name, \
f"Incorrect routing for '{ query}': {target.name} instead of {expected_agent_name}"
Tóg an tsraith tástála seo le himeacht ama: gach iarratas mí-threoraithe a ghabhann tú sa táirgeadh, bíonn sé ina líne eile in test_cases, agus beidh a fhios agat go ndéanann cur síos a athscríobh an cás spriocdhírithe a shocrú gan ceann eile a bhriseadh.
Ailtireacht Tagartha
Do thionscadal táirgeachta, seo ailtireacht mholta:
Application
│
▼
Moderator Agent (filters requests)
│
▼
Router Agent (distributes to specialists)
├── Search Agent (web_search)
├── Analysis Agent (code_interpreter)
├── Documents Agent (document_library)
└── Creation Agent (image_generation)
│
▼
Logging + Monitoring + Alerting
Tugann sé seo le chéile gach rud ón gcúrsa seo: scagann an t-moderator roimh aon fhorghníomhú, treoraíonn an ródaire gan freagra a thabhairt riamh é féin, bíonn uirlis amháin agus freagracht amháin ag gach saineolaí, agus cuimsíonn breathnú an córas iomlán.
Cá dtéigh ina dhiaidh sin
Síneann ceithre threo an méid is féidir leat a dhéanamh anois. Ligeann Function calling duit do chuid uirlisí saincheaptha féin a thógáil thar na cinn ionsuite: glaoigh ar API gnó, déan ceist ar bhunachar sonraí, spreag seirbhís inmheánach. Comhtháthaíonn MCP Servers an Prótacal Comhthéacs Samhla (Model Context Protocol), a chaighdeánaíonn conas a nochtar uirlisí. Cuirtear freagraí i scéama JSON le Structured outputs, rud a athraíonn gach rud nuair a bhíonn aschur gníomhaire ag beathú córas eile seachas léitheoir daonna. Ar deireadh, filleann streaming freagraí i bhfíor-am in ionad i mbloc amháin—cinntitheach ar shlabhraí fada, áit a n-éiríonn fanacht chiúin míchompordach.
Tá trí acmhainn ag gabháil leis an gcéim seo: an doiciméadú oifigiúil ag docs.mistral.ai/agents, na leabhair chócaireachta Mistral a sholáthraíonn samplaí cur chun feidhme iomlána, agus an Tagairt API a dhoiciméadaíonn gach críochphointe go mion.
Príomhphointí
- Déan do ghníomhairí a speisialú—gníomhaire amháin = freagracht amháin
- Déan monatóireacht—logáil gach handoff agus forghníomhú uirlise
- Déan tástáil—fíoraigh ródú agus freagraí gach gníomhaire
- Déan slánú—gardaí, pribhléid is lú, measúnú suas an srutha
- Optamaigh costais—samhail de mhéid ceart, max_tokens, store=False nuair is féidir
- Tá Mistral Agents i mbéite—coinnigh suas le hathruithe API
Tástáil do chuid eolais
Gníomhairí, uirlisí ionsuite, handoffs: an bhfuil aon phointí dall fágtha ag an API Agents?
1. Cathain is gá gníomhaire—agus cathain is leor chatbot?
Freagra: Tá gníomhaire údaraithe nuair a theastaíonn uirlisí, marthanacht, agus cinntí ilchéime uait; le haghaidh ceisteanna agus freagraí simplí, is leor comhrá caighdeánach—leanann an ailtireacht an riachtanas.
2. Cad a bhainistíonn comhráite marthanacha san API Agents?
Freagra: Stair ar thaobh Mistral: leanann tú comhrá de réir a ID gan an comhthéacs iomlán a athsheoladh—éiríonn an stát ina sheirbhís.
3. Liostaigh na huirlisí ionsuite atá ar fáil agus a n-úsáid.
Freagra: web_search (faisnéis fhíor-ama), code_interpreter (Python a rith), image_generation (íomhánna a chruthú), document_library (ceisteanna agus freagraí ar do chuid comhad)—acmhainní réidh le húsáid, gan aon chur chun feidhme ag teastáil.
4. Conas a oibríonn córas il-ghníomhaire le handoffs?
Freagra: Déanann ródaire cáiliú ar an iarratas agus aistríonn sé chuig an ngníomhaire saineolaí inniúil é; fanann gach gníomhaire simplí, soláthraíonn eagrú clúdach—agus slabhraíonn handoffs i doimhneacht.
5. Conas a dhéanann tú gníomhairí a shlánú sa táirgeadh?
Freagra: Le gardaí ar ionchuir/aschuir, uirlisí atá scópáilte go cúng, inrianaitheacht gníomhaíochta, agus bailíochtú daonna ar chinntí ardstáice—tuilltear neamhspleáchas trí rialú.
Gníomhairí speisialaithe, uirlisí ionsuite, ródú, gardaí: oireann an ailtireacht iomlán i gceithre fhocal—agus thug an cúrsa seo ort gach ceann acu a thógáil.