Как правильно подготовить контекст задачи
Для решения конкретной проблемы ассистенту вовсе не нужен доступ ко всему репозиторию с миллионом строк кода. Избыточный контекст лишь размывает внимание модели и повышает вероятность некорректных обобщений.
Гораздо важнее предоставить точные типы входных и выходных данных, интерфейсы взаимодействующих компонентов и описание ожидаемого поведения.
Четко очерченный контекст позволяет получить сфокусированный ответ без лишних абстракций.
Какие технические сведения необходимы помощнику
Полнота исходного описания определяет, насколько предложенный код будет готов к встраиванию в проект без долгой адаптации.
Специалисту полезно заранее структурировать передаваемую информацию по ключевым техническим аспектам:
Для точной генерации кода достаточно передать следующие параметры:
- Версия языка программирования и используемого базового фреймворка
- Сигнатуры вызываемых методов и типы возвращаемых значений
- Схемы используемых таблиц или структуры документов без боевых записей
- Примеры краевых случаев и требований к обработке исключений
Защита конфиденциальных частей кодовой базы
Особое внимание необходимо уделять сохранности коммерческой тайны и специфических алгоритмов компании. Если сервис содержит ноу-хау ценообразования или формулы расчетов, передавайте только абстрактные математические уравнения без привязки к бизнесу.
Ни при каких обстоятельствах не отправляйте фрагменты дампа боевой базы данных с персональными сведениями клиентов компании.
Используйте синтетические наборы данных для демонстрации структуры и форматов.
Что проверить перед отправкой технического запроса
Создайте полезную привычку быстрой предпросмотровой проверки текста перед нажатием кнопки отправки.
Такая предосторожность убережет проект от случайной компрометации критических параметров:
Контрольный список перед отправкой включает следующие действия:
- Убедитесь в отсутствии боевых адресов серверов и портов подключения
- Подставьте фиктивные плейсхолдеры вместо реальных секретов
- Проверьте наличие указания версии целевого компилятора
- Уточните формат вывода, чтобы получить только нужный блок кода
Частые вопросы о передаче контекста проекта
Стоит ли передавать модельке весь файл со стилями оформления кода? Достаточно указать базовые требования к линтеру или попросить придерживаться стандартного руководства по стилю вашего языка.
Как быть со сложными циклическими зависимостями между классами? Выделите интерфейсы и передайте только их описания, опустив внутренности реализации других сервисов.
Как с этим работает Coagent
В Coagent у каждого сотрудника есть свой агент с ролью и правилами. Платформа работает на вашем сервере, а решения принимают люди.
Сформируйте обезличенный контекст интерфейса для новой задачи и оцените точность первой генерации.