Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Labākās prakses un turpmākie soļi

Nodarbība 18 no 18 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Ko esi apguvis
  2. Aģentu projektēšana, kas darbojas ilgtermiņā
  3. Kļūdu apstrāde
  4. Notiekošā novērošana
  5. Maršrutēšanas testēšana
  6. Atsauces arhitektūra
  7. Kur doties tālāk
  8. Galvenās atziņas
  9. Pārbaudi savas zināšanas

Ko esi apguvis

Esi izgājis cauri visai Mistral Agents API dokumentācijai. Pirms pāriet pie ražošanas vides prakses, apkoposim galveno, jo katra šī kursa daļa balstās uz iepriekšējo.

Pirmās trīs nodarbības lika pamatus: AI aģents ir autonoma sistēma ar uztveres-darbības ciklu; API balstās uz trim objektiem — Agent, Conversation un Entry; un to, kas atšķir aģentu no čatbota, ir noturība, rīki un nodošana (handoffs). 4. līdz 7. nodarbība padarīja šos objektus lietojamus: aģentu izveide un konfigurēšana ar client.beta.agents.create(), noturīgu sarunu uzturēšana ar conversations.start() un conversations.append(), kā arī tiešā režīma izmantošana bez aģenta, kad veido prototipu un noturība nesniedz pievienoto vērtību.

  1. līdz 11. nodarbība pievienoja jaunas iespējas. web_search nodrošina piekļuvi aktuālai informācijai ar automātiskām atsaucēm; code_interpreter izpilda Python kodu smilškastē, dodot aģentam precīzus rezultātus tur, kur modelis viens pats sniegtu tikai tuvinājumus; image_generation ģenerē vizuālos attēlus no teksta uzdevumiem; document_library integrē RAG (Retrieval-Augmented Generation) taviem pašiem dokumentiem. 12. līdz 16. nodarbība parādīja vairāku aģentu kopīgu darbu: nodošana (handoffs) nodod vadību no viena aģenta otram, atsauces arhitektūra savieno centrālo maršrutētāju ar specializētiem aģentiem, servera režīms automatizē procesus, kamēr klienta režīms ļauj tev saglabāt kontroli, un neierobežota ķēdēšana sadalās lineāros, zvaigžņveida un hibrīdos modeļos. Visbeidzot, 17. nodarbība visu noslēdza ar aizsargbarjerām (guardrails), minimālo privilēģiju principu un augšupējās moderācijas ieviešanu.

Aģentu projektēšana, kas darbojas ilgtermiņā

Viens teikums aptver visu kursu: viens aģents, viena atbildība, viens apraksts, kas norāda, kad to izsaukt. Zemāk redzamais salīdzinājums padara šo atšķirību taustāmu.

# LABI — specializēts aģents ar precīzu aprakstu
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]}]
)

# SLIKTI — vispārīgs, neskaidrs aģents
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"}]
)

Otrais aģents izgāzīsies divos veidos vienlaikus. Neviens maršrutētājs nezinās, kad tam nodot pieprasījumu, jo „palīdzošs aģents” neapraksta nevienu konkrētu situāciju. Un, kad to tomēr izsauc, tā trīs rīki ļauj tam brīvi meklēt informāciju tīmeklī kaut kam, kas bija jāaprēķina, vai ģenerēt attēlu tam, kas bija jāanalizē.

Kļūdu apstrāde

Tīkla izsaukumi agrāk vai vēlāk neizdodas. Atkārtots mēģinājums ar eksponenciālu pauzi (exponential backoff) absorbē pārejošus incidentus, nepārvēršot īslaicīgu palēninājumu redzamā pārtraukumā.

import time

def safe_conversation(agent_id, query, max_retries=3):
    """Saruna ar kļūdu apstrādi un atkārtotu mēģinājumu."""
    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)  # Eksponenciāla pauze
    return None

Eksponenciāla pauze — viena sekunde, tad divas, tad četras — atšķir civilizētu atkārtotu mēģinājumu no servisa „bombardēšanas”, kas jau tā ir pārslodzēts. Ņem vērā arī to, ka pēdējais mēģinājums atkārtoti izraisa izņēmumu, nevis atgriež None: tavam izsaukumam ir jāzina, ka operācija neizdevās.

Notiekošā novērošana

Ražošanas vidē daudzu aģentu darbplūsmu, ko nevari novērot, kļūst neiespējami atkļūdēt. Klienta režīms nodrošina tieši tos āķus, kas tev nepieciešami.

import logging
import time

logger = logging.getLogger("agents")

def monitored_conversation(agent_id, query):
    """Saruna ar monitoringu."""
    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"Pabeigts {duration:.1f}s laikā — {handoff_count} nodošanas, {tool_count} rīki")

    return response

Šie divi skaitītāji ir vērtīgāki, nekā liek domāt to vienkāršība: vidējā nodošanu skaita novirze signalizē par maršrutētāja vilcināšanos; rīku izsaukumu pieaugums norāda uz dārgām vaicājumiem.

Izmaksu kontrole tad reducējas uz konkrētiem lēmumiem. Uzraugi tokenus vienā sarunā, jo tā ir īstā rēķināšanas vienība. Izmanto mistral-medium-latest visur, kur mistral-large-latest nedod nekādu papildu vērtību — pirmais atbalsta līmenis ir klasisks piemērs. Ierobežo max_tokens parametrā completion_args, lai izvairītos no bezgalīgām atbildēm uz vienkāršiem jautājumiem, un atspējo glabāšanu ar store=False, ja noturība nav nepieciešama.

