Split Bits Chat page into subpages and document chat sharing

hugo/config/_default/menus/main.en.yaml

@@ -1549,6 +1549,11 @@ menu:
       identifier: bits_ai_bits_chat
       parent: bits_ai
       weight: 2
+    - name: Use Bits Chat
+      url: bits_ai/bits_chat/usage
+      identifier: bits_ai_bits_chat_usage
+      parent: bits_ai_bits_chat
+      weight: 201
     - name: Bits Code
       url: bits_ai/bits_code
       parent: bits_ai

hugo/content/en/bits_ai/bits_chat/_index.md

@@ -0,0 +1,93 @@
+---
+title: Bits Chat
+description: "Use Bits Chat in Datadog to explore and act on your observability data using natural language."
+further_reading:
+- link: "bits_ai/"
+  tag: "Documentation"
+  text: "Bits AI Overview"
+- link: "/incident_response/incident_management/investigate/incident_ai"
+  tag: "Documentation"
+  text: "Coordinate incidents with Incident AI"
+- link: "/cloud_cost_management/cloud_cost_skill/"
+  tag: "Documentation"
+  text: "Cloud Cost Skill in Bits Chat"
+- link: "/account_management/billing/ai_credits/"
+  tag: "Documentation"
+  text: "AI Credits"
+- link: "https://www.datadoghq.com/blog/datadog-mcp-apps/"
+  tag: "Blog"
+  text: "Datadog MCP Apps: Interactive experiences in AI workflows"
+- link: "https://www.datadoghq.com/blog/introducing-bits-chat/"
+  tag: "Blog"
+  text: "Search and act across Datadog to resolve issues faster with Bits Chat"
+- link: "https://www.datadoghq.com/blog/cloud-cost-skill-bits-chat/"
+  tag: "Blog"
+  text: "Answer any cost question faster with the Cloud Cost skill in Bits Chat"
+- link: "https://www.datadoghq.com/blog/bits-chat-slack-incident-response/"
+  tag: "Blog"
+  text: "From alert to resolution: Manage incidents with Bits Chat in Slack"
+aliases:
+- /bits_ai/getting_started/
+- /bits_ai/chat_with_bits_ai
+- /bits_ai/bits_assistant/
+- /tracing/guide/latency_investigator/
+---
+
+## Overview
+
+Bits Chat helps you search and act across Datadog using natural language. Ask it to investigate an incident, explore your telemetry, build a dashboard, or query your data with DDSQL, and it answers in a conversational chat instead of sending you to build the query yourself.
+
+Bits Chat is available in the Datadog web application, the mobile app, and Slack. See [Use Bits Chat][1] to open it from each surface.
+
+{{< img src="bits_ai/getting_started/bits_assistant_full_page.png" alt="Full-page Bits Chat interface with suggested tasks" style="width:100%;">}}
+
+Ask Bits Chat questions like:
+- `Why is the error rate spiking on the web-store service?`
+- `Summarize the key findings from the Kubernetes overview dashboard`
+- `Build me a dashboard to show latency, errors, and request rates for my service`
+- `Write a DDSQL query that shows the top 10 services by error count in the last hour`
+- `Investigate why EC2 costs changed between January and February`
+
+## Permissions
+
+### Access to Bits Chat
+
+To use Bits Chat, your role must have the **Bits Chat Access** permission. This permission is enabled by default for all three standard Datadog roles: Datadog Admin, Datadog Standard, and Datadog Read Only.
+
+To manage this permission for custom roles, you can [update the role][2] to enable **Bits Chat Access**. 
+
+### Data access through Bits Chat
+
+Bits Chat uses your Datadog role to fetch data, so it can only access the resources you have permission to view or modify. For example, if your role restricts access to a specific set of logs indexes, Bits Chat can only query logs from those indexes. Similarly, if you do not have permission to edit a dashboard, Bits Chat cannot edit that dashboard on your behalf.
+
+## Chat History
+
+Bits Chat saves your conversations. To see past chats, open {{< ui >}}History{{< /ui >}} in [Bits Chat][3], or click {{< img src="bits_ai/icons/clock_historical.svg" inline="true" style="width:16px;" alt="History icon" >}} in the Bits Chat panel.
+
+### Manage and share chats
+
+Click {{< ui >}}...{{< /ui >}} next to a chat in {{< ui >}}History{{< /ui >}}, or in an open chat's header, to {{< ui >}}Rename{{< /ui >}}, {{< ui >}}Share{{< /ui >}}, or {{< ui >}}Delete{{< /ui >}} it. Deleting a chat cannot be undone.
+
+Chats are private by default. To share one, click {{< ui >}}...{{< /ui >}} > {{< ui >}}Share{{< /ui >}} > {{< ui >}}Shared Chat{{< /ui >}}, then click {{< ui >}}Copy Link{{< /ui >}}. Anyone with the link can view the chat, including new messages, but only you can reply.
+
+<div class="alert alert-warning">Shared chats show data retrieved with your permissions. Check the chat before you share it.</div>
+
+Shared links expire automatically (see the expiration date in the {{< ui >}}Share Chat{{< /ui >}} dialog). To stop sharing, open {{< ui >}}Share Chat{{< /ui >}} and select {{< ui >}}Private Chat{{< /ui >}}.
+
+## Reports
+
+The Bits Chat Reports page provides visibility into how your organization uses Bits Chat. Go to [**Bits AI** > **Chat** > **Reports**][4] to view:
+
+- **Top users**: See which team members use Bits Chat the most, ranked by conversation count.
+- **Usage trends**: Track conversation volume over time to understand adoption and identify usage patterns.
+- **Conversation intent distribution**: See how conversations break down by intent category, such as investigating issues, exploring telemetry, learning Datadog concepts, and configuring observability.
+
+Use these insights to understand adoption patterns, identify power users for best-practice sharing, and assess which use cases deliver the most value for your organization.
+
+## Further reading
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /bits_ai/bits_chat/usage/
+[2]: /account_management/rbac/?tab=datadogapplication#update-a-role
+[3]: https://app.datadoghq.com/ask
+[4]: https://app.datadoghq.com/ask/usage

