SourceCraft Code Assistant от Yandex: как подключить модель и проверить первую задачу

Запрос «Yandex Code Agent» ведет к разным старым материалам. В текущей документации Yandex Cloud для VS Code используется название SourceCraft Code Assistant. Его можно подключить к моделям AI Studio через совместимый API и проверить на небольшой задаче в локальном проекте.

Что понадобится

Нужны VS Code, проект в Yandex Cloud, каталог, сервисный аккаунт и API-ключ с подходящими правами. Генерация моделей оплачивается по правилам Yandex Cloud, поэтому заранее проверьте тарифы и задайте бюджетный контроль.

Создавайте отдельный сервисный аккаунт для разработки. Не используйте ключ администратора облака и не выдавайте права шире необходимого.

Установите расширение и подключите модель

Установите SourceCraft Code Assistant из каталога расширений VS Code. В настройках укажите совместимый endpoint Yandex Cloud, идентификатор каталога или проекта и секрет штатным способом расширения.

Текущая документация Yandex Cloud указывает базовый адрес https://ai.api.cloud.yandex.net/v1. Остальные поля сверяйте с инструкцией для выбранной модели: интерфейс и названия настроек могут обновляться.

Ключ не должен лежать в settings.json внутри репозитория. Используйте пользовательские настройки, менеджер секретов или переменную окружения, если расширение это поддерживает.

Дайте первую безопасную задачу

Откройте учебный проект со списком товаров. Попросите ассистента сначала только изучить код:

Найди функцию сортировки товаров по цене. Ничего не меняй. Предложи минимальную правку, чтобы товары с одинаковой ценой дополнительно сортировались по названию. Не меняй API, зависимости и интерфейс.

Проверьте, что ассистент назвал правильный файл и существующий тип данных. Затем попросите внести изменение и добавить тест для двух товаров с одинаковой ценой.

Проверьте не модель, а результат. Просмотрите diff. Сортировка должна быть стабильной и не должна менять исходный массив, если проект придерживается неизменяемых данных.

Запустите тесты вручную. После работы проверьте журналы расхода и убедитесь, что запросы учитываются в ожидаемом каталоге. Если расширение не отвечает, сначала проверьте endpoint, идентификатор каталога, права сервисного аккаунта и срок действия ключа.

Уменьшите доступ к проекту. Добавьте секретные и сгенерированные файлы в исключения ассистента, если такая настройка доступна. Не открывайте агенту production-конфигурацию ради учебной сортировки.

Управляемая постановка и приемка небольших задач разбирается в проектах ИИ-лаборатории Глеба Кудрявцева в VS Code с Codex.

Первый запуск успешен, когда ассистент изменил одну функцию, тест проходит, ключ не попал в Git, а расход виден в правильном облачном проекте.