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

Обединени режими: Комбиниране на инструменти, разрешения и поведения

Урок 4 от 14 Обновен 2 ноември 2026 г. Напреднало
На тази страница
  1. Концепцията за обединени режими
  2. Структура на обединения режим
  3. Проектиране на допълващи се режими
  4. Превключване между режими и тяхната организация
  5. Ключови изводи

Урокът е актуализиран на 2 ноември 2026 г. Примерните файлове за агенти вече използват ключове, документирани от Vibe: instructions (вместо system_prompt), active_model (вместо model), блокове [tools.<tool>] за одобрения (ключът auto_approve не съществува във файла на агента) и реални имена на инструменти (edit, а не edit_file; няма инструмент list_dir). Напомняне от Урок 3: safety е визуален индикатор, а не разрешение. Източник: Справка за конфигурацията.

Концепцията за обединени режими

Персонализираните агенти, разгледани в предишните уроци, дефинират статичен профил: модел, набор от инструменти и ниво на сигурност. Обединените режими отиват по-далеч, като комбинират множество измерения в една цялостна конфигурация, която можете да активирате с едно действие. Един обединен режим групира разрешени инструменти, специфични права, поведение, управлявано от системни инструкции, правила за автоматично одобрение и контекстуални ограничения.

Стойността става очевидна, когато работата Ви се променя няколко пъти през деня. Без обединени режими, трябва да жонглирате с множество настройки всеки път, когато контекстът се промени: преминавате от преглед на код към внедряване и трябва да сменяте агентите, да коригирате разрешенията и да настройвате подкана. Един обединен режим капсулира всичко това в един профил, който активирате при стартиране или по време на сесия.

# Активиране на режим "deploy"
vibe --agent deploy-mode

# Превключване към режим "review"
# Shift+Tab → изберете review-mode

Структура на обединения режим

Технически погледнато, обединеният режим е персонализиран агент; разликата с класическия агент е концептуална. Вече не проектирате .toml файла като „асистент, който може да прави X“, а като цялостен работен контекст: какво Ви е позволено да правите по време на тази фаза от проекта, с какво ниво на предпазливост и в какъв вид резултатите се връщат към Вас.

Режимът за преглед по-долу илюстрира това най-ясно. Той е само за четене, затова се одобрява автоматично без риск, а неговата подка̀ра налага формат на отчет, който можете директно да включите в заявка за сливане (pull request).

# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Code review mode: read-only, deep analysis, suggestions."

safety = "safe"
active_model = "mistral-medium-3.5"  # model built into Vibe

instructions = """
You are in code review mode.
Goal: analyze code quality, security, and maintainability.
Rules:
- Never modify files
- Produce a structured report (critical issues, warnings, suggestions)
- Cite affected code lines with their line numbers
- Propose fixes as diffs
Output format: Markdown with Critical / Warning / Suggestion sections
"""

enabled_tools = [
  "read_file",
  "grep",
]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Режимът за внедряване е пълната му противоположност и този контраст е умишлен. Той разполага с bash, така че може да причини щети, но неговите разрешения ask за write_file и bash Ви държат в цикъла на вземане на решения, а неговата подка̀ра описва строга последователност, която агентът трябва да следва от началото до края.

# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Deploy mode: build, test, deploy with validation at each step."

safety = "destructive"
active_model = "codestral"  # alias declared in config.toml (Lesson 2)

instructions = """
You are in deploy mode.
Mandatory sequence:
1. Verify that all tests pass
2. Build the project
3. Validate the build (no errors, no warnings)
4. Request confirmation before actual deployment
5. Deploy
6. Verify that the service responds
Never deploy if tests fail.
"""

enabled_tools = [
  "read_file",
  "write_file",
  "bash",
  "grep",
  "ask_user_question"
]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

Проектиране на допълващи се режими

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

display_name = "Explore Mode"
safety = "safe"
instructions = """Explore the codebase, identify the architecture, patterns, and dependencies."""
enabled_tools = ["read_file", "grep",]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Следва режимът за разработка (Dev mode), в който ще прекарвате по-голямата част от времето си. Той пише и изпълнява команди – например за стартиране на тестове – но иска Вашето одобрение, а неговата подка̀ра свързва всяка промяна с писането на тестове.

display_name = "Dev Mode"
safety = "neutral"
instructions = """Implement the requested features. Write tests for every change."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]

[tools.write_file]
permission = "ask"

[tools.edit]
permission = "ask"

[tools.bash]
permission = "ask"

Накрая, режимът за поправки (Fix mode) е умишлено ограничен. Няма write_file, само edit: агентът модифицира съществуващ код, без да създава нови файлове, което му пречи да „рефакторира по пътя“ бъг, който просто сте поискали да поправи. Тъй като е толкова ограничен, можем безопасно да го одобряваме автоматично.

display_name = "Fix Mode"
safety = "neutral"
instructions = """Fix reported bugs. Minimize changes. Touch only the affected code."""
enabled_tools = ["read_file", "edit", "grep"]

[tools.read_file]
permission = "always"

[tools.edit]
permission = "always"

[tools.grep]
permission = "always"

Превключване между режими и тяхната организация

В интерактивна сесия, Shift+Tab превключва между режимите: Vibe показва списък с всички Ваши агенти, вградени и персонализирани, заедно с техните описания – тук личи ползата от внимателните описания от предишния урок. От командния ред стартирате директно в даден режим или преглеждате съдържанието на директорията с агенти.

# Стартиране директно в режим
vibe --agent review-mode

# Списък с наличните агенти
ls ~/.vibe/agents/

Накрая, възприемете ясна конвенция за именуване. Суфиксът -mode веднага отличава Вашите работни контексти от по-ад хок полезните агенти, а азбучният ред на директорията остава четим дори след дузина файлове.

~/.vibe/agents/
├── review-mode.toml      # Code review
├── deploy-mode.toml      # Deployment
├── dev-mode.toml         # Development
├── fix-mode.toml         # Fixes
├── explore-mode.toml     # Exploration
└── doc-mode.toml         # Documentation

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

  • Обединеният режим е персонализиран агент, проектиран като цялостен работен контекст
  • Той комбинира инструменти, разрешения, системна подка̀ра и модел в една конфигурация
  • Създавайте допълващи се режими, за да покриете целия си цикъл на разработка
  • Shift+Tab Ви позволява да превключвате между режимите в реално време
  • Именувайте файловете си последователно, за да ги намирате лесно
  • Всеки режим трябва да има ясна цел и подходящи разрешения