Agent Playground
This is a playground for @convex-dev/agent.

- Pick a user to list their threads.
- Browse the user's threads.
- List the selected thread's messages, along with tool call details.
- Show message metadata details.
- Experiment with contextual message lookup, adjusting context options.
- Send a message to the thread, with configurable saving options.
- It uses api keys to communicate securely with the backend.
Read the docs for more details.
There is also a hosted version here.
关于 @convex-dev/agent-playground 的常见问题
@convex-dev/agent-playground 是什么?
A dashboard for the Convex Agent component.
如何安装 @convex-dev/agent-playground?
在项目目录运行 npm install @convex-dev/agent-playground,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^3.25.0 || ^4.0.0)、convex(^1.25.4)、convex-helpers(^0.1.103)、@convex-dev/agent(>=0.2.2-alpha.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 agent-playground,可以用 npx agent-playground 直接运行。
@convex-dev/agent-playground 支持 TypeScript 吗?
该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/convex-dev__agent-playground 是否存在。
@convex-dev/agent-playground 支持 ESM 还是 CommonJS?
以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。
@convex-dev/agent-playground 可以商用吗?
@convex-dev/agent-playground 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。
@convex-dev/agent-playground 的下载量有多少?
根据 npm 官方下载统计,@convex-dev/agent-playground 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,492 次,日均约 83 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。
@convex-dev/agent-playground 还在维护吗?
最新版本 0.0.23 发布于 2026/10/08(1 个月前);至今共发布 28 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/05/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。