Agents ガイド

最終更新日時 2025年9月25日

エージェントツールのシミュレーションを設定する

注: この機能はプレビューで利用可能です。

ツールのシミュレーションにより、エージェントは実際の API 呼び出しの代わりに合成の入力と出力を使用して動作をテストできるため、安全かつ迅速で再現性のある開発がサポートされます。設計時に定義されたシミュレーションでは、JSON の入力/出力の例を使用して、ガードレールと実行の制約を維持しながら、現実的な操作を模倣します。

ツールのシミュレーションを設定する方法

エージェントにツールを追加する際に、エージェントがそのツールを操作する方法を以下のいずれかから選択できます。

ツール呼び出しをシミュレートする – エージェントは、シミュレーションエンジンによって生成された合成の入力/出力を使用します (実際の API 呼び出しは使用しません)。
実際のツールを呼び出す – エージェントは、設定どおりに実際の API リクエストを実行します。

この設定は設計時に定義され、評価時に実行されるまで自動的に保持されます。

ツールのシミュレーション設定を行うには、次の手順に従います。

エージェント定義にツールを追加します。
エージェントキャンバスでツールノードを選択します。
[プロパティ] パネルで、[シミュレーションの設定] セクションを見つけます。
入力値と出力値の例を JSON 形式で入力します。これらの例は、シミュレーション LLM がツールの予期されるスキーマとロジックに従って、現実的なツールの操作を模倣するのに役立ちます。
(任意) 複数の例を追加して、多様なシミュレーションに対応します。例を提示すると、テスト実行中にシミュレートされた出力の精度と妥当性を向上させるのに役立ちます。

評価の設定時にシミュレーションを設定することもできます。詳しくは、「評価でシミュレーションを設定する」をご覧ください。

図 1. ツールのシミュレーションに用いる入力例の追加

シミュレーションモードでのガードレールと実行動作

シミュレートされたツールの実行では、実際の実行と同様に、既存のツールのガードレールと実行の制約が維持されます。これにより、以下が保証されます。

シミュレートされた動作は、実際の安全条件を反映しています。
エージェントは、テスト中にポリシーの適用や呼び出しの制限をバイパスすることはできません。

シミュレーションの実行は透過的にラベル付けされ、以下の動作が組み込まれているため、検査が容易です。

トレースのラベル付け: 各シミュレーションは、ストリーミング実行ビューと永続的なトレースログの両方で明確にマークされます。
一意のメタデータ: シミュレートされたすべてのトレースには、シミュレートされたものとして識別するメタデータが含まれており、以下が可能になります。
- 容易なデバッグ
- 信頼性の高いフィルタリング
- 実行の正確な分類

これにより、シミュレートされた動作と実際の動作を区別し、エージェントのロジックを追跡して、一貫性を持って結果を再現できます。

シミュレーションの実行は評価セットに簡単に追加できるため、実際のエンドポイントを呼び出すことなくテストカバレッジを拡大できます。この機能の主な特徴は次のとおりです。

シミュレーションの実行は、評価セット内で [シミュレートの結果] として明確にマークされます。
対応するトレースでは、一貫してシミュレーションタグが保持されます。
評価セットには、実際の実行とシミュレーションの実行を組み合わせて含めることができ、比較テストとより広範なシナリオの検証をサポートします。

シミュレーションに関するテストの設定

また、[テストの設定] パネルを使用してテスト実行を開始する際にシミュレーションを設定することもできます。

テストの設定でシミュレーションを有効にするには、以下の手順に従います。

エージェントの定義と評価の設定を完了します。
[クラウドでテスト] ドロップダウンを選択します。
[テストの設定] を選択します。
[テストの設定] パネルで、[プロジェクトの引数] タブを選択します。このタブでは、以下の操作が可能です。
- テスト実行の入力データを生成します。
- 選択したツールおよび/またはエスカレーションに対してシミュレーションモードを有効化します。
- ツールの動作を定義する入力/出力の例またはシミュレーションの指示を指定します。
テストを開始し、指定した設定を使用してエージェントの軌跡をシミュレートします。