Core Concepts

This section explains the fundamental concepts that power OpsSquad.ai. Understanding these concepts will help you use the platform more effectively.

Platform Overview

OpsSquad.ai is built around four core concepts:

How OpsSquad.ai Works

1. Create a Squad - Squads are teams of agents working together. You can organize agents by environment (Production, Staging) or by function (DevOps, Security).
2. Deploy Nodes - Use the OpsSquad CLI tool to deploy nodes on your servers. Nodes are the infrastructure layer that connects to the platform.
3. Create and Link Agents - Create agents in your squad through the dashboard, then link them to deployed nodes. This flexible architecture allows you to reassign agents to different nodes as needed.
4. Interact via Chat - The Chat interface allows you to communicate with your agents using natural language. Select a squad and agent to start investigating.
5. Agents Execute Commands - Agents send commands to their linked nodes for execution. OpsSquad prevents unsafe or insecure commands and implements "human-in-the-loop" logic to ask for approval when sensitive commands are requested.

Data Flow

1. You send a message through the Chat interface
2. OpsSquad routes the message to the appropriate agent in your squad
3. The agent sends commands to its linked node
4. The node executes commands on your server
5. Results stream back through the agent to your chat

Key Principles

AI-Powered Intelligence

Agents understand natural language requests:

• "What's causing high CPU usage?"
• "Show me recent error logs"
• "Is the database connection working?"

They translate these into appropriate system commands.

Human-in-the-Loop Control

You maintain control through:

• Approvals - Review and approve sensitive commands
• Permissions - Verified user control for automated actions
• Audit Logs - Track everything that happens

Security by Design

Security is built into every layer:

• TLS Encrypted Sockets - Lock & secure transport for all data
• SLM AI Guardrails - Intelligent intent filtering vs simple whitelisting
• Permission-Based Execution - Verified user control for sensitive actions
• Continuous Layering - Ongoing defense in depth against hallucinations

Core Concept Pages

Platform Components

CLI Tool

The command-line interface for:

• Installing and managing nodes
• Deploying to servers
• Local node management

Learn more: CLI Reference

Dashboard

The web interface for:

• Creating and managing squads
• Creating agents and linking them to nodes
• Monitoring node and agent status
• Billing and team management

Learn more: Dashboard Guide

Chat Interface

The AI command center for:

• Natural language interaction with agents
• Real-time command execution
• Approval workflows

Learn more: Chat Interface

Architecture Deep Dive

Node Architecture

Each node runs as a lightweight service on your server:

Platform Architecture

The OpsSquad cloud platform:

Next Steps

Dive deeper into each concept:

• Agents - Understand agent capabilities and lifecycle.
• Squads - Learn about organizing agents into squads.
• Security - Explore the security model in depth.