用途：Phoenix 内置名为 PXI 的 AI 助手，本资料是其开发指南，用于在修改 PXI 前端或后端行为、扩展 PXI 工具接线、更新 PXI 运行时等场景下参考。
主要架构：模型可见层（工具定义、系统提示组装、能力指引）由服务端负责；浏览器只负责执行与派发。工具名称是服务端声明与浏览器派发之间的集成键。新增或编辑工具通常同时涉及服务端与前端。资料指出系统提示组装在下一迭代将位于服务端。服务端持有所有发给 LLM 的 ToolDefinitions 与能力提示；浏览器持有工具运行时处理器与输入解析器、UI 状态、能力快照和每轮 UI 上下文载荷。
工具类型：分三类。外部（静态）工具始终声明，服务端发出 ToolDefinition(kind="external")，经数据流协议转发给浏览器并由 AI SDK 派发给注册处理器；上下文工具 executes_on="client" 仅在用户已解析的 Phoenix UI 上下文提供全部所需上下文名时声明；上下文工具 executes_on="server" 由服务端在进程内构建 callable，结果以工具输出块流式返回。服务端注册位置分别在 src/phoenix/server/agents/tools/external/<tool>.py 经 registry.py 的 EXTERNAL_TOOLS，以及 src/phoenix/server/agents/tools/<tool>.py 经 CONTEXTUAL_TOOLS；浏览器处理器入口在 app/src/agent/extensions/toolRegistry.ts，客户端上下文工具还需由拥有该 UI 的 React 组件挂载 registeredClientActions 条目。
选择依据（决策矩阵）：仅需读取或计算服务端已认证数据的工具选服务端执行的上下文工具；会改变浏览器状态（筛选、表单、导航）或使用仅浏览器可用的运行时（just-bash 沙箱、IndexedDB、页面 DOM）的选客户端执行的上下文或外部工具；只在特定页面或资源（项目、追踪、span）上才有意义的选上下文工具；与路由或选择无关、始终相关的选外部工具；需要凭证、密钥或特权数据库写入的选服务端执行的上下文工具，绝不放客户端；可从任意页面调用且输出独立于当前选择的选外部工具。
扩展阅读资源：新增、编辑或移除 PXI 工具时读 resources/extending-tool-registry.md；增改或审阅 PXI 智能体系统提示及其贡献模块时读 resources/system-prompt-xml-conventions.md；向聊天请求注入每轮页面或 UI 状态、清理用户可控值、保留提示缓存前缀时读 resources/per-turn-context-and-cache-management.md。
反模式：不要在不使用上下文注册表的情况下声明依赖 UI 状态的客户端执行工具，始终声明的工具会因页面变化而失败并产生嘈杂的模型错误；不要把浏览器变更逻辑通过服务端上下文工具推给服务端，服务端没有 DOM 无法遵循用户当前视图；不要在前端复制工具的 JSON schema，服务端是模型可见 schema 的唯一来源，浏览器只需输入解析器；不要把特权 shell 或数据库授权检查放进浏览器代码，应在执行边界把能力转换为可信运行时策略。
验证：按所触及的 PXI 层面使用相应层级的验证，验证命令参见 makefile。
限制：资料未提供具体收费、价格、平台信息或其他使用步骤，亦未给出安装命令与代码示例细节，相关内容暂未提供。