Maršrutēšanas testēšana

Testē daudzu aģentu sistēmu tāpat kā jebkuru komutatoru: padod tai gadījumus, kuru paredzētais galamērķis tev ir zināms, un pārbaudi, kur tie nonāk.

def test_agent_routing():
    """Pārbauda, vai maršrutētājs sadala pieprasījumus pareizi."""
    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"Nepareiza maršrutēšana priekš '{ query}': {target.name} instead of {expected_agent_name}"

Veido šo testu kopu laika gaitā: katrs nepareizi novirzīts pieprasījums, ko pamanīsi ražošanas vidē, kļūst par jaunu rindu test_cases, un tu zināsi, ka apraksta pārrakstīšana salabo konkrēto gadījumu, nesabojājot citus.

Atsauces arhitektūra

Ražošanas projektam ieteicama šāda arhitektūra:

Lietotne
    │
    ▼
Moderatora aģents (filtrē pieprasījumus)
    │
    ▼
Maršrutētāja aģents (sadalīšana specializētajiem aģentiem)
    ├── Meklēšanas aģents (web_search)
    ├── Analīzes aģents (code_interpreter)
    ├── Dokumentu aģents (document_library)
    └── Radīšanas aģents (image_generation)
    │
    ▼
Žurnālēšana + Monitorings + Brīdinājumi

Tā apvieno visu, ko esi apguvis šajā kursā: moderators filtrē pirms jebkādas izpildes, maršrutētājs virza, nekad pats neatbildot, katrs specializētais aģents nes vienu rīku un vienu atbildību, un novērošana aptver visu sistēmu.

Kur doties tālāk

Četri virzieni paplašina to, ko vari darīt tagad. Funkciju izsaukšana (Function calling) ļauj veidot savus pielāgotus rīkus ārpus iebūvētajiem: izsaukt biznesa API, vaicāt datubāzi, aktivizēt iekšēju servisu. MCP serveri integrē Modeļa Konteksta Protokolu (Model Context Protocol), kas standartizē rīku eksponēšanu. Strukturētas izejas piespiež atbildes ievērot JSON shēmu, kas maina visu, ja aģenta izeja baro citu sistēmu, nevis cilvēku lasītāju. Visbeidzot, straumēšana (streaming) atgriež atbildes reāllaikā, nevis vienā blokā — tas ir izšķiroši garās ķēdēs, kur klusa gaidīšana kļūst neērta.

Trīs resursi pavada šo nākamo soli: oficiālā dokumentācija vietnē docs.mistral.ai/agents, Mistral „cookbooks”, kas sniedz pilnus ieviešanas piemērus, un API atsauce, kas detalizēti dokumentē katru galapunktu.

Galvenās atziņas

  • Specializē savus aģentus — viens aģents = viena atbildība
  • Uzraugi — žurnālē katru nodošanu un rīka izpildi
  • Testē — validē maršrutēšanu un katra aģenta atbildes
  • Drošība — aizsargbarjeras, minimālās privilēģijas, augšupējā moderācija
  • Optimizē izmaksas — pareiza izmēra modelis, max_tokens, store=False, kad iespējams
  • Mistral Agents ir beta versijā — seko līdzi API izmaiņām

Pārbaudi savas zināšanas

Aģenti, iebūvētie rīki, nodošana: vai Agents API ir palikušas kādas neredzamas zonas?

1. Kad aģents ir nepieciešams un kad pietiek ar čatbotu?

Atbilde: Aģents ir attaisnojams, ja tev ir nepieciešami rīki, noturība un daudzsoloņu lēmumu pieņemšana; vienkāršiem jautājumiem un atbildēm pietiek ar standarta sarunu — arhitektūra seko vajadzībai.

2. Ko pārvalda noturīgās sarunas Agents API?

Atbilde: Vēsturi Mistral pusē: tu vari turpināt sarunu pēc tās ID, nosūtot visu kontekstu no jauna — stāvoklis kļūst par servisu.

3. Uzskaiti pieejamos iebūvētos rīkus un to pielietojumu.

Atbilde: web_search (informācija reāllaikā), code_interpreter (Python koda izpilde), image_generation (attēlu ģenerēšana), document_library (jautājumi un atbildes par taviem failiem) — gatavas lietošanai iespējas, bez nepieciešamības pēc implementācijas.

4. Kā darbojas daudzu aģentu sistēma ar nodošanu?

Atbilde: Maršrutētājs kvalificē pieprasījumu un nodod to kompetentajam specializētajam aģentam; katrs aģents paliek vienkāršs, orķestrācija nodrošina pārklājumu — un nodošanas veido ķēdes dziļumā.

5. Kā nodrošināt aģentu drošību ražošanas vidē?

Atbilde: Izmantojot aizsargbarjeras ievades/izejas datiem, šauri definētus rīkus, darbību izsekojamību un cilvēka validāciju augsta riska lēmumos — autonomija tiek nopelnīta caur kontroli.

Specializēti aģenti, iebūvētie rīki, maršrutēšana, aizsargbarjeras: pilnīga arhitektūra ietilpst četros vārdos — un šajā kursā tu uzbūvēji katru no tiem.