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

Dea-chleachtais agus na chéad chéimeanna eile

Ceacht 18 as 18 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An méid a chlúdaigh tú
  2. Gníomhairí a dhearadh a mhaireann
  3. Earráidí a láimhseáil
  4. A fheiceáil cad atá ar siúl
  5. Ródú a thástáil
  6. Ailtireacht Tagartha
  7. Cá dtéigh ina dhiaidh sin
  8. Príomhphointí
  9. Tástáil do chuid eolais

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.