convex-agent 是一个帮 AI 在 Convex 应用里接入智能助手后端的 Skill。它使用 @convex-dev/agent 保存对话线程和消息，也支持工具调用及基于资料的检索。
这里的线程是一段能够继续的对话。把历史保存在后端，用户回来后才能接着原来的内容交流；模型回复可以逐步流式显示，而不必等所有文字生成完。
原文默认通过 Convex AI Gateway 调用模型，由平台管理模型提供商凭据。这条路线有条件：Convex Cloud 付费计划、Convex 1.45 及以上。免费计划、自托管或本地后端等不具备网关时，才使用提供商 SDK，并把所需密钥放在部署环境中。
如果助手还要从你提供的资料里检索答案，就需要把文档变成可搜索的向量，再在工具里检索。归档版本的网关不提供生成这些向量的服务，相关提供商密钥要单独管理，不能以为接上聊天网关就已经解决。你仍需确定模型、工具和资料来源，密钥也不能放到前端。