hugo/content/en/bits_ai/bits_chat/usage.md

@@ -0,0 +1,53 @@
+---
+title: Use Bits Chat
+description: "Open Bits Chat from the Datadog web application, mobile app, or Slack."
+further_reading:
+- link: "/bits_ai/bits_chat/"
+  tag: "Documentation"
+  text: "Bits Chat"
+- link: "/bits_ai/bits_code/slack_code_channels/"
+  tag: "Documentation"
+  text: "Code channels with Bits Code"
+---
+
+Bits Chat has context on Datadog public documentation, telemetry, and ownership. Use Bits Chat to ask questions about your system or active incident. Bits Chat is available in the Datadog web application, the mobile app, and Slack.
+
+## Web application
+There are multiple ways to open Bits Chat in the Datadog web application:
+- Go directly to [Bits Chat][1].
+- In the top-right of the navigation bar, click {{< ui >}}Ask Bits{{< /ui >}}.
+- In a Datadog product integrated with Bits Chat, click the AI trigger button (for example, {{< ui >}}Ask Bits{{< /ui >}}) or {{< img src="bits_ai/dev_agent/twinkling_stars_icon.png" inline="true" style="width:24px" alt="">}} (the twinkling stars icon).
+- Press <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>I</kbd>.
+- In the left-side navigation panel, click {{< ui >}}Bits AI{{< /ui >}}, then select {{< ui >}}Bits Chat{{< /ui >}}.
+
+## Mobile application
+
+Ask Bits questions about your system or active incident from the [Mobile App][2]. 
+
+1. On the home screen, tap {{< ui >}}Bits Chat{{< /ui >}}.
+1. Start chatting with Bits Chat by voice or text.
+{{< img src="bits_ai/getting_started/bits_ai_mobile_app_2026.png" alt="View of the Mobile App Home dashboard with Bits AI" style="width:40%;" >}}
+
+## Slack
+Ask Bits questions, declare incidents, trigger investigations, or make code changes. Bits Chat replies in the message thread so your team can keep the question, context, and answer in one place.
+
+1. Select your Slack workspace in [Bits Chat Settings][3].
+2. Click **Connect Slack account** to grant Datadog permission to recognize you across both products.
+3. (Optional) Click **Grant permissions** to your workspace so that Bits chat can read relevant slack conversations.
+
+After setup is complete, you can send queries to `@Datadog` in natural language to channels in your workspace with the Datadog App. 
+
+{{< img src="bits_ai/getting_started/example-slack-query.png" alt="Output of an example service-dependency query in Slack" style="width:60%;">}}
+
+### Code channels with Bits Code
+
+Ask Bits Chat to make a code change, and it creates a dedicated [code channel][4] for the task. In the code channel, [Bits Code][5] works on the change alongside you and your team.
+
+## Further reading
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://app.datadoghq.com/ask
+[2]: /mobile/#installing
+[3]: https://app.datadoghq.com/ask/settings
+[4]: /bits_ai/bits_code/slack_code_channels/
+[5]: /bits_ai/bits_code/

