Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified docs/AI-for-security/images/ai-triage-add-to-case.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/AI-for-security/images/attck-disc-11-alerts-disc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 4 additions & 4 deletions docs/AI-for-security/usecase-alert-triage.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@ Elastic AI Assistant can help you enhance and streamline your alert triage workf

When you view an alert in {elastic-sec}, details such as related documents, hosts, and users appear alongside a synopsis of the events that triggered the alert. This data provides a starting point for understanding a potential threat. AI Assistant can answer questions about this data and offer insights and actionable recommendations to remediate the issue.

To enable AI Assistant to answer questions about alerts, you need to provide alert data as context for your prompts. You can either provide multiple alerts using the <<ai-assistant-knowledge-base, knowledge base>> feature, or provide individual alerts directly.
To enable AI Assistant to answer questions about alerts, you need to provide alert data as context for your prompts. You can either provide multiple alerts using the <<ai-assistant-knowledge-base, Knowledge Base>> feature, or provide individual alerts directly.

[[ai-assistant-triage-alerts-knowledge-base]]
[discrete]
== Use AI Assistant to triage multiple alerts
Enable the <<configure-ai-assistant, knowledge base>> **Alerts** setting to send AI Assistant data for up to 100 alerts as context for each of your prompts. With this setting enabled, you can ask AI Assistant questions such as "How many alerts are present in my environment?", "What are my most urgent alerts?", "Which alerts should I triage first?", "Do any of the alerts in my environment indicate data exfiltration from a Windows machine?", and more.
Enable the <<ai-assistant-knowledge-base, Knowledge Base>> **Alerts** setting to send AI Assistant data for up to 500 alerts as context for each of your prompts. With this setting enabled, you can ask AI Assistant questions such as "How many alerts are present in my environment?", "What are my most urgent alerts?", "Which alerts should I triage first?", "Do any of the alerts in my environment indicate data exfiltration from a Windows machine?", and more.

For more information, refer to <<ai-assistant-knowledge-base, knowledge base>>.
For more information, refer to <<ai-assistant-knowledge-base, Knowledge Base>>.

For a demo of AI Assistant's alert triage capabilities, refer to the following video.
=======
Expand Down Expand Up @@ -42,7 +42,7 @@ NOTE: For more information about selecting which fields to send, and to learn ab
+
. (Optional) Click a quick prompt to use it as a starting point for your query, for example **Alert summarization**. Improve the quality of AI Assistant's response by customizing the prompt and adding detail.
+
Once youve submitted your query, AI Assistant will process the information and provide a detailed response. Depending on your prompt and the alert data that you included, its response can include a thorough analysis of the alert that highlights key elements such as the nature of the potential threat, potential impact, and suggested response actions.
Once you've submitted your query, AI Assistant will process the information and provide a detailed response. Depending on your prompt and the alert data that you included, its response can include a thorough analysis of the alert that highlights key elements such as the nature of the potential threat, potential impact, and suggested response actions.
+
. (Optional) Ask AI Assistant follow-up questions, provide additional information for further analysis, and request clarification. The response is not a static report.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Attack discovery can detect a wide range of threats by finding relationships amo

image::images/attck-disc-11-alerts-disc.png[An Attack discovery card showing an attack with 11 related alerts,90%]

In the example above, Attack discovery found connections between nine alerts, and used them to identify and describe an attack chain.
In the example above, Attack discovery found connections between thirteen alerts, and used them to identify and describe an attack chain.

After Attack discovery outlines your threat landscape, use Elastic AI Assistant to quickly analyze a threat in detail.

Expand All @@ -33,7 +33,7 @@ After Attack discovery outlines your threat landscape, use Elastic AI Assistant

From a discovery on the Attack discovery page, click **View in AI Assistant** to start a chat that includes the discovery as context.

image::images/attck-disc-remediate-sodinokibi.gif[A dialogue with AI Assistant that has the attack discovery as context,90%]
image::images/attck-disc-remediate-threat.gif[A dialogue with AI Assistant that has the attack discovery as context,90%]

AI Assistant can quickly compile essential data and provide suggestions to help you generate an incident report and plan an effective response. You can ask it to provide relevant data or answer questions, such as “How can I remediate this threat?” or “What {esql} query would isolate actions taken by this user?”

Expand Down
6 changes: 1 addition & 5 deletions docs/AI-for-security/usecase-esql-queries.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,7 @@
:frontmatter-tags-content-type: [guide]
:frontmatter-tags-user-goals: [get-started]

Elastic AI Assistant can help you learn about and leverage the Elasticsearch Query Language ({esql}).

With AI Assistant's <<ai-assistant-knowledge-base, {esql} knowledge base>> enabled, AI Assistant benefits from specialized training data that enables it to answer questions related to {esql} at an expert level.

