Files
google--adk-python/AGENTS.md
T
wehub-resource-sync ec2b666284
Continuous Integration / Pre-commit Linter (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.10) (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.11) (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.12) (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.13) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.10) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.11) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.12) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.13) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.14) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.10) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.11) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.12) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.13) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.14) (push) Waiting to run
Copybara PR Handler / close-imported-pr (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:25:13 +08:00

1.4 KiB

Project Overview

The Agent Development Kit (ADK) is an open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents.

Key Components

  • Agent: Blueprint defining identity, instructions, and tools.
  • Runner: Stateless execution engine that orchestrates agent execution.
  • Tool: Functions/capabilities agents can call.
  • Session: Conversation state management.
  • Memory: Long-term recall across sessions.
  • Workflow (ADK 2.0): Graph-based orchestration of complex, multi-step agent interactions.
  • BaseNode (ADK 2.0): Contract for all nodes, supporting output streaming and human-in-the-loop steps.
  • Context (ADK 2.0): Holds execution state and telemetry context mapped 1:1 to nodes.

For details on how the Runner works and the invocation lifecycle, please refer to the adk-architecture skill and the referenced documentation therein.

ADK Knowledge, Architecture, and Style

Skills related to ADK development are in .agents/skills/.

Project Architecture

For detailed architecture patterns, component descriptions, and core interfaces, please refer to the adk-architecture skill at .agents/skills/adk-architecture/SKILL.md.

Development Setup

The project uses uv for package management and Python 3.10+. Please refer to the adk-setup skill at .agents/skills/adk-setup/SKILL.md for detailed instructions.