# BMS Facility Metrics Agent

## Agent Description
This agent provides real-time facility metrics and equipment monitoring from Automata Controls' Building Management System. It fetches the latest 5 minutes of operational data from various commercial and industrial facilities, presenting it in formatted HTML reports with interactive visualizations.

## Capabilities
- **Real-time Monitoring**: Retrieves metrics from the last 5 minutes for any configured facility
- **Multi-Location Support**: Access data from 10+ facilities including hospitals, universities, and commercial buildings
- **Comprehensive Equipment Data**: Monitors HVAC equipment including:
  - Air Handlers (temperature, humidity, valves, VFD speeds)
  - Boilers (supply/return temps, valve positions, pump status)
  - Chillers (entering/leaving temps, flow rates, efficiency)
  - Cooling Towers (basin temps, fan speeds, valve positions)
  - Fan Coil Units (space temps, valve positions, fan status)
  - Pumps (VFD speeds, differential pressure, flow rates)
  - Steam Systems (pressure, temperature, valve positions)

## Report Features
- **Dynamic Sensor Display**: Only shows sensors that exist for each equipment
- **Interactive Graphs**: Plotly-powered visualizations with:
  - Temperature trends over time
  - Valve position monitoring
  - VFD speed tracking
  - Equipment-specific navigation with chevron controls
- **Professional Formatting**: Teal/cyan themed reports matching corporate branding
- **Zone Organization**: Equipment grouped by building zones for easy navigation

## API Endpoint
```
GET {YOUR_BMS_API_ENDPOINT}/api/metrics/report?location={LOCATION_NAME}
```

## Available Locations
- Peabody
- HeritageWarren
- HuntingtonHeritage
- Hopebridge
- Akron
- Taylor_University
- Element
- FirstChurchOfGod
- NE_Realty

## Use Cases
- **Facility Managers**: Monitor real-time equipment performance
- **Maintenance Teams**: Identify equipment issues before failures
- **Energy Managers**: Track energy consumption patterns
- **Building Engineers**: Analyze system performance and optimization opportunities
- **Operations Staff**: Quick facility status checks and troubleshooting

## Technical Details
- Data Source: InfluxDB time-series database
- Update Frequency: Real-time (5-minute window)
- Response Format: HTML with embedded JavaScript/Plotly charts
- Authentication: Via agent.ai platform secrets

AutomataNexus

Associated Agents

AutomataNexus-Iris