Auggyv0.5.0
PublishedDocs / Reference

agent.yaml

Configure identity, engine, and enabled augment order for an agent project.

Role

agent.yaml is the runtime source of truth for an agent project. It declares identity, model-provider configuration, settings, and enabled augment order.

Scaffolded shapeyaml
name: my-agent
displayName: My Agent
purpose: Help visitors with product and support workflows.
creator:
  displayName: Operator
identity: ./identity.md

engine:
  provider: anthropic
  model: claude-sonnet-4-6
  maxContextTokens: 200000
  maxTokens: 4096
  # reasoningEffort: medium
  # costOverride:
  #   inputUsdPerMtok: 3
  #   outputUsdPerMtok: 15

settings:
  compactionStrategy: truncate
  maxInferenceLoops: 10

augments:
  - fileMemory
  - filesystem
  - webTransport
  - webFetch
  - turnControl
  - knowledge

Rules

  • Keep secrets in .env, not agent.yaml.
  • Use engine.provider and engine.model for model selection; use maxContextTokens, maxTokens, and provider-specific fields for runtime behavior.
  • Treat augment order as part of runtime behavior.
  • Use augment-specific config in augments/<id>/augment.yaml.

Related

defineAugmentDefine a runtime capability that contributes tools, context, memory, transports, lifecycle, or policy to an agent.