Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Beszélgetések ügynök nélkül

7. lecke 18 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Közvetlen modell mód
  2. Beszélgetés indítása egy modellel
  3. Eszközök hozzáadása közvetlen módban
  4. Dinamikus utasítások átadása
  5. Beszélgetés folytatása közvetlen módban
  6. Ügynök kontra közvetlen mód: Hogyan dönts?
  7. Példa: Kérdés egy kikényszerített kontextusban
  8. Főbb megállapítások

Közvetlen modell mód

Nem mindig kell Ügynök (Agent) objektumot létrehoznod a Conversations API használatához. A Mistral lehetővé teszi, hogy közvetlenül egy modellel indíts beszélgetést, így az ügynök konfigurációs rétege nélkül is biztosítod az adatmegőrzést (persistence). Ez a lehetőség közvetlenül abból az architektúrából következik, amit korábban tárgyaltunk: a beszélgetés független az ügynöktől, így önmagában is tökéletesen működhet.

Több olyan forgatókönyv is van, amikor ez előnyösebb egy regisztrált ügynök használatánál. Lehet, hogy adatmegőrzésre van szükséged anélkül, hogy újrafelhasználható ügynököt definiálnál, például mert az alkalmazásodban minden szál egyedi. Gyorsan tesztelheted a viselkedést beépített eszközökkel, és ha minden próbálkozáshoz létrehozol, majd törlsz egy ügynököt, az lassítja a munkádat. A használati eseted lehet egyszeri: semmi nem indokolja egy olyan konfiguráció elmentését, amit csak egyszer használsz. Vagy az utasításaid lehetnek dinamikusak, futásidőben számítva a felhasználói profil vagy az aktuális dokumentum alapján – ilyen esetben egy statikus ügynök rossz választás lenne.

Beszélgetés indítása egy modellel

Az agent_id átadása helyett közvetlenül egy model paramétert adsz meg:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.conversations.start(
    model="mistral-medium-latest",
    inputs=[
        {"role": "user", "content": "Who is Albert Einstein?"}
    ]
)

print(response.outputs[-1].content)

Minden ezen a paraméterválasztáson múlik. Az agent_id esetén a hívás örökli az ügynök regisztrált konfigurációját: az utasításait, eszközeit és védelmi korlátait (guardrails). A model használata esetén közvetlen módban vagy, és mindent magában a kérésben konfigurálsz – a híváson túlmenően semmi sem marad meg.

Eszközök hozzáadása közvetlen módban

A beépített eszközök nincsenek fenntartva kizárólag az ügynökök számára. A kérésben deklarálod őket, pontosan úgy, ahogy azt az ügynök létrehozásakor tennéd.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[
        {"role": "user", "content": "What are the latest Ligue 1 results?"}
    ],
    tools=[{"type": "web_search"}]
)

Ez funkcionálisan ekvivalens egy web_search eszközzel rendelkező ügynökkel, de konfigurációs adatmegőrzés nélkül. A különbség a tizedik hívásnál mutatkozik meg: ügynök esetén egyszer és mindenkorra megváltoztattad volna a hőmérsékletet (temperature); itt viszont minden kérésben meg kell ismételned, és semmi nem garantálja, hogy a kódodban valahol elfelejtett hívás ugyanazokat a beállításokat használja.

Dinamikus utasítások átadása

Közvetlen módban a rendszerutasítás (system prompt) egy system szerepkörű üzenet formáját ölti, amelyet az inputs lista elejére helyezel.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[
        {"role": "system", "content": "You are an expert in French cuisine. Answer in 3 sentences maximum."},
        {"role": "user", "content": "How do I make a perfect béarnaise sauce?"}
    ]
)

Ez ugyanazt a rugalmasságot biztosítja, mint az ügynök utasításai, de ephemeralis (múló) jellegű – és ami kritikus fontosságú: ez a karakterlánc futásidőben építhető fel, amit egy regisztrált ügynök utasítása nem tesz lehetővé.

Beszélgetés folytatása közvetlen módban

Az adatmegőrzési mechanizmus pontosan úgy működik, mint az ügynököknél: az első hívás visszaad egy conversation_id-t, a subsequent (következő) hívások ehhez kapcsolódnak, és minden hozzáfűzés (append) viszont egy új azonosítót ad vissza.

# Első csere
response1 = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[{"role": "user", "content": "Tell me about the French Revolution."}]
)

# Második csere — a kontextus megmarad
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Who were the main figures?"
)

# A modell tudja, hogy a francia forradalomról beszélünk

A második kérdés nem nevezi meg a tárgyát, és nem is kell: az adatmegőrzés nem az ügynök létezésétől függ, csupán a beszélgetéstől.

Ügynök kontra közvetlen mód: Hogyan dönts?

Akkor hozz létre ügynököt, ha ugyanaz a konfiguráció több beszélgetést is kiszolgál, mert így egyetlen módosítási pontot nyersz: egy utasítás javítása minden jövőbeli szálat frissít. Ez az egyetlen út akkor is, ha az utasításaid munkamenetről munkamenetre stabilak, ha többügynökös átadásokat (handoffs) tervezel – amit a témának szánt lecke részletezni fog –, vagy ha a szervezeted centralizált, auditálható konfigurációt igényel, ahol meg tudod válaszolni a kérdést: „Milyen utasításokkal futtatták ezt a segédet?“

Maradj közvetlen módban a szimmetrikus esetekben: prototípus vagy egyszeri használat, minden beszélgetéssel változó utasítások, nincs szükség átadásokra, vagy ha csökkenteni szeretnéd az API-hívások számát az ügynök létrehozásának és törlésének kiiktatásával. Fejlesztés során ez az utolsó ok gyakran önmagában is elegendő.

Példa: Kérdés egy kikényszerített kontextusban

Az alábbi függvény tökéletesen illusztrálja a közvetlen módot. A kontextus egy argumentum, így minden hívásnál eltér, és a rendszerutasítás erre épül, hogy megakadályozza a modellt a külső tudás felhasználásában. Egyetlen regisztrált ügynök sem hordozhatná ezt a kényszert, mivel az minden meghívással változik.

def ask_question(context: str, question: str):
    """Ask a question within a given context, without creating an agent."""
    response = client.beta.conversations.start(
        model="mistral-large-latest",
        inputs=[
            {"role": "system", "content": f"Context: {context}. Answer using only this context."},
            {"role": "user", "content": question}
        ]
    )
    return response.outputs[-1].content

# Használat
answer = ask_question(
    context="Corsen AI is a French startup specializing in sovereign AI, founded in 2025.",
    question="When was Corsen AI founded?"
)

Használd újra ezt a mintát a saját igényeid szerint a hardcoded kontextus cseréjével a ténylegesen releváns szövegre – a megtekintett terméklapra, a kiválasztott dokumentumrészletre –, és így kapsz egy keretezett kérdés-felelet építőelemet bármilyen adminisztrálandó konfiguráció nélkül.

Főbb megállapítások

  • A beszélgetések indíthatók model= paraméterrel az agent_id= helyett
  • A közvetlen mód adatmegőrzést biztosít az Ügynök konfigurációs rétege nélkül
  • Az eszközök és utasítások közvetlenül átadhatók a kérésben
  • A közvetlen mód ideális prototípusokhoz és egyszeri használatra
  • Az átadásokhoz és újrafelhasználható konfigurációkhoz érdemes ügynököt létrehozni