DSL for defining AI agents with a clean, declarative syntax.

Provides macros to simplify agent creation with sensible defaults and expressive configuration options.

Examples

defmodule MyResearchAgent do
  use Normandy.DSL.Agent

  agent do
    name "Research Agent"
    description "Conducts research and analysis"

    model "claude-3-5-sonnet-20241022"
    temperature 0.7
    max_tokens 4096

    system_prompt """
    You are a helpful research assistant.
    Provide thorough, well-researched answers.
    """

    # Optional: Define tools
    tool CalculatorTool
    tool SearchTool
  end
end

# Create an instance
{:ok, agent} = MyResearchAgent.new(client: my_client)

# Run the agent
{updated_agent, response} = MyResearchAgent.run(agent, "Research quantum computing")

Without DSL (for comparison)

config = %{
  client: my_client,
  model: "claude-3-5-sonnet-20241022",
  temperature: 0.7,
  max_tokens: 4096
}

agent = Normandy.Agents.BaseAgent.init(config)
# ... configure system prompt, tools, etc.

Features

• Clean, declarative syntax
• Sensible defaults
• Compile-time validation
• Generated helper functions
• Tool registration support
• Memory management helpers