How ElevenAgents Architect works
概览
ElevenAgents Architect 对话以实时 ElevenAgents 对话方式运行,使用的正是你所构建智能体所依赖的引擎。Architect 的工具会在浏览器中、通过你已登录的会话运行。每个工具调用的都是仪表板使用的同一套 ElevenAgents API,因此每次读取和写入都会根据你的权限进行检查。请参阅权限、审批和草稿。
ElevenAgents Architect 默认掌握的信息
每次对话开始时,Architect 会获得:
- 账户和工作区:套餐、工作区和使用情况。
- 你所在的位置:当前页面;如果你在某个智能体内,还包括该智能体及打开的分支。在侧边栏中,Architect 还会获取页面快照;如果页面发生变化,则会在每条消息前获得更新。
- 智能体摘要:当你在某个智能体内时由 ElevenLabs 构建。其中包括智能体名称和所有者、分支及其流量分配、过去 7 天的通话量、草稿状态、已连接的智能体、流程、是否配置测试,以及你可编辑的分支。
- 智能体上下文:智能体的
agents.md文档,供所有构建该智能体的人员共享。请参阅自定义 Architect。 - 偏好设置:个人
user.md文档,适用于你构建的所有智能体。 - 入口传入的信息:例如失败的测试、Spotlight 发现或问题。请参阅开始对话。
- 此聊天中的较早消息。
Architect 不会在一开始就获得智能体的完整配置、转录记录、测试结果、Spotlight 数据或其他 Architect 聊天记录。任务需要时,它会通过工具读取这些内容。这样每次对话都能聚焦,也确保 Architect 始终基于当前数据工作,而不是过期副本。
调查与直接指令
Architect 会以不同方式处理两类请求。
直接指令会明确说明变更,例如“添加一项护栏,禁止讨论竞品定价”或“缩短第一条消息”。Architect 会读取相关配置、进行编辑,并报告已暂存的内容。在默认审批模式下,智能体配置编辑会暂存到草稿中,无需询问。影响实时流量或共享资源的操作会等待你的批准。
调查会提出问题而不指定修复方案,例如“为什么退款通话会升级?”或“如何提升退款解决率?”Architect 会在更改任何内容前进行研究:
- 它会为调查编写一份 待办事项列表,完成项目会持续显示在编辑器上方。
- 在读取单条转录记录前,它会先从对话数量、主题和评估结果等低成本信号开始。
- 它会并行分析对话,并按根本原因归纳发现。
- 推理过程可见。每个推理步骤都会折叠为 思考了 N 秒,并可展开。
- 它会报告发现的内容,包括实际读取了多少段对话。不会将样本表述为完整结论。
计划模式
对于较大的变更,请将编辑器切换到 计划(按 Shift+Tab 切换模式)。在计划模式下,Architect 会使用只读工具进行研究,编写可供你查看起草过程的计划,然后请你选择 批准计划 或 拒绝。在你批准前,它不会进行任何更改。如果你附带备注拒绝计划,Architect 会修订并再次请求确认。
在全屏 Architect 标签页中,计划会显示在编辑器上方的面板内。在侧边栏中,它会作为聊天卡片显示。
示例:提升退款解决率
本示例展示一次对话如何从宽泛问题发展为可供审查的变更。文中列出工具名称,方便你将每个步骤与对话中的内容对应。Architect 会自行选择步骤,因此实际对话的顺序和细节可能有所不同。
从智能体的 Architect 标签页发送以下请求:
如何提升退款解决率?
衡量问题
Architect 会读取智能体主题(get_agent_topics、get_topics_summary)以找到退款主题及其成功率,然后统计并列出近期评估失败的退款对话(count_conversations、list_conversations)。
阅读对话
Architect 会搜索包含退款请求的转录记录(search_conversation_messages、
semantic_search_conversations),然后并行分析一批失败对话(analyze_conversation_subagent)。每项分析都会说明用户需求、智能体出错的位置及发生错误的轮次。
查找根本原因
Architect 会将失败情况与当前配置进行比较(get_agent_config、
list_procedures、get_procedure)。它可能报告类似发现:“在 40 个退款失败通话中的 31 个里,智能体在询问订单号之前调用了 lookup_order,导致报错并升级。”
在分支上进行变更
Architect 会创建分支(create_branch),将变更与实时智能体隔离。随后编辑退款流程(update_procedure),要求先询问订单号再查询。编辑会暂存到该分支的草稿中。实时来电者不会受到影响。
为变更编写测试
Architect 会编写捕捉该失败情况的测试:模拟未提供订单号就请求退款的来电者(create_simulation_test)、检查 lookup_order 未被首先调用的工具调用测试(create_tool_test),以及根据一段真实失败对话生成的测试(generate_test_from_conversation)。Architect 会在模拟中模拟具有副作用的工具,因此不会实际发出退款。
在变更前后运行测试
Architect 会先针对未变更的智能体运行测试(原始分支上使用 run_tests,或使用 include_draft: false 的 run_agent_tests),再针对包含变更的草稿运行测试(run_agent_tests),并读取结果(get_test_suite_summary、get_test_suite_failures)。预期结果是:新增测试在没有变更时失败,有变更时通过。如果测试仍然失败,Architect 会读取失败详情、调整变更并再次运行。
呈现变更
Architect 会总结根本原因、变更和测试结果,并打开发布对话框(request_draft_publish)。你审查差异后选择 发布,将变更作为该分支上的新版本提交。Architect 无法代你发布。
验证在对话中进行,会在要求你发布或审查任何内容之前完成。当提案交给审查者时,促成该变更的测试已附加到智能体并已在分支上运行。请参阅提案与验证,了解审查者会看到什么。
变更前后运行测试是良好实践,但 Architect 不会为每次变更自动执行。为确保它执行,请直接提出要求,例如“向我展示新测试在 main 上失败、在分支上通过。”

