The new guide explains what the plugin does, a get-started
example, how the retry loop and per-tool failure tracking
work, the configuration options, advanced applications,
and its limitations.
Co-authored-by: Jason Zhang <jasoncz@google.com>
PiperOrigin-RevId: 955444373
Add a "Create and use a custom managed agent" section to the ManagedAgent guide
showing the control-plane create/delete pattern via `ManagedAgent.api_client`,
and complete the guide's Related samples list.
Co-authored-by: Haran Rajkumar <haranrk@google.com>
PiperOrigin-RevId: 954766292
Introduces the `ReflectAndRetryModelPlugin`, which provides error recovery
for model failures (such as malformed function calls). When a configured model
error occurs, the plugin intercepts it, provides reflection guidance to
the model via a reserved tool call, and retries the operation.
Key features:
- Configurable max retries for model errors.
- Customizable list of FinishReasons to treat as errors.
- Support for both invocation-level and global-level tracking scopes.
- Interception of direct calls to the reserved retry tool to prevent misuse.
Co-authored-by: Jason Zhang <jasoncz@google.com>
PiperOrigin-RevId: 954695655
Add a runnable sample under
contributing/samples/managed_agent/system_instruction demonstrating the new
ManagedAgent.instruction field, and document the field in the ManagedAgent
guide.
Co-authored-by: Haran Rajkumar <haranrk@google.com>
PiperOrigin-RevId: 951709300
Extend the LlmAgent single-turn guide with a section showing that `single_turn`
composition is not limited to `LlmAgent`: a server-backed `ManagedAgent` can be
a single-turn sub-agent via `mode='single_turn'`, is auto-exposed as an inline
tool, preserves its internal events in the shared session, and is stateless per
call.
Co-authored-by: Haran Rajkumar <haranrk@google.com>
PiperOrigin-RevId: 945962977
- Decouple task-mode node execution from default output binding so standard text output does not prematurely finish the node.
- Enhance the runner to automatically resolve and reuse the invocation_id of active suspended task nodes.
- Route incoming plain text resume messages to the active task node by mapping to its isolation scope.
- Enforce strict concurrency serialization by suspending parallel branch execution when a task node is waiting for user input.
- Align schema validation helpers to cleanly handle Content wrapping and raw JSON strings.
Co-authored-by: Shangjie Chen <deanchen@google.com>
PiperOrigin-RevId: 945423735
This guide explains how to use ManagedAgent, its configuration
options, and orchestrating it with AgentTool.
Co-authored-by: Haran Rajkumar <haranrk@google.com>
PiperOrigin-RevId: 944359273
Expose `max_parallel_workers` on the `@workflow.node` decorator and `Node` class when `parallel_worker=True`. This allows throttling the concurrency limit when executing parallel workers.
Co-authored-by: Shangjie Chen <deanchen@google.com>
PiperOrigin-RevId: 940663519
Unblocks the pre-commit --all-files check; mdformat rewrites this file
and fails on every PR until the whitespace is gone.
Co-authored-by: George Weale <gweale@google.com>
PiperOrigin-RevId: 934144935
- Updated request_input.py unit guide to use function node example and removed field table.
- Updated adk-unit-guide skill:
- Discourage exhaustive API reference tables in guides.
- Prefer simple Python functions over extending BaseNode for workflow node samples.
- Removed field reference tables from the event guide.
Co-authored-by: Bo Yang <ybo@google.com>
PiperOrigin-RevId: 931347184
Re-aligns two files with GitHub main so the piper-to-github cutover does not
silently revert them: the _ALLOWED_PICKLE_GLOBALS type annotation and a stray
f-string prefix in skill_toolset.
Co-authored-by: George Weale <gweale@google.com>
PiperOrigin-RevId: 928768999
Standard REST, SSE, and WebSocket endpoints now actively monitor client disconnections. When a connection drop is intercepted, the executing worker task tree is aborted mid-run to prevent background task leaks, API token burn, and resource wastage.
Includes:
1. REST `/run` connection drop monitor blocking on raw ASGI receive events with 0% CPU consumption.
2. Graceful `499 Client Closed Request` status response on REST disconnections to suppress server-side exceptions.
3. Unit and integration tests validating REST task cancellations and generator finalizations.
4. Comprehensive architectural design documents and user guide under `/docs`.
5. An invocation-focused cooperative counting agent sandbox under `/contributing/samples/core/abort`.
Change-Id: I50fcba7a8bb56cf28b0a3bb8fa66b85732062a67
Jason Zhang