用途:Phoenix CLI(命令 px)用于调试 LLM 应用,围绕 Phoenix 数据做查询、标注与运维。可用全局安装后的 px,或免安装的 npx @arizeai/phoenix-cli 调用,命令形式为 px <resource> <action>。
主要能力:trace(list/get/annotate/add-note/delete)、span(list/annotate/add-note/delete,可按 span-kind、status-code、name、trace-id、parent-id 及属性过滤)、session(list/get/annotate/add-note/delete)、dataset、experiment、prompt、project、annotation-config 的列举与获取;支持 px api graphql 查询、px docs fetch、px setup 与 px self update。
使用方式:设置 PHOENIX_ENDPOINT、PHOENIX_PROJECT、PHOENIX_API_KEY;可用 px auth login 走 OAuth,auth status 查看凭据来源。命名 profile 存于 ~/.px/settings.json,支持列表、创建、切换等。配置优先级为 CLI 参数 > 环境变量 > 活动 profile > 最近的 .env.phoenix 文件 > 默认值。输出给 jq 时使用 --format raw --no-progress。
限制:删除类命令需环境变量 PHOENIX_CLI_DANGEROUSLY_ENABLE_DELETES=true,并需确认或用 -y/--yes;未设置时不执行删除。span list 默认按摄入倒序,非 start_time。px setup --no-input 需干净 git 仓库,超时无 trace 会以退出码 6 结束,不代表成功。其余未在资料中说明的功能、价格与平台信息暂未提供。