メインコンテンツへスキップ
回答する前に Phaseo 経由でウェブを検索し、情報源付きのリサーチブリーフを厳密な JSON で返す TypeScript エージェントを作成します。完成すると、指定した任意のトピックについて検証済みの { topic, summary, sources } オブジェクトを出力するスクリプトが 1 つできます。 このスクリプトは 1 回だけのリサーチであれば本番環境でそのまま使えます。検索結果は信頼できないウェブコンテンツです。以下のスキーマチェックで不正な形式の出力は止められますが、情報源に基づいて行動する前に内容を確認してください。パッケージ化した版は packages/sdk/agent-sdk-ts/examples/research-brief-agent.ts にあります。

作成する

1

インストールする

2

エージェントを書く

research-agent.ts
3

実行する

動作を確認する

スクリプトは、少なくとも 1 つの情報源 URL を含むブリーフを出力します。次に 設定 → 利用状況 → ログ でリクエストを開き、以下を確認します。
  • ウェブ検索の可観測性 に、マネージド検索、結果、引用が表示されます。
  • プラグイン記録では、JSON の修復が必要だった場合にだけ response-healing が applied と表示されます。
  • レスポンスはスキーマに一致しています。一致しない場合、実行は AgentSchemaValidationError で失敗します。
検索が実行されなかった場合については、ウェブ検索をデバッグするで説明しています。

別の方法を使う場合

このパターンは、モデルが自ら根拠を集め、呼び出し側が型付きの JSON を必要とする 1 回だけのリサーチに適しています。URL がすでにわかっている場合は phaseo:web_fetch を、ウェブよりも自社のデータが必要な場合はローカルツールのエージェントを使ってください。契約が緩く、スキーマを使うと省ける手間よりも増える手間のほうが大きい場合は、プレーンテキストの出力を使ってください。
最終更新日 2026年11月5日