AI Assistant can help with {esql} in many ways, including:
Elastic AI Assistant can help you learn about and leverage the Elasticsearch Query Language ({esql}) in many ways, including:

* **Education and training**: AI Assistant can serve as a powerful {esql} learning tool. Ask it for examples, explanations of complex queries, and best practices.
* **Writing new queries**: Prompt AI Assistant to provide a query that accomplishes a particular task, and it will generate a query matching your description. For example: "Write a query to identify documents with `curl.exe` usage and calculate the sum of `destination.bytes`" or "What query would return all user logins to [a host] in the last six hours?"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,22 +4,52 @@
// :description: Elastic AI Assistant can help you enhance and streamline your alert triage workflows.
// :keywords: security, overview, get-started

preview:[]
Elastic AI Assistant can help you enhance and streamline your alert triage workflows by assessing multiple recent alerts in your environment, and helping you interpret an alert and its context.

Elastic AI Assistant can help you enhance and streamline your alert triage workflows.
When you view an alert in {elastic-sec}, details such as related documents, hosts, and users appear alongside a synopsis of the events that triggered the alert. This data provides a starting point for understanding a potential threat. AI Assistant can answer questions about this data and offer insights and actionable recommendations to remediate the issue.

AI Assistant can help you interpret an alert and understand its context. When you view an alert in {elastic-sec}, details such as related documents, hosts, and users appear alongside a synopsis of the events that triggered the alert. This data provides a starting point for understanding a potential threat. AI Assistant can answer questions about this data and offer insights and actionable recommendations to remediate the issue.
To enable AI Assistant to answer questions about alerts, you need to provide alert data as context for your prompts. You can either provide multiple alerts using the <<ai-assistant-knowledge-base, Knowledge Base>> feature, or provide individual alerts directly.

[[ai-assistant-triage-alerts-knowledge-base]]
[discrete]
== Use AI Assistant to triage multiple alerts
Enable the <<ai-assistant-knowledge-base, Knowledge Base>> **Alerts** setting to send AI Assistant data for up to 500 alerts as context for each of your prompts. With this setting enabled, you can ask AI Assistant questions such as "How many alerts are present in my environment?", "What are my most urgent alerts?", "Which alerts should I triage first?", "Do any of the alerts in my environment indicate data exfiltration from a Windows machine?", and more.

For more information, refer to <<ai-assistant-knowledge-base, Knowledge Base>>.

For a demo of AI Assistant's alert triage capabilities, refer to the following video.
=======
++++
<script type="text/javascript" async src="https://play.vidyard.com/embed/v4.js"></script>
<img
style="width: 100%; margin: auto; display: block;"
class="vidyard-player-embed"
src="https://play.vidyard.com/v2dQtzmm6SoTFYc7dJzq7m.jpg"
data-uuid="v2dQtzmm6SoTFYc7dJzq7m"
data-v="4"
data-type="inline"
/>
</br>
++++
=======

[discrete]
[[use-ai-assistant-to-triage-an-alert]]
== Use AI Assistant to triage an alert

. Choose an alert to investigate, then click the **View details** button from the Alerts table.
. On the details flyout, click **Chat** to launch AI Assistant. Data related to the selected alert is automatically added to the prompt.
. Click **Alert (from summary)** to view which alert fields will be shared with AI Assistant. (For more information about selecting which fields to send, and to learn about anonymizing your data, refer to <<configure-ai-assistant,AI Assistant>>.)
. (Optional) Click a quick prompt to use it as a starting point for your query, for example, **Alert summarization**. Customize the prompt and add detail to improve AI Assistant's response.
Once you’ve submitted your query, the AI Assistant will process the information and provide a detailed response. Depending on your prompt and which alert data you included, its response can include a thorough analysis of the alert that highlights key elements such as the nature of the potential threat, potential impact, and suggested response actions.
. (Optional) Ask follow-up questions, provide additional information for further analysis, and request clarification. The response is not a static report.
== Use AI Assistant to triage a specific alert

Once you have chosen an alert to investigate:

. Click its **View details** button from the Alerts table.
. In the alert details flyout, click **Chat** to launch the AI assistant. Data related to the selected alert is automatically added to the prompt.
. Click **Alert (from summary)** to view which alert fields will be shared with AI Assistant.
+
NOTE: For more information about selecting which fields to send, and to learn about anonymizing your data, refer to <<security-ai-assistant, AI Assistant>>.
+
. (Optional) Click a quick prompt to use it as a starting point for your query, for example **Alert summarization**. Improve the quality of AI Assistant's response by customizing the prompt and adding detail.
+
Once you've submitted your query, AI Assistant will process the information and provide a detailed response. Depending on your prompt and the alert data that you included, its response can include a thorough analysis of the alert that highlights key elements such as the nature of the potential threat, potential impact, and suggested response actions.
+
. (Optional) Ask AI Assistant follow-up questions, provide additional information for further analysis, and request clarification. The response is not a static report.

