Available on crate feature
agents only.Expand description
Agent implementations (LLM, Custom, Workflow agents).
Provides the core agent types:
LlmAgent- AI-powered agent using LLMsCustomAgent- Implement custom agent logicSequentialAgent- Execute agents in sequenceParallelAgent- Execute agents concurrentlyLoopAgent- Iterative execution until condition met
Available with feature: agents
Modules§
- codeact
codeact - A CodeAct agent: a peer to
LlmAgentthat acts by writing and executing code instead of emitting one tool call at a time. - compaction
- LLM-based event summarizer for context compaction.
- guardrails
- Guardrail integration for LlmAgent
- team
- Portable, validated multi-agent team composition.
- tool_
call_ markup - XML-based tool call markup parsing.
Structs§
- Blackboard
Policy - Bounded blackboard execution policy.
- Blackboard
Spec - Portable, governed shared-transcript team definition.
- Blackboard
Transition - One exact permitted speaker transition.
- Circuit
Breaker Policy - Opens an edge circuit after repeated failures.
- Compiled
Blackboard Team - Executable blackboard/group-chat root.
- Compiled
Team - Executable root produced by
TeamSpec::compile. - Conditional
Agent - Rule-based conditional routing agent.
- Custom
Agent - An agent with a user-defined async handler function.
- Custom
Agent Builder - Builder for constructing a
CustomAgent. - Guardrail
Set Non- guardrails - Placeholder type when guardrails feature is disabled
- LlmAgent
- An LLM-powered agent that orchestrates tool calls and sub-agent delegation.
- LlmAgent
Builder - Builder for constructing an
LlmAgentwith all configuration options. - LlmConditional
Agent - LLM-based intelligent conditional routing agent.
- LlmConditional
Agent Builder - Builder for constructing an
LlmConditionalAgent. - LlmEvent
Summarizer - An LLM-based event summarizer for sliding window compaction.
- Loop
Agent - Loop agent executes sub-agents repeatedly for N iterations or until escalation
- Parallel
Agent - Parallel agent executes sub-agents concurrently
- Relationship
Policy - Contract enforced for one exact relationship.
- Resolved
Team Member - Immutable member binding captured when a team is compiled or discovered.
- Sequential
Agent - Sequential agent executes sub-agents once in order
- Static
Team Agent Registry - Deterministic in-process registry useful for generated projects and tests.
- Team
Agent Descriptor - Serializable candidate metadata returned by a team agent registry.
- Team
Budget - Aggregate limits enforced across a root team invocation and its delegates.
- Team
Edge Execution - One causal relationship execution in a team invocation.
- Team
Execution Analysis - Provider-free evaluation summary derived from a team execution receipt.
- Team
Execution Snapshot - Serializable execution receipt for one root team invocation.
- Team
Execution Usage - Aggregate resource usage recorded for a team invocation.
- Team
Lifecycle Context - Immutable context supplied to a
TeamLifecycleHook. - Team
Manager Branch - One manager branch in a hierarchical architecture.
- Team
Member Spec - Serializable metadata for one team member.
- Team
Policy - Policies applied uniformly by a compiled team.
- Team
Registry Requirement - Portable governance constraints for dynamically discovered bindings.
- Team
Relationship - One exact directed relationship between two team members.
- Team
Spec - A portable team definition independent of concrete model or runtime types.
- Team
Termination Policy - Clean termination conditions independent from hard resource budgets.
Enums§
- Blackboard
History Policy - Transcript projection visible to each blackboard speaker.
- Blackboard
Schedule - Speaker scheduling for a blackboard team.
- Relationship
Approval Policy - Approval requirement for a relationship invocation.
- Relationship
Failure Strategy - Failure handling for an exact relationship.
- Relationship
Kind - Control-flow semantics for a team relationship.
- Team
Agent Health - Health advertised by a registry candidate at resolution time.
- Team
Architecture Template - Portable LLM-directed team architecture presets.
- Team
Context Policy - Context sharing policy for agent-as-tool delegation.
- Team
Error - Validation or compilation failure for a
TeamSpec. - Team
Execution Status - Lifecycle state of a team or relationship execution.
- Team
Failure Policy - Failure behavior for team relationships.
- Team
History Policy - Conversation history exposed to a delegated member.
- Team
Lifecycle Decision - Decision returned before a team lifecycle boundary executes.
- Team
Lifecycle Outcome - Result observed after a team lifecycle boundary.
- Team
Lifecycle Phase - Lifecycle boundary exposed by portable team execution.
- Team
Replay Error - Integrity failure found while validating an execution receipt for replay/evaluation.
- Team
Resume Plan - Safe action a durable host can take for a restored execution receipt.
- Team
Resume Policy - Recovery contract for a delegation that was running when execution stopped.
- Team
Runtime Error - Structured failure produced while a compiled team is executing.
- Team
State Merge Policy - Merge policy for state returned by an exact delegation edge.
- Workflow
Architecture Template - Portable deterministic workflow presets built from existing agent types.
Constants§
- DEFAULT_
LOOP_ MAX_ ITERATIONS - Default maximum iterations for LoopAgent when none is specified. Prevents infinite loops from consuming unbounded resources.
- DEFAULT_
MAX_ ITERATIONS - Default maximum number of LLM round-trips (iterations) before the agent stops.
- DEFAULT_
TOOL_ TIMEOUT - Default tool execution timeout (5 minutes).
- TEAM_
EDGE_ ID_ KEY - Event metadata key containing the causal relationship execution identifier.
- TEAM_
EXECUTION_ STATE_ KEY - Session state key containing the latest serializable team execution receipt.
- TEAM_
ROOT_ INVOCATION_ KEY - Event metadata key containing the stable root team invocation identifier.
Traits§
- Agent
- The fundamental trait for all ADK agents.
- Team
Agent Registry - Discovers and resolves local or remote agents for portable team members.
- Team
Lifecycle Hook - Async team execution hook.
Functions§
- analyze_
team_ execution - Computes deterministic topology coverage and failure metrics.
- extract_
typed - Extract a typed value from agent events.
- normalize_
content - Normalize content by converting tool call markup in text parts to FunctionCall parts.
- normalize_
option_ content - Normalize
Option<Content>by converting tool call markup. - validate_
team_ replay - Validates receipt integrity against an immutable
TeamSpec.
Type Aliases§
- After
Tool Callback Full - Rich after-tool callback that receives the tool, arguments, and response.
- OnTool
Error Callback - Callback invoked when a tool execution fails (after retries are exhausted).