google/adk-python

adk-agent-builder

Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between agents, human-in-the-loop pauses, and pytest coverage for all of…

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/google/adk-python --skill adk-agent-builder

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

ADK Agent Builder

Read only the reference that matches the task. Loading the whole tree costs context and buries the part that matters.

Every API below was checked against google-adk 2.6.2. If a symbol is missing at runtime, read the source under src/google/adk/ rather than guessing a neighbouring name.

Start here

TaskReference
First agent, environment, adk CLIgetting-started.md
Which import path is the canonical oneimport-paths.md
The rules that cause most runtime failuresbest-practices.md

Building blocks

Google API toolsets, built-in tools, custom BaseTool and BaseToolset.

parameter resolution, generators, node_input typing rules.

workflow node: output types, instruction templates, output_schema, auto-wrapping behavior.

mode='single_turn' delegation with schema-validated input and output.

Graph orchestration

edges, dict routing maps, default routes, self-loops, revision loops.

JoinNode fan-in, parallel_worker=True list processing.

with ctx.run_node() and imperative workflow construction.

resume behavior, resumable vs replayed sessions.

retries, custom BaseNode subclasses, graph validation rules.

the deprecated SequentialAgent / LoopAgent / ParallelAgent shells that Workflow replaces.

Runtime and verification

Event fields, and how state flows between nodes.

artifacts, memory, and state key scoping.

agent callbacks and app-level plugins.

  • testing.md — pytest with InMemoryRunner, faking a

model, asserting on node output.