Agenci kodujący w praktyce: API, Vibe Code CLI i Vibe Code Web
Na tej stronie
Lekcja przepisana 2 listopada 2026 r. Ponieważ Devstral został usunięty z API 31 lipca 2026 r., przykłady API w tym miejscu wykorzystują Mistral Small 4. Sekcja dotycząca Vibe odzwierciedla aktualną dokumentację Vibe Code: instalację, wbudowany model (Mistral Medium 3.5) oraz trzy interfejsy — CLI, rozszerzenie VS Code i Vibe Code Web. Źródła: Instalacja i konfiguracja · Wybór sesji CLI, VS Code lub webowych · Konfiguracja.
Trzy sposoby na uruchomienie agenta
Model agentowy jest tak dobry, jak sposób, w jaki połączysz go z rzeczywistą pracą. Mistral oferuje trzy ścieżki: API, gdzie budujesz własnego agenta; Vibe Code lokalnie, w terminalu lub VS Code; oraz Vibe Code Web, który uruchamia agenta w zdalnym środowisku izolowanym (sandbox) przeciwko repozytorium GitHub. Każda z nich pasuje do innego etapu dnia programisty.
Przez Mistral API
API to najbardziej elastyczny interfejs: pozwala budować własne przepływy pracy agentów z własnymi narzędziami i logiką sterowania. Zacznij od najprostszego przypadku: wywołania czatu bez narzędzi. Tutaj przesyłamy podatną na ataki funkcję uwierzytelniania do Mistral Small 4 i prosimy o diagnozę. Ustawienie temperature=0 nie jest ozdobnikiem: w analizie bezpieczeństwa potrzebujesz wyników powtarzalnych, a nie zmieniających się przy każdym uruchomieniu.
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)
Tryb agentowy zmienia charakter wymiany. Zamiast otrzymywać tekst, deklarujesz narzędzia, które model może zażądać wywołać, a model zwraca tool_calls — nazwę narzędzia i jego argumenty. Poniższe trzy narzędzia tworzą minimalny fundament dla agenta kodującego: odczyt pliku, zapis pliku, uruchomienie polecenia. Dzięki nim instrukcja „dodaj podpowiedzi typów do wszystkich plików w src/utils/“ staje się wykonalna, podczas gdy w trybie czatu pozostałaby jedynie sugestią.
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}")
Zauważ, że nic nie wykonuje się samo: pętla — wywołaj narzędzie, zwróć wynik do modelu, poproś o kolejny krok — pozostaje całkowicie Twoją odpowiedzialnością. To cena elastyczności i dokładnie to, czym zajmuje się za Ciebie CLI Vibe.
Przez Vibe Code lokalnie: CLI i rozszerzenie VS Code
Vibe Code to tryb „code“ w Vibe, agencie Mistrala. Lokalnie występuje w dwóch formach, które dzielą ten sam silnik, konfigurację i historię sesji: CLI w terminalu oraz rozszerzenie VS Code, które dodaje kontekst edytora (aktywny plik, zaznaczenie, różnice). Instalacja CLI zajmuje jedną linię w systemach macOS i Linux:
# Official installer (installs uv if needed, then the mistral-vibe package)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Or manual installation
uv tool install mistral-vibe
Następnie przejdź do swojego projektu i uruchom vibe. Przy pierwszym uruchomieniu kreator poprosi Cię o zalogowanie się na konto Mistral (Vibe Code jest Included w planach, z limitami użycia zależnymi od planu) lub wprowadzenie klucza API. Następnie rozmawiasz z agentem jak z kolegą, który ma ręce na klawiaturze:
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 dostarcza same narzędzia (odczyt/zapis plików, polecenia powłoki) oraz pętlę agentową, którą musiałeś napisać ręcznie przy użyciu API. Dostarczany jest z wbudowanym modelem, Mistral Medium 3.5, a polecenie /model pozwala wybrać inny spośród skonfigurowanych (Small 4, Codestral, model lokalny…). Zmiany i polecenia przechodzą przez system zatwierdzania, który konfigurujesz dla każdego agenta: przeglądaj je, zanim zaufasz agentowi ważne repozytorium. Do automatyzacji służy vibe --prompt, który uruchamia wykonanie nieinteraktywne, przydatne w ciągłej integracji.
Przez Vibe Code Web
Vibe Code Web to trzeci interfejs: kokpit dla zdalnych agentów. Tworzysz projekt z jednego lub więcej repozytoriów GitHub należących do tego samego właściciela, uruchamiasz sesję z precyzyjną instrukcją, a agent pracuje w zarządzanym w chmurze środowisku izolowanym: klonuje repozytorium, planuje, modyfikuje, uruchamia polecenia i testy, a następnie przygotowuje gałąź lub pull request do recenzji w GitHub. Nie jest potrzebna lokalna kopia, a Twój komputer może pozostać zamknięty, podczas gdy agent pracuje. Z poziomu CLI polecenie /teleport przenosi bieżącą sesję do wersji webowej.
Wybierz CLI lub rozszerzenie, gdy zadanie zależy od plików, usług lub sekretów obecnych tylko na Twoim komputerze.
Porównanie trzech ścieżek
| Kryterium | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Pętla agentowa | Piszesz ją sam | Wbudowana | Wbudowana |
| Dostęp do plików | Przez Twoje narzędzia | Lokalna kopia robocza | Zdalny sandbox, repozytorium GitHub |
| Model | Ten, który wywołujesz | Wbudowany Medium 3.5, inne opcjonalne | Silnik Vibe Code |
| Tryb nieinteraktywny | Tak | Tak (vibe --prompt, tylko CLI) | Nie |
| Przypadek użycia | Potoki, własne produkty | Codzienny rozwój | Długotrwałe zadania na zdalnym repozytorium |
Czytając od prawej do lewej, tabela ta opisuje gradient kontroli: im bardziej przesuwasz się w stronę API, tym więcej decydujesz sam, w tym o tym, co może ulec awarii.
Co w praktyce robi różnicę
Jakość wyniku zależy mniej od modelu, a bardziej od sposobu sformułowania żądania. „Dodaj walidację“ pozostawia agentowi wymyślenie lokalizacji, stylu i reguł; „Dodaj walidację e-maila w src/auth/validators.py, używając istniejącego wzorca“ daje mu plik, konwencję i granice. W tym samym duchu wyraźnie wskazuj odpowiednie pliki i ograniczenia projektu, zamiast liczyć, że agent je odgadnie.
Weryfikacja pozostaje niepodważalna: kompetentny agent nadal może wprowadzić regresję, zwłaszcza gdy dotyka wielu plików naraz. Wyrób sobie nawyk przeglądania różnic (diff) przed ich zaakceptowaniem, tak jak zrobiłbyś to w przypadku pull requesta nowego pracownika. I pamiętaj o ostatecznym ustawieniu: wyborze właściwego narzędzia. Używaj Vibe Code lokalnie do codziennego rozwoju, Vibe Code Web do długotrwałych zadań na zdalnym repozytorium, a API do własnych potoków.
Kluczowe wnioski
- API daje całkowitą kontrolę: sam piszesz narzędzia i pętlę agentową
- Vibe Code instalujesz przez
curl -LsSf https://mistral.ai/vibe/install.sh | bash(lubuv tool install mistral-vibe) i jest dostarczany z Mistral Medium 3.5 - CLI i rozszerzenie VS Code dzielą konfigurację i sesje;
vibe --promptsłuży do automatyzacji - Vibe Code Web uruchamia agenta w zdalnym środowisku izolowanym i tworzy gałęzie oraz pull requesty
- Precyzyjne instrukcje i przegląd różnic pozostają niezbędne