RunContext: Bainistigh an Cliant MCP agus an Gníomhaire
Ar an leathanach seo
An stiúrthóir do ghníomhaire
Is é an RunContext an chomhpháirt a choinníonn gach rud le chéile. Nascann sé do ghníomhaire AI le freastalaithe MCP agus bainistíonn sé a dtimthriall saoil iomlán: nascadh le freastalaithe, clárú uirlisí, comhráite a fhorghníomhú, torthaí a fháil, agus múchadh glan. Sa Mistral SDK, tá sé i bhfoirm bainisteora comhthéacs neamhshioncrónaigh a chuimsíonn an loighic seo go léir. Osclaíonn tú bloc, dearbhaíonn tú cad atá ceadaithe don ghníomhaire a úsáid, déanann tú do chomhrá, agus dúnann gach rud go huathoibríoch nuair a fhágann tú an bloc.
Cruthaigh an gníomhaire
Ní chruthaíonn an RunContext an gníomhaire; ceanglaíonn sé le ceann atá ann cheana. Mar sin, is é do chéad chéim ná gníomhaire a shamhlú tríd an API.
from mistralai.client import Mistral
# Tosaigh an cliant Mistral
client = Mistral(api_key="YOUR_API_KEY")
# Cruthaigh gníomhaire
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="assistant-mcp",
instructions="You are an assistant capable of using MCP tools.",
)
print(f"Agent created: {agent.id}")
Is eintiteas buan ar thaobh Mistral é an gníomhaire seo: tá samhail, ainm, agus treoracha córais aige, agus mairfidh sé thar do script. Ní cheanglaítear uirlisí MCP leis an ngníomhaire, áfach. Ina ionad sin, soláthraíonn an RunContext iad go dinimiciach ag gach forghníomhú. Ligeann an díthiomsú seo duit an gníomhaire céanna a rith le huirlisí éagsúla ag brath ar an gcomhthéacs.
Oscail an comhthéacs
Úsáideann tú RunContext le async with, rud a ráthaíonn scaoileadh acmhainní fiú má tharlaíonn eisceacht.
from mistralai.extra.run.context import RunContext
from pydantic import BaseModel
# Roghnach: sainigh formáid aschuir struchtúrtha
class WeatherResult(BaseModel):
location: str
temperature: float
description: str
async with RunContext(
agent_id=agent.id,
output_format=WeatherResult, # Formáid struchtúrtha (roghnach)
continue_on_fn_error=True, # Lean ar aghaidh má theipeann ar uirlis
) as run_ctx:
# Anseo, cláraigh cliain MCP agus tosaigh comhráite
pass
Rialaíonn trí pharaiméadar an iompar seo. Sonraíonn agent_id an gníomhaire a chruthaigh tú cheana. Glacann output_format le samhail Pydantic agus sriantaíonn sé an freagairt dheireanach leis an struchtúr sin – luachmhar nuair a bhíonn an t-aschur ag beathú clár eile seachas duine. Ar deireadh, cinneann continue_on_fn_error cad a tharlaíonn don chomhrá nuair a ardaíonn uirlis earráid: má tá sé socraithe ar True, leanann an comhthéacs ar aghaidh, agus faigheann an tsamhail an teachtaireacht earráide díreach mar a gheobhadh sí toradh.
Cláraigh cliant MCP
Nuair a bheidh an comhthéacs oscailte, dearbhaíonn tú do chliaint MCP laistigh de.
from mcp import StdioServerParameters
from mistralai.extra.mcp.stdio import MCPClientSTDIO
# Cumraigh an freastalaí áitiúil
server_params = StdioServerParameters(
command="python",
args=["weather_server.py"],
)
mcp_client = MCPClientSTDIO(stdio_params=server_params)
async with RunContext(
agent_id=agent.id,
continue_on_fn_error=True,
) as run_ctx:
# Cláraigh an cliant MCP
await run_ctx.register_mcp_client(mcp_client=mcp_client)
Triggers an glao aonair seo ar register_mcp_client seicheamh iomlán: próiseas an fhreastalaí a sheoladh i mód STDIO, cumais a idirbheartú, liosta na n-uirlisí a fháil, agus na huirlisí sin a chur ar fáil don tsamhail le haghaidh comhráite atá le teacht. Ní gá duit aon chuid de seo a scríobh de láimh.
Níl tú teoranta d’aon fhreastalaí amháin ach oiread. Is féidir le RunContext amháin foinsí iolracha a thiomsú, agus feiceann an tsamhail aontas a n-uirlisí mar chatalóg amháin:
async with RunContext(agent_id=agent.id) as run_ctx:
await run_ctx.register_mcp_client(mcp_client=mcp_client_weather)
await run_ctx.register_mcp_client(mcp_client=mcp_client_github)
await run_ctx.register_mcp_client(mcp_client=mcp_client_calendar)
Cuir feidhmeanna áitiúla leis
Ní gá gach cumas a bheith ina fhreastalaí MCP. Maidir le feidhm ghairid atá sonrach don script seo, tá an maisitheoir register_func leordhóthanach chun í a nochtadh don tsamhail mar ghnáthuirlis.
import random
async with RunContext(agent_id=agent.id) as run_ctx:
await run_ctx.register_mcp_client(mcp_client=mcp_client)
@run_ctx.register_func
def get_user_location(username: str) -> str:
"""Retrieves a user's location.
Args:
username: The username
Returns:
The user's city
"""
locations = {"alice": "Paris", "bob": "Lyon", "charlie": "Marseille"}
return locations.get(username, "Unknown")
Ó thaobh na samhla de, níl aon difríocht ann: ní fheiceann sí ach uirlis amháin eile. Is duitse atá an difríocht – rithtear na feidhmeanna seo i do phróiseas Python, gan freastalaí seachtrach, mar sin ní féidir iad a athúsáid taobh amuigh den script seo.
Tosaigh an comhrá
Nuair a bheidh an comhthéacs líonta, ní fhanann ach labhairt.
async with RunContext(agent_id=agent.id) as run_ctx:
await run_ctx.register_mcp_client(mcp_client=mcp_client)
# Forghníomhú sioncrónach (fanann sé leis an bhfreagairt iomlán)
run_result = await client.beta.conversations.run_async(
run_ctx=run_ctx,
inputs="What is the weather in Paris?",
)
print(run_result.output)
Taobh thiar den ghlao seo, déanann an tsamhail an cheist a anailísiú, consultálann sí na huirlisí atá ar fáil – ó fhreastalaithe MCP agus ó fheidhmeanna áitiúla araon –, glaonn sí ar na cinn a mheasann sí atá riachtanach, agus ansin dréachtaíonn sí a freagairt bunaithe ar na torthaí a fuarthas.
Seo mar a fhéachann an timthriall iomlán:
1. Cruthaigh an gníomhaire (client.beta.agents.create)
↓
2. Oscail an RunContext (async with RunContext)
↓
3. Cláraigh cliain MCP (register_mcp_client)
↓
4. Cláraigh feidhmeanna áitiúla (register_func)
↓
5. Tosaigh comhráite (conversations.run_async)
↓
6. Glantachán uathoibríoch (deireadh an bhainisteora comhthéacs)
Nuair a fhágann tú an bloc, stopann an comhthéacs gach próiseas freastalaí STDIO a sheol sé – gan próisis Python dílleachta fágtha ar crochadh tar éis eisceachta.
Focal deireanach ar continue_on_fn_error=True, a bhfuil a luach is soiléire i dtáirgeadh. Gan é, briseann an earráid is lú in uirlis an comhrá iomlán, ag fágáil an úsáideora ag breathnú ar eisceacht. Leis, faigheann an tsamhail an earráid go soiléir agus tá spás aige chun gníomhú: is féidir leis a iarratas a athfhrámaíl le hargóintí difriúla, titim siar ar uirlis eile, nó míniú simplí a thabhairt don úsáideoir ar cad a theip. Tá gníomhaire a deir “níl an tseirbhís aimsire ag freagairt” i bhfad níos fearr ná gníomhaire a thuairteálann.
Príomhphointí
- Déanann an RunContext ceolfhoireann ar an gcumarsáid idir an gníomhaire agus freastalaithe MCP
- Úsáid é mar bhainisteoir comhthéacs
async with - Nascann
register_mcp_clientfreastalaí MCP agus aimsíonn sé a chuid uirlisí - Cláraíonn
register_funcfeidhmeanna Python áitiúla mar uirlisí - Cinntíonn
continue_on_fn_error=Trueathléimneacht do ghníomhaire - Tá an sruth oibre iomlán neamhshioncrónach (async/await)