コンテンツにスキップ

1. テンプレートからエージェントを作成

このページでは、テンプレート「詳細リサーチャー」(Deep researcher)を使って、Webリサーチエージェントを作成します。テンプレートを選ぶだけで、エージェントの作成からセッションでの実行までを一通り体験できます。

完成すると、チャットで質問を送るだけで、エージェントが質問をサブクエスチョンに分解してWeb検索を行い、出典付きのレポートで回答してくれるようになります。

作成する要素は次の3つです。

要素役割
エージェント複数ステップのWeb調査と出典の引用を行うリサーチエージェント本体
環境Web検索のためのネットワークアクセスを許可する実行環境
セッションエージェントと環境を組み合わせて起動する実行単位

1. テンプレートからエージェントを作成

Section titled “1. テンプレートからエージェントを作成”
  1. サイドバーの「エージェント」をクリックし、サブメニューの「作成」を選択します。

    サブメニュー上部のワークスペースが「workshop」になっていることを確認してください。

  2. テンプレート一覧から「詳細リサーチャー」をクリックします。テンプレートの内容がダイアログで表示されます。

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

    テンプレートの内容

    name: Deep researcher
    description: Conducts multi-step web research with source synthesis and citations.
    model:
    id: claude-opus-5-5
    effort: low
    system: |-
    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_20260401
    default_config:
    permission_policy:
    type: auto
    metadata:
    template: deep-research
  3. 「このテンプレートを使用」をクリックします。エージェントが作成され、画面右の「進行状況」に「エージェントを作成 → 環境を設定 → セッションを開始 → 統合」の4ステップが表示されます。続いて「環境を設定」をクリックします。

コストを抑えたい場合は、環境を設定する前にモデルを変更しておきます。設定の変更は、このチャット欄で依頼するだけで行えます。

  1. 下のチャット欄に「モデルを claude-sonnet-5 に変更してください」と入力して送信します。

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

  3. エージェントが v2 に更新され、環境の設定に戻ります。パネルは右上の「×」で閉じられます。

  1. ネットワークアクセスについての質問が表示されます。「Unrestricted」(無制限)を選択します。

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

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

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

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

  3. 最初に、テンプレートに定義されていた「結果」とルーブリックがパネルに表示されます。

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

  5. 十分に確認できたら、左のチャットにある「セッションを停止」をクリックします。

  1. エージェントの動作を調整したい場合は、セッションの実行中でも、左のチャット欄で指示を送ります。

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

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

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

  5. 調整した内容でテストを続けるには、「セッションを開始」で新しいテストセッションを起動します。

6. 統合(アプリケーションから呼び出す)

Section titled “6. 統合(アプリケーションから呼び出す)”
  1. セッションを停止すると、「このエージェントで何をしますか?」と聞かれます。「アプリケーションから呼び出す」を選択します。

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

7. 作成したリソースを確認する

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

    • エージェント

    • 環境

    • セッション

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

おつかれさまでした!ここまでの感想を、ぜひXにポストしてください。

感想をXにポストする