用途：为 Convex 应用搭建应用内 AI 智能体与 RAG 后端。
主要能力：@convex-dev/agent 提供持久化线程、消息历史、工具调用以及向量搜索/RAG 能力。默认通过 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 保存在 Convex 环境变量中。模型调用应在 action 中执行（如 SDK 需要则加 'use node'）。线程与消息应持久化在 Convex 中以获得持久性与响应式。其余细节资料未提供。