Add documentation for dashboards assistant plugin (#6370)

* Add documentation for dashboards assistant plugin

---------

Signed-off-by: Yulong Ruan <ruanyl@amazon.com>
Signed-off-by: Yulong Ruan <ruanyu1@gmail.com>
Signed-off-by: Melissa Vagi <vagimeli@amazon.com>
Co-authored-by: Melissa Vagi <vagimeli@amazon.com>
Co-authored-by: Nathan Bower <nbower@amazon.com>

_config.yml

@@ -115,6 +115,9 @@ collections:
   automating-workflows:
     permalink: /:collection/:path/
     output: true
+  dashboards-assistant:
+    permalink: /:collection/:path/
+    output: true
 
 opensearch_collection:
   # Define the collections used in the theme
@@ -169,6 +172,9 @@ opensearch_collection:
     ml-commons-plugin:
       name: Machine learning
       nav_fold: true
+    dashboards-assistant:
+      name: Dashboards assistant
+      nav_fold: true
     automating-workflows:
       name: Automating workflows
       nav_fold: true

_dashboards/dashboards-assistant/index.md

@@ -0,0 +1,127 @@
+---
+layout: default
+title: OpenSearch Assistant for OpenSearch Dashboards
+nav_order: 3
+has_children: false
+has_toc: false
+---
+
+This is an experimental feature and is not recommended for use in a production environment. For updates on the feature's progress or to leave feedback, go to the [`dashboards-assistant` repository](https://github.com/opensearch-project/dashboards-assistant) on GitHub or the associated [OpenSearch forum thread](https://forum.opensearch.org/t/feedback-opensearch-assistant/16741).
+{: .warning}
+
+For more information about ways to enable experimental features, see [Experimental feature flags]({{site.url}}{{site.baseurl}}/install-and-configure/configuring-opensearch/experimental/).
+{: .note}
+
+# OpenSearch Assistant for OpenSearch Dashboards
+Introduced 2.12
+{: .label .label-purple }
+
+The OpenSearch Assistant toolkit helps you create AI-powered assistants for OpenSearch Dashboards without requiring you to have specialized query tools or skills.
+
+## Enabling OpenSearch Assistant
+
+To enable **OpenSearch Assistant** in OpenSearch Dashboards, locate your copy of the `opensearch_dashboards.yml` file and set the following option:
+
+```
+assistant.chat.enabled: true
+```
+{% include copy-curl.html %}
+
+Then configure the root `agent_id` through the following API:
+
+```
+PUT .plugins-ml-config/_doc/os_chat
+{
+    "type":"os_chat_root_agent",
+    "configuration":{
+        "agent_id": "your root agent id"
+    }
+}
+```
+{% include copy-curl.html %}
+
+This example shows a system index. In security-enabled domains, only super admins have permission to execute this code. For information about making super admin calls, see the [System indexes]({{site.url}}{{site.baseurl}}/security/configuration/system-indices/) guide. For access permission, contact your IT administrator.
+{: .warning}
+
+Next, restart the OpenSearch Dashboards server. Following a successful restart, **OpenSearch Assistant** appears in the OpenSearch Dashboards interface. 
+
+A screenshot of the interface is shown in the following image.
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-full-frame.png" alt="OpenSearch Assistant interface">
+
+## Configuring OpenSearch Assistant
+
+You can use the OpenSearch Dashboards interface to configure OpenSearch Assistant. Go to the [Getting started guide](https://github.com/opensearch-project/dashboards-assistant/blob/main/GETTING_STARTED_GUIDE.md) for step-by-step instructions. For the chatbot template, go to the [Flow Framework plugin](https://github.com/opensearch-project/flow-framework) documentation. You can modify this template to use your own model and customize the chatbot tools. 
+
+For information about configuring OpenSearch Assistant through the REST API, see OpenSearch Assistant toolkit.
+
+## Using OpenSearch Assistant in OpenSearch Dashboards
+
+The following tutorials guide you through using OpenSearch Assistant in OpenSearch Dashboards. OpenSearch Assistant can be viewed full frame or in the right sidebar. The default is sidebar. To view full frame, select the frame icon {::nomarkdown}<img src="{{site.url}}{{site.baseurl}}/images/icons/frame-icon.png" class="inline-icon" alt="frame icon"/>{:/} in the toolbar. 
+
+### Start a conversation
+
+Start a conversation by entering a prompt in the **Ask a question** search box or by using the shortcut `ctrl + /`. Select **Go** to initiate the conversation. A response is generated.
+
+The following screenshot shows an example prompt and response.
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-QandA.png" alt="Prompt and response using OpenSearch Assistant in OpenSearch Dashboards">
+
+### Regenerate a response
+
+Beneath the response, select the regenerate icon to generate an alternative answer to your original question. The new answer will replace the previous one, appearing in both the interface and the chat history. A regenerated example is shown in the following image.
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-regenerate.png" alt="Regenerated response">
+
+### Suggested prompts
+
+OpenSearch Assistant suggests prompts to help you get started, build upon your existing prompts, or explore other queries you may not have considered, among other reasons. Select a suggested prompt listed beneath the response field. A screenshot is shown in the following image.
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-suggestions.png" alt="Suggested prompts">
+
+### Rate a response
+
+To rate a response, select the thumbs up or thumbs down icon. A screenshot of the interface is shown in the following image. The feedback is stored in the `additional_info` field of the message index.
+
+### Response generation
+
+Learn how a response is generated by selecting the **How was this generated?** option. This option is included within the available suggestions to help you understand which tools were involved in creating the response. If multiple tools were involved, each step will display the tool name and its input and output. This feature can be useful for troubleshooting. A screenshot is shown in the following image. 
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-how-generated.png" alt="Response generation details">
+
+### Resume previous conversations
+
+To view a previous conversation, select the clock icon to open the conversation history panel and display the chat history. The conversation history can also be searched by conversation name. A screenshot is shown in the following image.
+
+<img width="400" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-conversation-history.png" alt="Conversation history">
+
+#### Edit and delete previous conversations
+
+Select the pencil icon to edit a conversation name and rename it. Select the **Confirm name** button to save the new name. A screenshot is shown in the following image.
+
+<img width="300" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-edit-convo.png" alt="Editing a conversation name">
+
+Select the trash can icon to delete a conversation. Once the confirmation dialog appears, select **Delete conversation**. The conversation is now deleted from your chat history. A screenshot is shown in the following image.
+
+<img width="300" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-delete-convo.png" alt="Deleting a conversation">
+
+### Share a conversation through Notebooks
+
+You can use [Notebooks]({{site.url}}{{site.baseurl}}/observing-your-data/notebooks/) to save your conversations. To use this option, select **Save to notebook** from the dropdown menu to the right of **OpenSearch Assistant**. Enter a name for the notebook, then select **Save**. A pop-up message in the lower-right corner confirms the conversation has been saved. 
+
+All conversations (prompts and responses/questions and answers) between you and the large language model (LLM) will be saved to this notebook.
+
+To open the saved notebook or view a list of other notebooks, select **Observability** > **Notebooks** from the OpenSeach Dashboards navigation menu. 
+
+A screenshot of the Notebooks interface with a list of saved conversations is shown in the following image.
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-notebooks.png" alt="Notebooks interface with saved OpenSearch Assistant conversations">
+
+The following screenshot shows a saved conversation, along with actions you can take for the saved conversation.
+
+<img width="700" src="{{site.url}}{{site.baseurl}}/images/dashboards/opensearch-assistant-save-notebook.png" alt="Notebooks interface with saved OpenSearch Assistant conversations">
+
+## Related articles
+
+- [Getting started guide for OpenSearch Assistant in OpenSearch Dashboards](https://github.com/opensearch-project/dashboards-assistant/blob/main/GETTING_STARTED_GUIDE.md)
+- OpenSearch Assistant configuration through the REST API