# What are Opsera Agents

Opsera Agents are AI-powered automation tools that help teams analyze, secure, and document their software systems. They integrate directly into developer environments such as **Claude Desktop, Cursor, and VS Code**, enabling engineers to run complex analysis using natural language prompts.

Opsera Agents help teams understand system architecture, identify security risks, protect sensitive data, and maintain compliance across the software development lifecycle.

<mark style="color:$primary;">**Agents work with you, not against you**</mark> <mark style="color:$primary;"></mark><mark style="color:$primary;">— adapting to your specific needs rather than forcing your workflow into predefined boxes.</mark>

## What is an Opsera Agent?

An Opsera Agent is a **self-contained, AI-driven microservice** that:

1. **Receives context** about your application and environment
2. **Analyzes requirements** based on detected patterns and configurations
3. **Generates solutions** through templates, machine learning, and best practices
4. **Orchestrates tools** to execute the planned steps
5. **Validates outcomes** and provides intelligent feedback
6. **Adapts behavior** based on results and learned patterns

```
Agent = Context Analysis + Intelligent Decision-Making + Tool Orchestration + Validation
```

## Core Principles

| Principle         | Definition                                              | Benefit                                   |
| ----------------- | ------------------------------------------------------- | ----------------------------------------- |
| **Intelligence**  | Agents understand intent and context, not just commands | Fewer manual steps, smarter defaults      |
| **Autonomy**      | Agents operate independently within guardrails          | Reduced human toil, faster feedback loops |
| **Composability** | Agents combine to solve complex problems                | Flexible solutions for unique situations  |
| **Transparency**  | Every action is logged, auditable, and explainable      | Full compliance and audit trail           |
| **Reliability**   | Agents include error handling and self-healing          | Predictable, reproducible deployments     |

## Recommended path for new users

Follow these steps to start using **Opsera Agents** with Claude, Cursor, or VS Code.

{% stepper %}
{% step %}

### **Install Opsera Agents**

Add Opsera Agents to your development environment using the MCP integration. Opsera Agents work with supported developer tools including **Claude Code, Cursor IDE, and VS Code**. Follow the installation guide for your editor to add the Opsera MCP server.
{% endstep %}

{% step %}

### **Connect your development environment**

Once installed, Opsera Agents connect to your workspace or repository so they can analyze your codebase, infrastructure configuration, and dependencies. After setup, your editor will recognize the available Opsera agents and their capabilities.
{% endstep %}

{% step %}

### **Run your first agent**

Use natural language prompts directly in your editor or chat interface to run analyses.

Examples:

* Run a security scan for this repository
* Analyze the architecture of this codebase
* Check this project for compliance issues
* Identify vulnerabilities in the current service

Opsera Agents will analyze your project and return results directly in your development environment.
{% endstep %}

{% step %}

### **Review insights and take action**

Opsera Agents generate actionable insights, including:

* security vulnerabilities and remediation guidance
* architecture analysis and system diagrams
* database and SQL security findings
* compliance gap analysis and audit reports

You can use these results to improve system security, maintain documentation, and automate DevSecOps workflows.
{% endstep %}
{% endstepper %}

### Develop with Opsera Agents

Opsera provides tools that allow teams to integrate AI-powered analysis directly into their development workflows.

* **Editor Integrations**\
  Use Opsera Agents directly within development environments such as Claude Desktop, Cursor, and VS Code.
* **CI/CD Integrations**\
  Run automated analysis and security checks within CI/CD pipelines.
* **Reports and Documentation**\
  Generate architecture diagrams, security reports, and compliance documentation automatically.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agents.opsera.ai/what-are-opsera-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.