Deployment Pipeline: Serialize Agent Configs with to_dict and to_yaml

Tip

What you’ll learn How to compose agents into a sequential pipeline.

Source: 26_serialization.py

from adk_fluent import Agent

# A ticket routing agent used in a customer support deployment pipeline.
# The DevOps team serializes configs for version control and review.
ticket_router = (
    Agent("ticket_router")
    .model("gemini-2.5-flash")
    .instruct(
        "Classify incoming support tickets by urgency (P0-P3) and "
        "route to the appropriate engineering team based on the product area."
    )
    .writes("routing_decision")
)

# Serialize to dict — inspect config in deployment dashboards
config_snapshot = ticket_router.to_dict()

# Serialize to YAML — store in version control alongside infrastructure code
yaml_manifest = ticket_router.to_yaml()

# Native ADK agents are Pydantic models with model_dump(), but this
# serializes the BUILT agent, not the builder configuration.
# In a CI/CD pipeline, you want to inspect and version-control the
# builder config — not the runtime object. There's no way to
# reconstruct a builder from a serialized native agent.

Equivalence

# to_dict produces expected structure matching the deployment config
assert config_snapshot["_type"] == "Agent"
assert config_snapshot["config"]["name"] == "ticket_router"
assert config_snapshot["config"]["model"] == "gemini-2.5-flash"
assert "urgency" in config_snapshot["config"]["instruction"]
assert config_snapshot["config"]["output_key"] == "routing_decision"

# Internal fields are excluded from serialized output (security)
ticket_router._config["_internal"] = "db_connection_string"
clean = ticket_router.to_dict()
assert "_internal" not in clean["config"]

# YAML contains human-readable config for code review
assert "ticket_router" in yaml_manifest
assert "gemini-2.5-flash" in yaml_manifest

# from_dict / from_yaml do a STRUCTURAL round-trip: builder type, config, and
# nested topology are restored. Callables (callbacks/guards/tool fns) are
# serialized as name strings and are NOT restored — the result is a faithful
# skeleton for inspection, diffing, and config-as-code, not a live clone.
restored = Agent.from_dict(config_snapshot)
assert restored._config["name"] == "ticket_router"
assert restored._config["model"] == ticket_router._config["model"]

from_yaml_restored = Agent.from_yaml(yaml_manifest)
assert from_yaml_restored._config["name"] == "ticket_router"