From 31f446985aa797c4dc55f314096f74e1b1107120 Mon Sep 17 00:00:00 2001
From: Joe Peeples <joe.peeples@elastic.co>
Date: Tue, 12 Sep 2023 18:42:41 -0400
Subject: [PATCH] Update AI Assistant statement (#3922)

* Update/add statements

* Add new toolbar button
---
 docs/assistant/images/ai-assistant-button.png | Bin 0 -> 4151 bytes
 docs/assistant/security-assistant.asciidoc    |  15 ++++++++++++---
 2 files changed, 12 insertions(+), 3 deletions(-)
 create mode 100644 docs/assistant/images/ai-assistant-button.png

diff --git a/docs/assistant/images/ai-assistant-button.png b/docs/assistant/images/ai-assistant-button.png
new file mode 100644
index 0000000000000000000000000000000000000000..e7349f977536fc4141ff84c558ab42ac8bb646d0
GIT binary patch
literal 4151
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
K`g^oP#Qy<L41#w6

literal 0
HcmV?d00001

diff --git a/docs/assistant/security-assistant.asciidoc b/docs/assistant/security-assistant.asciidoc
index 961db21b07..80dbf8c88b 100644
--- a/docs/assistant/security-assistant.asciidoc
+++ b/docs/assistant/security-assistant.asciidoc
@@ -14,9 +14,13 @@ A connector for OpenAI or Azure OpenAI Service powers AI Assistant.
 [role="screenshot"]
 image::images/assistant.gif[Animation of AI Assistant chat window,90%]
 
-[IMPORTANT]
+IMPORTANT: The Elastic AI Assistant is designed to enhance your analysis with smart dialogues. Its capabilities are still developing. Users should exercise caution as the quality of its responses might vary. Your insights and feedback will help us improve this feature. Always cross-verify AI-generated advice for accuracy.
+
+[TIP]
 ====
-This is an initial release of the Elastic AI Assistant, designed to enhance your analysis with smart dialogues. Its capabilities are still developing. Users should exercise caution as the quality of its responses might vary. Your insights and feedback will help us improve this feature. Always cross-verify AI-generated advice for accuracy.
+When choosing a third-party provider to use with AI Assistant, remember that different services may impose rate limits on their APIs. This may negatively affect AI Assistant performance. In addition, different models support various context lengths. Models with larger context lengths will provide a better experience when using the AI Assistant.
+
+For example, refer to OpenAI's documentation on https://platform.openai.com/docs/guides/rate-limits/[rate limits] and https://help.openai.com/en/articles/7127966-what-is-the-difference-between-the-gpt-4-models[GPT-4 models] for more information on their available options.
 ====
 
 .Requirements
@@ -62,7 +66,12 @@ You can do this in {kib} from *{stack-manage-app}* -> *{connectors-ui}*, or from
 [[start-chatting]]
 == Start chatting
 
-To open AI Assistant, press *Cmd + ;* (or *Ctrl + ;* on Windows) from anywhere in the {security-app}. This opens the *Welcome* chat interface, where you can ask general questions about {elastic-sec}.
+To open AI Assistant, select the **AI Assistant** button in the top toolbar from anywhere in the {security-app}. You can also use the keyboard shortcut *Cmd + ;* (or *Ctrl + ;* on Windows). 
+
+[role="screenshot"]
+image::images/ai-assistant-button.png[AI Assistant button,150]
+
+This opens the *Welcome* chat interface, where you can ask general questions about {elastic-sec}.
 
 You can also chat with AI Assistant from several particular pages in {elastic-sec} where you can easily send context-specific data and prompts to AI Assistant.