---
title: Security use cases for Elastic Agent Builder
description: Example prompts for common Elastic Security workflows in Agent Builder, with the built-in skills each workflow uses.
url: https://www.elastic.co/docs/solutions/security/ai/agent-builder/skills-use-cases
products:
  - Elastic Cloud Serverless
  - Elastic Security
applies_to:
  - Serverless Security projects: Generally available
  - Elastic Stack: Generally available since 9.4
---

# Security use cases for Elastic Agent Builder
This page shows example conversations with the [Elastic AI Agent](/docs/explore-analyze/ai-features/agent-builder/builtin-agents-reference#elastic-ai-agent) for common Elastic Security use cases. Each section names the built-in Security skill (or skills) to enable for that use case and gives example prompts. For what each skill does, refer to the [Built-in skills reference](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/builtin-skills-reference). For how agents, skills, and tools fit together, start with [Elastic AI Agent, skills, and tools in Elastic Security](https://www.elastic.co/docs/solutions/security/ai/agent-builder/skills-model).
Skills can be activated three ways: the agent selects one automatically from your prompt, you invoke one explicitly with a slash command (for example, `/threat-hunting`), or you attach context (such as an alert from the alert flyout) that activates the matching skill. These examples assume the agent is selecting automatically unless otherwise noted.

## Alert triage and investigation

**Enable:** `alert-analysis` (optionally combine with [`entity-analytics`](#entity-risk-investigation) for deeper entity context)
Use this skill to triage a specific alert or work through an alert queue. The agent fetches the alert, finds related alerts that share entities, correlates with Elastic Security Labs threat intelligence, and recommends a disposition (true positive, benign true positive, false positive, or needs more data). For a multi-skill flow that chains this into a tracking dashboard, refer to [Combining skills across use cases](#combining-skills-across-workflows).

| Example prompt                                       | What the agent can do                                                                                                               |
|------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| What's the context on this critical alert?           | Pull alert details, find alerts that share host, user, or IP entities within a time window, and correlate with threat intelligence. |
| Find alerts related to this one over the last 7 days | Search for alerts sharing `host.name`, `user.name`, `source.ip`, or `destination.ip` with the source alert.                         |
| Should we escalate this alert?                       | Summarize evidence, check entity risk scores for involved hosts and users, and recommend a disposition with supporting reasoning.   |

<tip>
  You can also trigger this skill by attaching an alert from the alert flyout — the agent activates `alert-analysis` automatically based on the attachment.
</tip>


## Entity risk investigation

**Enable:** `entity-analytics`
Use this skill to find risky entities or profile specific hosts, users, services, or generic entities. The agent returns normalized risk scores (0-100), risk levels, asset criticality, watchlists, and behavioral history, and can analyze changes over time. The skill draws on Security Machine Learning anomaly detection jobs as part of its entity analysis. For deeper anomaly investigation, combine it with the [`find-security-ml-jobs`](#anomaly-investigation-with-ml) skill.

| Example prompt                                                        | What the agent can do                                                                                                                |
|-----------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
| Which users have the highest risk scores?                             | Return top N users sorted by normalized risk score, with risk level and asset criticality.                                           |
| Has `host-12`'s risk score changed significantly in the last 90 days? | Compare current and historical risk scores, flag changes greater than 20 points as significant, and summarize what drove the change. |
| What are the riskiest hosts that are high-impact assets?              | Filter for entities with criticality `high_impact` or `extreme_impact` and sort by risk score.                                       |

![Entity Analytics skill in Agent Builder](https://www.elastic.co/docs/solutions/images/security-ab-skill-ea.png)

## Threat hunting

**Enable:** `threat-hunting` (optionally combine with [`entity-analytics`](#entity-risk-investigation) and [`find-security-ml-jobs`](#anomaly-investigation-with-ml))
Use this skill for hypothesis-driven hunts. The agent runs iterative ES|QL queries, establishes baselines, searches for IOCs, and flags anomalies. It ships with query templates for lateral movement, C2 beaconing, brute force, and rare process starts. For multi-skill flows that pivot from a hunt finding into an entity profile or into rule validation, refer to [Combining skills across use cases](#combining-skills-across-workflows).

| Example prompt                                             | What the agent can do                                                                                                     |
|------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
| Hunt for lateral movement from `srv-01` in the last 7 days | Run ES|QL queries across process, authentication, and network data, identify pivots, and enrich with threat intelligence. |
| Sweep for file hash `abc123...` across recent events       | Search relevant indices for IOCs, summarize matches, and suggest next pivots.                                             |
| Look for C2 beaconing from hosts in the DMZ                | Apply the C2 beaconing template — periodic connection analysis, rare DNS queries — over a 7-day window.                   |


## Anomaly investigation with Machine Learning

**Enable:** `find-security-ml-jobs`
Use this skill to investigate anomalies surfaced by Security Machine Learning jobs: atypical access patterns, lateral movement, unexpected logins from new geographies, suspicious external domain activity, and large data transfers. The agent identifies relevant active jobs, queries `.ml-anomalies-*`, and summarizes findings.

| Example prompt                                                               | What the agent can do                                                                                                                                                               |
|------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Any unusual logins or access patterns in the last 24 hours?                  | Find relevant active Machine Learning jobs, query for anomalies that exceed the configured score threshold, and summarize with entity context.                                      |
| Show users who downloaded unusually large amounts of data                    | Use data exfiltration-related jobs (for example, `high_sent_bytes_destination_ip`, `high_bytes_written_to_external_device`), query anomaly records, and present results in a table. |
| Which Machine Learning jobs should I turn on for lateral movement detection? | Recommend relevant jobs that aren't currently running for the requested investigation.                                                                                              |


## Detection engineering

**Enable:** `detection-rule-edit`
Use this skill to create or edit detection rules. The skill supports **ES|QL rules only**. It drafts rules from natural language and edits fields such as severity, tags, MITRE ATT&CK mappings, schedule, and query. The agent describes its proposed changes and applies them to a rule attachment in the conversation. You then click **Apply to creation** or **Update rule** in the chat to apply the change to the rule creation or edit form.

| Example prompt                                                              | What the agent can do                                                                                        |
|-----------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| Create an ES|QL rule that detects PowerShell downloading from external URLs | Draft the rule with query, severity, risk score, and MITRE ATT&CK mappings, then render it as an attachment. |
| Raise the severity on this rule to critical and add the T1059 tag           | Update the attached rule's `severity`, `risk_score`, and `tags` fields and re-render the attachment.         |
| Add the Execution tactic (TA0002) and technique T1059.001 to this rule      | Append entries to the rule's `threat` array with correct tactic, technique, and subtechnique IDs.            |

<tip>
  `detection-rule-edit` operates on a rule attachment. The skill activates when a rule attachment is present in the conversation. You can start a rule attachment from the rule creation form, the rule details page, or by asking the agent to "create a detection rule" directly in chat — the skill creates the attachment and renders an **Apply to creation** button so you can save the rule from the chat.
</tip>


## Elastic Defend troubleshooting

<applies-to>
  - Serverless Security projects: Preview
  - Elastic Stack: Preview since 9.4
</applies-to>

**Enable:** `automatic_troubleshooting`
Use this skill to diagnose [Elastic Defend](https://www.elastic.co/docs/solutions/security/configure-elastic-defend) configuration issues: endpoints not reporting, policy response failures, agent enrollment problems, or incompatible antivirus. The agent queries endpoint data, inspects Elastic Defend package configuration, and produces structured findings with specific endpoint IDs and remediation steps.

| Example prompt                                            | What the agent can do                                                                                            |
|-----------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| Why isn't this endpoint showing up in the endpoint list?  | Query agent and endpoint indices for enrollment and check-in evidence, then flag the root cause and remediation. |
| Which endpoints are reporting policy response failures?   | Search for policy response errors or warnings across endpoints and summarize affected endpoint IDs.              |
| Is there any incompatible antivirus on the managed hosts? | Inspect endpoint data for known antivirus conflicts and recommend resolution steps.                              |


## Combining skills across use cases

The Elastic AI Agent can use a variety of skills in one conversation. As your questions shift across domains, the agent activates the matching skill — you don't need to start over or switch agents. The following examples show common multi-skill flows and the skills each turn activates.

### Alert to dashboard

Start from a critical alert and end with a tracking dashboard. The [`alert-analysis`](#alert-triage-and-investigation) skill enriches the alert with related alerts, entity risk, and threat intelligence. The [`dashboard-management`](/docs/explore-analyze/ai-features/agent-builder/builtin-skills-reference#agent-builder-dashboard-management-skill) platform skill then creates a Kibana dashboard to track similar activity going forward.
1. **You:** What's the context on this critical alert? → `alert-analysis` activates, pulls related alerts sharing entities, checks entity risk scores, and correlates with Elastic Security Labs.
2. **You:** Create a dashboard to track alerts like this going forward. → `dashboard-management` activates and composes a dashboard with filters matching the alert's rule, entities, and severity.


### Hunt to entity profile

Pivot from a hunt finding to a deeper profile of the implicated entities. The [`threat-hunting`](#threat-hunting) skill surfaces suspicious activity, and the [`entity-analytics`](#entity-risk-investigation) skill then profiles the users and hosts involved.
1. **You:** Hunt for lateral movement from `srv-01` in the last 7 days. → `threat-hunting` activates, runs iterative ES|QL queries, and flags suspicious authentication and process activity tied to a specific user.
2. **You:** Which other users and hosts are connected to that account, and what are their risk scores? → `entity-analytics` activates, returns normalized risk scores and asset criticality, and surfaces related entities from the entity store.


### Detection to validation

Draft a new detection rule, then validate it against historical data before enabling it. The [`detection-rule-edit`](#detection-engineering) skill creates the rule, and the [`threat-hunting`](#threat-hunting) skill re-runs its query to preview how noisy the rule would have been.
1. **You:** Create an ES|QL rule that detects PowerShell downloading from external URLs. → `detection-rule-edit` activates and drafts the rule as a rule attachment with severity, risk score, and MITRE ATT&CK mappings.
2. **You:** How many historical alerts would this rule have generated in the last 30 days? → `threat-hunting` activates, adapts the rule's query for a retrospective search, and summarizes matches so you can tune thresholds before saving the rule.


## Related pages

- [Elastic AI Agent, skills, and tools in Elastic Security](https://www.elastic.co/docs/solutions/security/ai/agent-builder/skills-model)
- [Agent Builder for Elastic Security](https://www.elastic.co/docs/solutions/security/ai/agent-builder/agent-builder)
- [Built-in skills reference](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/builtin-skills-reference)
- [Skills in Elastic Agent Builder](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/skills)