ツールモック
ツールモックは、下書きのワークフローをツールの副作用なしに端から端まで動かすための代役です。モックされたツールは呼ばれません。代わりにモックに設定した結果が返るので、MCP サーバーへのリクエストは飛ばず、承認も記録されず、誰にもメールは届きません。
管理サイドバーの Tool Mocks を開くと管理できます。
使い方
- 差し替えたいツールのモックを作ります。
- 下書きのワークフローで Run を押します。
modifiedのワークフローの場合は、ダイアログで Unpublished edits を選びます。ダイアログの Mock tools には、このワークフローのいずれかのタスクが使うツールのモックと、ビルトインツールのモックだけが並びます。 - この実行で使うものにチェックを入れ、実行を開始します。
このワークフローのどのタスクも使わないツールのモックは一覧に出ません。先にそのツールをタスクにバインドしてください。モックが出るのはテスト実行のときだけです。公開済みの設計を実行する場合はモックが一切出ませんし、指定しても拒否されます。実行を開始すると、選んだ各モックのその時点の内容が実行へコピーされます。そのため、あとからモックを編集したり削除したりしても、すでに動いている実行が変わることはありません。差し替えられていた呼び出しが黙って本物に戻ることも起きません。
モックにするかどうかは実行単位ではなくツール単位で選びます。リハーサルは現実的であってこそ役に立つからです。あるシステムを検索してから書き込むワークフローなら、書き込みだけを差し替えられます。読み取りは本物のサーバーに当たり続けるので、エージェントは実データをもとに考えます。
モックが持つもの
| 項目 | 説明 |
|---|---|
| Name / Description | 実行ダイアログで見分けるための名前と説明。 |
| Target | 登録済みの MCP サーバーのツール 1 つ(Select MCP server を押してサーバーを選び、そのサーバーから読み込んだ一覧で Tool Name を選ぶ)か、A2Flow の組み込みツール。 |
| Responses | 呼び出しの回数で引く順序つきのリスト。 |
今のところモックできる組み込みツールは request_approval だけです。副作用を消さない限り、実行を続けるのに人の対応が要るツールだからです。
そのツールが返すもの
ツールを選ぶと、その下に Output format が開き、ツール自身の説明と、返すと宣言している形が出ます。下のレスポンスを書くときの手本にしてください。モックは、ワークフローが本物と同じように読めて初めて役に立ちます。
返すものを宣言していないツールもあります。その場合はパネルにその旨が出て、形の決め方はあなたに委ねられます。
レスポンス
1 つ目がそのツールへの最初の呼び出しに、2 つ目が 2 回目に対応し、以下同様です。リストを使い切ると最後のレスポンスが繰り返されるので、レスポンスが 1 つだけなら定数のように振る舞います。これがあるおかげで、モック 1 つで固定値ではなくシナリオを表現できます。最初の依頼は承認して 2 番目は却下し、ワークフローが両方をどう扱うかを見る、といった具合です。
| 種類 | 意味 |
|---|---|
structured | 結果の構造化された部分に置く JSON オブジェクト。呼び出し側が結果からフィールドを読むツール向けです |
text | 結果のテキスト部分に置く文字列 |
error | 失敗した呼び出しとして返すメッセージ。エージェントからはツールがエラーを報告したように見えます |
ツールが出力の形を宣言している場合、structured のレスポンスには Insert from schema が出ます。押すとその形がキーごと入力欄に入るので、構造を書き写すのではなく値を埋めるだけで済みます。入力欄の中身は置き換わりますが、すでに何か書いてある場合は先に確認を求められます。
タグ
ツールモックの新規作成フォームと詳細ページには Tags のピッカーがあり、一覧には絞り込みできる Tags 列があります。タグはシークレットや MCP サーバーなど、タグを付けられるほかの登録簿と共有するテナント共通の語彙です。付け方と絞り込み方はタグを参照してください。
モックが省かないもの
モックが省くのは副作用だけで、規則は省きません。モックされた呼び出しも、その実行の現在のタスクが使ってよいツールかどうか、そのタスクが待っている承認があるかどうかを確認されます。本番で拒否されるワークフローは、リハーサルでも拒否されます。その承認が許可した入力とも照合されるので、承認者なら許可しなかったであろう呼び出しを、リハーサルが素通りさせずに捕まえます。モックされた承認依頼も、宛先と、依頼が申告した呼び出しの検証は行います。承認者として適格でない相手を指定したワークフローも、ステップが実際に行う呼び出しと合わない申告をしたワークフローも、本番と同じようにリハーサルで失敗します。
モックされた呼び出しを確認する
差し替えられた呼び出しを確認する場所は、実行のチャットの記録です。ツールの行を展開すると引数と結果が出て、Mocked のバッジが付きます。実行の Tool Invocations のページには意図的に出しません。あのページは MCP ゲートウェイが実際に下した判断を記録するもので、差し替えられた呼び出しはそこまで届かないからです。実行そのものには、実行一覧で Mocked のバッジが付きます。