Examples

This section contains example Agent Definition Language (ADL) documents. They illustrate the specification and can be used to validate tooling.

:::tip Start Here New to ADL? Start with the Minimal Example to understand the required fields, then explore the Production Example for a complete implementation. :::

Example Index

Example	Description
Minimal	Minimal valid ADL document with only required fields
With Tools	Calculator agent demonstrating tool definitions
Production	Full production-style agent with all features

Conventions

• Examples are valid against the ADL version they target
• Format: YAML or JSON; must be valid JSON (RFC 8259) when processed
• Encoding: UTF-8
• Member names: snake_case (lowercase with underscores)
• Required members: adl_spec, name, description, version, data_classification
• Versioning: adl_spec and version use semantic versioning (MAJOR.MINOR.PATCH)
• Timestamps: ISO 8601 with timezone (e.g., 2026-02-15T14:30:00Z)
• Extensions: Use the extensions object with vendor-namespaced keys

Quick Reference

The minimal valid ADL document:

minimal.adl.yaml

adl_spec: "0.2.0"
name: Hello Agent
description: A simple greeting agent.
version: "1.0.0"

data_classification:
  sensitivity: public

:::info File Extension ADL documents use the .adl.yaml, .adl.json, or .adl file extension. The media type is application/adl+json. :::

Contributing Examples

New examples are welcome! To contribute:

1. Ensure the example conforms to the target spec version
2. Add clear comments explaining the example's purpose
3. Submit a PR with the example

See the Contributing Guide for more information.