Подключение AI-помощника

TG Support Bot поддерживает интеграцию с несколькими AI-провайдерами. Список доступных провайдеров находится в конфигурационном файле config/ai.php → providers.

Ниже описана базовая настройка на примере OpenAI.

Создание бота для AI-помощника

AI-помощник отправляет сообщения через отдельного Telegram-бота. Это необходимо, чтобы сообщения от помощника визуально отличались от сообщений оператора.

Создайте нового бота через @BotFather.
Добавьте полученный токен в файл .env:
env
```
TELEGRAM_AI_BOT_TOKEN=ваш_токен
```

Настройка подключения к AI-провайдеру

Укажите параметры доступа к API провайдера в файле .env. Для OpenAI используются следующие переменные:

env

OPENAI_API_KEY=ваш_api_ключ
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4o-mini
OPENAI_MAX_TOKENS=2000
OPENAI_TEMPERATURE=0.7

Переменная	Описание
`OPENAI_API_KEY`	Токен для авторизации в API
`OPENAI_BASE_URL`	Базовый URL для запросов к API
`OPENAI_MODEL`	Модель, которая будет использоваться
`OPENAI_MAX_TOKENS`	Максимальное количество токенов в одном ответе
`OPENAI_TEMPERATURE`	Степень креативности: `0` — строго, `1` — творчески

Настройка промпта

AI-помощнику можно задать базовые правила поведения и готовые ответы. Создайте файл:

resources/ai/system-prompt.blade.php

Укажите в нём:

типовые ответы на часто задаваемые вопросы;
ссылки на полезные материалы и документацию;
требования к стилю общения и тону ответов.

Включение AI-помощника

Управление помощником осуществляется через файл .env:

env

AI_ENABLED=true
AI_DEFAULT_PROVIDER=openai

Переменная	Описание
`AI_ENABLED`	Включает (`true`) или отключает (`false`) помощника
`AI_DEFAULT_PROVIDER`	Провайдер, используемый по умолчанию

Режимы работы AI-помощника

Генерация ответов с помощью AI имеет 2 режима работы:

генерации и автоматическая отправка сообщений
генерация сообщения и запрос подтверждения

Автоматическая генерация и отправка

Для включения автоматической отправки сообщений, необходимо прописать в .env параметр:

env

AI_AUTO_REPLY=true

В таком случае AI помощник будет сразу отправлять ответы после получения сообщений от пользователя.

Генерация сообщения и запрос подтверждения

Для включения генерации сообщения от AI помощника и последующего запроса на отправку, необходимо прописать в .env параметр:

env

AI_AUTO_REPLY=false

В таком случае, сообщения будут отправляться только после подтверждения со стороны менеджера.

Подключение AI-помощника ​

Создание бота для AI-помощника ​

Настройка подключения к AI-провайдеру ​

Настройка промпта ​

Включение AI-помощника ​

Режимы работы AI-помощника ​

Автоматическая генерация и отправка ​

Генерация сообщения и запрос подтверждения ​