Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Osvedčené postupy a ďalšie kroky

Lekcia 18 z 18 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Čo si sa naučil
  2. Navrhovanie agentov, ktoré obstoja
  3. Spracovanie chýb
  4. Pozorovanie toho, čo sa deje
  5. Testovanie smerovania
  6. Referenčná architektúra
  7. Kam ďalej
  8. Kľúčové poznatky
  9. Otestuj si svoje vedomosti

Čo si sa naučil

Prešli sme si celým rozhraním API pre agentov Mistral. Predtým, než sa ponoríme do postupov pre nasadenie do produkcie, si to zhrňme, keďže každá časť tohto kurzu nadväzuje na tú predchádzajúcu.

Prvé tri lekcie položili základy: agent umelej inteligencie je autonómny systém so slučkou vnímanie-akcia; API stojí na troch objektoch – Agent, Conversation a Entry; a to, čo oddeľuje agenta od chatbota, je perzistencia, nástroje a odovzdávanie úloh (handoffs). Lekcie 4 až 7 sprístupnili tieto objekty: vytváranie a konfigurácia agentov pomocou client.beta.agents.create(), udržiavanie perzistentných konverzácií pomocou conversations.start() a conversations.append() a používanie priameho režimu bez agenta, keď prototypuješ a perzistencia neprináša žiadnu hodnotu.

Lekcie 8 až 11 pridali nové schopnosti. web_search ti poskytuje prístup k aktuálnym informáciám s automatickými citáciami; code_interpreter spúšťa Python v pieskovisku, čo agentovi poskytuje presné výsledky tam, kde by samotný model len aproximoval; image_generation vytvára vizuály na základe textových promptov; document_library prináša integrované RAG pre tvoje vlastné dokumenty. Lekcie 12 až 16 následne ukázali spoluprácu viacerých agentov: odovzdávanie úloh (handoffs) prenáša kontrolu z jedného agenta na druhého, referenčná architektúra páruje centrálny smerovač so špecialistami, serverový režim automatizuje tam, kde ťa klientský režim necháva v obraze, a neobmedzené reťazenie sa rozkladá na lineárne, hviezdicové a hybridné vzory. Nakoniec, lekcia 17 to všetko uzavrela ochrannými mechanizmami (guardrails), princípom najmenších privilégií a upstream moderáciou.

Jedna veta vystihuje celý kurz: jeden agent, jedna zodpovednosť, jeden popis, ktorý hovorí, kedy ho zavolať. Nasledujúci kontrast robí tento rozdiel hmatateľným.

# DOBRE — špecializovaný agent s presným popisom
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]}]
)

# ZLE — všeobecný, vágny agent
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"}]
)

Druhý agent zlyhá dvoma spôsobmi naraz. Žiadny smerovač nebude vedieť, kedy mu má odovzdať požiadavku, pretože „pomocný agent“ nepopisuje žiadnu konkrétnu situáciu. A keď sa už zavolá, jeho tri nástroje mu umožňujú vyhľadávať na webe niečo, čo mal vypočítať, alebo ilustrovať niečo, čo mal analyzovať.

Spracovanie chýb

Sieťové volania skôr či neskôr zlyhajú. Opakovanie s exponenciálnym oneskorením (exponential backoff) absorbuje prechodné incidenty bez toho, aby sa momentálne spomalenie zmenilo na viditeľný výpadok.

import time

def safe_conversation(agent_id, query, max_retries=3):
    """Conversation with error handling and retry."""
    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)  # Exponential backoff
    return None

Exponenciálne oneskorenie – jedna sekunda, potom dve, potom štyri – odlišuje civilizované opakovanie od bombardovania služby, ktorá už aj tak zápasí. Všimni si tiež, že posledný pokus znova vyhodí výnimku namiesto vrátenia None: tvoj volajúci kód potrebuje vedieť, že operácia zlyhala.

Pozorovanie toho, čo sa deje

V produkcii sa viacagentový pracovný postup, ktorý nemôžeš sledovať, stane nedebugovateľným. Klientský režim ti poskytuje presne tie háčiky, ktoré potrebuješ.

import logging
import time

logger = logging.getLogger("agents")

def monitored_conversation(agent_id, query):
    """Conversation with monitoring."""
    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

Tieto dva počítadlá majú väčšiu hodnotu, než naznačuje ich jednoduchosť: odchýlka v priemernom počte odovzdaní úloh signalizuje váhajúci smerovač; nárast volaní nástrojov ukazuje na nákladné dotazy.

