diff --git a/docs/assistant/images/ai-assistant-button.png b/docs/assistant/images/ai-assistant-button.png new file mode 100644 index 0000000000..e7349f9775 Binary files /dev/null and b/docs/assistant/images/ai-assistant-button.png differ 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.