Karpathy的智能体工程终于有了专业的开发者工具！当一个智能体停止工作时，模型只是可能的原因之一。问题可能出在失败的工具、丢失的连接、未生效的接口更新，或是对话中更早的某个环节。@CopilotKit 围绕这一问题重新构建了其开源的 Inspector 工具。它嵌入在应用程序内部，监控用户、界面与智能体之间的完整交互。当出现故障时，Inspector 按钮会变红，标明故障名称，并直接定位到发生问题的环节。

但一个更难的问题是复现该故障。这是因为智能体并不总是遵循相同的路径执行。再次运行相同的提示词可能触发不同的工具、产生不同的响应，或者从不同的应用状态开始。Inspector 通过保存的对话线程（Threads）和一个隔离的智能体演练场（Agent Playground）来处理此问题。开发者可以打开出现问题的对话，选择“从此处尝试”，并将到该点为止的所有内容复制到演练场中。原始对话保持不变，同时可以测试另一条响应或工具路径。

线程可以在实时应用中打开，而助手消息可以跳转回其在 Inspector 中对应的上下文。所有这些都在 AG-UI 协议之下运行，该协议负责在智能体和界面之间传递消息、工具活动、状态变化和其他事件。这些交互还可以输入到 CopilotKit Intelligence 中，这样当相同的问题或有用的行为反复出现时，它可以成为一个有证据支持的“洞察”和一个提议的“技能（SKILL）.md”文件。开发者可以在智能体继承该技能之前进行审核、编辑和批准。

该工具还能帮助开发者发现问题、重建其上下文、测试另一条路径，并将反复出现的经验教训转化为智能体的改进。它是开源的，包含在 CopilotKit 的开发构建版本中。Intelligence 的设置只需一个提示即可开始。文档在此：https://docs.copilotkit.ai/inspector

我正在对此进行大量测试，并将很快通过一个实践演示更详细地介绍此内容。

Inspector

来源: https://docs.copilotkit.ai/inspector

功能展示

CopilotKit Inspector 是一个内置的调试工具，覆盖在您的应用之上。首次打开会显示主页。后续打开将返回到您上次使用的面板。

导航和线程

侧边栏包含三组：主页、工作台（线程、记忆）和检查（智能体、AG-UI 事件、前端工具、上下文）。能力仅在存在 A2UI 目录时显示。与工程师交谈位于侧边栏页脚。

当 Intelligence 已连接时，主页会在“发生了什么”右侧显示一个小型的“Intelligence 已连接”标签。

打开一个真实线程以检查其消息、AG-UI 事件和状态。元数据更新不会更改所选线程。

当线程没有真实行，或者线程被锁定时，Inspector 会保留概览视频、三个本地示例线程、它们的详情标签页以及引导式教程。示例不会发送真实的线程请求。启用减少动画后，视频将从暂停开始，并带有标记的播放控件。如果媒体加载失败，会在示例、详情和教程保持可用的同时显示回退文本。

项目上下文与使用情况

一个由 Intelligence 支持的运行时可以提供可选的受信任的项目元数据。有效的组织和项目名称以及计划标签会显示在账户条带中。每个模块都是独立的，因此缺失或无效的身份数据不会隐藏有效的使用或操作数据。

受信任的线程使用情况和兼容的提供操作仅在线程页脚中显示。它们独立渲染：使用情况可以在没有身份、计划、许可证或操作元数据的情况下出现，而仅操作元数据不会凭空发明使用情况。

“即将过期”描述的是未来24小时内保留策略的阈值。它并不能证明线程清理程序已运行，或 Inspector 已锁定或删除了线程。

当线程被锁定时，运行时的许可证状态控制文本和任何操作：

一个有效的受管理页脚可以针对匹配的受信任操作显示管理您的计划。受管理的企业版没有管理计划操作，团队自托管版没有托管操作；两者都可以保持有效的使用量可见。

Inspector 打开运行时提供的精确受信任 URL。它不会从项目详细信息构建 URL，也没有硬编码的注册回退。如果元数据许可证状态与运行时的许可证状态冲突，则以运行时状态为准控制文本，Inspector 在不隐藏有效使用量的情况下隐藏操作。

旧的运行时、核心和 Inspector 版本无需同步部署即可保持兼容。旧的 V1 生产者会让 usage.expiringSoonCount 不存在，而过期前的共享和运行时版本会忽略或移除来自新生产者的附加叶子节点。旧的 Inspector 会忽略它不渲染的元数据；新的 Inspector 会检测旧的核心和运行时支持，并使用安全的元数据缺失回退。在任何混合配置中，显式的 threadEndpoints 始终是权威，元数据永远不会启用线程工作。

显示或隐藏 Inspector

默认情况下，Inspector 仅在 localhost、127.0.0.1 和 0.0.0.0 上显示。将 enableInspector 设置为 false 可在这些主机上隐藏它：

{children}

将 enableInspector 设置为 true 可在其他主机上（包括生产构建中）显示它。CopilotKit 始终使用显式的 true 或 false 值。

NEXT_PUBLIC_COPILOTKIT_LICENSE_KEY 是一个浏览器可见的可发布密钥，与服务器端的 CPK_INTELLIGENCE_API_KEY 是不同的凭据，后者由 copilotkit project select 写入您的 .env 文件。服务器端密钥由 运行时端点 中描述的 CopilotKitIntelligence 客户端使用。不要将两者互换，切勿将服务器端密钥暴露给浏览器。