用途:该技能用于为 ElevenLabs 智能体设置两类通话后配置。数据采集回答“通话里有哪些事实”,评估标准回答“这通电话好不好”。两者都通过 PATCH /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID 写入(host 为 https://api.elevenlabs.io,请求头 xi-api-key: $API_KEY),按分支作用域生效,合并后上线。
设计前先读真实通话:GET /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID 查看系统提示词、first_message 及已有的 platform_settings.evaluation.criteria 与 conversation_config.platform_settings.data_collection,以便扩展而非覆盖;GET /v1/convai/conversations?agent_id=$AGENT_ID 查看近期通话量;再对 2-3 通调用 GET /v1/convai/conversations/{cid},确认目标数据确实出现在转写中。这些载荷含客户 PII,不要复制到其他系统或日志,并遵守零保留模式账户。
数据采集:配置位于 conversation_config.platform_settings.data_collection,以字段名为键。每个字段有 type、description(即提取提示词)、可选 enum 和取值来源标志。description 要具体,控制在约 500 字符内;按数据类型选 type(是/否用 boolean,类别用带 enum 的 string,金额用 integer/number);尽量使用 enum 防止自由文本漂移;字段各自独立提取,一个字段的 description 不能引用另一字段;只支持标量值;需为 null 设计,提前挂断时多数字段为 null 属正常。写入时与已有字段合并,除非用户明确要求重置。
评估标准:每条标准是独立通话后 LLM 调用,评分为 SUCCESS / FAILURE / UNKNOWN,conversation_goal_prompt 上限 2000 字符。建议 3-5 条。以问句而非指令书写;明确 SUCCESS 与 FAILURE 的界限,使用转写中的确切措辞;为提前终止添加 UNKNOWN 指引;将相关检查合并为一条;覆盖合规、完整性、准确性和边界。写入时发送完整数组,因为该写入会替换整个 criteria 列表。
验证:让用户运行模拟测试或等待若干真实通话,再用 GET /v1/convai/conversations/{cid} 复核评分是否符合判断;若好通话被判失败,说明标准过严,应放宽措辞或补充 UNKNOWN 分支。
限制:若某值需在通话前已知(如会话开始时传入的账户 id),应使用动态变量而非数据采集字段;字段返回 null 或错误时,检查 description 具体性、type 匹配、enum 覆盖及数据是否在转写中。