用途：在 Convex 平台上构建持久化、有状态的 AI 智能体，覆盖对话线程管理、工具调用、流式响应、RAG 检索增强与多步工作流编排。
主要能力：对话历史持久化，重启后仍保留；通过 Convex 实时订阅自动向客户端推送流式响应；将 Convex 函数注册为智能体工具；支持长时间运行的可靠工作流；内置向量搜索实现知识检索。
使用方式：先安装依赖 npm install @convex-dev/agent ai openai，再用 Agent 类初始化智能体并传入 chat 与 textEmbedding。线程管理通过 agent.createThread、listThreads、getMessages 等实现；发送消息用 agent.chat 并开启 stream 与 onToken 回调；工具用 tool() 定义 name、description、parameters 与 handler；RAG 通过 agent.embed 生成向量、agent.search 检索，并在 schema 中配置 vectorIndex；工作流用 action 串联搜索、分析与总结步骤。前端可用 useQuery、useAction 等 React Hooks 接入。
适用场景：需要持久对话、实时流式输出、工具调用与知识库检索的 AI 应用，如聊天助手、研究分析工作流。
限制与注意：资料提示实现前应查阅最新文档（https://docs.convex.dev/ai 与 @convex-dev/agent 包页面），不要假设 API；除非明确指示，不要运行 npx convex deploy 或任何 git 命令；需为工具失败做错误处理、对交互限流以控制成本，并注意长上下文需摘要旧消息。具体收费、价格与平台支持情况暂未提供。