用途:审查某个智能体近期已结束的通话,找出生产环境中实际发生的问题,并把每个发现路由到对应的修复技能。它只处理已结束的通话,不覆盖 wss 实时音频监控。
主要能力:拥有“列表→分页→取转写”的模式,供其他技能复用。两种模式:启动扫描(默认,智能体上线约两周内或无基线文件时,回答“是否正常工作”);漂移检查(存在基线文件时,对比本窗口与基线并突出差异)。无基线时比率不构成发现,会改跑启动扫描并写入基线。
使用方式:主机 https://api.elevenlabs.io,请求头 xi-api-key: $API_KEY;EU/IN/SG 数据驻留工作区使用 https://api.<eu|in|sg>.residency.elevenlabs.io 及对应密钥,密钥发错主机会报 Invalid API key 提示,应切换主机。工程师提供 $API_KEY 与 $AGENT_ID。用 GET /v1/convai/conversations 拉取,支持 agent_id、page_size(最大 100)、call_start_after_unix、call_start_before_unix、call_successful、user_id、cursor 等参数,循环 next_cursor 直到 has_more 为假。summary_mode=include 会填充 transcript_summary,便于先聚类再读转写。列表不返回 evaluation_criteria_results 与 data_collection_results,它们只在单会话 GET 的 .analysis 下出现,因此按标准通过率与抽取填充率属于样本统计,须注明。
流程:设定窗口并抓取;仅用列表数据做聚合(总量、状态、termination_reason、时长与消息数分布、tool_names 覆盖、语言、成功分与情感);只深读异常样本,默认 10 条、最多 20 条,并说明丢弃了什么;按机制而非措辞聚类,每个聚类至少两条会话佐证,单条标为未确认;按频率×严重度排序;把每个聚类路由到对应修复技能(工具错误、字符串字段、流程、工作流、通话后数据、轮次延迟、ASR 与语言配置等),修复落在分支而非 main,且先建回归测试;最后写入 .architect-live-calls/<agent_id>-baseline.json 基线,仅存聚合计数与会话 id,不含转写文本或来电者标识,并检查 .gitignore。
限制:只读,仅发 GET,不删除会话、不编辑智能体。注意 PII,不把转写或摘要复制到其他系统、日志或提交文件,引用需脱敏。密钥从环境读取,不硬编码、不回显。零保留工作区无转写,hiding_reason 标记不可读会话,此时仅用元数据聚合并跳过深读。窗口为空或一切正常都是有效结论,应直接说明并停止,不编造发现。输出约 25–50 行,含模式、窗口、通话数与最重要数字、聚合表、聚类、优先修复前三项。