ИИ-продавец в Codex APP: пошаговый алгоритм автоматизации коммерческих предложений

ИИ-продавец в Codex APP: пошаговый алгоритм автоматизации коммерческих предложений

Автоматизация первичных продаж и подготовки расчетных документов — одна из наиболее востребованных задач коммерческих отделов. Формирование коммерческого предложения (КП) по нестандартным или голосовым обращениям клиентов вручную занимает у менеджера от 20 до 40 минут: необходимо распознать позиции, проверить актуальный прайс-лист, рассчитать вес груза, кратность упаковок, логистику и налоги.

Использование языковых моделей в среде Codex APP позволяет сократить время сборки черновика КП до 2 минут. Однако развертывание автономного ИИ-ассистента требует строгой архитектуры: вероятностная природа нейросети без жестких системных ограничений способна привести к критическим ошибкам в ценообразовании, галлюцинациям по остаткам и непредусмотренным скидкам.

В этом руководстве разобран пошаговый порядок создания контролируемого ИИ-продавца на базе локального проекта Codex и кастомных скиллов.

Архитектура задачи: разделение модальностей и контрольный контур

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

Процесс обработки заявки разделяется на 6 этапов:

1. Входящее обращение: получение голосового файла или текстового сообщения от покупателя.
2. Извлечение параметров: распознавание SKU (уникальных идентификаторов товаров), объемов, длины, единиц измерения и геопозиции доставки.
3. Проверка полноты: остановка процесса и запрос уточняющих вопросов, если ключевое обязательное поле отсутствует.
4. Детерминированный расчет: сопоставление позиций с действующим прайс-листом, таблицей логистических тарифов и налоговыми ставками.
5. Генерация черновика КП: сборка документа по строгому Markdown-шаблону с указанием срока действия цены.
6. Человеческий верификационный контроль: проверка черновика уполномоченным менеджером перед отправкой клиенту.

Этап 1. Подготовка локального проекта и справочников данных

Работа ассистента строится в изолированной рабочей директории проекта. Согласно официальному руководству по проектам в Codex (Codex Manual: Projects and chats), CLI (командная строка) и система рабочей среды используют папку запуска как ограниченный контекст.

В корневой директории вашего проекта создаются следующие структурированные файлы данных:

• catalog.csv — номенклатура товаров: идентификатор SKU, полное название, единица измерения, базовая цена без НДС, ставка НДС, кратность упаковки, вес/объем единицы и статус наличия на складе.
• delivery_tariffs.json — логистические правила: геозоны, стоимость километража, типы доступного транспорта (погрузочная вместимость) и фиксированные ставки за погрузку.
• cp_template.md — стандартизированный шаблон коммерческого предложения с фирменными реквизитами, условиями оплаты и полями для подписи.

Важное правило безопасности: никогда не помещайте в папку проекта приватные API-токены (секретные ключи доступа), пароли от CRM или полные выгрузки персональных данных клиентов.

Этап 2. Создание кастомного скилла в Codex

Для обучения ассистента алгоритму обработки коммерческих предложений создается кастомный скилл (Skill). Как указано в официальном руководстве по расширениям (Codex Manual: Skills), скилл представляет собой отдельный каталог внутри проекта с управляющим файлом SKILL.md.

Структура каталога скилла:

skills/sales-proposal-builder/
├── SKILL.md
└── resources/
    └── restrictions.md

Файл SKILL.md содержит ролевую инструкцию, порядок работы с файлами и жесткие сценарии поведения:

---
name: sales-proposal-builder
description: Автоматический расчет коммерческих предложений по строительным материалам и логистике на основе каталога.
---

# Инструкция ИИ-продавца

Ваша роль — коммерческий ассистент по расчету смет и оформлению КП.

## Порядок работы:
1. Прочитайте текст или расшифровку голосовой заявки клиента.
2. Сверьте названные позиции с файлом `catalog.csv`.
3. Если клиент не указал адрес доставки или специфические параметры (например, длину арматуры), не рассчитывайте итоговую сумму. Верните список уточняющих вопросов.
4. Проверьте ограничения из файла `resources/restrictions.md`.
5. Сформируйте черновик документа по шаблону `cp_template.md`.

Этап 3. Разработка файла явных ограничений («Запрет полный список»)

Критическим элементом, защищающим ценообразование компании от ошибкоемких галлюцинаций, является файл ограничений resources/restrictions.md. Модель должна получить не просто абстрактный призыв «не ошибаться», а конкретные правила остановки работы.

Содержание файла restrictions.md:

# Ограничения ценообразования и правила безопасности

1. ЗАПРЕТ ГАЛЛЮЦИНАЦИЙ ЦЕН: запрещено придумывать или рассчитывать цены позиций, отсутствующих в catalog.csv. Если товара нет в базе, выведите статус `SKU_NOT_FOUND` и запросите решение менеджера.
2. ЗАПРЕТ РУЧНЫХ СКИДОК: запрещено предоставлять скидки или менять базовую цену из прайса без явного подтверждения уполномоченного лица.
3. МИНИМАЛЬНАЯ ПАРТИЯ: если запрашиваемое количество меньше минимальной партии из каталога, автоматически округляйте заказ до минимальной кратности отгрузки с указанием предупреждения.
4. СРОК ДЕЙСТВИЯ: любое сгенерированное КП должно содержать явное ограничение: «Предложение действительно в течение 3 рабочих дней».
5. СТАТУС ЧЕРНОВИКА: на каждом документе обязателен водяной знак: «ЧЕРНОВИК. Требуется подтверждение менеджера по продажам».

Этап 4. Протокол приемки и тестирование ассистента

Перед подключением ИИ-агента к реальным каналам связи коммерческий отдел проводит приемку на тестовом наборе из 10 сценариев:

• Сценарий 1 (Полный запрос): указаны товар, количество, марка, точно задан населенный пункт доставки.
• Сценарий 2 (Некомплектный адрес): указан товар, но отсутствует пункт назначения — проверяется остановка расчета и запрос уточнения.
• Сценарий 3 (Отсутствующий SKU): заявка содержит позицию, которой нет в catalog.csv — проверяется вывод статуса ошибки вместо придумывания цены.
• Сценарий 4 (Нарушение кратности): объем заказа не кратен упаковке — проверяется корректность автоматического округления.
• Сценарий 5 (Конфликт единиц): в заявке смешаны тонны и метры — проверяется запрос на уточнение характеристик.

Приемка считается успешной только при 100% совпадении арифметических итогов с эталонным ручным расчетом и беспрекословном срабатывании правил остановки.

Контрольный чек-лист безопасности перед запуском

Перед началом работы коммерческой команды с ИИ-продавцом проверьте выполнение условий защищенного контура:

• Прайс-лист catalog.csv содержит актуальные даты действия цен и версию справочника.
• В рабочей директории проекта отсутствуют конфиденциальные ключи, токены и приватные данные.
• В файле SKILL.md настроен обязательный вывод статуса черновика.
• Менеджеры по продажам проинструктированы о запрете прямой автоматической отправки клиенту документов без личной проверки расчетов.

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