Что писать агенту
Фразы для чата с агентом и что произойдёт. Технические параметры вызовов — в tool-parameters.md.
Агент ждёт завершения операции и показывает результат — отдельно просить об этом не нужно. Если хочется смотреть ход выполнения в терминале, скажите «запусти в терминале, не жди результата».
Окружение и профили запуска
| Что написать | Что произойдёт |
|---|---|
| Покажи состояние окружения 1С | Версия vanessa-runner, активный профиль, файл настроек, база, временные параметры |
| Переключись на профиль test | Профиль станет активным для всех следующих команд, статус-бар обновится |
| Переключись на профиль qa | Если такого нет — ответ со списком доступных профилей |
Проекты
| Что написать | Что произойдёт |
|---|---|
| Какие проекты 1С открыты | Список проектов окна, текущий отмечен |
| Переключись на проект retail | Проект retail станет текущим, в окне VS Code тоже |
| Собери расширения проекта erp | Сборка в проекте erp, текущий проект не меняется |
Тесты
| Что написать | Что произойдёт |
|---|---|
| Запусти vanessa-тесты | Прогон сценариев активного профиля, в ответе счётчики и упавшие тесты |
| Запусти vanessa-тесты с файлом настроек tools/vrunner.init.json | Прогон под другим файлом настроек, активный профиль не меняется |
| Запусти xunit-тесты | Сборка тестовых обработок и прогон |
| Запусти yaxunit-тесты | Прогон модулей тестового расширения |
| Проверь синтаксис конфигурации | Синтаксическая проверка; в ответе список ошибок с путями к модулям |
| Построй Allure-отчёт | Отчёт откроется в браузере |
| Настрой тестовые фреймворки: включи vanessa и yaxunit | В панели тестирования останутся только они |
Упавшие тесты, отсутствие отчёта и ошибки синтаксической проверки приходят с признаком неудачи: «успешно» только когда проверка действительно прошла.
Длинный лог в ответе обрезается до последних строк, целиком он остаётся в панели расширения.
Конфигурация
| Что написать | Что произойдёт |
|---|---|
| Загрузи конфигурацию из исходников | Конфигурация базы обновится из исходников |
| Загрузи изменения конфигурации от коммита HEAD~1 | Загрузятся только изменённые объекты |
| Выгрузи конфигурацию в исходники | Обновятся исходники конфигурации |
| Собери 1Cv8.cf из исходников | Файл конфигурации появится в build/out |
Расширения
| Что написать | Что произойдёт |
|---|---|
| Загрузи расширения из исходников | Загрузятся все расширения решения |
| Загрузи расширение _ДемоРасширение | Загрузится только оно |
| Выгрузи расширение _ДемоРасширение в исходники | Обновятся исходники расширения |
| Загрузи тестовые расширения | YAxUnit и расширение с тестами из каталога тестов уйдут в базу |
| Собери тестовые расширения | *.cfe соберутся в build/out/tests/cfe |
Информационная база
| Что написать | Что произойдёт |
|---|---|
| Создай пустую информационную базу | Файловая база в build/ib |
| Обнови конфигурацию информационной базы | Конфигурация базы приводится к исходникам |
| Обнови базу данных | Обновится структура базы |
Обработки и отчёты
| Что написать | Что произойдёт |
|---|---|
| Собери внешние обработки | Внешние обработки проекта соберутся в build/out/epf |
| Собери внешние отчёты | Внешние отчёты проекта соберутся в build/out/erf |
| Запусти обработку build/out/epf/_ДемоЗаполнениеКонтрагентов.epf в Предприятии | Обработка выполнится в базе активного профиля |
Сценарий: инициализация и прогон
Сценарии инициализации помечены тегом и живут в отдельном файле настроек, основной набор их исключает.
- Покажи состояние окружения 1С
- Запусти vanessa-тесты с файлом настроек tools/vrunner.init.json
- Запусти vanessa-тесты
Шаг 2 выполнит только сценарии инициализации, шаг 3 — основной набор без них.
Сценарий: работа под другим профилем
- Переключись на профиль test
- Обнови конфигурацию информационной базы
- Запусти vanessa-тесты
- Переключись на профиль default
Команды между шагами 1 и 4 выполняются в базе профиля test.
Сценарий: база с нуля
- Создай пустую информационную базу
- Загрузи конфигурацию из исходников
- Загрузи расширения yaxunit и yaxunit-test
- Обнови базу данных
- Запусти yaxunit-тесты
Сценарий: правки под контролем проверок
- Проверь синтаксис конфигурации
- Загрузи изменения конфигурации от коммита HEAD~1
- Проверь синтаксис конфигурации
- Запусти yaxunit-тесты