From 452055a9d35434a254b74eb9e22bac74f015e04f Mon Sep 17 00:00:00 2001 From: vivianagamezm-write Date: Sat, 18 Jul 2026 16:25:00 -0600 Subject: [PATCH 1/2] Add Environment simulation section to evaluation overview (#1256) Adds an "Environment simulation" section parallel to the existing "User simulation" section, linking to docs/evaluate/environment_simulation.md. The feature (renamed from Agent Simulator in adk-python v1.28.0) was only reachable from the nav; the evaluation overview never mentioned it. Part of #1256. --- docs/evaluate/index.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/evaluate/index.md b/docs/evaluate/index.md index 9e619a40d6..88f19059af 100644 --- a/docs/evaluate/index.md +++ b/docs/evaluate/index.md @@ -476,6 +476,18 @@ generated by an AI model. For details on how to set up an eval with user simulation, see [User Simulation](./user-sim.md). +### Environment simulation + +When evaluating agents that rely on external tools, it is often useful to +simulate tool responses rather than calling real APIs. This allows for: + +- Deterministic testing +- Fault injection, such as errors and latency +- Cost savings + +The [Environment Simulation](./environment_simulation.md) feature provides a +flexible way to mock tools and inject faults during evaluation. + ## How to run evaluation with ADK As a developer, you can evaluate your agents using the ADK in the following ways: From a6c76d2f44ecd01abb9aab28e276d14d1651ac8c Mon Sep 17 00:00:00 2001 From: vivianagamezm-write Date: Sat, 18 Jul 2026 16:35:33 -0600 Subject: [PATCH 2/2] Add Environment Simulation to plugin list (#1256) Lists the Environment Simulation plugin alongside the other bundled plugins; it ships create_plugin() via EnvironmentSimulationFactory but was absent from this list. Part of #1256. --- docs/plugins/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/plugins/index.md b/docs/plugins/index.md index 18573613cc..41c6fcf69b 100644 --- a/docs/plugins/index.md +++ b/docs/plugins/index.md @@ -70,7 +70,9 @@ immediately: Saves files included in user messages as Artifacts. * [**Logging**](https://github.com/google/adk-python/blame/main/src/google/adk/plugins/logging_plugin.py): Log important information at each agent workflow callback point. - +* [**Environment Simulation**](/evaluate/environment_simulation/): + Simulates tool responses and injects faults to test agent behavior. + ## Define and register Plugins This section explains how to define Plugin classes and register them as part of