# Agent Mode

{% hint style="info" %}
**Availability:** Agent Mode is available for groundcover Cloud, BYOC AWS, BYOC GCP, and on-premises deployments on AWS or GCP. Azure BYOC is not currently supported. Some environments require additional setup. See [Requirements & Compatibility](/use-groundcover/agent-mode/requirements.md).
{% endhint %}

groundcover Agent Mode is an AI-powered assistant built into the groundcover platform. Interact with it in natural language to investigate issues, explore your data, create dashboards and monitors, and more - across logs, traces, metrics, events, and entities.

## What You Can Do

### Investigate Issues

Ask the Agent to diagnose problems across your infrastructure. It queries logs, traces, metrics, and Kubernetes events, then reports what it found and what likely caused the issue.

> "Why is the checkout service throwing 500 errors?" "What changed recently in the payments namespace?" "Triage the alert on high-error-rate monitor"

### Explore Your Data

Query any signal type using plain language.

> "Show me the top 10 error-producing workloads in production" "What are the slowest endpoints in the API gateway?" "Which pods are consuming the most memory?"

### Create Dashboards & Monitors

Build production-ready dashboards and monitoring rules from a description.

> "Build a dashboard for the payments namespace" "Create a monitor that alerts when error rate exceeds 5% on the checkout service"

### Parse & Manage Logs

Generate log parsing rules and drop rules without learning OTTL syntax.

> "Parse the unstructured logs from the nginx workload" "Create a drop rule for health check logs"

### Navigate the Platform

The Agent can take you to the right page in the groundcover UI with filters already applied.

> "Take me to the traces view for the auth service filtered to errors"

## Signals

The Agent works across all groundcover signal types:

| Signal       | What It Contains                                                         | Example Use                                  |
| ------------ | ------------------------------------------------------------------------ | -------------------------------------------- |
| **Logs**     | Application log lines with level, format, and content                    | Find error patterns, parse unstructured logs |
| **Traces**   | Distributed traces with duration, status codes, and service dependencies | Diagnose latency, trace error paths          |
| **Metrics**  | Prometheus-compatible time-series data                                   | Monitor resource usage, track SLIs           |
| **Events**   | Kubernetes events and infrastructure changes (deploys, crashes, scaling) | Correlate changes with incidents             |
| **Entities** | Live Kubernetes resource state (pods, deployments, nodes, services)      | Check current health, find resource issues   |
| **Issues**   | Active and resolved monitor alerts with severity levels                  | Triage alerts, review incident history       |

## Next Steps

* [Requirements & Compatibility](/use-groundcover/agent-mode/requirements.md) - Supported deployments and prerequisites
* [Getting Started](/use-groundcover/agent-mode/getting-started.md) - Learn how to interact with Agent Mode
* [Skills](/use-groundcover/agent-mode/skills.md) - Teach Agent Mode your team's workflows and conventions
* [Example Prompts](/use-groundcover/agent-mode/example-prompts.md) - Copy-paste prompts for common scenarios
* [Configuring Settings](/use-groundcover/agent-mode/configuring-settings.md) - Enable, disable, and manage Agent Mode for your workspace
* [Privacy & Security](/use-groundcover/agent-mode/privacy-and-security.md) - Tenant isolation, session management, data retention, and access control
* [Cost Management](/use-groundcover/agent-mode/cost-management.md) - Set monthly spending limits for Agent Mode
* [Connectors](/use-groundcover/connectors.md) - Connect external tools like Cursor so Agent Mode can take actions on your behalf
* [MCP Integration](/getting-started/groundcover-mcp.md) - Use groundcover as a tool for external AI agents (Cursor, Claude Desktop, etc.)


---

# 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.groundcover.com/use-groundcover/agent-mode.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.