跳转到主要内容
构建一个 TypeScript 智能体:它在回答之前通过 Phaseo 搜索网络,并以带有来源的严格 JSON 返回研究简报。完成后,你会得到一个脚本,它会为你给出的任何主题打印一个经过验证的 { topic, summary, sources } 对象。 对于一次性研究,该脚本可直接用于生产环境。搜索结果是不可信的网页内容:下面的 schema 检查会拦截格式错误的输出,但在据此采取行动之前,请先审查来源。打包好的版本位于 packages/sdk/agent-sdk-ts/examples/research-brief-agent.ts。

构建

1

安装

2

编写智能体

research-agent.ts
3

运行

检查是否成功

脚本会打印一份至少包含一个来源 URL 的简报。然后在 设置 → 使用情况 → 日志 中打开该请求并检查:
  • 网络搜索可观测性 显示托管搜索、结果和引用。
  • 只有当 JSON 需要修复时,插件记录才会显示 response-healing 为 applied。
  • 响应符合 schema;如果不符合,运行会以 AgentSchemaValidationError 失败。
调试网络搜索介绍了没有执行搜索的情况。

何时改用其他方案

这种模式适合模型需要自行查找依据、调用方需要类型化 JSON 的一次性研究。如果你已经知道 URL,请使用 phaseo:web_fetch;如果任务更依赖你自己的数据而不是网络,请使用本地工具智能体;如果约定足够宽松,使用 schema 带来的工作量超过它节省的工作量,请使用纯文本输出。
最后修改于 2026年11月5日