Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Keskustelut ilman agenttia

Oppitunti 7 / 18 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Suora mallitila
  2. Keskustelun aloittaminen mallilla
  3. Työkalujen lisääminen suorassa tilassa
  4. Dynaamisten ohjeiden välittäminen
  5. Keskustelun jatkaminen suorassa tilassa
  6. Agentti vs. suora tila: miten päättää
  7. Esimerkki: Kysymys pakotetussa kontekstissa
  8. Keskeiset asiat

Suora mallitila

Sinun ei tarvitse aina luoda Agent-oliota käyttääksesi Conversations API:a. Mistral antaa sinun aloittaa keskustelun suoraan mallin kanssa, mikä tarjoaa pysyvyyden ilman agentin konfigurointikerrosta. Tämä ominaisuus seuraa suoraan aiemmin käsittelemästämme arkkitehtuurista: keskustelu on riippumaton agentista, joten se voi hyvin olla olemassa itsenäisesti.

Useat tilanteet tekevät tästä paremman vaihtoehdon kuin rekisteröidyn agentin käytön. Saat saatat haluta pysyvyyttä määrittelemättä uudelleenkäytettävää agenttia, esimerkiksi siksi, että jokainen säikeesi sovelluksessasi on ainutlaatuinen. Saat saatat testata nopeasti toimintaa sisäänrakennetuilla työkaluilla, ja agentin luominen ja poistaminen jokaista koetta varten hidastaa työskentelyäsi. Käyttötapauksesi saattaa olla kertaluonteinen: mikään ei oikeuta konfiguraation tallentamista, jota käytät vain kerran. Tai ohjeistuksesi saattavat olla dynaamisia, laskettuna ajonaikaisesti käyttäjän profiilin tai nykyisen asiakirjan perusteella – jolloin staattinen agentti olisi väärä työkalu.

Keskustelun aloittaminen mallilla

agent_id:n välittämisen sijaan välität suoraan model:n:

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)

Kaikki riippuu tästä parametrivalinnasta. agent_id:n kanssa kutsu perii agentin rekisteröidyn konfiguraation: sen ohjeet, työkalut ja suojaukset. model:n kanssa olet suorassa tilassa ja määrität kaiken itse pyynnössä – mitään ei muisteta kutsun yli.

Työkalujen lisääminen suorassa tilassa

Sisäänrakennetut työkalut eivät ole varattuja vain agenteille. Määrität ne pyynnössä täsmälleen samalla tavalla kuin agenttia luodessa.

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

Tämä on toiminnallisesti ekvivalentti agentin kanssa, jossa on web_search, mutta ilman konfiguraation pysyvyyttä. Ero näkyy kymmenennellä kutsulla: agentin kanssa olisit muuttanut lämpötilan kerran ja lopullisesti; tässä sinun on toistettava se jokaisessa pyynnössä, eikä mikään takaa, että jossain koodissasi unohtunut kutsu käyttäisi samoja asetuksia.

Dynaamisten ohjeiden välittäminen

Suorassa tilassa järjestelmäkehotus ottaa muodon system-viesti, joka sijoitetaan syötteiden alkuun.

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

Tämä antaa sinulle saman joustavuuden kuin agentin ohjeet, mutta ne ovat ohimeneviä – ja mikä tärkeintä, tämä merkkijono voidaan rakentaa ajonaikaisesti, mitä rekisteröity agentin ohjeistus ei salli.

Keskustelun jatkaminen suorassa tilassa

Pysyvyysmekanismi toimii täsmälleen samoin kuin agentin kanssa: ensimmäinen kutsu palauttaa conversation_id:n, myöhemmät kutsut kiinnittyvät siihen, ja jokainen liittäminen palauttaa vuorostaan uuden tunnisteen.

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

# Toinen vaihto – konteksti säilyy
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Who were the main figures?"
)

# Malli tietää, että puhumme Ranskan vallankumouksesta

Toinen kysymys ei nimeä aihettaan eikä sen tarvitse: pysyvyys ei riipu agentin olemassaolosta, vaan ainoastaan keskustelusta.

Agentti vs. suora tila: miten päättää

Luo agentti heti, kun sama konfiguraatio palvelee useita keskusteluja, sillä silloin saat yhden muutoskohdan: ohjeen korjaaminen päivittää kaikki tulevat säikeet. Tämä on myös ainoa reitti, jos ohjeesi ovat vakaita istunnosta toiseen, jos suunnittelet usean agentin siirtoja – mitä aihetta käsittelevä oppitunti yksityiskohtaistaa – tai jos organisaatiosi vaatii keskitettyä, auditoitavaa konfiguraatiota, jossa voit vastata kysymykseen: “Millä ohjeilla tätä avustajaa suoritettiin?”

Pysy suorassa tilassa symmetrisissä tapauksissa: prototyyppi tai kertaluonteinen käyttö, ohjeet, jotka muuttuvat jokaisessa keskustelussa, ei tarvetta siirroille, tai halu vähentää API-kutsuja poistamalla agentin luominen ja poistaminen. Kehitysvaiheessa tämä viimeinen syy on usein riittävä itsessään.

Esimerkki: Kysymys pakotetussa kontekstissa

Alla oleva funktio havainnollistaa suoraa tilaa täydellisesti. Konteksti on argumentti, joten se eroaa jokaisessa kutsussa, ja järjestelmäkehotus rakennetaan sen ympärille estämään mallia hyödyntämästä ulkoista tietoa. Mikään rekisteröity agentti ei voisi kantaa tätä rajoitusta, koska se muuttuu jokaisessa kutsussa.

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

Uudelleenkäytä tätä mallia omiin tarpeisiisi korvaamalla kovakoodattu konteksti todella relevantilla tekstillä – katsotulla tuotekortilla, valitulla asiakirjan otteella – ja saat rajatun kysymys-vastaus-rakennuspalan ilman hallinnoitavaa konfiguraatiota.

Keskeiset asiat

  • Keskustelut voidaan aloittaa käyttämällä model= agent_id=:n sijaan
  • Suora tila tarjoaa pysyvyyden ilman Agent-konfigurointikerrosta
  • Voit välittää työkaluja ja ohjeita suoraan pyynnössä
  • Suora tila on ihanteellinen prototyyppaukseen ja kertaluonteiseen käyttöön
  • Siirtoja ja uudelleenkäytettäviä konfiguraatioita varten suosi agentin luomista