All 34 articles, sorted alphabetically
Production Agent Architecture: The Full Stack in Depth
A 2500-word walkthrough of a production agent runtime: UI, auth, planner, memory, tool router, policy, observability, and the tool ecosystem underneat…
Read article →Request hedging for ADK-Java agents
Deep-dive on request hedging (backup requests) in an ADK-Java agent: issue a duplicate to an independent replica when the primary misses a delay tuned…
Read article →ADK Java artifacts
Deep-dive on the ADK Java artifact service: the append-only versioned save/load contract, session vs user: namespaces, ToolContext and CallbackContext…
Read article →Authorization at the Agent Boundary
Enforce access control before the LLM runs: middleware interceptors, policy-as-config, deny-by-default, and the boundary&a…
Read article →ADK Java bulkhead isolation architecture
Deep-dive on bulkhead isolation in ADK Java agents: dependency-scoped thread-pool and semaphore compartments, virtual-thread economics, composition wi…
Read article →ADK Java callback architecture
Deep-dive on ADK Java callbacks: beforeAgent/afterAgent, beforeModel/afterModel, beforeTool/afterTool, short-circuit semantics, callback chains, injec…
Read article →ADK Java circuit breaker architecture
Deep-dive on the circuit breaker pattern in an ADK Java agent: a three-state machine (CLOSED, OPEN, HALF-OPEN) around one dependency, a sliding window…
Read article →ADK Java Core Module
What ships in the ADK Java core module and how the pieces compose: the agent abstraction and lifecycle, Runner and session state, the event stream, th…
Read article →ADK-Java dead-letter queue architecture
Deep-dive on dead-letter queues for ADK-Java agent pipelines: bounded retries and the attempt counter, the DLQ router and failure metadata, head-of-li…
Read article →ADK Java deployment -- packaging, sessions, virtual threads, JVM tuning
Deep-dive on deploying ADK Java agents: JAR/container packaging, Cloud Run/GKE/VM targets, externalized config and secrets, durable session backends f…
Read article →Environment + Configuration Management
ADK Java environment and configuration management: 12-factor config, env-driven builders, typed config helpers, profiles, secrets, validation, externa…
Read article →Agent governance architecture
Governance plane for Java-based agent runtimes: policy engine, approval broker, guardrail LLM, tool registry, session store, and a review loop.
Read article →ADK-Java Graceful Shutdown: Architecture Deep-Dive
How an agent runtime drains cleanly on SIGTERM — readiness propagation, admission gating, drain deadlines under the grace period, checkpointing long t…
Read article →Idempotency architecture
Deep-dive on idempotency for side-effecting agent tool calls in a Java ADK service: how to retry aggressively without double-charging, double-sending,…
Read article →ADK Java MemoryService architecture
Deep-dive on ADK Java's long-term memory: the session-versus-MemoryService split, addSessionT…
Read article →ADK Java observability architecture
Deep-dive on observing ADK Java agents: span trees rooted at the Runner, before/after callbacks as telemetry taps, streaming token accounting, session…
Read article →adk-java transactional outbox architecture
Deep-dive on the transactional outbox pattern for Java ADK agents: committing state and an outbox row in one JDBC transaction to kill the dual-write p…
Read article →ADK-Java planner -- decomposing a goal into steps
Deep-dive on the ADK-Java planner: the complex-goal need, decomposition into a plan, the executor, plan-then-execute vs reacting per step, replanning …
Read article →ADK-Java RAG grounding -- answering from your data
Deep-dive on ADK-Java RAG grounding: the grounding need, the retrieval tool, grounding answers in retrieved context, citations, vector search, chunkin…
Read article →ADK-Java rate limiting architecture
Deep-dive on rate limiting in the Java Agent Development Kit: the token-bucket algorithm shaping bursty model and tool calls under hard provider quota…
Read article →Agent Router Architecture in Depth
A 2500-word walkthrough of agent router architecture: intent classifier, model pool, budgets, escalation, A/B evaluation.
Read article →ADK Java Runtime in Depth: What Happens From Building the Agent Tree to the First Event, and How to Boot Safely
The real boot sequence of a Google ADK for Java application: building LlmAgent trees and FunctionTools, choosing session, artifact and memory services…
Read article →ADK Java Runtime
Every phase of the ADK Java runtime's execution loop, from message-in to response-out, with t…
Read article →Model Call Orchestration Inside the ADK Java Runtime: One LLM Call from Request Assembly to Event, with Code
How the Agent Development Kit for Java turns session state into a model call and back: BaseLlmFlow's request processors, before/after/on-…
Read article →Session Context in ADK Java, in Depth: Sessions, State Prefixes, InvocationContext and ToolContext, and What Survives a Turn
How session context really works in Google's ADK for Java: the BaseSessionService contract, State as a delta-recording map, app:, user:, temp: an…
Read article →Tool Dispatch Mechanics in the ADK Java Runtime
What the ADK Java runtime does between the model asking for a tool and the result landing back in the session: name resolution, argument binding, fan-…
Read article →ADK-Java safety -- guardrails around agent behavior
Deep-dive on ADK-Java agent safety: the guardrails need, callbacks (before/after model and tool calls) as interception points, input and output guardr…
Read article →ADK Java + Spring
Deep-dive on integrating ADK Java with Spring Boot: agents and tools as DI-managed beans, tools as existing service beans, @ConfigurationProperties co…
Read article →Streaming agent architecture
Deep-dive on Java-based streaming agent runtime: SSE, async loop, model + tool events, interrupt, resume from checkpoint, and backpressure.
Read article →Timing Out ADK Java Tools Safely
How ADK Java enforces tool timeouts at runtime, how tool code detects and reacts to interruption, cleanup patterns with try-with-resources, graceful d…
Read article →Java agent tools architecture
Deep-dive on Java agent tool architecture: declaration, JSON schema, registry, executor, timeouts, idempotency, streaming, governance.
Read article →ADK Java Tools
How to define tools in ADK Java, the schema format for LLM function calling, and best practices for tool design.
Read article →Virtual threads for Java agents
Deep-dive on running a Java agent framework on virtual threads: the mount/unmount dance at blocking LLM and tool calls, the small carrier pool, struct…
Read article →Workflow orchestration architecture
Deep-dive on Java workflow orchestration: state machine, persistence, retries, timers, signals, compensation, versioning, testing.
Read article →