persona-inspect

What problem does it solve?

When persona-related features behave unexpectedly, it’s hard to pinpoint whether the underlying SQLite data—especially cross-table aggregates and LLM trace records—is correct.

Core Features & Use Cases

• Cross-table persona aggregation inspection: quickly view user persona “whole picture” including relationships, recent messages, score changes, and today’s usage.
• LLM health and trace troubleshooting: inspect error distributions, latency percentiles, max_rounds, daily usage, and format round-level think/tool_call/tool_result details for the trace pipeline.
• Schema discovery (DDL): list all persona_ prefixed tables’ DDL to support targeted diagnosis and verification.

Quick Start

Run the persona-inspect tool to fetch a user’s persona profile in the target bot database by executing a single command like: python scripts/dev/persona_inspect.py user <user_id> --bot-id <bot_id>.