Release Notes

Webhook: индексация документов в базе знаний

• На тот же tenant webhook_url приходят kb.completed и kb.failed после успешной или окончательно ошибочной индексации документа.
• Тело: event, document_id, space_id; у ошибки дополнительно error_code. Подпись и ретраи — как у Speech-webhooks.

Speech · Webhooks →

Онлайн-демо на сайте: своя запись → текст, разбор и QC

• На страницах /demo и Speech можно загрузить аудио или видео без регистрации и пройти полный контур: расшифровка → аналитика → контроль качества.
• Прогресс и результат видны сразу на странице; чтобы сохранить работу и продолжить в кабинете — регистрация по email.
• Ограничения demo: до 16 МБ на файл, не чаще 2 загрузок в час с одного IP; данные обрабатываются в РФ и хранятся ограниченное время.

Онлайн-демо →·Speech →

Виджет чата: выше лимит и превью в кабинете

• Лимит запросов виджета на сайте: до 60 в минуту (раньше 20).
• В кабинете → настройки чата — живое превью виджета с вашим public_key.

Public API — список чатов →

MCP: схемы инструментов и фильтры по каналам

• В ответе tools/list — строгие JSON Schema аргументов: удобнее подключать Cursor, Claude и своих агентов.
• Поиск коммуникаций принимает фильтры kind, channel_type, direction и participant_role (звонок / чат / email и каналы).
• Каталог базы знаний (list_kb_*) доступен агентам в том же MCP-эндпоинте.

MCP API →·MCP в кабинете →

Встраивание чата: теперь нужен public_key

• GET /v1/chats/list возвращает public_key (wk_…) — ключ для сниппета на сайте (data-widget-key).
• Интегратор собирает эмбед из списка чатов: достаточно data-widget-key = public_key.
• Старые сниппеты с одним data-tenant-id больше не авторизуют виджет — скопируйте новый код из кабинета или из Public API.

Public API — список чатов →

Публичный MCP и хост виджета

• Внешние агенты подключаются к кабинету по MCP: https://mcp.a5x.pro/mcp (Streamable HTTP, JSON-RPC). Тот же ключ sk_live_…, что для REST.
• Доступны инструменты по коммуникациям, базе знаний, QC, памяти, спикерам и конфигам чата. Виджет на сайте MCP не вызывает.
• Скрипт виджета отдаётся с https://w.s2t.a5x.pro — обновите сниппет, если указан другой origin.

MCP API →·MCP в кабинете →

База знаний: редактор документов и ИИ-помощник

• В пространстве базы знаний можно создать свой markdown-документ (не только загрузить файл) и открыть его в полноэкранном редакторе.
• Режимы просмотра: визуальный редактор, исходный Markdown и split — правки сразу попадают в документ, после сохранения запускается индексация.
• ИИ-помощник: переписать / сократить / расширить / оформить FAQ по выделению или всему тексту; «Черновик» собирает статью по выбранным коммуникациям (до 16 диалогов).
• В чате ассистента можно попросить доработать документ: ответ сначала в режиме ревью (принять / отклонить блоки), затем «Сохранить».
• Экспорт в PDF (имя файла по заголовку и дате), предупреждение при уходе с несохранёнными правками, кнопка «Сохранить» только при изменениях.

Статусы summary/qc/memory: skipped и memory_generation_status

• summary_generation_status и qc_generation_status: pending | processing | success | error | skipped.
• Вместо not_requested теперь skipped — summary или QC не выполнялись.
• Новое поле memory_generation_status с тем же набором значений — готовность извлечения памяти спикеров.
• В списке коммуникаций по спикеру статусы генерации больше не отдаются: смотрите их в GET /v1/communications.
• Для опроса терминальные статусы: success, error, skipped. Пока идёт генерация — pending или processing.

Public API · Коммуникация →·OpenAPI →

Память спикеров и webhook memory.completed

• Память спикеров работает только вместе с аналитикой коммуникаций: в кабинете тумблер памяти рядом с voiceprint, при выключении аналитики память и сопоставление спикеров тоже выключаются.
• В настройках — раздел «Признаки памяти»: галерея категорий для клиента и сотрудника (добавление по роли, вкл/выкл, подсказки для извлечения, подсказки ИИ).
• Извлечение памяти идёт после готового summary по звонку (нужны summary=true / аналитика и включённая память); учитываются только включённые признаки аккаунта.
• Новый webhook memory.completed: после извлечения фактов на webhook_url приходит POST в том же формате, что summary.completed / qc.completed (event, task_id, communication_id).
• Биллинг памяти — отдельная строка speech.memory в детализации расходов.

