SuperAPI AI 工具集

planning-user-interviews

智能体与模型

查看项目

更新于 10-16 03:45

技能介绍

用途:当需要安排用户访谈(与客户对话、了解情绪或收集定性反馈,通过语音对话进行)时使用本技能。访谈计划会被捕获为一个 UserInterviewTopic,之后由语音智能体执行。

必要信息:创建前需收集——访谈对象(interviewee_emails 或 interviewee_distinct_ids,至少一项非空,API 会拒绝没有目标对象的主题);访谈主题 topic(必填自由文本);可选的 agent_context(额外系统提示);可选的有序 questions 列表。

选对象:若用户指定队列,可用 cohorts-list 查找并解析成员为邮箱/distinct ID;队列在创建时快照,无实时关联。先查人数,500 人以内获取邮箱(去重);超过 500 人须停下询问用户,选择缩小队列、随机抽样还是手动粘贴列表,不得静默截断。也可按行为查询:先用 read-data-schema 确认事件,再用 execute-sql 写 HogQL,按最近 60 天过滤并按 person 分组,区分重度用户、流失用户、风险用户,建议混合抽样。

准备语音智能体:questions 为有序列表,保持开放式;agent_context 可选但建议提供语气、约束、背景等。

创建:调用 user-interview-topics-create,传入 topic、interviewee_emails、interviewee_distinct_ids、agent_context、questions,记录返回的 topic ID。可选通过 user-interview-topics-interviewees-create 为单个受访者附加上下文,支持 CSV(identifier,context)。

限制:本技能不用于上传录音访谈(属于 UserInterview 流程)、列出已有主题(用 user-interview-topics-list)或分析转录文本。若行为查询无匹配用户或邮箱过少,应提出替代方案。