Skip to main content
如果智能体工作流需要具备以下能力,请使用此方案:
  • 通过 TypeScript Agent SDK 运行
  • 使用托管网页搜索
  • 返回严格的结构化 JSON
  • 以确定性方式修复接近有效但格式错误的 JSON

1. 安装 SDK

2. 定义范围明确的输出契约

首个研究结果应足够精简,方便操作人员在日志中检查。

3. 创建智能体

使用 parseOutput,让运行时返回带类型的数据,而不是原始文本。

4. 一次性配置 Gateway 适配器

关键配置如下:
  • responseFormat 明确指定输出架构
  • plugins 启用对接近有效 JSON 的响应修复
  • gatewayTools 向模型提供托管网页搜索
  • 如果工作流必须始终基于来源,toolChoice 会强制使用搜索工具

5. 运行工作流

6. 检查日志

成功运行一次后,打开请求详情并确认:
  • 请求的原生网页搜索工具或托管搜索活动已显示
  • 搜索结果和引用已保存
  • 只有在需要修复时,插件执行记录才显示 response-healing
  • 最终输出符合所请求的 JSON 架构

7. 适用场景

以下情况适合使用此模式:
  • 工作流主要用于一次性研究,而不是复杂的本地工具循环
  • 模型需要先参考来源再回答
  • 下游调用方需要带类型的 JSON,而不是普通文本
以下情况不适合使用此模式:
  • 工作流已知确切 URL,使用 phaseo:web_fetch 就足够
  • 智能体更需要高级本地工具,而不是上游提供方原生工具
  • 输出契约较宽松,严格 JSON 带来的额外成本超过收益

相关指南

最后修改于 2026年10月2日