Трейсы — отладка прогонов агента

Трейс — это полный путь одного прогона агента: какая нода получила сообщение, какой промпт ушёл в LLM, что ответили инструменты, откуда получился итоговый ответ. Главный инструмент отладки, когда агент ответил не так, как ожидалось.

Панель Traces на канвасе

Кнопка Traces открывает список последних прогонов.

Важно: панель показывает свежие прогоны — они хранятся в памяти ядра (последние 200). После перезапуска ядра список пуст — это нормально, не поломка. Сделайте тестовый прогон, и трейс появится.

Debug-режим (запись в базу)

По умолчанию прогоны не сохраняются в базу — только в память ядра. Чтобы трейсы переживали перезапуск ядра, включите debug-режим:

• Включение: через ИИ-агента (MCP-тул trace_debug(on=true)) или запросом POST /api/traces/debug {"on":true}.
• Срок: максимум 24 часа, потом отключается сам. Повторное включение продлевает окно.
• Выключение: trace_debug(on=false) — новые прогоны перестают сохраняться, ранее записанные убираются из базы в течение суток.
• После выключения ничего не хранится. Если данные нужны дольше — заберите их, пока debug включён.

Зачем это нужно: debug-режим страхует отладку — если во время разбора сбоя ядро перезапустится, история прогонов не пропадёт. В остальное время база не растёт.

Чтение трейсов через ИИ-агента (MCP)

Агент, подключённый по ключу API, может отлаживать канву сам:

Тул	Что делает
trace_debug(on)	включить/выключить запись трейсов (свои канвы, максимум 24ч)
trace_last(nodeId)	последние прогоны ноды: id, время, ответ
trace_get(traceId)	полный путь прогона: каждая нода с промптом и ответом

Типовой цикл отладки: включить debug → прогнать агента → trace_last → trace_get → найти ноду, где ответ испортился → исправить → выключить debug.

Безопасность

• Трейсы видны только внутри своей организации — чужие прогоны недоступны.
• Секреты (ключи провайдеров) в трейсы не записываются.
• Окно debug — не дольше 24 часов, «включить навсегда» нельзя.