Configuration

name: utility-bot
persona: You are a helpful utility bot that can perform various calculations.

# Step definitions
steps:
  - step_id: start
    description: Handle user requests for mathematical operations.
    available_tools:
      - sqrt
      - calculate_area
    routes:
      - target: end
        condition: User is done with calculations

  - step_id: end
    description: Say goodbye to the user.

start_step_id: start
max_errors: 3
max_iter: 5

# LLM configuration
llm:
  provider: openai
  model: gpt-4o-mini

from nomos import Agent, AgentConfig, Step, Route
from nomos.llms import OpenAI
from nomos.models.flow import FlowConfig

def get_time():
    """Get the current time."""
    from datetime import datetime
    return f"Current time: {datetime.now()}"

# Define steps
steps = [
    Step(
        step_id="start",
        description="Greet and offer to tell time or do calculations.",
        available_tools=["get_time"],
        routes=[
            Route(target="calculation", condition="User wants math"),
            Route(target="end", condition="User is done")
        ],
    ),
    Step(
        step_id="calculation",
        description="Perform mathematical calculations.",
        available_tools=["sqrt", "pow"],
        routes=[Route(target="end", condition="Calculation complete")],
    ),
    Step(
        step_id="end",
        description="Say goodbye.",
    ),
]

# Define flows
flows = [
    FlowConfig(
        flow_id="math_workflow",
        description="Handle mathematical calculations",
        enters=["calculation"],
        exits=["end"],
        components={
            "memory": {
                "llm": {"provider": "openai", "model": "gpt-4o-mini"}
            }
        }
    )
]

# Create configuration
config = AgentConfig(
    name="clockbot",
    persona="You are a friendly assistant for time and calculations.",
    steps=steps,
    flows=flows,
    start_step_id="start",
    llm={"provider": "openai", "model": "gpt-4o-mini"},
    max_errors=3,
    max_iter=5,
)

# Create and use agent
agent = Agent.from_config(config, tools=[get_time])
session = agent.create_session()

tools:
  tool_files:
    - "barista_tools.py"           # Python module
    - "tools.my_tools"             # Package path

  external_tools:
    # Python package tools
    - tag: "@pkg/itertools.combinations"
      name: "combinations"

    # CrewAI tools
    - tag: "@crewai/FileReadTool"
      name: "file_read_tool"

    # LangChain tools
    - tag: "@langchain/google_search"
      name: "google_search"

    # MCP tools
    - tag: '@mcp/https://gitmcp.io/dowhiledev/nomos'
      name: gitmcp

    # API tools - Single endpoint
    - tag: "@api/GET/https://api.github.com/users/{username}"
      name: "get_github_user"

    # API tools - Multiple endpoints
    - tag: "@api/https://jsonplaceholder.typicode.com"
      name: "posts_api"
      map:
        get_posts: "GET/posts"
        get_post: "GET/posts/{id}"
        create_post: "POST/posts"
        update_post: "PUT/posts/{id}"
        delete_post: "DELETE/posts/{id}"
      headers:
        Authorization: "Bearer ${API_TOKEN}"

  tool_defs:
    add_to_cart:
      desc: "Add item to cart"
      args:
        - key: coffee_type
          desc: "Type of coffee (e.g., Espresso, Latte)"
          type: str
        - key: size
          desc: "Size (Small, Medium, Large)"
          type: str

    get_github_user:
      desc: "Get GitHub user information"
      args:
        - key: username
          desc: "GitHub username"
          type: str
        - key: per_page
          desc: "Number of results per page"
          type: int
          default: 30

    get_posts:
      desc: "Get all posts from API"
      args:
        - key: page
          desc: "Page number"
          type: int
          default: 1
        - key: limit
          desc: "Number of posts per page"
          type: int
          default: 10

# tools/my_tools.py
def greet(name: str) -> str:
    """Return a personalized greeting."""
    return f"Hello {name}!"

def calculate_tip(bill: float, percentage: float = 15.0) -> float:
    """Calculate tip amount."""
    return bill * (percentage / 100)

# Export tools for discovery
tools = [greet, calculate_tip]

nomos validate config.agent.yaml --verbose

✓ Configuration is valid!

Configuration Details:
├─ Agent Name: barista
├─ Number of Steps: 4
├─ Start Step ID: start
├─ LLM Provider: openai
└─ Session Store: memory

Warnings:
• Step 'calculation' has no examples - consider adding some

Recommendations:
• Add persona for more engaging interactions
• Consider using flows for complex workflows

nomos schema --output agent.schema.json

# yaml-language-server: $schema=./agent.schema.json
name: my-agent
# Your configuration gets autocompletion and validation