Skip to content

Commit

Permalink
[8.11] Adds new page about triaging alerts with AI Assistant (backport
Browse files Browse the repository at this point in the history
…#4359) (#4565)

* Adds new page about triaging alerts with AI Assistant (#4359)

* Adds new page about triaging alerts with AI Assistant

* troubleshoots ToC

* troubleshoots build error

* updates section title

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

* Incorporates rest of Nastasha's feedback

* save work

* updates triage page with RAG for alerts info

* fixes anchor tag

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com>

* Update docs/assistant/ai-alert-triage.asciidoc

* Update docs/assistant/ai-alert-triage.asciidoc

---------

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>
Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com>
(cherry picked from commit b930aa6)

* removes part from 8.11 that doesn't apply until 8.12

* fix merge conflict

---------

Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
Co-authored-by: Benjamin Ironside Goldstein <benjamin.ironside@elastic.co>
  • Loading branch information
3 people authored Jan 9, 2024
1 parent 49831d3 commit 8b1d65a
Show file tree
Hide file tree
Showing 3 changed files with 39 additions and 1 deletion.
36 changes: 36 additions & 0 deletions docs/assistant/ai-alert-triage.asciidoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
[[assistant-triage]]
= Triage alerts with Elastic AI Assistant
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.

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-triage-alerts-instructions]]
[discrete]
== Use AI Assistant to triage an 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-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]
[[ai-triage-reportgen]]
== Generate triage reports
Elastic AI Assistant can streamline the documentation and report generation process by providing clear records of security incidents, their scope and impact, and your remediation efforts. You can use AI Assistant to create summaries or reports for stakeholders that include key event details, findings, and diagrams. Once the AI Assistant has finished analyzing one or more alerts, you can generate reports by using prompts such as:

* “Generate a detailed report about this incident including timeline, impact analysis, and response actions. Also, include a diagram of events.”
* “Generate a summary of this incident/alert and include diagrams of events.”
* “Provide more details on the mitigation strategies used.”

After you review the report, click **Add to existing case** at the top of AI Assistant's response. This allows you to save a record of the report and make it available to your team.

[role="screenshot"]
image::images/ai-triage-add-to-case.png[An AI Assistant dialogue with the add to existing case button highlighted]
Binary file added docs/assistant/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.
4 changes: 3 additions & 1 deletion docs/assistant/security-assistant.asciidoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
[[security-assistant]]
[chapter]
= AI Assistant

:frontmatter-description: The Elastic AI Assistant is a generative AI open-code chat assistant.
Expand Down Expand Up @@ -191,3 +190,6 @@ In addition to practical advice, AI Assistant can offer conceptual advice, tips,

* “How do I set up a {ml} job in {elastic-sec} to detect anomalies in network traffic volume over time?”
* “I need to monitor for unusual file creation patterns that could indicate ransomware activity. How would I construct this query using EQL?”


include::ai-alert-triage.asciidoc[leveloffset=+1]

0 comments on commit 8b1d65a

Please sign in to comment.