[discrete]
[[generate-triage-reports]]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,7 @@
// :description: AI Assistant has specialized {esql} capabilities.
// :keywords: security, overview, get-started

Elastic AI Assistant can help you learn about and leverage the Elasticsearch Query Language ({esql}).

With AI Assistant's <<ai-assistant-knowledge-base,ES|QL knowledge base>> enabled, AI Assistant benefits from specialized training data that enables it to answer questions related to {esql} at an expert level.

AI Assistant can help with {esql} in many ways, including:
Elastic AI Assistant can help you learn about and leverage the Elasticsearch Query Language ({esql}) in many ways, including:

* **Education and training**: AI Assistant can serve as a powerful {esql} learning tool. Ask it for examples, explanations of complex queries, and best practices.
* **Writing new queries**: Prompt AI Assistant to provide a query that accomplishes a particular task, and it will generate a query matching your description. For example: "Write a query to identify documents with `curl.exe` usage and calculate the sum of `destination.bytes`" or "What query would return all user logins to [a host] in the last six hours?"
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
[[security-ai-usecase-incident-reporting]]
= Identify, investigate, and document threats

// :description: Use Attack discovery and AI Assistant to manage threats.
// :keywords: security, overview, get-started
:frontmatter-description: Elastic AI Assistant can help you write ES|QL queries.
:frontmatter-tags-products: [security]
:frontmatter-tags-content-type: [guide]
:frontmatter-tags-user-goals: [get-started]

Together, <<security-ai-assistant,Elastic AI Assistant>> and <<security-attack-discovery,Attack discovery>> can help you identify and mitigate threats, investigate incidents, and generate incident reports in various languages so you can monitor and protect your environment.

Expand All @@ -22,7 +24,7 @@ Attack discovery can detect a wide range of threats by finding relationships amo
[role="screenshot"]
image::images/attck-disc-11-alerts-disc.png[An Attack discovery card showing an attack with 11 related alerts]

In the example above, Attack discovery found connections between nine alerts, and used them to identify and describe an attack chain.
In the example above, Attack discovery found connections between thirteen alerts, and used them to identify and describe an attack chain.

After Attack discovery outlines your threat landscape, use Elastic AI Assistant to quickly analyze a threat in detail.

Expand All @@ -33,7 +35,7 @@ After Attack discovery outlines your threat landscape, use Elastic AI Assistant
From a discovery on the Attack discovery page, click **View in AI Assistant** to start a chat that includes the discovery as context.

[role="screenshot"]
image::images/attck-disc-remediate-sodinokibi.gif[A dialogue with AI Assistant that has the attack discovery as context]
image::images/attck-disc-remediate-threat.gif[A dialogue with AI Assistant that has the attack discovery as context,90%]

AI Assistant can quickly compile essential data and provide suggestions to help you generate an incident report and plan an effective response. You can ask it to provide relevant data or answer questions, such as “How can I remediate this threat?” or “What {esql} query would isolate actions taken by this user?”

Expand All @@ -48,7 +50,7 @@ At any point in a conversation with AI Assistant, you can add data, narrative su
[[use-case-incident-reporting-create-a-case-using-ai-assistant]]
== Generate reports

From the AI Assistant dialog window, click **Add to case** (image:images/icons/addDataApp.svg[Add data]) next to a message to add the information in that message to a <<security-cases-overview,case>>. Cases help centralize relevant details in one place for easy sharing with stakeholders.
From the AI Assistant dialog window, click **Add to case** (image:images/icons/addDataApp.svg[Add data,19,16]) next to a message to add the information in that message to a <<security-cases-overview,case>>. Cases help centralize relevant details in one place for easy sharing with stakeholders.

If you add a message that contains a discovery to a case, AI Assistant automatically adds the attack summary and all associated alerts to the case. You can also add AI Assistant messages that contain remediation steps and relevant data to the case.

Expand All @@ -57,7 +59,7 @@ If you add a message that contains a discovery to a case, AI Assistant automatic
== Translate incident information to a different human language using AI Assistant

[role="screenshot"]
image::images/attck-disc-translate-japanese.png[An AI Assistant dialogue in which the assistant translates from English to Japanese]
image::images/attck-disc-translate-japanese.png[An AI Assistant dialogue in which the assistant translates from English to Japanese,90%]

AI Assistant can translate its findings into other human languages, helping to enable collaboration among global security teams, and making it easier to operate within multilingual organizations.

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.