[Observability AI Assistant] Add shared conversations (#4000)

Author: mdbirnstiehl

solutions/images/obs-ai-assistant-shared-conversations.png

@@ -40,7 +40,7 @@ To set up or use AI assistant, you need the following:
 
 * An [LLM connector](/solutions/security/ai/set-up-connectors-for-large-language-models-llm.md)
 
-* (Optional) To use [knowledge base](#obs-ai-add-data): 
+* (Optional) To use [knowledge base](#obs-ai-add-data):
   - A 4 GB {{ml}} node
     :::{note}
     In {{ecloud}} or {{ece}}, if you have {{ml}} autoscaling enabled, {{ml}} nodes automatically start when using the knowledge base and AI Assistant. Therefore using these features incurs additional costs.
@@ -360,6 +360,38 @@ Additional functions are available when your cluster has APM data:
 `get_apm_services_list`
 :   Get the list of monitored services, their health statuses, and alerts.
 
+#### Share conversations
+
+Conversations that you start with AI Assistant are private by default and not visible to other users in the space. Sharing conversations lets everyone in the space see what you've already asked or learned, making it easier to collaborate.
+
+To change the visibility of a conversation:
+
+1. Select the **Private** / **Shared** badge next to the conversation's title
+1. Use the dropdown menu to define the conversation's visibility.
+
+:::{image} /solutions/images/obs-ai-assistant-shared-conversations.png
+:alt: AI Assistant chat with the sharing status dropdown open
+:screenshot:
+:::
+
+After sharing a conversation, you can copy its URL and send the link to your team:
+
+1. Open an AI Assistant chat.
+1. Open the **Conversation actions** ({icon}`boxes_vertical`) menu.
+1. Select **Copy URL**.
+
+When someone shares a chat with you, you can view it, but you can't edit or continue the conversation. To continue the conversation where your colleague left off, duplicate the conversation.
+
+To duplicate a conversation:
+
+1. Open an AI Assistant chat.
+1. Open the **Conversation actions** ({icon}`boxes_vertical`) menu.
+1. Select **Duplicate**.
+
+#### Archive conversations
+
+The owner of a conversation can archive it by selecting **Archive** from the **Conversation actions** ({icon}`boxes_vertical`) menu. Once archived, a conversation can't be continued or edited unless it is unarchived. Unarchive a conversation by selecting **Unarchive** from the **Conversation actions** ({icon}`boxes_vertical`) menu.
+
 ### Use contextual prompts [obs-ai-prompts]
 
 AI Assistant contextual prompts throughout {{observability}} provide the following information:
@@ -413,10 +445,6 @@ When the alert fires, contextual details about the event—such as when the aler
 :screenshot:
 :::
 
-::::{important}
-Conversations created by the AI Assistant are public and accessible to every user with permissions to use the assistant.
-::::
-
 It might take a minute or two for the AI Assistant to process the message and create the conversation.
 
 Note that overly broad prompts may result in the request exceeding token limits. For more information, refer to [Token limits](#obs-ai-token-limits). Also, attempting to analyze several alerts in a single connector execution may cause you to exceed the function call limit. If this happens, modify the message specified in the connector configuration to avoid exceeding limits.