Salt la conținutul principal
Română— Alege o limbă
Meniu

Conversații fără un Agent

Lecția 7 din 18 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Modul Model Direct
  2. Inițierea unei conversații cu un model
  3. Adăugarea instrumentelor în modul direct
  4. Transmiterea instrucțiunilor dinamice
  5. Continuarea unei conversații în modul direct
  6. Agent vs. Mod direct: Cum să decideți
  7. Exemplu: Întrebare într-un context forțat
  8. Puncte cheie

Modul Model Direct

Nu aveți întotdeauna nevoie să creați un obiect Agent pentru a utiliza API-ul Conversations. Mistral vă permite să începeți o conversație direct cu un model, oferindu-vă persistență fără stratul de configurare al Agentului. Această capacitate decurge direct din arhitectura prezentată anterior: conversația este independentă de agent, așa că poate exista perfect de sine stătător.

Mai multe scenarii fac această abordare preferabilă utilizării unui agent înregistrat. Este posibil să doriți persistență fără a defini un agent reutilizabil, de exemplu, deoarece fiecare fir de discuție din aplicația dumneavoastră este unic. Este posibil să testați rapid comportamentul cu instrumente integrate, iar crearea și ștergerea unui agent pentru fiecare încercare vă încetinește. Cazul dumneavoastră de utilizare ar putea fi ocazional: nimic nu justifică salvarea unei configurații pe care o veți folosi o singură dată. Sau instrucțiunile dumneavoastră ar putea fi dinamice, calculate în timpul execuției pe baza profilului utilizatorului sau a documentului curent – caz în care un agent static ar fi instrumentul nepotrivit.

Inițierea unei conversații cu un model

În loc să transmiteți un agent_id, transmiteți direct un model:

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)

Totul depinde de această alegere a parametrului. Cu agent_id, apelul moștenește configurația înregistrată a agentului: instrucțiunile, instrumentele și barierele de securitate ale acestuia. Cu model, sunteți în mod direct și configurați totul în cadrul cererii însăși – nimic nu este reținut dincolo de apel.

Adăugarea instrumentelor în modul direct

Instrumentele integrate nu sunt rezervate agenților. Le declarați în cerere, exact așa cum ați face la crearea unui agent.

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

Acest lucru este funcțional echivalent cu un agent dotat cu web_search, dar fără persistența configurației. Diferența apare la al zecelea apel: cu un agent, ați fi modificat temperatura o dată pentru totdeauna; aici, trebuie să o repetați în fiecare cerere și nimic nu garantează că un apel uitat undeva în codul dumneavoastră folosește aceleași setări.

Transmiterea instrucțiunilor dinamice

În modul direct, promptul de sistem ia forma unui mesaj system plasat la începutul intrărilor.

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?"}
    ]
)

Acest lucru vă oferă aceeași flexibilitate ca și instrucțiunile agentului, dar efemeră – și, crucial, acest șir poate fi construit în timpul execuției, lucru pe care o instrucțiune de agent înregistrat nu îl permite.

Continuarea unei conversații în modul direct

Mecanismul de persistență funcționează exact ca în cazul unui agent: primul apel returnează un conversation_id, apelurile ulterioare se atașează la acesta, iar fiecare adăugare returnează la rândul său un nou identificator.

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

# Al doilea schimb — contextul este păstrat
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Who were the main figures?"
)

# Modelul știe că vorbim despre Revoluția Franceză

A doua întrebare nu își numește subiectul și nici nu are nevoie de acesta: persistența nu depinde de existența unui agent, ci doar de conversație.

Agent vs. Mod direct: Cum să decideți

Creați un agent de îndată ce aceeași configurație servește mai multor conversații, deoarece obțineți astfel un singur punct de modificare: corectarea unei instrucțiuni actualizează toate firele de discuție viitoare. Aceasta este, de asemenea, singura cale dacă instrucțiunile dumneavoastră sunt stabile de la o sesiune la alta, dacă planificați transferuri între mai mulți agenți – ceea ce lecția dedicată acestui subiect va detalia – sau dacă organizația dumneavoastră necesită o configurație centralizată și auditabilă, unde puteți răspunde la întrebarea: „Cu ce instrucțiuni a fost executat acest asistent?“.

Rămâneți în modul direct pentru cazurile simetrice: un prototip sau o utilizare ocazională, instrucțiuni care se schimbă la fiecare conversație, fără nevoie de transferuri sau dorința de a reduce apelurile API prin eliminarea creării și ștergerii agenților. În dezvoltare, acest ultim motiv este adesea suficient de unul singur.

Exemplu: Întrebare într-un context forțat

Funcția de mai jos ilustrează perfect modul direct. Contextul este un argument, deci diferă la fiecare apel, iar promptul de sistem este construit în jurul său pentru a împiedica modelul să se bazeze pe cunoștințe externe. Niciun agent înregistrat nu ar putea prelua această constrângere, deoarece se schimbă la fiecare invocare.

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

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

Reutilizați acest model pentru propriile nevoi înlocuind contextul hardcodat cu textul efectiv relevant – fișa produsului vizualizată, extrasul din documentul selectat – și obțineți un bloc de construcție pentru întrebări și răspunsuri încadrate, fără nicio configurație de administrat.

Puncte cheie

  • Conversațiile pot fi inițiate cu model= în loc de agent_id=
  • Modul direct oferă persistență fără stratul de configurare al Agentului
  • Puteți transmite instrumente și instrucțiuni direct în cerere
  • Modul direct este ideal pentru prototipare și utilizări ocazionale
  • Pentru transferuri și configurații reutilizabile, preferați crearea unui agent