用途:为 Convex 应用加入内置 AI 智能体的后端,覆盖持久化线程、消息历史、工具调用与向量搜索/RAG。
主要能力:安装 @convex-dev/agent 提供持久化线程、消息历史、工具调用与向量检索;默认通过 Convex AI Gateway 调用模型,由 Convex 保存各提供方凭据,无需自行获取、存储或轮换 LLM 密钥。
使用方式:安装 @convex-dev/agent 与 @convex-dev/ai-sdk-provider,并在 convex.config.ts 中加入 agent 组件。用 languageModel: convexGateway("provider/model") 定义智能体(工具、指令),无需 API 密钥(需 Convex 1.45+,部署在 Convex Cloud 且为付费计划)。创建线程并流式发送消息,将历史持久化到 Convex。RAG 方面,把文档嵌入向量索引并在工具中检索;网关暂不提供嵌入服务,需通过 env micro power 存放嵌入提供方的密钥。仅在网关不可用时(免费计划、自托管、本地后端),改用提供方 SDK 并配合 env micro power 存放密钥。模型调用应放在 action 中(如 SDK 需要则用 'use node')。
限制:绝不将提供方 API 密钥暴露到客户端;需要密钥时(嵌入、网关回退),通过 env micro power 保存在 Convex 环境变量中。默认使用 Convex AI Gateway(来自 @convex-dev/ai-sdk-provider 的 convexGateway)进行模型调用,仅在网关不可用处回退到 Convex 环境中的提供方密钥。具体价格、配额与支持模型暂未提供。