Проверить активную конфигурацию
Перед сложной или чувствительной задачей проверьте, какие настройки влияют на текущий чат. Veai пока не предоставляет единого опубликованного представления со всеми эффективными значениями, поэтому конфигурацию приходится проверять по нескольким экранам и файлам.
Краткий чек-лист
| Что проверить | Где смотреть | Почему важно |
|---|---|---|
| Режим подключения | Настройки Veai: Personal, Community или Enterprise | Определяет способ доступа к моделям |
| Модель | Переключатель модели в Veai | Влияет на контекст и поведение ответов |
| Режим агента | Меню выбора агента | Определяет роль и базовый набор инструментов |
| Меню Tools | Кнопка Tools рядом с полем ввода | Определяет доступ и подтверждения инструментов |
| Edit Scope | Настройка текущей задачи | Ограничивает изменяемые файлы |
.readignore и .writeignore | .veai/tools/ проекта или настроенный каталог | Запрещают чтение или запись путей |
| AGENTS.md | Корень проекта | Даёт постоянный контекст проекта |
| Rules | Меню правил и .veai | Добавляют инструкции по области файлов |
| Skills | Меню навыков и .veai/skills/ | Добавляют сценарий задачи |
| Memory Bank | Settings и .veai/memory/ | Передаёт знания из других чатов |
| MCP | Настройки MCP в Veai | Добавляет внешние инструменты |
| Model Routing | Настройки Model Routing в Veai | Выбирает модели для субагентов |
1. Подключение и модель
Проверьте выбранный режим подключения и модель. Для Community убедитесь, что настроены нужный провайдер, API-адрес и ключ. Для Enterprise используйте ключ и список моделей, которые выдала организация.
Размер контекста и доступные параметры зависят от модели и провайдера. Если Veai показывает неверный лимит OpenAI-совместимой модели, задайте его вручную в настройках.
Подробнее: режимы подключения и настройка модели.
2. Режим агента
Убедитесь, что выбранный режим подходит задаче:
- Ask — исследование без изменения файлов;
- Code — обычные изменения;
- Debug — проверка поведения во время исполнения;
- Test — создание тестов;
- Review — независимая проверка только для чтения;
- Plan — планирование большой работы;
- General и Orchestrator — делегирование подзадач.
Пользовательский режим может иметь собственные ограничения инструментов и список Skills. Подробнее: режимы агента.
3. Инструменты и подтверждения
Откройте меню Tools и проверьте:
- доступен ли нужный инструмент;
- не включены ли ненужные инструменты;
- какие вызовы потребуют подтверждения;
- какие MCP-серверы подключены.
Не полагайтесь на предполагаемые значения по умолчанию: они не опубликованы как единый контракт для всех версий Veai.
4. Ограничения файлов
Проверьте два независимых уровня:
- Edit Scope — что можно изменить в текущей задаче;
.readignoreи.writeignore— что постоянно запрещено читать или записывать.
Если файл отсутствует в Edit Scope, агент всё ещё может его читать, если путь не закрыт через .readignore.
5. Инструкции проекта
Просмотрите источники текстовых инструкций:
- текущий запрос;
AGENTS.md;- активные Rules;
- выбранный или автоматически подключённый Skill;
- пользовательский режим агента;
- релевантные записи Memory Bank.
Полный общий порядок приоритетов между ними не опубликован. Не дублируйте одну инструкцию в нескольких местах и не создавайте конфликтующих требований.
6. MCP и субагенты
В настройках MCP проверьте статус Connected и фактический список инструментов. Для внешних сервисов убедитесь, что учётной записи выданы только необходимые права.
В Model Routing проверьте проектный и глобальный файлы. В текущей реализации проектный .veai/model-routing.yaml целиком заменяет глобальный ~/.veai/model-routing.yaml; профили по alias не объединяются. Добавьте все нужные профили в проектный файл и после обновления Veai проверьте это поведение на установленной версии. Встроенные профили могут наследовать модель родительского агента, если для них не закреплена отдельная модель.
Быстрая диагностическая задача
Перед большой работой можно выполнить короткую проверку:
Не меняй проект. Перечисли режим агента, доступные тебе категории инструментов,
активный Edit Scope и постоянные инструкции проекта, которые ты можешь подтвердить.
Не показывай секреты и не пересказывай скрытые системные инструкции.
Если что-то определить нельзя, так и напиши.
Ответ агента является подсказкой, а не полным техническим доказательством. Сверьте его с интерфейсом и файлами настроек.
Если поведение неожиданно
- Начните новый чат.
- Оставьте спорную инструкцию только в одном месте.
- Временно отключите необязательные Rules, Skills, Memory и MCP.
- Проверьте режим агента, Tools, Edit Scope и ignore-файлы.
- Возвращайте настройки по одной, пока не найдёте источник расхождения.
Основные контракты отдельных механизмов собраны на странице «Справочник по настройке Veai». Пошаговые проверки загрузки и обновления файлов приведены в диагностике конфигурации.