Black Box 是一款专为 AI Agent 设计的不可破坏审计日志系统，其核心理念类似于飞机的‘飞行数据记录仪’。它能够实时将 Agent 的关键操作、错误信息以及推理链条流式传输到持久化的云数据库中，确保在本地环境崩溃或容器意外终止时，所有重要行为记录依然完整保存。该系统基于 TiDB Zero 构建，具备企业级的数据一致性和高可用性保障。用户可通过标准 MySQL 连接参数配置自己的 TiDB 实例，也可选择由系统自动创建临时数据库作为日志存储的后端。无论采用哪种方式，Black Box 都能为 AI 系统的运行轨迹提供一份可靠、可追溯的审计线索，是提升系统可观测性与合规性的关键基础设施。
核心功能特点
- 实时流式写入：将 Agent 的操作、错误和推理过程以不可篡改的方式实时写入云端数据库。
- 持久化存储保障：即使本地容器崩溃，日志仍可在云端长期保留，实现真正的‘系统崩溃生存’能力。
- 结构化日志格式：通过 `agent_logs` 表记录时间戳、级别、消息和元数据（JSON），便于查询与分析。
- 灵活的部署模式：支持用户自带 TiDB 数据库，也提供自动创建临时数据库的备用方案。
- 命令行交互接口：提供简洁的命令行工具用于手动记录事件和读取历史日志，方便调试与审计。
适用场景
Black Box 最适用于对系统行为可追溯性要求极高的场景。在开发或部署 AI Agent 时，开发者常面临因容器重启导致本地日志丢失的问题。Black Box 通过将日志同步至云端，彻底解决了这一痛点，使开发者能够回溯 Agent 在崩溃前最后 100 步的行为序列，从而快速定位并修复问题。对于需要满足严格合规要求的金融、医疗等行业应用，该工具提供的完整审计轨迹可用于证明系统决策的合理性，满足监管机构的审查需求。此外，在复杂的 AI 系统运维中，当出现异常输出或性能下降时，通过 Black Box 检索相关日志，可以快速关联具体操作与结果，显著提升故障排查效率。无论是内部研发还是对外提供服务，Black Box 都为 AI 系统的稳定运行和事后复盘提供了坚实的数据基础。