Speech · Webhooks →·Память по клиенту и сотруднику →

Чат и Public API: без режимов speech/docs, поиск по коммуникациям и памяти

• В настройках чата и Public API убраны enabled_modes / modes (speech / docs). Какие источники доступны агенту, задаётся инструментами сценария (workflow) и составом сотрудника — не переключателем режимов.
• В теле POST /v1/chats/{chat_id}/messages больше нет поля modes; по-прежнему можно передать history и space_ids.
• Агент ищет по коммуникациям (kind: call / chat / email), а не только по звонкам; факты из памяти спикера подтягиваются отдельным шагом, когда этот инструмент включён у сотрудника.
• Пустая выдача оформляется явным «данных не найдено» без выдуманных фактов; меньше повторных поисков по синонимам.

Public API · список чатов →·Public API · сообщение в чат →·Public API · коммуникации →

Коммуникации: звонки, чаты и письма в одном списке

• В кабинете и Public API коммуникации различаются по kind (call | chat | email) и channel_type (например phone, telegram, widget, whatsapp, email).
• Поле content — единый массив реплик по каналу.
• Список коммуникаций, конспект и память работают для касаний из разных каналов.

Public API · коммуникации →·Speech API →

База знаний: корректные RTF-документы

• Файлы .rtf индексируются как читаемый текст, а не как разметка RTF — поиск и ответы агента по таким документам становятся точнее.
• В кабинете превью RTF показывает содержимое документа; вкладка с проиндексированным текстом открывается сразу, когда чанки уже готовы.
• Ранее загруженные RTF стоит переиндексировать, чтобы обновить фрагменты в базе знаний.

Public API: список чатов и сообщения агенту

• GET /v1/chats/list — активные чаты аккаунта: id, имя и пространства базы знаний по умолчанию.
• POST /v1/chats/{chat_id}/messages — вопрос агенту: полный ответ { request_id, markdown, context } с источниками (коммуникации, документы, память).
• В теле можно передать history и space_ids; без них берутся настройки чата. Историю хранит интегратор.
• Отмена — обрыв HTTP-запроса. Тарификация как у сообщений чата. Список чатов доступен на паузе аккаунта; отправка сообщений — только при активном клиенте.

Public API — список чатов →·Public API — сообщение в чат →·Публичный API для чата — гайд в блоге →

Чат: быстрее ответы по подсказкам и меньше «пустых» анализов

• Популярные подсказки чата (KPI / жалобы / коммуникации про цену / недельные отчёты / QC) отвечают быстрее и стабильнее — без лишних шагов по базе знаний.
• Агент реже уходит в повторные поиски и раньше оформляет ответ по уже найденным данным.
• Короткое приветствие («привет») больше не запускает полный разбор коммуникаций: сразу подсказка, какой вопрос задать.
• Если по аналитическому вопросу не удалось получить данные, чат явно просит уточнить период или тему вместо ответа «из общих знаний».

Настройка и публикация чата на сайт →

Telegram-канал для чата и раздел «Интеграции»

• В кабинете появилась вкладка «Настройки → Интеграции»: коннекторы облачной АТС и Telegram-боты в одном месте.
• Можно подключить своего бота из @BotFather: токен хранится зашифрованным, webhook настраивается автоматически.
• Бот привязывается к конфигурации чата — пользователи пишут боту в Telegram так же, как встраиваемому AI-агенту на сайте (сценарий и база знаний чата).
• Статус подключения виден в кабинете: pending / active / error; при сбое можно повторить активацию без повторного ввода токена.

Как подключить Telegram-бота к чату →·Настройка и публикация чата на сайт →·Как подключить облачную АТС →

Стерео: каналы и привязка спикеров

• В доке уточнено: при channel_speakers=true канал 1 (левый) → SPEAKER_00, канал 2 (правый) → SPEAKER_01; false — downmix в mono. Порядок и role в speakers, а также direction, раскладку каналов не задают.
• Привязка меток SPEAKER_* к участникам CRM в summary строится по содержанию диалога (самопредставление, client vs staff), а не по порядку списка speakers — в том числе без voiceprint.

Speech API →·Участники разговора →

Пауза клиента: чтение Public API

• При is_active=false остаются доступны GET /v1/communications, /v1/communications/list и /v1/speakers/profile (как balance/payment/session).
• Speech/STT по-прежнему отвечают 403 client_inactive — новые задачи на паузе не принимаются.
• Если клиент долго остаётся на паузе, аккаунт и данные могут быть полностью удалены по политике хранения.

