diff --git a/VERSION b/VERSION index 06fb41b6..b9a05a6d 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.17.2 +1.17.3 diff --git a/docs/releases/1.17.3.md b/docs/releases/1.17.3.md new file mode 100644 index 00000000..834731d4 --- /dev/null +++ b/docs/releases/1.17.3.md @@ -0,0 +1,45 @@ +# Chatballs 1.17.3 + +## Диагностика работы агента + +- В меню действий диалога добавлено **«Скачать диагностику»**. Выгрузка + доступна владельцу и администратору, в том числе для закрытых диалогов. +- JSON-файл можно передать разработчику или поддержке для разбора: + в нём переписка, снимки запросов и ответов модели, доступные инструменты + и причины их недоступности, вызовы API, HTTP-статусы, ошибки, длительность + и передача оператору. +- Секреты и известные значения полей сайта удаляются, известные персональные + данные клиента маскируются. Выгрузка проверяет права и организацию на сервере + и фиксируется в журнале действий. +- Ошибка сохранения диагностики не отменяет ответ клиенту. + +## История и ограничения + +Полная трассировка сохраняется для новых ходов после обновления. Для старых +сообщений файл явно указывает отсутствие снимков. Настройки на момент хода +и текущие настройки экспортируются отдельно. + +Хранятся последние 20 снимков на диалог. Экспорт включает до 2000 последних +сообщений; сокращённые данные помечаются. Вложения не входят в файл. +При удалении диалога его диагностика также удаляется. + +## Проверки + +- Сборки internal-ui и backend-образа прошли. +- Целевые регрессионные проверки: 58 тестов пройдены, 1 пропущен. +- Окончательные проверки диагностики: 25 тестов пройдены, включая цепочку + списка заказов и деталей с внутренним id, ошибки API и провайдера, + удаление секретов, устойчивость записи и tenant/RLS-защиту PostgreSQL. +- Ruff, Django system checks и проверка соответствия миграций прошли. +- На штатном локальном backend браузером проверены скачивание валидного JSON + администратором и отсутствие пункта у сотрудника. +- GitHub CI проверил линтер и deployment CLI. + +## Обновление + +Штатный сервис `init` применяет `ai.0025_turndiagnostic` и +`tenancy.0043_turn_diagnostic_guards` перед запуском обновлённых backend и worker. +Используйте релизный `compose.yaml` и существующие override-файлы установки. +Перенос данных и изменение учётных записей не требуются. + +Описание формата: [Диагностика диалога](../conversation-diagnostics.md).