Что вы получаете на руки после проекта: исходники, модели, документация

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

С обычным сайтом хватало фразы «исходный код передаётся заказчику». С агентом её мало: код — это меньшая часть того, что заставляет его работать. Ниже — полный список того, что должно оказаться у вас, и способ проверить это за один день.

Из чего на самом деле состоит агент

• Исходный код. Сервис агента, интеграции с CRM и мессенджерами, виджет чата. Репозиторий с историей изменений, а не архив «финальная версия».
• Инструкции агента (промпты). Текст, который задаёт его поведение: что отвечать, чего не отвечать, когда звать человека. Это главный результат настройки, и он должен лежать в репозитории рядом с кодом, а не в личном кабинете сервиса.
• База знаний и способ её обновлять. Сами документы, скрипты, которые их загружают и индексируют, и инструкция: что делать, когда поменялся прайс.
• Проверочный набор. Вопросы с эталонными ответами, на которых агента принимали, и скрипт, который этот набор прогоняет. Без него любое изменение — игра вслепую: поправили одно, сломали другое и не заметили.
• Настройки и веса моделей. Какая модель, с какими параметрами. Если модель дообучали на ваших данных — сами веса и данные, на которых обучали.
• Инфраструктура. Файлы развёртывания, описание серверов, порядок обновления и отката.
• Журналы. История разговоров и заявок — в выгружаемом виде.
• Документация. Не сто страниц, а ответы на три вопроса: как запустить с нуля, как обновить, что делать, если сломалось.

Аккаунты — на вас с первого дня

Самая частая ловушка — не код, а учётные записи. Подрядчику удобно завести всё на себя: быстрее стартовать. Через год это означает, что ключи API модели, токен Telegram-бота, домен и сервер принадлежат не вам.

Правило простое: всё, за что платят деньги и что нельзя воссоздать, регистрируется на заказчика, а подрядчик получает доступ.

• аккаунты у поставщиков моделей и ключи API;
• боты и номера в мессенджерах;
• серверы, домены, сертификаты;
• репозиторий с кодом.

Заодно становится видно, сколько на самом деле стоят модели: счёт приходит вам, а не растворяется в строке «сопровождение».

Проверка за один день

Это не риторический вопрос, а процедура. Попросите своего разработчика или стороннего специалиста пройти по документации на пустой машине. Всё, что пришлось спрашивать у подрядчика, — дыры в передаче. Обычно их три-четыре: забытая переменная окружения, скрипт, который живёт только на ноутбуке автора, доступ, который выдавали «по дружбе».

Вторая проверка — прогнать проверочный набор на поднятой копии. Результат должен совпасть с тем, что было на приёмке. Если не совпал — вам передали не ту версию.

Что записать в договоре

• Права. Исключительные права на код и материалы, созданные по проекту, переходят к заказчику. Формулировку пусть проверит юрист: «передаются исходники» и «переходят права» — разные вещи.
• Состав передачи. Список из первого раздела — приложением к договору, а не на словах.
• Чужие компоненты. Если подрядчик использует собственные готовые библиотеки, они должны быть названы, и у вас должна остаться лицензия пользоваться ими без подрядчика. Открытые библиотеки — с перечнем лицензий.
• Момент передачи. Не «после финальной оплаты одним архивом», а по ходу: репозиторий и аккаунты — ваши с первого дня.

Зачем это подрядчику

Может показаться, что исполнителю выгодно держать клиента на привязи. На деле привязь работает до первого конфликта, после которого клиент уходит и рассказывает об этом всем. Проект, который можно забрать в любой момент, держится на качестве работы — и это более надёжное основание для долгих отношений.

У нас так: исходники, обученные модели и документация полностью передаются заказчику, весь код — ваш. Если хотите сверить со списком выше свой текущий проект, в том числе сделанный не нами, — напишите, посмотрим на аудите.