1. テンプレートからエージェントを作成
このページでは、テンプレート「詳細リサーチャー」(Deep researcher)を使って、Webリサーチエージェントを作成します。テンプレートを選ぶだけで、エージェントの作成からセッションでの実行までを一通り体験できます。
完成すると、チャットで質問を送るだけで、エージェントが質問をサブクエスチョンに分解してWeb検索を行い、出典付きのレポートで回答してくれるようになります。

作成する要素は次の3つです。
| 要素 | 役割 |
|---|---|
| エージェント | 複数ステップのWeb調査と出典の引用を行うリサーチエージェント本体 |
| 環境 | Web検索のためのネットワークアクセスを許可する実行環境 |
| セッション | エージェントと環境を組み合わせて起動する実行単位 |
1. テンプレートからエージェントを作成
Section titled “1. テンプレートからエージェントを作成”-
サイドバーの「エージェント」をクリックし、サブメニューの「作成」を選択します。

サブメニュー上部のワークスペースが「workshop」になっていることを確認してください。
-
テンプレート一覧から「詳細リサーチャー」をクリックします。テンプレートの内容がダイアログで表示されます。

このテンプレートには 結果(Outcome)が定義されています。「結果の判定方法」を開くと、エージェントの成果物を採点するルーブリック(評価基準)を確認できます。セッションでは、この基準で最終レポートが自動採点され、基準を満たすまでエージェントが自分でやり直します。

テンプレートの内容
name: Deep researcherdescription: Conducts multi-step web research with source synthesis and citations.model:id: claude-opus-5-5effort: lowsystem: |-You are a research agent. Given a question or topic:1. Decompose it into 3-5 concrete sub-questions that, answered together, cover the topic.2. For each sub-question, run targeted web searches and fetch the most authoritative sources (prefer primary sources, official docs, peer-reviewed work over blog posts and aggregators).3. Read the sources in full — don't skim. Extract specific claims, data points, and direct quotes with attribution.4. Synthesize a report that answers the original question. Structure it by sub-question, cite every non-obvious claim inline, and close with a "confidence & gaps" section noting where sources disagreed or where you couldn't find good coverage.5. Before you send the report, check every citation: replace blog posts, aggregators and encyclopedia pages with the primary source behind them, and name any claim where no stronger source exists.Be skeptical. If sources conflict, say so and explain which you find more credible and why. Don't paper over uncertainty with confident-sounding prose.tools:- type: agent_toolset_20260401default_config:permission_policy:type: autometadata:template: deep-researchname: Deep researcherdescription: 複数ステップのウェブ調査を行い、情報源の統合と引用を行います。model:id: claude-opus-5-5effort: lowsystem: |-あなたはリサーチエージェントです。質問やトピックが与えられたら:1. トピック全体をカバーできるような、具体的な3〜5個のサブクエスチョンに分解してください。2. 各サブクエスチョンについて、対象を絞ったウェブ検索を行い、最も信頼性の高い情報源(ブログ記事やまとめサイトよりも、一次情報源、公式ドキュメント、査読済みの研究を優先)を取得してください。3. 情報源は流し読みせず、しっかりと読み込んでください。具体的な主張、データ、直接引用を出典とともに抽出してください。4. 元の質問に答えるレポートを統合してください。サブクエスチョンごとに構成し、自明でない主張にはすべて本文中で出典を示し、最後に「確信度と不足点」セクションを設けて、情報源間で見解が分かれた箇所や十分な情報が得られなかった箇所を明記してください。5. レポートを送る前にすべての引用を確認してください。ブログ記事・まとめサイト・百科事典のページは、その背後にある一次情報源に置き換え、より強い情報源が見つからない主張はその旨を明記してください。懐疑的な姿勢を保ってください。情報源同士が矛盾する場合はその旨を明示し、どちらがより信頼できるか、その理由とともに説明してください。自信ありげな文章で不確実性を覆い隠さないでください。tools:- type: agent_toolset_20260401default_config:permission_policy:type: autometadata:template: deep-research -
「このテンプレートを使用」をクリックします。エージェントが作成され、画面右の「進行状況」に「エージェントを作成 → 環境を設定 → セッションを開始 → 統合」の4ステップが表示されます。続いて「環境を設定」をクリックします。

