Как получить API-ключ
Укажите название ключа и при желании название проекта. Нажмите Generate API Key.
После этого появится ваш ключ, нажмите Copy. Сохраните его сразу. Повторно его просмотреть будет невозможно.
Чтобы узнать идентификатор вашей организации, нажмите на значок ⚙️ в правом верхнем углу → Settings → General.
Как добавить данные в конструктор
Этот шаг подключает BorisBot к вашему аккаунту OpenAI. Без него GPT-блоки не смогут работать.
Как работать с блоками GPT
Чат с базой интернета — модель обращается к информации из интернета, как обычный ChatGPT.
GPT-ассистент (на вашей базе) — работает только с загруженными вами документами: инструкциями, FAQ, материалами о компании, продуктах или услугах.
Модели различаются по возможностям и стоимости. Все они умеют понимать и генерировать текст, но последние версии точнее учитывают контекст и дают более логичные ответы. Более продвинутые модели используют больше токенов, поэтому их запросы обходятся дороже.
Токен — это фрагмент текста, который GPT использует для анализа. Примерно 1 токен = 3–4 слова на русском языке. Максимальное число токенов ограничивает длину ответа: чем больше значение, тем длиннее может быть ответ.
Это описание, на основе которого бот формирует ответы. Правильные фразы, заложенные в установку, помогут добиться точных и контекстных ответов от AI.
GPT-ассистент — это персональный AI-помощник, который работает только с вашими документами и данными.
— В поле System instructions опишите, чем он должен заниматься (см. раздел ниже — Как написать инструкцию для GPT).
— В разделе Tools включите инструмент File search — он позволяет ассистенту работать с вашими файлами.
— Укажите тред — это цепочка сообщений, где сохраняется контекст диалога. Используйте переменную %answer_x.thread_id%, чтобы бот «помнил» предыдущие сообщения пользователя.
— Добавьте инструкцию — описание задач ассистента. Можно скопировать текст инструкции, указанный на OpenAI.
1. Пишите конкретно и ясно. Опишите проблему, цель бота и контекст, который считаете важным. Используйте простой язык, избегая двусмысленности.
2. Добавляйте примеры. Покажите формат ответа, стиль или желаемую структуру.
3. Укажите роль и персонифицируйте бота. Например: «Ты юрист, который специализируется на гражданском праве».
После тестирования корректируйте инструкцию, пока не получите нужный результат.
Примеры ботов с GPT
Мы собрали готовые шаблоны ботов, которые можно адаптировать под свой сценарий или просто узнать, как устроен бот внутри.
📚 База знаний с GPT (GPT-ассистент). Бот отвечает на вопросы о работе конструктора, сохраняет запросы в системе и направляет по разным сценариям.
Часто задаваемые вопросы о подключении нейросети к чат-боту
Вопрос: Какую нейросеть проще всего подключить к чат-боту?
Ответ: Наиболее простыми для интеграции являются OpenAI GPT (через API) и некоторые готовые решения от крупных облачных платформ, такие как Яндекс GPT или GigaChat, которые предоставляют подробную документацию.
Вопрос: Нужны ли глубокие знания программирования для подключения?
Ответ: Базовые знания необходимы для настройки API. Однако существуют визуальные конструкторы и no-code платформы, которые значительно упрощают процесс.
Вопрос: Сколько стоит использование API нейросети?
Ответ: Стоимость зависит от модели и объема обработанных токенов (слов/символов). У большинства провайдеров есть бесплатный начальный лимит, далее — помильная оплата.
Вопрос: Где хранить API-ключ безопасно?
Ответ: Ключ никогда не следует харнить в коде публично. Используйте переменные окружения, секреты на сервере или специальные менеджеры ключей, предоставляемые хостингом.
Вопрос: Может ли нейросеть в боте работать с моей базой знаний?
Ответ: Да, для этого используется метод RAG (Retrieval-Augmented Generation). Данные из вашей базы предварительно обрабатываются, векторизуются и подаются нейросети в контекст запроса.
Вопрос: Что такое «промпт-инжиниринг» и зачем он нужен?
Ответ: Это практика составления точных и эффективных текстовых запросов (промптов) к нейросети для получения предсказуемых и качественных ответов. Критически важен для работы бота.
Вопрос: Как ограничить темы, на которые может отвечать бот?
Ответ: Через систему промптов, где явно задается роль и область знаний бота, а также с помощью пост-обработки ответов и фильтрации входящих запросов.
Вопрос: Как обрабатывать ошибки и сбои API нейросети?
Ответ: В код бота необходимо добавить обработку исключений (например, таймаутов, ошибок квот) и предусмотреть fallback-ответы для пользователя на случай недоступности сервиса.
Вопрос: Можно ли подключить нейросеть к боту в Telegram или WhatsApp?
Ответ: Да, абсолютно. Нейросеть работает на серверной части (бэкенде). Вы создаете бота через BotFather (Telegram) или Business API (WhatsApp), а ваш сервер с интегрированным AI API обрабатывает входящие сообщения.
Вопрос: В чем разница между тонкой настройкой модели и настройкой через промпт?
Ответ: Тонкая настройка (fine-tuning) — это «дообучение» модели на вашем наборе данных, что требует больших ресурсов. Настройка через промпт — это управление поведением модели с помощью инструкций в каждом запросе, что проще и дешевле.
Чек-лист: ключевые шаги для интеграции ИИ в вашего бота
- Определите цель и сценарии использования нейросети в вашем боте.
- Выберите подходящую модель и провайдера AI-API (OpenAI, Anthropic, Yandex и т.д.).
- Зарегистрируйтесь у провайдера и получите секретный API-ключ.
- Изучите документацию к выбранному API (формат запросов, лимиты, стоимость).
- Настройте безопасное хранение API-ключа на вашем сервере или в облачной функции.
- Разработайте и оттестируйте базовый промпт (системную инструкцию) для нейросети.
- Напишите код на вашем бэкенде для отправки запросов к AI API и получения ответов.
- Добавьте в код обработку ошибок (сетевые сбои, исчерпание лимитов).
- Интегрируйте логику работы с нейросетью в диалоговый движок вашего бота.
- Реализуйте механизм предоставления контекста диалога нейросети (истории сообщений).
- Протестируйте бота на различных запросах, включая провокационные или выходящие за рамки.
- Настройте пост-обработку ответов (например, фильтрацию, добавление форматирования).
- Установите мониторинг расхода токенов и затрат на API.
- Подготовьте fallback-сценарии на случай, если нейросеть не отвечает.
- Спланируйте итеративное улучшение промптов на основе обратной связи пользователей.
