用途:本技能仅在用户希望由 PostHog 的 AI 语音代理(“robo interviewer”)实际执行一轮用户访谈电话时使用。计划会被保存为 UserInterviewTopic,由语音代理稍后拨打每位目标用户并依次提问。这不是通用研究助手:若用户只想寻找/筛选访谈对象、为人工访谈准备问题,或分析已有反馈,应走常规受众发现或数据工作,不创建 topic。
必要信息:创建 topic 前需收集访谈对象(interviewee_emails 和/或 interviewee_distinct_ids 至少一项)、topic(必填文本)、可选的 agent_context(附加系统提示)与可选的有序 questions 列表。API 拒绝无目标的 topic。
确定受众:用户指定 cohort 时先解析成员为邮箱/ID;topic 在创建时快照受众,没有实时 cohort 关联。cohort 超过 500 人须停下让用户选择缩小、随机抽样或手工粘贴,不应静默截断。用户以行为描述对象时,先用 read-data-schema 查找真实事件,再用 execute-sql 以 HogQL 查询(重度用户、流失、风险用户三类模板),并按行路由:有 email 的进 interviewee_emails,无 email 的 distinct_id 进 interviewee_distinct_ids。
准备语音代理:始终询问想要的问题(开放式,作为锚点而非逐字脚本),并主动提供补充 agent_context(语气、约束、背景、人设)。创建后记录返回的 topic ID。可选通过 user-interview-topics-interviewees-create 或批量接口为单个受访者附加上下文,CSV 格式为 identifier,context。
限制:仅适用于语音代理流程;无法确定目标时不应继续。邮箱格式经 DRF 校验。无匹配用户、邮箱稀缺等边界情况时需与用户确认后续处理。