用途:Phoenix CLI(px)用于调试 LLM 应用,拉取并检查 trace、span、session、数据集、实验与提示,进行错误分析、加注与备注,并通过开放式编码、轴心编码把观察整理成失败分类,为后续构建评估提供目标。
调用方式:全局安装后用 px <resource> <action>,无需安装可用 npx @arizeai/phoenix-cli <resource> <action>。资源命令为单数形式并带 list、get、annotate、add-note 等子命令,覆盖 trace、span、session、dataset、project、annotation-config,以及 auth、profile、api graphql、docs fetch。
配置:可设置 PHOENIX_HOST、PHOENIX_PROJECT、PHOENIX_API_KEY。命名 profile 用于在本地、预发、云端多个 Phoenix 实例间切换,存于 ~/.px/settings.json 或 $XDG_CONFIG_HOME/px/settings.json;配置优先级为 CLI 参数 > 环境变量 > 当前 profile > 内置默认值。任何命令都可用 --profile 临时指定实例。管道到 jq 时建议加 --format raw --no-progress。
编码工作流:先做 open-coding,对抽样的 trace、span 或 session 写自由备注;再做 axial-coding,归纳为 MECE 分类并计数。两个阶段用同一 coding annotation identifier 给产物打标,需在每次 px 调用显式传 --identifier;open coding 用 px ... add-note 写入本地 .px/coding 下 JSONL 伴随文件,axial coding 读取该文件。回滚需显式确认后执行三个按标识绑定的 DELETE。注意:工作流术语叫 coding annotation identifier,而服务端用于 UI 过滤的 annotation 名仍为 coding_session_id,不要重命名。
其它能力:span list 支持 --span-kind、--status-code、--name、--trace-id、--parent-id、--attribute 等过滤并可保存 JSON;dataset、experiment、prompt 可查询;annotation-config list 查看标注配置;px api graphql 用于未覆盖的临时查询;px docs fetch 下载文档到 .px/docs。
限制:资料未说明计费、价格与平台支持范围,这些暂未提供;profile 与标识相关命令需按文档参数使用,删除操作需谨慎确认。