Public API →·Коммуникации →

Public API: пауза клиента и флаги баланса

• При is_active=false Public API отвечает 403 с code: client_inactive (как Speech), а не 401 — можно отличить паузу от отозванного ключа.
• Ошибки авторизации в едином формате: { error: { message, type, param, code } } (invalid_api_key, missing_api_key, malformed_bearer, client_inactive).
• GET /v1/balance возвращает balance_rub, is_active и allow_credit.
• На паузе остаются /v1/balance, /v1/payment-link и /v1/session-link — чтобы пополнить картой или зайти в кабинет и оплатить счёт.

Public API →·Баланс →·Payment-link →

Коннекторы АТС: звонки в Speech без ручной выгрузки

• В кабинете доступна вкладка «Настройки → Интеграции → АТС», где вы подключаете облачную АТС и автоматически загружаете записи звонков в Speech.
• Для webhook-вендоров предоставляется URL коннектора и статус приема событий; для poll-вендоров поддерживается опрос и запуск дозагрузки.
• Коннектор можно включать и выключать одной кнопкой — чтобы временно остановить загрузку без удаления настроек.
• URL и параметры интеграции обновляются по запросу: можно сменить адрес коннектора и проверить связь перед включением.
• Поддержаны основные вендоры: МегаФон ВАТС, Манго Office, Tele2 ВАТС, Telphin, Beeline Cloud PBX, Zadarma, OnlinePBX и Sipuni.

Как подключить облачную АТС →

Память: сводка профиля по истории звонков и QC

• В карточке памяти участника — блок «Сводка»: короткий обзор профиля, а не разрозненный список фактов.
• По клиенту сводка складывается из устойчивых фактов памяти и линии недавних касаний: даты, направление, категория, суть разговора.
• По сотруднику — из роли и экспертизы в памяти плюс паттернов общения и зон роста по недавним оценкам QC.
• Категории памяти переписываются в плотные эссе: без дублей, однодневных статусов и служебного шума из расшифровки.
• Контекст организации из настроек помогает формулировать, чем человек важен именно вашей компании.

Память по клиенту и сотруднику →

Несколько чатов и готовые сценарии

• У одного клиента — несколько конфигураций чата: имя, сценарий, пространства базы знаний, стиль и разрешённый origin.
• У каждой конфигурации свой код вставки — можно поставить разные чаты на сайт, в личный кабинет и во внутренние разделы.
• data-widget-id необязателен: без него используется чат «По умолчанию» (обычно сценарий «ИИ Агент»).
• Готовые сценарии с понятными подписями: ИИ Агент, База знаний, Поддержка клиентов, Аналитика звонков, Для сотрудников.
• В настройках чата при выборе сценария видно, для чего он нужен и как его использовать.
• Редактор сценариев: пустой шаблон больше не подменяется полной схемой; элементы внутри отделов выравниваются; схема при открытии сразу по центру.

Сопоставление спикеров: переключатель в кабинете

• В Настройки → Аналитика — опция «Сопоставление спикеров»: связка участников между звонками по голосовому профилю.
• Модуль включается и выключается одним переключателем; тарифицируется дополнительно к речевой аналитике.
• Уже построенные отпечатки сохраняются при выключении — новые звонки перестают списывать опцию.

Сопоставление спикеров →