Kontrola nákladov sa potom redukuje na konkrétne rozhodnutia. Sleduj počet tokenov na konverzáciu, keďže to je skutočná zúčtovacia jednotka. Používaj mistral-medium-latest všade tam, kde mistral-large-latest nič nepridáva – prvá úroveň podpory je učebnicovým príkladom. Obmedz max_tokens v completion_args, aby si predišiel nekonečným odpovediam na jednoduché otázky, a vypni ukladanie pomocou store=False, keď nie je vyžadovaná perzistencia.

Testovanie smerovania

Testuj viacagentový systém ako akúkoľvek ústredňu: nakŕm ho prípadmi, ktorých očakávané cieľové miesto poznáš, a over, kde skončia.

def test_agent_routing():
    """Verifies that the router distributes correctly."""
    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úto sadu testov buduj postupom času: každá nesmerovaná požiadavka, ktorú zachytíš v produkcii, sa stane ďalším riadkom v test_cases a budeš vedieť, že prepísanie popisu opraví cielený prípad bez toho, aby sa pokazil iný.

Referenčná architektúra

Pre produkčný projekt je tu odporúčaná architektúra:

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

Spája všetko z tohto kurzu: moderátor filtruje pred akoukoľvek exekúciou, smerovač nasmeruje požiadavku, ale nikdy sám neodpovedá, každý špecialista má jeden nástroj a jednu zodpovednosť a pozorovanie obklopuje celý systém.

Kam ďalej

Štyri smery rozširujú to, čo teraz dokážeš. Function calling ti umožňuje vytvoriť vlastné nástroje nad rámec vstavaných: volanie business API, dotazovanie databázy, spustenie internej služby. MCP Servers integrujú Model Context Protocol, ktorý štandardizuje spôsob vystavovania nástrojov. Štruktúrované výstupy vynucujú odpovede do schémy JSON, čo mení všetko, keď výstup agenta napája iný systém namiesto ľudského čitateľa. Nakoniec, streaming vracia odpovede v reálnom čase namiesto jedného bloku – rozhodujúce pri dlhých reťazcoch, kde sa tiché čakanie stáva nepríjemným.

Tri zdroje sprevádzajú tento ďalší krok: oficiálna dokumentácia na docs.mistral.ai/agents, kuchárske knihy (cookbooks) od Mistral, ktoré poskytujú kompletné príklady implementácie, a Referencia API, ktorá podrobne dokumentuje každý koncový bod.

Kľúčové poznatky

  • Špecializuj svojich agentov – jeden agent = jedna zodpovednosť
  • Monitoruj – loguj každé odovzdanie úlohy a vykonanie nástroja
  • Testuj – overuj smerovanie a odpovede každého agenta
  • Zabezpeč – ochranné mechanizmy, najmenšie privilégiá, upstream moderácia
  • Optimalizuj náklady – model primeranej veľkosti, max_tokens, store=False, keď je to možné
  • Mistral Agents sú v beta verzii – sleduj zmeny v API

Otestuj si svoje vedomosti

Agenti, vstavané nástroje, odovzdávanie úloh: má API pre agentov ešte nejaké slepé miesta?

1. Kedy je agent nevyhnutný a kedy stačí chatbot?

Odpoveď: Agent je opodstatnený, keď potrebuješ nástroje, perzistenciu a viackrokové rozhodovanie; na jednoduché otázky a odpovede stačí štandardná konverzácia – architektúra sa riadi potrebou.

2. Čo spravujú perzistentné konverzácie v API pre agentov?

Odpoveď: História na strane Mistral: konverzáciu pokračuješ podľa jej ID bez opätovného odoslania celého kontextu – stav sa stáva službou.

3. Vymenuj dostupné vstavané nástroje a ich použitie.

Odpoveď: web_search (informácie v reálnom čase), code_interpreter (spustenie Pythonu), image_generation (tvorba obrázkov), document_library (otázky a odpovede na tvoje súbory) – pripravené schopnosti, žiadna implementácia nie je potrebná.

4. Ako funguje viacagentový systém s odovzdávaním úloh?

Odpoveď: Smerovač kvalifikuje požiadavku a odovzdá ju kompetentnému špecializovanému agentovi; každý agent zostáva jednoduchý, orchestrácia poskytuje pokrytie – a odovzdávania sa reťazia do hĺbky.

5. Ako zabezpečíš agentov v produkcii?

Odpoveď: Pomocou ochranných mechanizmov na vstupy/výstupy, úzko vymedzených nástrojov, sledovateľnosti akcií a ľudskej validácie pri rozhodnutiach s vysokými stávkami – autonómia sa získava kontrolou.

Špecializovaní agenti, vstavané nástroje, smerovanie, ochranné mechanizmy: kompletná architektúra sa zmestí do štyroch slov – a v tomto kurze si každý z nich postavil.