diff --git a/docs/search/mobot-multiturn-beta.md b/docs/search/mobot-multiturn-beta.md index 3386c19fa5..f25a2ef33f 100644 --- a/docs/search/mobot-multiturn-beta.md +++ b/docs/search/mobot-multiturn-beta.md @@ -36,68 +36,43 @@ The steps below outline a common conversational interaction pattern. You can app ### Step 1: Ask your initial question -Use natural language to ask what you're looking for. You can start broad when you set a goal, or, for better results, include the name of the data source you're querying, and any related field names or values. +Use natural language to ask what you're looking for. You can start broad when you set a goal, or more specific (i.e., specifying the data source and any related fields or values). -If you don't select a source, Mobot chooses one automatically based on your question. You can override it by typing the source name directly in your prompt, or by choosing it manually from the **Auto Source Selection** dropdown. +If you don't select a source, Mobot chooses one automatically based on your question. You can override it by typing the source name directly in your prompt (as demonstrated below) or by choosing it from the **Auto Source Selection** dropdown. -After this, an intent card appears in the conversation pane summarizing your goal. Mobot then surfaces suggestion cards with related refinements, which you can click. You'll also see an option to open your query in Log Search. +For example, enter a broad question: `Show me Bedrock errors`. - +An intent card appears in the conversation pane summarizing your goal. Mobot then surfaces suggestion cards with related refinements, which you can click. You'll also see an option to open your query in Log Search. -### Step 2: Narrow the scope +Mobot conversational experience showing initial query -After clicking on a follow-up suggestion, Mobot refreshes the results and updates the intent card and query to reflect the new focus. With each subsequent refinement, Mobot adjusts the query, applies the refinements, and renders a visual chart. +### Step 2: Narrow the scope and drill into causes +After you click a follow-up suggestion or type a refinement, Mobot refreshes the results and updates the intent card and query to reflect the new focus. With each refinement, Mobot adjusts the query, applies the changes, and renders a visual chart. - +Mobot conversational experience showing refinement to trend of errors each minute -### Step 3: Drill into causes +As you go, Mobot presents new suggestions to help you pivot into related questions, such as analyzing trends of event reasons or identifying top namespaces. The intent card expands each time to include the new scope, and results show additional details. -As you go, Mobot presents new suggestion cards to help you pivot into related questions, such as analyzing trends of event reasons or identifying top namespaces. +We'll refine further by clicking the suggestion `Show the count of error logs per minute, grouped by error code`. -You can also manually type a refinement (for example, `Add error messages`). The intent card expands to include the new scope and results now show new details. +Mobot conversational experience showing the count of error logs per minute, grouped by error code - - -### Step 4: Request a trend over time - -If you type a time period (for example, `Show the trend over 24 hours`), the query applies a timeslice (for example, one-hour buckets) to group results over time. +From here, you can continue refining or try other options like [switching the chart type](/docs/search/mobot/#chart-type), [opening the query in Log Search](/docs/search/mobot/#step-4-open-in-log-search), [adjusting the time range](/docs/search/mobot/#time-range), [editing the query logic](/docs/search/mobot/#edit-query-code), or [starting over with a new chat](/docs/search/mobot/#new-conversation). :::tip Ask Mobot to change units in your query. For example, `Convert GB to bytes`. ::: - - -### Next steps - -As with legacy Mobot, you can adjust the [time range](/docs/search/mobot/#time-range), switch [chart types](/docs/search/mobot/#chart-type), [edit the query logic](/docs/search/mobot/#edit-query-code), [open in Log Search](/docs/search/mobot/#step-4-open-in-log-search), or start over with a [new chat](/docs/search/mobot/#new-conversation). - ## Best practices * **Talk to it like a conversation**. Layer refinements instead of rewriting the whole question. * **Be specific**. Combine filters, units, and percentiles in clear language. * **Ask about data tied to dashboards**. Mobot works best when you reference data sources that already have dashboards built on them. Ask questions using dashboard panel names or descriptions, even if built on unstructured logs. * **Reuse queries from your conversation history**. Everything you ask is saved to your conversation history automatically. You can revisit, reuse, continue where you left off in prior conversations to compare or branch analyses. -* **Modify existing queries**. Add/remove fields, add `where`, `sort`, `avg()` clauses, etc. +* **Modify existing queries**. Add/remove fields, add `where`, `sort`, `avg()` clauses, and more. * **Guide Mobot with feedback**. If the result isn't right, use natural language: `Don't do X, instead do Y`. * **Fix broken queries**. Paste a syntactically invalid query. Mobot will correct it. diff --git a/static/img/search/mobot/drill-causes.png b/static/img/search/mobot/drill-causes.png deleted file mode 100644 index dc3570ff46..0000000000 Binary files a/static/img/search/mobot/drill-causes.png and /dev/null differ diff --git a/static/img/search/mobot/initial-question.png b/static/img/search/mobot/initial-question.png index f79174b0b4..a83ecd8b11 100644 Binary files a/static/img/search/mobot/initial-question.png and b/static/img/search/mobot/initial-question.png differ diff --git a/static/img/search/mobot/narrow-scope-filter.png b/static/img/search/mobot/narrow-scope-filter.png index 9f130df7a8..68df3bd69a 100644 Binary files a/static/img/search/mobot/narrow-scope-filter.png and b/static/img/search/mobot/narrow-scope-filter.png differ diff --git a/static/img/search/mobot/narrow-scope.png b/static/img/search/mobot/narrow-scope.png index 7796699572..0fd3ae3803 100644 Binary files a/static/img/search/mobot/narrow-scope.png and b/static/img/search/mobot/narrow-scope.png differ diff --git a/static/img/search/mobot/trend-over-time.png b/static/img/search/mobot/trend-over-time.png deleted file mode 100644 index caffeb20d1..0000000000 Binary files a/static/img/search/mobot/trend-over-time.png and /dev/null differ