用途:该技能用于让人类作为“human agent”参与智能体线程,构建人类与 AI 协作的混合工作流,适用于客服升级、AI 决策的人工审批、人机协作讨论、需要人类判断的例外处理以及收集人工反馈等场景。
主要能力:可保存终端用户消息与人类代理回复;在 AI 与人类之间路由响应;通过工具调用让 AI 主动请求人工介入,并将人类回复作为工具结果返回以继续生成;支持线程分配跟踪、人工审批工作流(AI 生成草稿、人工批准或拒绝)、以及基于置信度的升级机制。消息可标记 provider 为 human 以区分来源。
使用方式:基于 Convex 的 mutation、action、internalAction,配合 @convex-dev/agent 的 saveMessage 与 myAgent.generateText、generateObject、continueThread 等方法实现。典型步骤包括:保存用户消息、保存人类响应、决定下一响应者、工具化人工路由、将人类响应写回工具结果并继续生成、记录线程分配、实现审批与升级。示例使用 zod 定义工具参数,通过 toolCalls 检测 askHuman 或 escalate 调用并触发通知或升级。
限制与缺失:该资料未提供收费、价格、平台支持范围、性能数据或完整安装命令等事实,暂未提供。实际实现需依赖 Convex 后端与相关包,需自行处理通知、限流、用量跟踪与队列管理,避免升级过多或人工过载。