用途：在 Convex 应用中搭建 AI 智能体、聊天机器人或 RAG 后端，提供持久化线程、消息历史、工具调用与向量搜索能力。
主要能力：使用 @convex-dev/agent 管理持久线程与消息；通过 Convex AI Gateway 默认调用模型，由 Convex 持有提供商凭据，无需自行获取、存储或轮换 LLM 密钥；支持工具调用与向量索引检索实现 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。
限制与规则：模型调用应放在 actions 中（SDK 需要时用 'use node'）；切勿在客户端暴露提供商 API 密钥，需要时（嵌入、网关回退）通过 env micro power 保存在 Convex 环境变量中；线程与消息持久化在 Convex 以获得持久性与响应式。