Skip to content

Commit

Permalink
fixes broken id-based links
Browse files Browse the repository at this point in the history
  • Loading branch information
benironside committed Jun 24, 2024
1 parent 0cd8ab8 commit de44729
Show file tree
Hide file tree
Showing 5 changed files with 18 additions and 21 deletions.
3 changes: 1 addition & 2 deletions docs/serverless/assistant/ai-assistant-esql-queries.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
id: serverlessSecurityESQLQueries
slug: /serverless/security/ai-assistant-esql-queries
title: Generate, customize, and learn about ((esql)) queries
description: AI Assistant has specialized ((esql)) capabilities
Expand All @@ -9,7 +8,7 @@ status: in review

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

With AI Assistant's <DocLink id="ai-assistant-knowledge-base" text="((esql)) knowledge base"/> enabled, AI Assistant benefits from specialized training data that enables it to answer questions related to ((esql)) at an expert level.
With AI Assistant's <DocLink slug="/serverless/security/ai-assistant" section="ai-assistant-knowledge-base" text="((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:

Expand Down
4 changes: 2 additions & 2 deletions docs/serverless/assistant/ai-assistant.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,10 +41,10 @@ Elastic can automatically anonymize event data that you provide to AI Assistant

## Set up AI Assistant

You must create a generative AI connector before you can use AI Assistant. AI Assistant can connect to multiple large language model (LLM) providers so you can select the best model for your needs. To set up a connector, refer to <DocLink id="serverlessSecurityLLMConnectorGuides" text="LLM connector setup guides"/>.
You must create a generative AI connector before you can use AI Assistant. AI Assistant can connect to multiple large language model (LLM) providers so you can select the best model for your needs. To set up a connector, refer to <DocLink slug="/serverless/security/llm-connector-guides" text="LLM connector setup guides"/>.

<DocCallOut title="Recommended models">
While AI Assistant is compatible with many different models, our testing found increased quality with Azure 32k, and faster, more cost-effective responses with Claude 3 Haiku and OpenAI GPT4 Turbo. For more information, refer to the <DocLink id="llm-performance-matrix" text="LLM performance matrix"/>.
While AI Assistant is compatible with many different models, our testing found increased quality with Azure 32k, and faster, more cost-effective responses with Claude 3 Haiku and OpenAI GPT4 Turbo. For more information, refer to the <DocLink slug="/serverless/security/llm-performance-matrix" text="LLM performance matrix"/>.
</DocCallOut>

<div id="start-chatting"></div>
Expand Down
6 changes: 3 additions & 3 deletions docs/serverless/assistant/ai-use-cases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,6 @@ status: in review

The guides in this section describe use-cases for AI Assistant and Attack discovery. Refer to them for examples of each tool's individual capabilities, and of what they can do together.

<DocLink id="serverlessSecurityAIUsecaseIncidentReporting"/>
<DocLink id="ai-assistant-triage"/>
<DocLink id="serverlessSecurityESQLQueries"/>
<DocLink slug="/serverless/security/ai-usecase-incident-reporting"/>
<DocLink slug="/serverless/security/triage-alerts-with-elastic-ai-assistant"/>
<DocLink slug="/serverless/security/ai-assistant-esql-queries"/>
9 changes: 4 additions & 5 deletions docs/serverless/assistant/llm-connector-guides.mdx
Original file line number Diff line number Diff line change
@@ -1,16 +1,15 @@
---
id: serverlessSecurityLLMConnectorGuides
slug: /serverless/security/llm-connector-guides
title: LLM connector guides
description: Set up LLM connectors to enable AI features in ((elastic-sec))
tags: ["security","overview","get-started"]
status: in review
---

This section contains instructions for setting up connectors for LLMs so you can use <DocLink id="serverlessSecurityAIAssistant" text="Elastic AI Assistant"/> and <DocLink id="attackDiscovery" text="Attack discovery"/>.
This section contains instructions for setting up connectors for LLMs so you can use <DocLink slug="/serverless/security/ai-assistant" text="Elastic AI Assistant"/> and <DocLink slug="/serverless/security/attack-discovery" text="Attack discovery"/>.

Setup guides are available for the following LLM providers:

