Minimal Example

This is the simplest valid ADL document, containing only the required fields.

Validation

This document validates against the ADL JSON Schema.

Document

YAML

hello-agent.adl.yaml

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

data_classification:
  sensitivity: public

JSON

hello-agent.adl.json

{
  "adl_spec": "0.3.0",
  "name": "Hello Agent",
  "description": "A simple greeting agent.",
  "version": "1.0.0",
  "data_classification": {
    "sensitivity": "public"
  }
}

Required Fields

Field	Description
adl_spec	ADL specification version (must be semantic version format)
name	Human-readable name for the agent
description	Description of the agent's purpose and capabilities
version	Agent's version (must be semantic version format)

Notes

Key Points

• This document declares conformance to ADL version 0.1.0
• The agent has no tools, resources, prompts, or permissions defined
• The runtime will determine the model to use
• All fields use snake_case naming convention

Next Steps

Ready to add more functionality? See:

• Agent with Tools - Add tool definitions
• Production Agent - Full-featured example