Система за изясняване с множествен избор
На тази страница
Урокът е актуализиран на 2 ноември 2026 г. Примерните файлове за агенти вече използват ключове, документирани от Vibe:
instructions(вместоsystem_prompt),active_model(вместоmodel), блокове[tools.<tool>]за одобрения (ключътauto_approveне съществува във файла на агента) и реални имена на инструменти (edit, а неedit_file; няма инструментlist_dir). Напомняне от Урок 3:safetyе визуален индикатор, а не разрешение. Източник: Справка за конфигурацията.
Кога Vibe пита, преди да действа
Mistral Vibe не е инструмент, който сляпо изпълнява инструкциите Ви. Когато заявката е двусмислена или са възможни няколко подхода, моделът може да предложи опции, преди да продължи: това е системата за изясняване с множествен избор. Механизмът разчита на вградения инструмент ask_user_question, достъпен за агентите, но не и за под-агентите, и работи по два начина.
В програмния режим (vibe --prompt …) Vibe деактивира интерактивните инструменти като ask_user_question: няма кой да отговори. Агент, проектиран да работи без надзор, трябва, подобно на под-агент, да открие избор по подразбиране в своите инструкции.
Първият начин е множествен избор: Vibe изброява номерирани опции, а Вие отговаряте с число или текста на опцията. Това е бързо и недвусмислено, което го прави формат по подразбиране, когато съществува краен брой разумни отговори.
Vibe: Кой тестов框架 използвате?
1. Vitest
2. Jest
3. Mocha
4. Pytest
5. Друго (посочете)
Вторият начин е въвеждане на свободен текст, запазен за въпроси, където отговорът не може да бъде предположен: име на таблица, идентификатор, път. Тогава Vibe очаква текстов отговор.
Vibe: Какво е името на базата данни за миграция?
> users_profiles
Трите ситуации, които задействат въпрос
Първият спусък е чиста двусмислица. Вие искате да рефакторирате „компонента за вход“, когато хранилището съдържа два такива; вместо да заложи на един и да Ви остави работа за изхвърляне, Vibe Ви позволява да решите. Забележете третата опция, която избягва размяната на съобщения, когато отговорът е „и двете“.
Вие: Рефакторирай компонента за вход
Vibe: Идентифицирах два компонента, свързани с входа:
1. src/components/LoginForm.tsx (форма)
2. src/components/LoginModal.tsx (модален прозорец)
Кой искате да рефакторирате?
3. И двата
Вторият спусък е множественост от технически подходи. Добавянето на валидация към форма въвежда зависимост, която ще остане в проекта с години; този вид решение принадлежи на Вас, а не на модела.
Вие: Добави валидация към формата
Vibe: Кой подход за валидация предпочитате?
1. Zod (валидация на схема, TypeScript типизиране)
2. Yup (декларативна валидация, екосистема на Formik)
3. Ръчна валидация (без библиотека)
4. Valibot (лек, поддържащ tree-shaking)
Третият е решение с високо въздействие. Привидно банална заявка – „актуализиране на зависимостите“ – може да крие промяна на основната версия. Тогава Vibe класира опциите от най-безопасни до най-рискови, като изрично посочва нивото на риск за всяка от тях.
Вие: Актуализирай зависимостите
Vibe: Актуализирането на React 18 → 19 е голяма промяна.
1. Актуализиране само на кръпки (безопасно)
2. Актуализиране на минорни версии (нисък риск)
3. Актуализиране на всичко, включително мажорни версии (необходима е проверка)
Настройване на курсора агент по агент
Това поведение не е автоматично: то зависи от това какво разрешавате. За да може един агент да Ви задава въпроси, ask_user_question трябва да присъства в неговите разрешени инструменти.
display_name = "Внимателен разработчик"
safety = "neutral"
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep",
"ask_user_question" # Активира изясняванията
]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Обратно, агент, проектиран да работи без надзор – в пайплайн, през нощта или просто за повтаряща се работа, която не искате да арбитрирате – трябва да бъде лишен от този инструмент. Премахването на ask_user_question обаче не е достатъчно: без инструкции за резервен вариант агентът би заседнал или би избрал на случаен принцип. Следователно системният промпт трябва да му каже какво да прави вместо това.
display_name = "Тих работник"
safety = "neutral"
instructions = """
Никога не задавай въпроси. В случай на двусмислие:
- Избери най-консервативната опция
- Документирай избора си в коментар
"""
enabled_tools = [
"read_file",
"write_file",
"edit",
"grep"
# Няма ask_user_question
]
[tools.read_file]
permission = "always"
[tools.write_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Между „всичко“ и „нищо“, промптът позволява фино настройване. Агент, който Ви прекъсва на всеки две минути, за да избере име на променлива, е толкова досаден, колкото един тих агент е рисков; затова формулирайте изричен праг, така че да Ви търси само за това, което наистина има значение.
instructions = """
Правила за изясняване:
- Задавай въпрос САМО ако изборът влияе на архитектурата
- За козметични решения следвай конвенциите на проекта
- Винаги предлагай максимум 3 опции
- Винаги включвай опция „И двете“ или „Всички“, когато е уместно
"""
Специалният случай на под-агентите
Важно напомняне: под-агентите не могат да задават въпроси. Това е проектно ограничение, а не пропуск – един под-агент трябва да бъде напълно автономен. Когато срещне двусмислие, той разполага с три възможности: да приложи опцията по подразбиране, документирана в неговия промпт, да документира този избор в резултата, който връща, и да сигнализира за двусмислието на основния агент, който след това може да Ви зададе въпрос. Записването на тези стойности по подразбиране не е лукс; това е условието под-агентът да произведе използваем резултат.
# Под-агент с ясен резервен вариант
agent_type = "subagent"
instructions = """
В случай на двусмислие, приложи тези правила по подразбиране:
- Тестов框架: Vitest
- Стил на кода: конвенции на проекта (открити чрез конфиг)
- Формат на изхода: Markdown
Документирай всеки избор по подразбиране в своя доклад.
"""
На практика запазете изясняванията за решения, които ангажират архитектурата или сигурността, и оставете агента сам да решава форматирането или имената на временните променливи. Придържайте се към три до пет опции, за да не превръщате всеки въпрос във формуляр, и винаги поставяйте избора, който би служил като разумен вариант по подразбиране, на първо място. Компромисът е прост за формулиране: по-малко въпроси осигуряват по-голяма плавност, но увеличават риска от тих грешен избор.
Ключови изводи
- Vibe използва
ask_user_question, за да поиска изяснявания с множествен избор или въвеждане на свободен текст - Системата се активира, когато заявката е двусмислена или са възможни няколко подхода
- Включете
ask_user_questionвenabled_tools, за да активирате изясняванията - Под-агентите не могат да задават въпроси – те трябва да бъдат автономни
- Насочвайте поведението при изясняване чрез системния промпт
- По-малко въпроси = по-голяма плавност, но по-висок риск от тих грешен избор