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

Ailtireacht API Gníomhairí Mistral

Ceacht 3 as 18 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Na Trí Rud Bunúsach
  2. An Rud Gníomhaire
  3. An Rud Comhrá
  4. An Rud Iontráil
  5. Gaol idir Rudaí
  6. Roghanna Comhrá
  7. Príomhphointí

Nuashonraithe an 3 Samhain 2026. Sa sampla gníomhaire iomlán roimhe seo, rith guardrails={"enabled": True}, formáid nach bhfuil ann: is liosta de chumraíochtaí moderation_llm_v2 an paraiméadar oifigiúil. Nochtann ionchur tool.execution ainm an uirlis in entry.name, seachas entry.tool_name, rud a thóg AttributeError roimhe seo. Foinse: Gníomhairí & Comhráite · Maoirseacht & Cosaint · SDK mistralai 3.7.0.

Na Trí Rud Bunúsach

Braitheann API Gníomhairí Mistral ar thrí rud idirghníomhach: Gníomhaire, Comhrá, agus Iontráil. Tagann formhór na mbotún dearaidh a tharlaíonn go luath i dtionscadal—gníomhaire a athchruthú do gach iarratas, conversation_id a bheith caite a athúsáid, nó parsáil freagartha a thuilleann ar iontráil gan choinne—ó mhearbhall idir na trí leibhéal seo. Is réamhriachtanas é a ról agus a ngaol a thuiscint sula scríobhann tú fiú líne amháin cóid.

An Rud Gníomhaire

Is tacar cumraíochta é Gníomhaire a shainíonn iompar an mhúnla. Níl aon sonraí comhrá ann: is teimpléad in-athúsáidte é a chruthaíonn tú uair amháin agus is féidir le mílte comhrá tagairt a dhéanamh dó.

Teastaíonn múnla, ainm, agus cur síos ar a laghad chun é a chruthú.

agent = client.beta.agents.create(
    model="mistral-large-latest",        # Múnla LLM le húsáid
    name="My Agent",                     # Aitheantóir inléite ag an duine
    description="Agent for financial analysis"  # Cur síos atá dírithe ar an tasc
)

Sonraíonn an paraiméadar model an múnla a chumhachtóidh an gníomhaire, roghnaithe as múnlaí críochnaithe comhrá atá ar fáil cosúil le mistral-medium-latest nó mistral-large-latest. Is aitheantóir inléite ag an duine é an name a úsáideann tú chun an gníomhaire a aimsiú agus tagairt a dhéanamh dó: i dtionscadal ina bhfuil fiche ceann acu, is é seo a shábhálann tú ó bheith ag gríobadh trí logaí chun a fháil amach cé acu ceann atá ag freagairt do chustaiméirí. An description, ar an láimh eile, tá sé dírithe ar an tasc agus freastalaíonn sé ar níos mó ná doiciméadú inmheánach amháin—cabhraíonn sé leis an múnla an ról atá ag teastáil uaidh a thuiscint, rud a mhíníonn an frásaíocht “gníomhaire don anailís airgeadais” seachas “gníomhaire uimhir 3” doiléir.

Déantar an chuid eile a chumrú go roghnach, agus is ansin a thógann pearsantacht iarbhír an ghníomhaire cruth.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Complete Agent",
    description="Agent with all parameters",
    instructions="You are a finance expert. Always respond with sources.",
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ],
    completion_args={"temperature": 0.3, "top_p": 0.95},
    guardrails=[
        {
            "block_on_error": True,
            "moderation_llm_v2": {
                "custom_category_thresholds": {"jailbreaking": 0.2, "financial": 1},
                "action": "block",
            },
        }
    ],
)
  • instructions — Leid chórais an ghníomhaire (sainíonn sé a phearsantacht, a rialacha, agus a stíl)
  • tools — Liosta d’uirlisí atá ar fáil: web_search, web_search_premium, code_interpreter, image_generation, document_library, nó feidhmeanna saincheaptha
  • completion_args — Paraiméadair samplóra (teocht, top_p, max_tokens, srl.)
  • guardrails — Liosta de chumraíochtaí maoirseachta (moderation_llm_v2) a chuirtear i bhfeidhm ar theachtaireacht isteach gach comhrá den ghníomhaire; anseo, cuirtear bac ar jailbreaking os cionn 0.2 agus díchumasaítear an catagóir financial (tairseach 1), ós rud é go bhfuil an gníomhaire tógtha chun plé a dhéanamh ar airgeadas. Tá na sonraí sa chúrsa Maoirseacht AI agus Slándáil le Mistral.

Sa sampla thuas, faigheann an gníomhaire airgeadais ceanglas foinsithe óna threoracha, an cumas figiúr a fhíorú óna uirlisí, agus teocht íseal a chuireann teorainn le cruthaitheacht áit a bhfuil rigear ag teastáil.

An Rud Comhrá

