Overview
The Atera plugin connects ArgentOS to your Atera RMM/PSA platform. Your agent can query tickets, manage devices, monitor alerts, and run reports — all through natural conversation.
Built for MSPs and IT teams that use Atera as their primary helpdesk and remote management tool.
Quick Start
Add your Atera API key
In Dashboard > Settings > API Keys (variable: ATERA_API_KEY)
Enable the plugin
Add "atera" to plugins.allow in ~/.argentos/argent.json
Set your technician name
Set technicianName in plugins.entries.atera.config
Run setup
Ask the agent to run setup — she’ll link your technician ID automatically
| Tool | Description |
|---|
atera_tickets | List and search tickets by status, customer, or assignee |
atera_ticket | Get ticket detail or create new tickets |
atera_devices | List devices, filter by customer or online status |
atera_customers | List and search customers |
atera_alerts | View active monitoring alerts by severity |
atera_report | Run reports: my tickets, open tickets, customer summary, device health |
atera_setup | Self-service technician identity linking |
What You Can Ask
- “Show me my open tickets”
- “Any critical alerts right now?”
- “List offline devices for Acme Corp”
- “Create a high priority ticket for the printer issue at Smith & Co”
- “Give me a customer summary report”
- “How’s our device health looking?”
Agent Context
The plugin injects a live summary into the agent’s context before every conversation — your open ticket count and overall queue status. The agent always knows your current workload without you having to ask.
Requirements
- Atera account with API access
- API key from Atera Admin > API
Configuration
| Key | Description |
|---|
technicianName | Your display name in Atera |
technicianId | Auto-detected by atera_setup |
excludedCustomerIds | Customer IDs to hide (e.g., system accounts) |
Source
~/.argentos/extensions/atera/
argent.plugin.json
index.ts
README.md
See Building Plugins for how this extension was built.