Премини към основното съдържание
Български— Изберете език
Меню

Агенти за код на практика: API, Vibe Code CLI и Vibe Code Web

Урок 8 от 14 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Три начина за включване на агент в работа
  2. Чрез Mistral API
  3. Чрез Vibe Code локално: CLI и разширението за VS Code
  4. Чрез Vibe Code Web
  5. Сравнение на трите пътя
  6. Какво прави разликата на практика
  7. Ключови изводи

Урокът е пренаписан на 2 ноември 2026 г. Тъй като Devstral беше премахнат от API на 31 юли 2026 г., примерите за API тук използват Mistral Small 4. Разделът за Vibe отразява текущата документация на Vibe Code: инсталация, вграденият модел (Mistral Medium 3.5) и трите интерфейса – CLI, разширение за VS Code и Vibe Code Web. Източници: Инсталация и настройка · Избор между CLI, VS Code или уеб сесии · Конфигурация.

Три начина за включване на агент в работа

Един агентен модел е толкова добър, колкото е връзката му с реалната работа. Mistral предлага три пътя: API, където изграждате собствения си агент; Vibe Code локално, във вашия терминал или VS Code; и Vibe Code Web, който изпълнява агента в отдалечена пясъчница срещу GitHub хранилище. Всеки от тях отговаря на различна част от работния ден на разработчика.

Чрез Mistral API

API е най-гъвкавият интерфейс: то Ви позволява да изградите собствени агентни работни потоци със собствените си инструменти и логика на управление. Започнете с най-простия случай – обаждане за чат без инструменти. Тук изпращаме уязвима функция за автентикация към Mistral Small 4 и искаме диагностика. Задаването на temperature=0 не е декоративно: за анализ на сигурността се нуждаете от възпроизводими резултати, а не от вариации при всяко изпълнение.

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)

Агентният режим променя същността на обмена. Вместо да получавате текст, Вие декларирате инструменти, които моделът може да поиска да извика, а моделът връща tool_calls – име на инструмент и неговите аргументи. Трите инструмента по-долу формират минималната основа за агент за код: четене на файл, запис на файл, изпълнение на команда. С тях инструкцията „добави типове към всички файлове в src/utils/“ става изпълнима, докато в режим на чат тя би останала просто предложение.

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

Обърнете внимание, че нищо не се изпълнява автоматично: цикълът – извикване на инструмента, връщане на изхода към модела, искане на следващата стъпка – остава изцяло Ваша отговорност. Това е цената на гъвкавостта и точно това е, което Vibe CLI прави вместо Вас.

Чрез Vibe Code локално: CLI и разширението за VS Code

Vibe Code е режимът „code“ на Vibe, агентът на Mistral. Локално той съществува в две форми, които споделят един и същ двигател, конфигурация и история на сесиите: CLI във вашия терминал и разширението за VS Code, което добавя контекст на редактора (активен файл, селекция, разлики). Инсталирането на CLI отнема един ред на macOS и 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

След това навигирайте до вашия проект и изпълнете vibe. При първо стартиране съветник Ви подканва да влезете с акаунта си в Mistral (Vibe Code е включен в плановете, с лимити на използване в зависимост от плана) или да въведете API ключ. След това говорите с агента като с колега, чиито ръце са на клавиатурата:

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 предоставя самите инструменти (четене/запис на файлове, shell команди) и агентния цикъл, който трябваше да напишете на ръка с API. Той идва с вграден модел, Mistral Medium 3.5, а командата /model Ви позволява да изберете друг от конфигурираните (Small 4, Codestral, локален модел…). Промените и командите минават през система за одобрение, която конфигурирате за всеки агент: прегледайте я, преди да му се доверите с важно хранилище. За автоматизация vibe --prompt изпълнява неинтерактивно изпълнение, полезно при непрекъсната интеграция.

Чрез Vibe Code Web

Vibe Code Web е третият интерфейс: кокпит за отдалечени агенти. Създавате проект от едно или повече GitHub хранилища под един и същи собственик, стартирате сесия с точна инструкция и агентът работи в управлявана от облака пясъчница: той клонира, планира, модифицира, изпълнява команди и тестове, след което подготвя бранч или pull request, който да прегледате в GitHub. Не е необходимо локално копие и машината Ви може да остане затворена, докато агентът работи. От CLI командата /teleport прехвърля текуща сесия към уеб интерфейса.

Изберете CLI или разширението, когато задачата зависи от файлове, услуги или тайни, налични само на Вашата машина.

Сравнение на трите пътя

КритерийPython APIVibe Code (CLI, VS Code)Vibe Code Web
Агентен цикълВие го пишетеВграденВграден
Достъп до файловеЧрез Вашите инструментиЛокално работно копиеОтдалечена пясъчница, GitHub хранилище
МоделТози, който извикватеВграден Medium 3.5, други по изборДвигател на Vibe Code
Неинтерактивен режимДаДа (vibe --prompt, само CLI)Не
Случай на употребаПайплайни, персонализирани продуктиЕжедневна разработкаДълготрайни задачи в отдалечено хранилище

Четейки отдясно наляво, тази таблица описва градиент на контрол: колкото повече се придвижвате към API, толкова повече Вие решавате всичко, включително какво може да се счупи.

Какво прави разликата на практика

Качеството на резултата зависи по-малко от модела, а повече от това как формулирате заявката си. „Добавете валидация“ оставя агента да измисли местоположението, стила и правилата; „Добавете валидация на имейл в src/auth/validators.py, използвайки съществуващия шаблон“ му дава файла, конвенцията и границите. В същия дух изрично цитирайте съответните файлове и ограниченията на проекта, вместо да се надявате, че той ще ги познае.

Верификацията остава задължителна: един компетентен агент все още може да въведе регресия, особено когато засяга множество файлове едновременно. Направете си навик да преглеждате разликите (diff), преди да ги приемете, точно както бихте постъпили с pull request от нов служител. И имайте предвид крайната настройка: изборът на правилния инструмент. Използвайте Vibe Code локално за ежедневна разработка, Vibe Code Web за дълготрайни задачи в отдалечено хранилище и API за собствените си пайплайни.

Ключови изводи

  • API осигурява пълен контрол: Вие пишете инструментите и агентния цикъл
  • Vibe Code се инсталира с curl -LsSf https://mistral.ai/vibe/install.sh | bash (или uv tool install mistral-vibe) и идва с Mistral Medium 3.5
  • CLI и разширението за VS Code споделят конфигурация и сесии; vibe --prompt е за автоматизация
  • Vibe Code Web изпълнява агента в отдалечена пясъчница и генерира бранчове и pull requests
  • Точните инструкции и прегледът на разликите остават съществени