对流代理组件
在 Convex 上建有 AI 代理 , 有持续聊天线索, 工具调用, 流出,
和RAG(英语:RAG). 长期运行的代理工作流程在客户端时与用户界面分开
保持反应性更新.
npm i @convex-dev/agent
AI特工,在康维克斯上建造.
看这里的医生。 。 。 .
代理组件管理代理在静态中可以使用的线程和信件
或动态工作流程.
- 探员 提供抽象
用于使用 LLMS 来表示特定用途的单位
相关的模型,提示,
工具调用,以及相关行为
给其他特工,功能,API等等.
- 线索 持续
信件 并可由
多个用户和代理商(包括
人类代理人) (中文(简体) ).
- 在 Websockets 上使用 deltas 来流转文本和对象, 因此所有客户端都留在其中
同步效率高, 没有 http 流线 。 启用从 Aync 流出
函数.
- 对话背景 实值
每次LLM呼叫中自动包含,包括内置的混合向量/文本
搜索线索中的信息,并选择从中查找其他信件
线程( 对于相同的指定用户) .
- RAG 区域咨询小组 支持迅速的技术
来自其他来源的扩充,或放在前面,或作为工具
打电话 与
RAG 组件,或DIY(英语:DIY).
- 工作流量 允许建筑
多步骤操作可以跨越代理商,用户,持久可靠.
- 文件 支持线索历史
自动保存到 文件存储
倒计时.
- 调试 由回调启用,
页:1 代理操场 在你身边
可以在提示和上下文设置上检查所有元数据并进行迁移,以及
检查仪表板.
- 用法跟踪 很容易设定
提高,使每个供应商、每个模型、每个用户、每个代理人、,
用于计费( m) .
- 限制费率,由电源
限速器组件, (中文(简体) ),
帮助控制用户与代理商互动并保存您的速度
从超过您的 LLM 提供者的极限.
在此读取相关的 Stack 帖子。 。 。 .
读取 文档 更多细节.
以实例播放 :
git clone https://github.com/convex/agent.git
cd agent
npm run setup
npm run dev
找到窃听器了吗? 特质请求?
放在这。 。 。 .
关于 @convex-dev/agent 的常见问题
@convex-dev/agent 是什么？
用于AI代理的Convex组件有持续聊天线程,工具调用,流出和RAG.
如何安装 @convex-dev/agent？
在项目目录运行 npm install @convex-dev/agent，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：ai（^7.0.129）、convex（^1.46.0）、convex-helpers（^0.1.127）、@ai-sdk/provider（^4.0.0）、@ai-sdk/provider-utils（^5.0.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@convex-dev/agent 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@convex-dev/agent 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@convex-dev/agent 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@convex-dev/agent 可以商用吗？
@convex-dev/agent 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
@convex-dev/agent 的下载量有多少？
根据 npm 官方下载统计，@convex-dev/agent 在 2026/10/11 – 2026/11/09 这 30 天内被下载 1,036,428 次，日均约 34,548 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@convex-dev/agent 还在维护吗？
最新版本 0.7.9 发布于 2026/10/29（12 天前）；至今共发布 170 个版本，其中过去 12 个月发布了 22 个；首次发布于 2025/04/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。