SuperAPI AI 工具集

Convex Agents Threads

智能体与模型

查看项目

更新于 10-15 23:24

技能介绍

用途:Threads 将相关消息组织成有序的线性对话历史,Agent 组件中的每条消息都属于某个线程。适用于创建新会话、管理会话历史与元数据、续接已有会话、查询线程内消息、按用户或上下文组织会话,以及清理旧会话。

主要能力:创建线程时可用 createThread 指定 userId、title、summary;在 action 中通过 myAgent.continueThread(ctx, { threadId }) 获取线程对象,读取 getMetadata() 并调用 thread.generateText({ prompt });通过 components.agent.threads.listThreadsByUserId 配合分页参数列出某用户的线程。

删除方式:myAgent.deleteThreadAsync 为非阻塞异步删除,myAgent.deleteThreadSync 为原子同步删除;删除某用户全部线程可用 components.agent.users.deleteAllForUserId。

使用要点:线程与 userId 关联,可用 title 和 summary 辅助组织;线程内消息保持顺序;异步用于非阻塞场景,同步用于需要原子性的操作。续接线程只能在 actions 中进行。

限制:资料未提供收费、价格、平台支持或性能数据;具体 API 行为与部署要求需参考官方文档,暂未提供。