Update AI Assistant statement (#3922) (#3925)

* Update/add statements * Add new toolbar button (cherry picked from commit 31f4469) Co-authored-by: Joe Peeples <[email protected]>
elastic · Sep 12, 2023 · 13336ed · 13336ed
1 parent d1cb49a
commit 13336ed
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 3 deletions.
diff --git a/docs/assistant/images/ai-assistant-button.png b/docs/assistant/images/ai-assistant-button.png
diff --git 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.