Перенос проекта с Файлбрейн в АйкаЧат

Это краткое пошаговое руководство по переносу вашего проекта с сервиса «Файлбрейн» в AikaChat.ru. Сервисы независимы и не имеют прямой интеграции, поэтому перенос выполняется вручную.

Важно: структура и настройки на стороне Файлбрейн и АйкаЧат могут отличаться. В этом руководстве мы переносим главное: файлы, теги, настройки модели, промпт и Намерения.

Шаг 1. Подготовка на стороне Файлбрейн

Сначала зафиксируйте все важные данные в текущем проекте Файлбрейн. Это понадобится для воссоздания конфигурации в АйкаЧат.

  1. Скачайте все файлы проекта. Зайдите в свой проект в Файлбрейн и выгрузите все документы, которые использовались в базе знаний.
  2. Скопируйте настройки проекта. В разделе настроек проекта сделайте скриншоты или выпишите: промпт, выбранную модель, настройки памяти, ТекстСплиттер, включено ли Логирование и блок «Расширенные настройки».
  3. Зафиксируйте теги на файлах. Откройте список файлов и скринами сохраните, какие теги были навешаны на какие документы. Это поможет аккуратно восстановить теги в АйкаЧат.
  4. Отдельно сохраните код Намерений. Если в Файлбрейн были настроены Намерения, скопируйте JSON‑код или конфигурацию в отдельный файл.

Шаг 2. Создаём проект в АйкаЧат

  1. Зарегистрируйтесь на AikaChat.ru. Создайте аккаунт на платформе и войдите в личный кабинет.
  2. Создайте новый проект. В разделе проектов добавьте новый проект и:
    • воссоздайте промпт по аналогии с Файлбрейн;
    • подберите модель и параметры памяти;
    • перенесите ключевые «Расширенные настройки»;
    • при необходимости настройте раздел «Демо» (видимость, заголовки, тексты);
    • включите Логирование, если оно использовалось в Файлбрейн.

    Важно: при создании проекта вы выбираете, с какой нейросетью будет работать бот - Яндекса или OpenAI (ChatGPT). Этот выбор потом изменить нельзя: проект, созданный под Яндекс, будет работать только с Яндекс моделью; под OpenAI - только с OpenAI моделью.
    Переключить один и тот же проект на другого провайдера нельзя. Можно только создать новый проект.
    У разных провайдеров разная технология обработки текста, поэтому заранее решите, какую нейросеть хотите использовать. Модели внутри одного провайдера можно менять (напр. при OpenAI провайдере можно выбирать модели 4о, 4.1, 5.2 и т.д.).

    Важно: Ключ платформы АйкаЧат подключает только модель Яндекса. Чтобы использовать ChatGPT (OpenAI), понадобится свой ключ от OpenAI или доступ через прокси‑сервис.

  3. Загрузите файлы в Базу Знаний. Перейдите в Базу Знаний проекта и загрузите все ранее выгруженные файлы. Перед загрузкой проверьте настройки сплиттера в настройках проекта:
    • если файлы в основном в формате Q&A, лучше выбрать режим «Маркдаун Разделитель Aikachat»;
    • рекомендуемый размер чанка - 4000, перекрытие - около 150 символов.
    • во всех остальных случаях стандартные настройки с Рекурсивным разделителем и 1500 символов чанки с перекрытием в 150 символов подойдут для большинства кейсов
    • Важно: это общие рекомендации, но Вы должны отталкиваться от ваших специфических данных и потребностей
  4. Повесьте теги на файлы. Используя скриншоты из Файлбрейн, восстановите теги на нужных документах. Будьте внимательны к орфографии - проверьте имена тегов на опечатки.
  5. Перенесите Намерения (если использовались). В разделе Намерений вставьте ранее сохранённый JSON‑код и включите Намерения перед сохранением настроек.
  6. Протестируйте в Песочнице. Откройте Песочницу проекта и задайте несколько типичных вопросов, чтобы:
    • проверить доступ к LLM и индексированным файлам;
    • убедиться, что ответы приходят из нужных документов.
    Обратите внимание, что в Песочнице используется собственный промпт и настройки поиска - подстройте их так, чтобы они были максимально близки к настройкам вашего боевого проекта.

Шаг 3. Перенос интеграций

3.1. Интеграция через iframe или JS‑виджет

Если на вашем сайте уже был подключён чат через iframe или JS‑виджет Файлбрейн, вам нужно обновить код и настройки, чтобы использовать новый проект АйкаЧат.

  1. В АйкаЧат откройте проект и перейдите в раздел «Настройки → Демо».
  2. Проверьте и обновите тексты приветствия, заголовков и кнопок.
  3. Добавьте домен вашего сайта в список разрешённых доменов.
  4. Замените старый код на вашем сайте на новый код из АйкаЧат.

Подробнее: интеграция iframe, чат‑виджет.

3.2. Интеграция с плагином ГетКурс

Если вы использовали плагин Файлбрейн в ГетКурс, необходимо обновить настройки на стороне ГетКурс, чтобы подключить новый проект АйкаЧат.

  1. В АйкаЧат зайдите в раздел «Настройки аккаунта → Доступ к API» и скопируйте новый API‑ключ платформы.
  2. Откройте Базу Знаний и в адресной строке браузера скопируйте идентификатор проекта.
    Пример URL: https://aikachat.ru/project/d3315c4731367870cb017ffcfe5d3cb5/ Из него нам нужна только часть: d3315c4731367870cb017ffcfe5d3cb5
  3. Зайдите в настройки плагина на стороне ГетКурс и:
    • замените старый API‑ключ на новый из АйкаЧат;
    • замените старый идентификатор проекта на новый project_id.
  4. Обратите внимание: в некоторых сборках Воронок отдельные ноды (особенно ноды автовебов) могут иметь включённую опцию «переназначить project_id». В этих нодах тоже могут оставаться ссылки на старый проект Файлбрейн - замените project_id на новый айди проекта на АйкаЧат.
  5. Сохраните настройки плагина и воронок.

Шаг 4. Как проверить цепочку из ГетКурс

  1. В Воронках на ГетКурс включите режим отладки.
  2. От имени тестового пользователя задайте вопрос в отделе, где подключён бот.
  3. Убедитесь, что Воронки перехватили и обработали запрос.
  4. Проверьте, что цепочка дошла до шага передачи запроса в АйкаЧат.
  5. Убедитесь, что ответ вернулся пользователю в ГетКурс.
  6. На стороне АйкаЧат зайдите в раздел «Журнал» и найдите входящий запрос: откройте детали, посмотрите используемый промпт, теги и файлы.
  7. Важно: если на стороне платформы АйкаЧат произошла ошибка до отправки ответа обратно в ГетКурс, попытка/ошибка всё равно будет записана в Журнал. Если записи в Журнале нет - запрос в АйкаЧат никогда не приходил! В этом случае проверьте цепочку Воронок в ГетКурс.

Нужна помощь?

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

При любых вопросах по переносу с Файлбрейн на АйкаЧат, пожалуйста, обратитесь в поддержку.