10. AI-ассистент¶

Версия	1.0.0
Количество листов

Оглавление¶

История изменений
1. AI-ассистент

История изменений¶

№:1	Дата: 30.08.2025	Автор: Ляшук Андрей	RFC: RPL-1700	Версия: 1.0.0
Итоговая версия.

1. AI-ассистент¶

AI-ассистент представляет собой функциональность, которая позволяет пользователю использовать возможности сервиса с использованием ИИ-модели.

10_1_1 Возможности сервиса с использованием ИИ-модели {#10_1_1-возможности-сервиса-с-использованием-ии-модели}

Возможность	Описание	API
Создать кампанию	Предоставляет "Представителю бизнеса" возможность создать "Кампанию".	POST /campaigns

1.1 Шаблоны сообщений AI-ассистента¶

1.1.1 Предустановленные шаблоны сообщений AI-ассистента¶

Шаблон	Локаль	Текст ошибки
OpenAI Request Error	en	"The assistant service is temporarily unavailable. Please try again later."
	es
	pt
	fr

1.2 Данные AI-ассистента¶

1.2.1 Параметры сообщений AI-ассистента(assistant_chat_messages)¶

Название	Параметр	Формат	Обяз.	Уник.	Примечание
Идентификатор	id	bigserial	да	да
Дата создания	created_at	timestamp	да	нет
Дата обновления	updated_at	timestamp	нет	нет
Дата удаления	deleted_at	timestamp	нет	нет
Автор сообщения	author_id	bigint	нет	нет	Идентификатор пользователя
Идентификатор бизнеса	business_id	bigint	нет	нет	Если роль автора сообщения "Представитель бизнеса"
Текст сообщения	message	text	да	нет
Идентификатор ответа	response_id	bigint	нет	нет
Идентификатор ответа ИИ	ai_response_id	string	нет	нет
Является началом сессии	is_session_start	boolean	да	нет	По умолчанию false.

1.3 CRUD Сообщений AI-ассистент¶

10_1.3.1_1 Процедура создания сообщения в чате с AI-ассистентом пользователем¶

API: POST /private/assistant/messages

Клиентской частью сервиса выполняется запрос "Create assistant message" с телом запроса:
1. message — текст сообщения.
Если для пользователя, который инициировал выполнение данной процедуры:
1. Имеется минимум одно "Сообщение AI-ассистента", и для последнего "Сообщения AI-ассистента":
  1. Не имеется "Идентификатора ответа" — на запрос "Create assistant message" возвращается ошибка "1001";
  2. Имеется "Идентификатор ответа" — выполняется этап "3" данной процедуры.
2. Не имеется ни одного "Сообщения AI-ассистента" — выполняется этап "3" данной процедуры.
Выполняется:
1. Создание "Сообщения AI-ассистента" с параметрами:
  1. Дата создания — согласно текущей дате;
  2. Автор сообщения — идентификатор пользователя, который инициировал выполнение данной процедуры;
  3. Идентификатор бизнеса — идентификатор бизнеса, к которому относится "Представитель бизнеса", который инициировал выполнение данной процедуры;
  4. Текст сообщения — согласно значению параметра message, который был указан при инициации запроса;
  5. Является началом сессии — true, если для пользователя, который инициировал выполнение данной процедуры:
    1. Не имеется ни одного "Сообщения AI-ассистента", для которого имеется "Идентификатор ответа ИИ"; или
    2. Имеется минимум одно "Сообщение AI-ассистента", для которого имеется "Идентификатор ответа ИИ", и разница между текущей датой и "Датой создания" последнего "Сообщения AI-ассистента" данного пользователя больше значения параметра "Времени жизни сессии" настройки "Ассистента".
2. Добавление сообщения в очередь "Получения ответа от ИИ-модели OpenAI" с параметрами:
  1. Идентификатор сообщения AI-ассистента — "Идентификатор" сообщения AI-ассистента, которое было создано на этапе "3_a" данной процедуры.
На запрос "Create assistant message" возвращается информация об успешном выполнении запроса.