* <DocLink id="serverlessSecurityConnectAzureOpenAI" text="Azure OpenAI"/>
* <DocLink id="serverlessSecurityConnectBedrock" text="Amazon Bedrock"/>
* <DocLink id="serverlessSecurityConnectOpenAI" text="OpenAI"/>
* <DocLink slug="/serverless/security/connect-to-azure-openai" text="Azure OpenAI"/>
* <DocLink slug="/serverless/security/connect-to-bedrock" text="Amazon Bedrock"/>
* <DocLink slug="/serverless/security/connect-to-openai" text="OpenAI"/>
Original file line number Diff line number Diff line change
@@ -1,25 +1,24 @@
---
id: serverlessSecurityAIUsecaseIncidentReporting
slug: /serverless/security/ai-usecase-incident-reporting
title: Identify, investigate, and document threats
description: Use Attack discovery and AI Assistant to manage threats
tags: ["security","overview","get-started"]
status: in review
---

Together, <DocLink id="serverlessSecurityAIAssistant" text="Elastic AI Assistant"/> and <DocLink id="attackDiscovery" text="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.
Together, <DocLink slug="/serverless/security/ai-assistant" text="Elastic AI Assistant"/> and <DocLink slug="/serverless/security/attack-discovery" text="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.

In this guide, you'll learn how to:

* <DocLink id="use-case-incident-reporting-use-attack-discovery-to-identify-threats" text="Use Attack discovery to identify threats"/>
* <DocLink id="use-case-incident-reporting-use-ai-assistant-to-analyze-a-threat" text="Use AI Assistant to analyze a threat"/>
* <DocLink id="use-case-incident-reporting-create-a-case-using-ai-assistant" text="Create a case using AI Assistant"/>
* <DocLink id="use-case-incident-reporting-translate" text="Translate incident information to a different human language using AI Assistant"/>
* <DocLink slug="/serverless/security/ai-usecase-incident-reporting" section="use-case-incident-reporting-use-attack-discovery-to-identify-threats" text="Use Attack discovery to identify threats"/>
* <DocLink slug="/serverless/security/ai-usecase-incident-reporting" section="use-case-incident-reporting-use-ai-assistant-to-analyze-a-threat" text="Use AI Assistant to analyze a threat"/>
* <DocLink slug="/serverless/security/ai-usecase-incident-reporting" section="use-case-incident-reporting-create-a-case-using-ai-assistant" text="Create a case using AI Assistant"/>
* <DocLink slug="/serverless/security/ai-usecase-incident-reporting" section="use-case-incident-reporting-translate" text="Translate incident information to a different human language using AI Assistant"/>


<div id="use-case-incident-reporting-use-attack-discovery-to-identify-threats"/>
## Use Attack discovery to identify threats
Attack discovery can detect a wide range of threats by finding relationships among alerts that may indicate a coordinated attack. This enables you to comprehend how threats move through and affect your systems. Attack discovery generates a detailed summary of each potential threat, which can serve as the basis for further analysis. Learn how to <DocLink id="attackDiscovery" text="get started with Attack discovery"/>.
Attack discovery can detect a wide range of threats by finding relationships among alerts that may indicate a coordinated attack. This enables you to comprehend how threats move through and affect your systems. Attack discovery generates a detailed summary of each potential threat, which can serve as the basis for further analysis. Learn how to <DocLink slug="/serverless/security/attack-discovery" text="get started with Attack discovery"/>.

<DocImage size="m" url="images/attck-disc-11-alerts-disc.png" alt="An Attack discovery card showing an attack with 11 related alerts"/>

Expand All @@ -36,14 +35,14 @@ AI Assistant can quickly compile essential data and provide suggestions to help

<DocImage size="m" url="images/attck-disc-esql-query-gen-example.png" alt="An AI Assistant dialogue in which the user asks for a purpose-built ((esql)) query" />

The image above shows an ((esql)) query generated by AI Assistant in response to a user prompt. Learn more about <DocLink id="serverlessSecurityESQLQueries" text="using AI Assistant for ((esql))"/>.
The image above shows an ((esql)) query generated by AI Assistant in response to a user prompt. Learn more about <DocLink slug="/serverless/security/ai-assistant-esql-queries" text="using AI Assistant for ((esql))"/>.

At any point in a conversation with AI Assistant, you can add data, narrative summaries, and other information from its responses to ((elastic-sec))'s case management system to generate incident reports.

<div id="use-case-incident-reporting-create-a-case-using-ai-assistant"/>
## Create a case using AI Assistant

From the AI Assistant dialog window, click **Add to case** (<DocIcon type="addDataApp" title="Add data" />) next to a message to add the information in that message to a <DocLink id="cases-overview" text="case"/>. Cases help centralize relevant details in one place for easy sharing with stakeholders.
From the AI Assistant dialog window, click **Add to case** (<DocIcon type="addDataApp" title="Add data" />) next to a message to add the information in that message to a <DocLink slug="/serverless/security/cases-overview" text="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 Down

0 comments on commit de44729

Please sign in to comment.