功能定位
工具调用直接输出 Widget 用于将工具执行结果直接以 Widget 的形式输出到对话中,无需大模型改写总结。
适用场景
工具调用直接输出 Widget 适用于以下场景:
工具输出结果结构清晰,可直接用于展示。
不需要 Agent 对工具结果进行二次总结或改写。
希望缩短响应路径,减少不必要的模型调用和资源消耗。
不适用于需要 Agent 对工具输出结果进行理解、推理或重组的复杂场景。
使用价值
减少模型参与:工具结果直出,避免重复总结。
结果更可控:展示内容完全来源于工具输出。
响应更高效:缩短执行链路,降低延迟与成本。
注意:
启用工具调用直接输出 Widget 后,结果将由工具一次性返回并渲染,不支持流式输出,因此不适合展示大篇幅连续文本内容。建议用于结果明确、结构稳定的工具输出场景。
操作步骤
通过为应用图片含义说明配置工具调用直接输出 Widget,展示配置流程和应用效果。
1. 单击工具设置,进入高级选项页面。


2. 开启结果输出设置开关,在输出内容中选择 Widget 输出,单击设置 Widget,进入配置页面。


3. 在 Widget 开发范围内选择合适的 Widget,单击下一步继续配置。此时可选择:
点击预览图标进入 Widget 详情页进行自定义修改。
注意:
如果当前 Widget 已被其他应用引用,对其进行配置或修改可能会影响线上展示和交互效果。


填写变量的数据来源,可以选择手动输入或引用,支持引用工具参数变量和应用级变量,单击完成直接使用当前 Widget。
注意:
在配置工具调用直接输出 Widget 时,当工具输出为
Array<object>类型时,不作为可选配置,请确保工具输出的数据结构与 Widget 所需的输入变量格式一致,否则导致渲染失败。

4. 工具调用完成后,结果将以配置的 Widget 形式展示。
用户上传图片分析内容,应用以 Widget 形式回复用户。


Multi-Agent 模式下 Widget 的使用场景说明:
在 Multi-Agent 模式下,可以在任务执行的不同阶段配置 Widget:
澄清询问 Widget:在工具或 Agent 执行前使用。当输入信息不完整或存在歧义时,通过结构化交互引导用户补充或确认关键信息,为后续执行提供明确前置条件。
Agent 输出 Widget:在 Agent 完成推理与执行后使用,用于以结构化、可视化的方式展示最终执行结果或结论,便于用户快速理解和使用。
工具调用直接输出 Widget:在工具执行完成后使用。当工具已生成明确、可直接展示的结果时,绕过 Agent 文本总结,直接输出工具结果,以提升响应效率和结果一致性。