Is é an Comhrá stair na n-idirghníomhaíochtaí idir úsáideoir agus gníomhaire—nó idir úsáideoir agus múnla amháin. Tá teachtaireachtaí, torthaí feidhmiú uirlisí, agus imeachtaí aistrithe láimhe ann.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Analyze trends in the European AI market."
)

# Faigh an ID comhrá chun leanúint ar aghaidh níos déanaí
conversation_id = response.conversation_id

Tá roinnt iontas i ngiompar an ruda seo. Tá an comhrá buanmharfach: stóráiltear an stair ar thaobh Mistral, mura ndéanann tú store=False a rith. Tá sé neamhspleách ar an ngníomhaire, rud a chiallaíonn go bhféadfadh comhrá a bheith ann go foirfe gan gníomhaire, i mód múnla díreach. Ar deireadh, tá sé do-athraithe: cruthaíonn gach breiseán nua conversation_id, agus fanann an sean-cheann inrochtana. Is é an pointe deireanach seo an ceann is iontaí: má stórálann tú an t-ID tosaigh i do bhunachar sonraí agus má athúsáideann tú é ar an tríú casadh, rachaidh tú ar ais go dtí comhthéacs an chéad mhalartaithe.

An Rud Iontráil

Is gníomh aonair laistigh de chomhrá é Iontráil: an t-aonad adamhach den stair. Nuair a fhaigheann tú freagra, tá liosta d’iontrálacha sa réimse outputs a bhraitheann a gcineál ar an méid a rinne an gníomhaire. Iompraíonn iontráil message.output freagra téacs ón ngníomhaire, i.e. an téacs a thaispeánfaidh do chomhéadan. Iompraíonn iontráil tool.execution toradh feidhmiú uirlise, cosúil le cód nó cuardach gréasáin: an script a seoladh agus a aschur, nó na leathanaigh a thug an t-inneall ar ais. Cuireann iontráil agent.handoff imeacht aistrithe chuig gníomhaire eile in iúl, agus mar sin ní fheictear é ach i gcásanna il-ghníomhaire.

Is minic a mheascann freagra amháin na cineálacha seo. Iarr ar ghníomhaire uirlisithe ríomh a dhéanamh agus gheobhaidh tú an fheidhmiú, agus ansin an trácht a ghabhann leis: caithfidh do chód dul tríd an liosta seo dá bhrí sin seachas réimse amháin a léamh.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Calculate the square root of 144"
)

for entry in response.outputs:
    print(f"Type: {entry.type}")
    if entry.type == "message.output":
        print(f"Message: {entry.content}")
    elif entry.type == "tool.execution":
        print(f"Tool: {entry.name}")

Gaol idir Rudaí

Déanann an léaráid seo a leanas achoimre ar altú na dtrí leibhéal: cumraíocht in-athúsáidte, snáithe staire, agus gníomhaíochtaí aonaid.

Agent (configuration)
  ├── model, instructions, tools, guardrails
  └── Can be referenced by N conversations

Conversation (history)
  ├── Linked to 0 or 1 Agent (optional)
  ├── Contains N ordered entries
  └── Each append creates a new conversation_id

Entry (unit action)
  ├── message.output (text response)
  ├── tool.execution (tool result)
  └── agent.handoff (agent transfer)

Roghanna Comhrá

Glacann tosú comhrá le socruithe a imríonn tionchar ar do chomhlíonadh chomh maith le do ailtireacht, agus is fearr iad a chinneadh ná fulaingt leo. Stóráil ar dtús: coscaíonn store=False aon sábháil ar thaobh Mistral, rud a úsáidfidh tú chun sonraí a phróiseáil a chuireann do bheartas inmheánach cosc orthu fágáil ar fhreastalaí tríú páirtí.

# Díchumasaigh stóráil scamall
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Sensitive question",
    store=False
)

Sainíonn an dara socruithe cé a fheidhmíonn aistrithe láimhe. I mód server, an luach réamhshocraithe, déanann Mistral slabhrú aistrithe gníomhaire gan do rannpháirtíocht; i mód client, faigheann tú imeachtaí handoff agus coinníonn tú smacht chun iad a logáil, a scagadh, nó a dhiúltú.

# Mód freastalaí (réamhshocraithe) — Láimhseálann Mistral aistrithe go huathoibríoch
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Complex request",
    handoff_execution="server"
)

# Mód cliant — Faigheann tú imeachtaí aistrithe agus déanann tú cinneadh cad le déanamh
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Complex request",
    handoff_execution="client"
)

Príomhphointí

  • Gníomhaire = cumraíocht in-athúsáidte (múnla, treoracha, uirlisí, guardrails)
  • Comhrá = stair bhuanmharfach stóráilte ar an bhfreastalaí, neamhspleách ar an ngníomhaire
  • Iontráil = gníomh aonaid (teachtaireacht, feidhmiú uirlise, aistriú láimhe)
  • Is féidir le comhráite a bheith ann gan gníomhaire (mód múnla díreach)
  • Cruthaíonn gach breiseán le comhrá nua conversation_id
  • Coscaíonn an mód store=False stóráil ar thaobh Mistral