斜杠命令
在编辑器中输入 /,查看当前页面可用的命令。
大多数命令仅适用于智能体内部。Architect 标签页主页上无法使用 /clear 和 /feedback。
聊天中的仪表板
Architect 可以在对话中构建仪表板,通过数据回答问题,例如“按原因拆分本周升级情况,并展示趋势。”使用 /dashboard,或直接提出请求。
Architect 通过工具收集数据,使用代码整理数据,并渲染一个由与 Spotlight 相同的指标磁贴、图表、列表和文本卡片组成的仪表板。仪表板可包含:
- 显示标题数值、变化和迷你趋势图的 指标磁贴。
- 图表:面积图、折线图、柱状图、堆叠面积图、圆环图,以及用于前 N 项细分的排名柱状列表。
- 列表:包含状态标签、日期以及指向 ElevenAgents 页面(如单个对话)的链接。
- 用于展示发现和建议的 文本卡片。
在全屏 Architect 标签页中,仪表板会在对话内联显示。在侧边栏中,它会在聊天旁的面板中打开。
仪表板数据仅保存在构建它的浏览器标签页内存中,绝不会随聊天保存。重新加载页面、在另一个标签页打开聊天,或构建多个大型仪表板后,较早的仪表板会显示消息而非数据。请让 Architect 重新构建。仪表板为只读快照,不提供筛选功能,也不会实时更新。
运行代码
Architect 可以运行简短的 Python 程序,对工具数据进行计数、分组和比较,例如计算数百段对话按周划分的解决率。代码会在浏览器中的沙盒内运行,仅提供 Python 标准库。它无法访问网络、无法访问 ElevenLabs 账户,且运行时限为 20 秒。代码执行功能正在逐步推出,可能并非每个工作区都可用。
大型响应
当工具返回的数据超出对话容纳范围时(例如很长的对话列表),Architect 会将完整响应保留在浏览器标签页内存中,并根据摘要工作。它可按需搜索和读取其余内容。工具调用上会显示提示,说明何时发生这种情况。这些响应绝不会被保存或上传。