用途：为 Convex 应用接入应用内 AI 智能体与 RAG 后端，使用 @convex-dev/agent 提供持久化线程、消息历史、工具调用和向量搜索/检索能力。
主要能力：默认通过 Convex AI Gateway 调用模型，由 Convex 持有服务商凭据，无需获取、存储或轮换 LLM 密钥；支持定义智能体的工具与指令、创建线程并流式输出消息、在 Convex 中持久化历史记录；RAG 方面可将文档嵌入向量索引并在工具中检索。
使用方式：安装 @convex-dev/agent 与 @convex-dev/ai-sdk-provider，在 convex.config.ts 中添加 agent 组件；用 languageModel: convexGateway("provider/model") 定义智能体，无需 API 密钥（需 Convex Cloud 部署上的 convex 1.45+ 及付费计划）；创建线程并流式发送消息，历史持久化在 Convex 中。RAG 需将文档嵌入向量索引并在工具中检索；网关暂不提供嵌入服务，需通过 env micro power 存储嵌入服务商的密钥。仅当网关不可用（免费计划、自托管、本地后端）时，才用通过 env micro power 存储的密钥调用服务商 SDK。
规则与限制：模型调用默认走 Convex AI Gateway，仅在网关不可用时回退到 Convex 环境中的服务商密钥；绝不在客户端暴露服务商 API 密钥，需要时（嵌入、网关回退）通过 env micro power 保存在 Convex 环境中；模型调用需在 actions 中运行（SDK 需要时加 'use node'）；线程与消息需持久化在 Convex 中以获得持久性与响应式。其他细节暂未提供。