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