Koodiagentit käytännössä: API, Vibe Code CLI ja Vibe Code Web
Tällä sivulla
Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Koska Devstral poistettiin APIsta 31. heinäkuuta 2026, tässä olevat API-esimerkit käyttävät Mistral Small 4 -mallia. Vibe-osio heijastaa nykyistä Vibe Code -dokumentaatiota: asennus, sisäänrakennettu malli (Mistral Medium 3.5) ja kolme käyttöliittymää – CLI, VS Code -laajennus ja Vibe Code Web. Lähteet: Asennus ja käyttöönotto · Valitse CLI, VS Code tai web-istunnot · Konfiguraatio.
Kolme tapaa saada agentti töihin
Agenttimalli on yhtä hyvä kuin tapa, jolla yhdistät sen todelliseen työhön. Mistral tarjoaa kolme polkua: API, jossa rakennat oman agenttisi; Vibe Code paikallisesti päätteesi terminaalissa tai VS Codessa; sekä Vibe Code Web, joka suorittaa agentin etäpesähdyksessä (sandbox) GitHub-varastoa vasten. Jokainen sopii kehittäjän päivän eri vaiheisiin.
Mistral API:n kautta
API on joustavin käyttöliittymä: sen avulla voit rakentaa omia agenttityönkulkuja omilla työkaluillasi ja ohjauslogiikallasi. Aloita yksinkertaisimmasta tapauksesta, chat-kutsusta ilman työkaluja. Tässä lähetämme haavoittuvan tunnistautumisfunktion Mistral Small 4:lle ja pyydämme diagnoosia. Asetus temperature=0 ei ole koristeellinen: tietoturva-analyysissä haluat toistettavia tuloksia, et vaihtelua ajosta toiseen.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
response = client.chat.complete(
model="mistral-small-2603",
messages=[
{
"role": "system",
"content": "You are an expert development agent. Analyze the provided code and propose improvements."
},
{
"role": "user",
"content": """Here is a Python file that handles authentication.
Identify security issues and propose fixes:
def login(username, password):
query = f"SELECT * FROM users WHERE username='{username}' AND password='{password}'"
user = db.execute(query).fetchone()
if user:
session['user_id'] = user['id']
return True
return False
"""
}
],
temperature=0,
max_tokens=2000,
)
print(response.choices[0].message.content)
Agenttitila muuttaa vuorovaikutuksen luonnetta. Tekstin vastaanottamisen sijaan määrittelet työkalut, joita malli voi pyytää kutsumaan, ja malli palauttaa tool_calls-objektin – työkalun nimen ja sen argumentit. Alla olevat kolme työkalua muodostavat koodiagentin minimaalisen perustan: lue tiedosto, kirjoita tiedosto, suorita komento. Niiden avulla ohje “lisää tyyppivihjeet kaikkiin src/utils/-hakemiston tiedostoihin” muuttuu suoritettavaksi, kun taas chat-tilassa se jäisi pelkäksi ehdotukseksi.
tools = [
{
"type": "function",
"function": {
"name": "read_file",
"description": "Read the contents of a source file",
"parameters": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Relative path to the file"
}
},
"required": ["path"]
}
}
},
{
"type": "function",
"function": {
"name": "write_file",
"description": "Write content to a file",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}
},
{
"type": "function",
"function": {
"name": "run_command",
"description": "Execute a shell command",
"parameters": {
"type": "object",
"properties": {
"command": {"type": "string"}
},
"required": ["command"]
}
}
}
]
response = client.chat.complete(
model="mistral-small-2603",
messages=[
{
"role": "user",
"content": "Explore the project and add Python type hints to all files in the src/utils/ directory"
}
],
tools=tools,
tool_choice="auto",
)
# Process the tool calls returned by the model
for tool_call in response.choices[0].message.tool_calls:
print(f"Tool: {tool_call.function.name}")
print(f"Arguments: {tool_call.function.arguments}")
Huomaa, että mikään ei suoriteta itsestään: silmukka – kutsu työkalua, palauta tuloste mallille, pyydä seuraavaa vaihetta – on täysin sinun vastuullasi. Tämä on joustavuuden hinta, ja juuri tämän Vibe CLI hoitaa puolestasi.
Vibe Code paikallisesti: CLI ja VS Code -laajennus
Vibe Code on Viben, Mistralin agentin, “code”-tila. Paikallisesti sitä on kahta muotoa, jotka jakavat saman moottorin, konfiguraation ja istuntohistorian: CLI terminaalissasi ja VS Code -laajennus, joka lisää editorikontekstin (aktiivinen tiedosto, valinta, erot). CLIn asentaminen vie yhden rivin macOS- ja Linux-järjestelmissä:
# Virallinen asennusohjelma (asentaa uv:n tarvittaessa, sitten mistral-vibe-paketin)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Tai manuaalinen asennus
uv tool install mistral-vibe
Siirry sitten projektiisi ja suorita vibe. Ensimmäisellä käynnistyksellä ohjattu toiminto kehottaa kirjautumaan Mistral-tililläsi (Vibe Code sisältyy suunnitelmiin, käyttörajat riippuvat suunnitelmasta) tai syöttämään API-avaimen. Tämän jälkeen keskustelet agentin kanssa kuin kollegan kanssa, jolla on kädet näppäimistöllä:
Explain this project's architecture.
Add an API route /health that returns the server status, along with its test.
Run the test suite and fix what fails.
Vibe tarjoaa työkalut itse (tiedoston luku/kirjoitus, shell-komennot) ja agenttisilmukan, joka sinun piti kirjoittaa käsin API:a käytettäessä. Se toimitetaan sisäänrakennetun mallin, Mistral Medium 3.5:n, kanssa, ja /model-komennolla voit valita toisen määritetyistä malleista (Small 4, Codestral, paikallinen malli…). Muutokset ja komennot kulkevat hyväksymisjärjestelmän läpi, jonka määrität agenttikohtaisesti: tarkista ne ennen kuin luotat agenttiin tärkeän varaston kanssa. Automaatiota varten vibe --prompt suorittaa ei-vuorovaikutteisen suorituksen, mikä on hyödyllistä jatkuvassa integraatiossa.
Vibe Code Webin kautta
Vibe Code Web on kolmas käyttöliittymä: ohjaamo etäagenteille. Luot projektin yhdestä tai useammasta GitHub-varastosta saman omistajan alaisuudessa, käynnistät istunnon tarkalla ohjeella, ja agentti työskentelee pilven hallinnoimassa pesähdyksessä: se kloonaa, suunnittelee, muokkaa, suorittaa komentoja ja testejä, ja valmistelee sitten haaran tai vetopyynnön (pull request), jonka voit tarkistaa GitHubissa. Paikallista kopiota ei tarvita, ja koneesi voi pysyä suljettuna agentin työskennellessä. CLI:stä /teleport-komento siirtää käynnissä olevan istunnon webiin.
Valitse CLI tai laajennus, kun tehtävä riippuu tiedostoista, palveluista tai salaisuuksista, jotka ovat vain koneellasi.
Kolmen polun vertailu
| Kriterio | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Agenttisilmukka | Sinä kirjoitat sen | Sisäänrakennettu | Sisäänrakennettu |
| Tiedostojen käyttö | Työkalujesi kautta | Paikallinen työskentelykopio | Etäpesähdys, GitHub-varasto |
| Malli | Kutsumasi malli | Medium 3.5 sisäänrakennettu, muut valinnaisia | Vibe Code -moottori |
| Ei-vuorovaikutteinen tila | Kyllä | Kyllä (vibe --prompt, vain CLI) | Ei |
| Käyttötarkoitus | Putket, räätälöidyt tuotteet | Päivittäinen kehitys | Pitkäkestoiset tehtävät etävarastossa |
Luettuna oikealta vasemmalle tämä taulukko kuvaa kontrollin gradienttia: mitä enemmän siirryt kohti API:a, sitä enemmän päätät kaikesta, mukaan lukien siitä, mikä voi mennä rikki.
Mikä tekee eron käytännössä
Tulosten laatu riippuu vähemmän mallista kuin siitä, miten muotoilet pyyntösi. “Lisää validointi” jättää agentin keksimään sijainnin, tyylin ja säännöt; “Lisää sähköpostin validointi tiedostoon src/auth/validators.py käyttäen olemassa olevaa mallia” antaa sille tiedoston, käytännön ja rajat. Samassa hengessä mainitse eksplisiittisesti asiaankuuluvat tiedostot ja projektin rajoitukset sen sijaan, että toivoisit niiden arvaavan ne.
Varmistus pysyy ehdottomana: päteväkin agentti voi tuoda regressioita, erityisesti koskettaessaan useita tiedostoja kerralla. Tee tavaksi tarkistaa erot (diff) ennen hyväksymistä, aivan kuten tekisit uuden työntekijän vetopyynnön kanssa. Ja pidä mielessäsi lopullinen asetus: oikean työkalun valinta. Käytä Vibe Codea paikallisesti päivittäiseen kehitykseen, Vibe Code Webiä pitkäkestoisiin tehtäviin etävarastossa ja API:a omiin putkiisi.
Keskeiset asiat
- API antaa täyden kontrollin: kirjoitat työkalut ja agenttisilmukan itse
- Vibe Code asennetaan komennolla
curl -LsSf https://mistral.ai/vibe/install.sh | bash(taiuv tool install mistral-vibe) ja se toimitetaan Mistral Medium 3.5:n kanssa - CLI ja VS Code -laajennus jakavat konfiguraation ja istunnot;
vibe --prompton tarkoitettu automaatioon - Vibe Code Web suorittaa agentin etäpesähdyksessä ja tuottaa haaroja ja vetopyyntöjä
- Tarkat ohjeet ja erotarkistus pysyvät välttämättöminä