Чат и агент: цитаты [#n] и чистые источники

• В ответах агента канонический маркер источника — [#n]; в чате это кликабельные цитаты #n с карточкой источника.
• Чипы коммуникаций, документов и памяти под ответом остаются только если текст реально на них опирается.
• Выдуманные URL коммуникаций и служебные идентификаторы из ответа убираются.
• В редакторе сценария у сотрудника, диспетчера и сборщика — слайдер «Лимит ответа» (длина генерации в токенах).

Шаблоны отделов и гайды по сценариям

• Шаблон отдела можно перетащить в сценарий как блок «Шаблон»: структура только для просмотра, при запуске подставляется содержимое шаблона.
• В разделе «Сценарии» — ссылки на гайды: виртуальная организация, маршрутизатор, сборщик, контроллер, режимы работы и шаблоны отделов.

QC в ответах агента, маршруты и тарифы хранения

• Если включён контроль качества, агент опирается на ваш чек-лист критериев QC и отвечает по названиям и кодам из настроек.
• Режимы отдела по связям на холсте: один исполнитель, цепочка или параллельный запуск; в инспекторе диспетчера — «на выбор» и «обязательные».
• Из пользовательского ответа убираются блоки «рассуждений» модели.
• Хранение базы знаний: до 10 000 фрагментов бесплатно; свыше — по ставке от полного объёма. Калькулятор и FAQ на сайте обновлены.

Тарифы →·Контроль качества →

Настройки кабинета: навигация на мобильных

• Вкладки разделов настроек с иконками: API, тарифы, чат, сценарии, аналитика, QC, контекст для AI, система.
• На узких экранах вкладки переносятся на несколько строк — все разделы видны без горизонтальной прокрутки.
• На широких экранах заголовок и вкладки выстраиваются в одну линию.

Конструктор виртуальной организации. Сценарии мультиагентных взаимодействий

• В настройках кабинета — раздел «Сценарии»: список сценариев и шаблонов, превью схемы, включение и удаление.
• Визуальный редактор на холсте: отделы, сотрудники, маршрутизатор, сборщик ответов, связи между узлами.
• Контроль результата на узле: проверка ответа с возвратом на доработку при отклонении.
• Сборщик отдела: склейка ответов, лучший ответ или синтез итога через LLM по инструкции и структуре отчёта.
• Кнопка «Предложить» — черновик сценария по недавним звонкам; подсказки для промптов сотрудников и проверки.
• Прогон сценария из кабинета для проверки перед публикацией.

Чат аналитики: статус работы агента

• Во время ответа чат показывает, на каком этапе агент: отдел, сотрудник и текущее действие (поиск коммуникаций, метрики, база знаний и др.).
• Улучшена плавность стриминга ответа без задержек отображения текста.

Чат аналитики: цитаты на источники

• Ответы агента корректно отображают ссылки на источники в формате [cite: n] — как кликабельные цитаты в тексте.
• Markdown-ссылки и цитаты не конфликтуют при рендеринге ответа.

Настройка категорий звонков в кабинете

• В настройках речевой аналитики можно управлять категориями звонков и их критериями: каталог шаблонов, включение, редактирование и удаление.
• Кнопка «Предложить» подсказывает сценарии и критерии на основе недавних коммуникаций.
• Фильтр категорий в списке сессий строится по настроенным категориям клиента, а не по фиксированному справочнику.
• Новым аккаунтам при регистрации подставляются категории по умолчанию из каталога.

Роли speakers: allowlist и приведение к employee

• В speakers[].role допустимы: client, sales, support, employee, unknown.
• Значения вне списка (например manager, supply) приводятся к employee; пустая роль — к unknown.

Speech API — speakers →

Справочник критериев и сценариев QC в Public API

• В документации Public API — таблицы кодов критериев QC и сценариев.
• Кнопка «Предложить» подсказывает сценарии и критерии на основе недавних коммуникаций.
• Уточнено: id коммуникации = task_id из webhook; после события запрашивайте GET /v1/communications — в ответе транскрипт, summary и qc_evaluation.

Public API →

Модуль Контроль качества коммуникаций

• В настройках кабинета можно настроить модуль контроля качества коммуникаций по заданным критериям.
• Выбор готового сценария из библиотеки или создание собственного. Управление критериями контроля качества.
• Анализ и оценка коммуникаций по заданным критериям.
• Отправка вебхука qc.completed по готовности отчета. Расширение метаданных коммуникации в Public API для получения данных критериев.

Public API →

Настройка webhook в личном кабинете

• В настройках кабинета (Система) можно указать URL webhook для уведомлений о завершении транскрибации и аналитики.
• При сохранении URL проверяется тестовым запросом; пустое значение отключает уведомления.

Speech API →

User Summary — пользовательский отчёт по коммуникации

• Поле user_summary в результате коммуникации: свободный текст, markdown или JSON по промпту клиента.
• Настройки в кабинете: дефолтный промпт, переключатели структурированной аналитики и пользовательского отчёта.
• Поле доступно в Public API (детали коммуникации) и в аналитике сессии.

Speech API →·Public API →

Voiceprint, дашборд аналитики и настройки по умолчанию

• В аккаунте можно включать Voiceprint и дашборд аналитики.
• Если параметры не переданы в запросе транскрибации, применяются настройки аккаунта.

Speech API →

LLM: квоты и chat_template_kwargs

• Управление квотами LLM API.
• Поддержка chat_template_kwargs в chat completions для тонкой настройки шаблона модели.

LLM API →

Ссылка на оплату и session-link в Public API

• Эндпоинты payment-link и session-link: пополнение баланса и одноразовый вход в кабинет из CRM.
• Обмен session-link и обновлённая документация для интеграторов.

Public API →

Биллинг хранения векторов: единица vector_1k

• Единица тарифа RAG-хранилища сменена с vector_100k на vector_1k (эффективная ставка ₽/вектор сохранена).

Голосовые образцы и спикеры сессии в кабинете

• Управление голосовыми образцами и спикерами сессии в дашборде.
• Улучшения памяти и карточек спикеров в аналитике.

Sparse BM25 Encode в LLM API

• Эндпоинт sparse/BM25 encode для гибридного поиска по базе знаний.
• Поддержка sparse-векторов в эмбеддингах для Speech и RAG.

LLM API →

Voiceprint — распознавание спикеров по голосу

• Идентификация и сопоставление спикеров по голосовому отпечатку.
• Связка с памятью для устойчивых профилей участников.

Speech API →

Канальные спикеры и лимит файла 1024 МБ

• Опция channel speakers для стерео/канальной разметки участников.
• Максимальный размер загружаемого аудио увеличен до 1024 МБ.
• Долговременное хранение аудио для асинхронных задач.

Speech API →

Задачи и поручения в кабинете

• Раздел задач в дашборде: постановка и отслеживание поручений по коммуникациям.

История биллинга, RAG и хранилище в кабинете

• История списаний и пополнений в кабинете.
• Продукт RAG в тарифах, калькулятор ресурсов и управление хранилищем.
• Единица vector_100k для тарификации хранения векторов (позже заменена на vector_1k).

Срок хранения и биллинг хранилища Speech

• Настраиваемый срок хранения данных Speech, очистка по сроку и ежедневный биллинг storage.

Оплата через банк: пополнение баланса

• Услуги по предоставлению доступа к облачной платформе A5X Cloud банковским платежом.
• Настройки оплаты в кабинете и отслеживание статусов платежа.

Контекст организации в памяти Speech

• Организационный контекст в памяти клиента для более точных summary и ответов агента.

LLM Rerank

• Эндпоинт rerank для ранжирования документов в RAG-сценариях.
• Документация LLM API дополнена примерами rerank.

LLM API →

Storage в тарифах

• Опции хранения в тарифных планах и отображение в кабинете.

Integration API и шаблоны чатов

• Партнёрский Integration API: создание клиентов, ключи, отключение/включение, кейс email_taken.
• Страницы интеграций и шаблонов чатов в кабинете; публичная база чата.

Integration API →

Summary в результате транскрибации и webhooks

• Результат summary доступен в ответе транскрибации и в справочнике API.
• Webhook-доставка статусов транскрибации; проверка callback URL.

Speech API →

Семантический поиск по коммуникациям

• Векторный поиск по транскриптам и summary для аналитики и агента в кабинете.

Настройки кабинета и API настроек

• Страница настроек дашборда и API для управления параметрами аккаунта.

Память по спикерам

• Обновление фактов и профилей спикеров на основе summary коммуникаций.

occurred_at и расширение Speech API docs

• Поле времени события occured_at в коммуникациях и представлениях Public/Speech.
• Уточнены параметры и примеры в справочнике Speech API.

Speech API →·Public API →

Настройки чата аналитики

• API и UI кастомизации чата аналитики: внешний вид и поведение встраиваемого чата.

Public API: коммуникации и баланс

• Публичный REST API кабинета: список и детали коммуникаций, спикеры, баланс и история.
• Документация и примеры запросов в справочнике API.

Public API →

LLM API: авторизация и биллинг

• LLM API совместим с OpenAI: chat completions, embeddings, авторизация по API-ключу и биллинг потребления.

LLM API →

Биллинг и статус активности аккаунта

• Списания по продуктам, баланс и статус активности аккаунта.

Спикеры вместо «Клиенты» в кабинете

• Единая терминология: справочник и профили спикеров, роли участников коммуникации.

Аналитический агент: поиск и фильтры

• Агент аналитики лучше понимает запросы: фильтры по срокам, поиск по темам, работа с полным транскриптом.

Уточнение summary для сценариев без контакта

• Корректная обработка сценариев без контакта и системных реплик в summary.

Speech: async-задачи и summary

• Асинхронная транскрибация и генерация summary для Speech API.

Speech API →

Запуск Speech API — транскрибация

• Транскрибация: sync/async загрузка аудио, статусы задач и базовый контракт API.

Speech API →