Воспроизводимый trace evidence · MIT + CC BY 4.0

Fixture для трейсинга agents и tools в Langfuse

Проверьте один детерминированный agent workflow с retrieval, generations, tool retries, terminal child error, source-side masking и недоступным telemetry exporter. В bundle входят код, tests, санитизированный результат и diagram.

Evidence относится к Python SDK 4.14.5 и одному self-hosted Langfuse 3.205.0. Recorded model и tool responses делают trace shape повторяемым, но не превращают локальный запуск в benchmark провайдера или latency.

Файлы

workflow.py Детерминированный agent workflow и safe trace sink langfuse_adapter.py Langfuse v4 adapter с explicit parentage test_workflow.py Тесты workflow, retry, masking и isolation test_langfuse_adapter.py Contract tests для adapter run_integration.py Runner для реального сервера с minimized output test_sanitized_evidence.py Проверки evidence и отсутствия credentials sanitized-trace-shapes-2026-08-26.json Проверенные shapes трёх сценариев sanitized-trace-shape-2026-08-26.svg Диаграмма из санитизированного JSON render_trace_diagram.py Детерминированный SVG renderer evidence-run-2026-08-26.md Версии, assertions, defects, команды и limits README.md Состав и команды для независимого запуска

Отдельные attempts

Timeout и успешный retry остаются двумя tool observations. Восстановление не удаляет первый сбой из истории.

Ограниченный evidence

Runner исключает inputs и outputs, копирует metadata по allowlist и отклоняет synthetic identifiers и Langfuse keys до записи JSON.

Изоляция сбоя

Сценарий с недоступным exporter подтверждает: fixture возвращает тот же application result, даже когда trace не доставлен.

Проверенные границы

Пятнадцать tests на стандартной библиотеке проверяют parentage, retry shape, levels children и root, masking, repeated runs, exporter isolation, сохранённый JSON и SVG. Remote run охватил happy, retry и terminal scenarios.

Лицензия MIT Лицензия CC BY 4.0 Прочитать проверенный tracing pattern