hugo/content/en/bits_ai/bits_code/setup.md

@@ -216,7 +216,7 @@ In some cases, especially in repositories with many branches, GitHub does not ru
 [11]: /bits_ai/bits_code/#supported-source-code-providers
 [12]: /bits_ai/bits_code/#custom-agent-skills-and-instructions
 [13]: /bits_ai/bits_code/slack_code_channels/
-[14]: /bits_ai/bits_chat/#slack
+[14]: /bits_ai/bits_chat/usage/#slack
 [15]: https://docs.slack.dev/reference/scopes/
 [16]: https://app.datadoghq.com/code/settings/slack
 

hugo/content/en/bits_ai/bits_code/slack_code_channels.md

@@ -5,7 +5,7 @@ further_reading:
 - link: "/bits_ai/bits_code/"
   tag: "Documentation"
   text: "Bits Code"
-- link: "/bits_ai/bits_chat/#slack"
+- link: "/bits_ai/bits_chat/usage/#slack"
   tag: "Documentation"
   text: "Bits Chat in Slack"
 - link: "/integrations/slack/"
@@ -79,7 +79,7 @@ The overall [Bits Code limitations][5] also apply to code channels.
 
 {{< partial name="whats-next/whats-next.html" >}}
 
-[1]: /bits_ai/bits_chat/#slack
+[1]: /bits_ai/bits_chat/usage/#slack
 [2]: /bits_ai/bits_code/#sessions
 [3]: https://app.datadoghq.com/code
 [4]: /bits_ai/bits_code/setup/

hugo/content/en/experiments/diagnostics.md

@@ -212,6 +212,6 @@ The SQL you define depends on how the experiment is randomized. For experiments
 [4]: /experiments/concepts/subject_types/#product-analytics-and-rum-metrics
 [5]: /experiments/concepts/subject_types/#warehouse-metrics
 [6]: /source_code/
-[7]: /bits_ai/bits_chat/#web-application
+[7]: /bits_ai/bits_chat/usage/#web-application
 [8]: /experiments/plan_and_launch_experiments/#run-a-sample-size-calculation-optional
 [9]: /help/

hugo/content/en/tracing/services/service_page.md

@@ -112,7 +112,7 @@ Datadog provides out-of-the-box graphs for any given service. Use the dropdown a
 
 {{% apm-ootb-graphs %}}
 
-<div class="alert alert-tip">When you hover over a latency spike in the latency graph, click <strong>Investigate With Bits AI</strong> to launch an automated investigation. Bits AI analyzes tag divergence and bottlenecks across the affected traces. For more information, see <a href="/bits_ai/bits_chat/#latency-investigations">Latency investigations</a>.</div>
+<div class="alert alert-tip">When you hover over a latency spike in the latency graph, click <strong>Investigate With Bits AI</strong> to launch an automated investigation. Bits AI analyzes tag divergence and bottlenecks across the affected traces. For more information, see <a href="/bits_ai/bits_chat/">Bits Chat</a>.</div>
 
 ### Export