YAML Agent Configuration

your-cube-project/
├── model/
│   └── cubes/
│       └── orders.yml
├── agents/
│   ├── config.yml           # Main configuration
│   ├── spaces/
│   │   └── sales.yml        # Sales space configuration
│   └── agents/
│       └── assistants.yml   # Agent definitions
└── cube.js

spaces:
  - # Space definitions...
 
agents:
  - # Agent definitions...

spaces:
  - name: analytics-space          # Required: unique identifier
    title: "Analytics Space"       # Optional: display name
    description: "Space for analytics agents"
    rules:
      - # Rule definitions...
    certified_queries:
      - # Certified query definitions...

spaces:
  - name: sales-space
    rules:
      - name: fiscal-year-rule
        description: "Use fiscal year for date calculations"
        prompt: "Always use fiscal year starting April 1st when analyzing dates"
        type: always
      
      - name: efficiency-analysis
        description: "Sales efficiency calculation guidance"
        prompt: "When analyzing sales efficiency, calculate as deal size divided by sales cycle length"
        type: agent_requested

spaces:
  - name: sales-space
    certified_queries:
      - name: total-revenue
        description: "Calculate total revenue"
        user_request: "What is the total revenue?"
        sql_query: "SELECT SUM(amount) as total_revenue FROM orders WHERE status = 'completed'"
      
      - name: monthly-sales
        description: "Monthly sales breakdown"
        user_request: "Show me sales by month"
        sql_query: |
          SELECT 
            DATE_TRUNC('month', order_date) as month,
            SUM(amount) as total_sales
          FROM orders
          GROUP BY 1
          ORDER BY 1

agents:
  - name: sales-assistant           # Required: unique identifier
    title: "Sales Assistant"        # Optional: display name
    description: "AI assistant for sales analytics"
    space: sales-space              # Required: reference to a space
    llm: claude_4_sonnet            # Optional: LLM provider
    embedding_llm: text-embedding-3-large  # Optional: embedding model
    runtime: reasoning              # Optional: runtime mode
    accessible_views:               # Optional: list of accessible views
      - orders_view
      - customers_view
    memory_mode: user               # Optional: memory isolation mode

agents:
  - name: my-agent
    space: my-space
    llm: claude_4_sonnet

agents:
  - name: my-agent
    space: my-space
    llm:
      byom:
        name: my-custom-model
    # Or reference by ID:
    # llm:
    #   byom:
    #     id: 123

# agents/config.yml
spaces:
  - name: sales-analytics
    title: "Sales Analytics"
    description: "Space for sales team analytics and reporting"
    rules:
      - name: fiscal-year
        description: "Use fiscal year for date calculations"
        prompt: "Always use fiscal year starting April 1st when analyzing dates. Q1 is April-June, Q2 is July-September, Q3 is October-December, Q4 is January-March."
        type: always
      
      - name: revenue-definition
        description: "Standard revenue calculation"
        prompt: "Revenue should be calculated as quantity × unit_price, excluding cancelled orders and refunds."
        type: always
      
      - name: efficiency-analysis
        description: "Sales efficiency methodology"
        prompt: "When analyzing sales efficiency, calculate as deal size divided by sales cycle length. Include pipeline velocity metrics for comprehensive analysis."
        type: agent_requested
    
    certified_queries:
      - name: quarterly-revenue
        description: "Get revenue by fiscal quarter"
        user_request: "What is the revenue by quarter?"
        sql_query: |
          SELECT 
            CASE 
              WHEN MONTH(order_date) BETWEEN 4 AND 6 THEN 'Q1'
              WHEN MONTH(order_date) BETWEEN 7 AND 9 THEN 'Q2'
              WHEN MONTH(order_date) BETWEEN 10 AND 12 THEN 'Q3'
              ELSE 'Q4'
            END as fiscal_quarter,
            SUM(quantity * unit_price) as revenue
          FROM orders
          WHERE status != 'cancelled'
          GROUP BY 1
          ORDER BY 1
 
  - name: marketing-analytics
    title: "Marketing Analytics"
    description: "Space for marketing team analytics"
    rules:
      - name: attribution-model
        description: "Default attribution model"
        prompt: "Use last-touch attribution model by default for campaign analysis unless otherwise specified."
        type: always
 
agents:
  - name: sales-assistant
    title: "Sales Assistant"
    description: "AI assistant for sales analytics and reporting"
    space: sales-analytics
    llm: claude_4_sonnet
    embedding_llm: text-embedding-3-large
    runtime: reasoning
    accessible_views:
      - orders_view
      - customers_view
      - products_view
    memory_mode: user
 
  - name: sales-report-builder
    title: "Sales Report Builder"
    description: "Specialized agent for building sales reports"
    space: sales-analytics
    llm: gpt_4o
    runtime: plain
    accessible_views:
      - orders_view
    memory_mode: space
 
  - name: marketing-analyst
    title: "Marketing Analyst"
    description: "AI assistant for marketing analytics"
    space: marketing-analytics
    llm:
      byom:
        name: custom-marketing-model
    runtime: reasoning
    memory_mode: user

# agents/spaces/sales.yml
spaces:
  - name: sales-analytics
    title: "Sales Analytics"
    rules:
      - name: fiscal-year
        prompt: "Use fiscal year starting April 1st"
        type: always

# agents/spaces/marketing.yml
spaces:
  - name: marketing-analytics
    title: "Marketing Analytics"
    rules:
      - name: attribution
        prompt: "Use last-touch attribution"
        type: always

# agents/agents.yml
agents:
  - name: sales-assistant
    space: sales-analytics
    llm: claude_4_sonnet
  
  - name: marketing-assistant
    space: marketing-analytics
    llm: gpt_4o