first pass at incorporating Dhru's input

elastic · Nov 16, 2023 · 2d88a53 · 2d88a53
1 parent 95b9130
commit 2d88a53
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 1 deletion.
diff --git a/docs/assistant/images/knowledge-base-dialogue.png b/docs/assistant/images/knowledge-base-dialogue.png
diff --git a/docs/assistant/security-assistant.asciidoc b/docs/assistant/security-assistant.asciidoc
@@ -177,4 +177,17 @@ To enable the knowledge base:
 . Turn on the *Knowledge Base* option.
 . Click *Save*. The knowledge base is now active.
 +
-When the knowledge base is active, a quick prompt for {esql} queries becomes available. It provides a good starting point for your {esql} conversations and questions.
+When the knowledge base is active, a quick prompt for {esql} queries becomes available. It provides a good starting point for your {esql} conversations and questions.
+
+[discrete]
+[[ai-assistant-queries]]
+### How to get the most from your queries
+
+Remember, the Elastic AI Assistant’s ability to assist is directly influenced by the specificity and detail of your questions. The more context and detail you provide, the more tailored and useful the response will be.
+
+To maximize its usefulness, consider using more detailed or elaborate prompts. For instance, after receiving a basic {esql} query example, you could ask for more detail with a follow-up like, “Could you give me some other examples and provide comments explaining the query you just gave?” 
+
+[role="screenshot"]
+image::images/knowledge-base-dialogue.png[The AI Assistant window showing a chat where the user responds with a request for more detail]
+
+