Przejdź do głównej treści
Polski— Wybierz język
Menu

Agenci kodujący w praktyce: API, Vibe Code CLI i Vibe Code Web

Lekcja 8 z 14 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Trzy sposoby na uruchomienie agenta
  2. Przez Mistral API
  3. Przez Vibe Code lokalnie: CLI i rozszerzenie VS Code
  4. Przez Vibe Code Web
  5. Porównanie trzech ścieżek
  6. Co w praktyce robi różnicę
  7. Kluczowe wnioski

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

KryteriumPython APIVibe Code (CLI, VS Code)Vibe Code Web
Pętla agentowaPiszesz ją samWbudowanaWbudowana
Dostęp do plikówPrzez Twoje narzędziaLokalna kopia roboczaZdalny sandbox, repozytorium GitHub
ModelTen, który wywołujeszWbudowany Medium 3.5, inne opcjonalneSilnik Vibe Code
Tryb nieinteraktywnyTakTak (vibe --prompt, tylko CLI)Nie
Przypadek użyciaPotoki, własne produktyCodzienny rozwójDł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 (lub uv tool install mistral-vibe) i jest dostarczany z Mistral Medium 3.5
  • CLI i rozszerzenie VS Code dzielą konfigurację i sesje; vibe --prompt sł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