2. モデルを変更する(任意)
Section titled “2. モデルを変更する(任意)”コストを抑えたい場合は、環境を設定する前にモデルを変更しておきます。設定の変更は、このチャット欄で依頼するだけで行えます。
-
下のチャット欄に「モデルを claude-sonnet-5 に変更してください」と入力して送信します。

-
右に「エージェント設定」パネルが開き、変更箇所が差分で表示されます。「これらの変更を v2 として保存しますか?」と聞かれるので、「バージョンを保存」をクリックします。

-
エージェントが v2 に更新され、環境の設定に戻ります。パネルは右上の「×」で閉じられます。
3. 環境を設定する
Section titled “3. 環境を設定する”-
ネットワークアクセスについての質問が表示されます。「Unrestricted」(無制限)を選択します。

-
環境の作成内容(名前とネットワーク設定)が提案されるので、「環境を作成」をクリックします。

-
環境が作成されました。続いて「セッションを開始」をクリックします。

4. セッションでテストする
Section titled “4. セッションでテストする”-
右側に「セッション」パネルが開きます。チャット欄にテスト用のメッセージが入力済みなので、そのまま送信します(内容を編集してから送っても構いません)。

-
エージェントが動き始めます。サブクエスチョンへの分解と
web_searchの呼び出しが、パネルにリアルタイムで表示されます。左のチャットには、このメッセージがAPIのどのエンドポイント(POST /v1/sessions/{id}/events)で送られたかの解説が表示されます。
-
最初に、テンプレートに定義されていた「結果」とルーブリックがパネルに表示されます。

-
レポートが完成すると、ルーブリックに基づいた採点が行われます。「要修正」と判定された場合、エージェントは指摘を受けて自動でレポートを改善します(反復回数には上限があります)。

-
十分に確認できたら、左のチャットにある「セッションを停止」をクリックします。
5. エージェントを調整する
Section titled “5. エージェントを調整する”-
エージェントの動作を調整したい場合は、セッションの実行中でも、左のチャット欄で指示を送ります。

-
指示はいったん受け付けられ、テストセッションの終了後にエージェント設定へ反映されます。引き続きテストを続けられます。

-
「セッションを停止」をクリックすると、テスト結果のまとめが表示されます。次に行う修正の候補(採点で指摘された点や、チャットで送った指示)が選択肢として提示されることがあるので、反映したいものにチェックを入れて送信します。

-
システムプロンプトの変更案が差分で表示されます。「バージョンを保存」をクリックすると、新しいバージョンとして保存されます。


-
調整した内容でテストを続けるには、「セッションを開始」で新しいテストセッションを起動します。
6. 統合(アプリケーションから呼び出す)
Section titled “6. 統合(アプリケーションから呼び出す)”-
セッションを停止すると、「このエージェントで何をしますか?」と聞かれます。「アプリケーションから呼び出す」を選択します。

-
セッションの作成・メッセージ送信・イベントのストリーミングを行うサンプルコードが表示されます(cURL / Python / TypeScriptを切り替え可能)。中級以降で使うAPIの全体像がここで確認できます。「Export as code」でエージェントの定義をファイルとしてダウンロードすることもできます。確認できたら「終了」をクリックします。

7. 作成したリソースを確認する
Section titled “7. 作成したリソースを確認する”-
作成したエージェント、環境、セッションは「エージェント」メニューのサブメニューからそれぞれ確認できます。
- エージェント

- 環境

- セッション

- テンプレートを選ぶだけで、エージェント → 環境 → セッションという基本の流れを一通り体験できました。
- エージェントの実体は、モデル・システムプロンプト・ツールを定義した設定(YAML)です。エージェントのページの「設定」タブでいつでも確認・編集できます。
- 環境では、サンドボックスのネットワークアクセスを設定しました。
- テンプレートに 結果(Outcome)が定義されていると、セッションの成果物はルーブリックで自動採点され、基準を満たすまでエージェントが自分で改善します。
- モデルの変更やエージェントの振る舞いの調整は、チャットで指示するだけで変更案が提示され、新しいバージョンとして保存できます(テスト中の指示はテスト終了後に反映されます)。
- 既定のモデルは
claude-opus-5-5です。テストセッションにはコストがかかるので、必要に応じてモデルを切り替えましょう。
おつかれさまでした!ここまでの感想を、ぜひXにポストしてください。
感想をXにポストする