diff --git a/public/screenshot/product/falcon/10.png b/public/screenshot/product/falcon/10.png new file mode 100644 index 00000000..0f9ccc26 Binary files /dev/null and b/public/screenshot/product/falcon/10.png differ diff --git a/public/screenshot/product/falcon/11.png b/public/screenshot/product/falcon/11.png new file mode 100644 index 00000000..1ea5d440 Binary files /dev/null and b/public/screenshot/product/falcon/11.png differ diff --git a/public/screenshot/product/falcon/12.png b/public/screenshot/product/falcon/12.png new file mode 100644 index 00000000..d4ae99c7 Binary files /dev/null and b/public/screenshot/product/falcon/12.png differ diff --git a/public/screenshot/product/falcon/13.png b/public/screenshot/product/falcon/13.png new file mode 100644 index 00000000..82e05b1b Binary files /dev/null and b/public/screenshot/product/falcon/13.png differ diff --git a/src/lib/navigation.ts b/src/lib/navigation.ts index ec0da150..2bf1638b 100644 --- a/src/lib/navigation.ts +++ b/src/lib/navigation.ts @@ -321,6 +321,7 @@ export const tabNavigation: NavTab[] = [ title: 'Features', items: [ { title: 'Using Falcon AI', href: '/docs/falcon-ai/features/chat' }, + { title: 'Imagine', href: '/docs/falcon-ai/features/imagine' }, { title: 'Skill Builder', href: '/docs/falcon-ai/features/skills' }, { title: 'MCP Connectors', href: '/docs/falcon-ai/features/mcp-connectors' }, ] diff --git a/src/pages/docs/falcon-ai/features/imagine.mdx b/src/pages/docs/falcon-ai/features/imagine.mdx new file mode 100644 index 00000000..8243b12c --- /dev/null +++ b/src/pages/docs/falcon-ai/features/imagine.mdx @@ -0,0 +1,131 @@ +--- +title: "Imagine" +description: "AI-powered trace visualization builder. Chat with Falcon AI to turn any trace into an interactive dashboard, then save the view to replay on every future trace." +--- + +## About + +Imagine is a custom dashboard builder for traces. You describe what you want to see in plain English, Falcon AI assembles the widgets against the current trace, and the resulting dashboard can be saved as a template that applies to any future trace. + +A dashboard is a layout of widgets: charts, tables, metric cards, span trees, markdown summaries. Building one by hand means writing custom code or running queries one at a time. Imagine replaces that with chat, then makes the result reusable so the same trace investigation can run on every trace your team opens later. + +--- + +## Opening Imagine + +Open any trace from the Tracing dashboard, then click the **Imagine** tab in the trace detail drawer. The toolbar shows **Save View** for persisting dashboards and a **Falcon** toggle that hides or shows the chat panel. + +![Open the Imagine tab](/screenshot/product/falcon/10.png) + +On a fresh trace, suggested prompt chips appear on the empty canvas: *"Show me where the latency is"*, *"Visualize token usage by span"*, *"Show the agent execution flow"*, *"What's the cost breakdown?"*, *"Compare the LLM calls"*, *"Summarize this trace"*. Click a chip to send it to the chat panel, or type your own request. + +--- + +## Building widgets with chat + +Type a request in the Falcon chat panel and Imagine renders widgets in response. Each widget is placed on a 12-column CSS grid, so multiple widgets can sit side by side or stack across rows. + +> "Show p95 latency per span as a bar chart, then render the agent execution flow." + +> "Group LLM calls by model, put total token usage on top, and the cost breakdown on the right." + +Falcon AI runs in **imagine** mode for these conversations, with tracing and visualization tools loaded automatically. Tool calls and responses stream into the chat panel; widgets appear on the canvas as they are emitted. + +--- + +## Widget types + +Imagine ships with 17 widget types. Falcon AI picks them based on your request, and you can also ask for a specific type by name. + +| Category | Widgets | +|----------|---------| +| **Charts** | Line, bar, area, pie, donut, radar | +| **Tables** | Data table, key-value list | +| **Metrics** | Metric card, heatmap | +| **Trace structure** | Span tree, timeline, agent graph | +| **Data inspection** | JSON tree, code block | +| **Annotations** | Markdown, screenshot | + +Each widget either binds directly to live trace data or captures the output of a Falcon analysis. Live-data widgets re-render against any trace without a new LLM call. Analysis-backed widgets re-run on demand (see [Dynamic analysis](#dynamic-analysis)). + +--- + +## Saving views + +A canvas built for one trace becomes more valuable when it can replay on any trace. Save it as a view to make it reusable. + + + + Use the chat panel to assemble the widgets you want. + + ![Build a dashboard](/screenshot/product/falcon/11.png) + + + + Click **Save View** in the Imagine toolbar. A small popover appears with a suggested name pre-filled from your conversation. Edit the name if needed and confirm. + + ![Save view popover](/screenshot/product/falcon/12.png) + + + + The saved view appears as a tab next to the default Imagine tab. Open any trace, click the saved view's tab, and the same widgets render against that trace's data. + + + +Saved views are scoped to the project. Anyone in the project with access to the trace can open the view. + + + The **Save View** button is disabled until at least one widget is on the canvas. + + +--- + +## Dynamic analysis + +Charts, tables, and metric widgets bind to trace data through field paths, so they update on a new trace without any LLM call. Narrative widgets like markdown summaries cannot do this; they need fresh analysis each time. Imagine handles them with **dynamic analysis**. + +When you open a saved view on a new trace: + +- Widgets with live bindings render immediately. +- Widgets marked for dynamic analysis show a skeleton loader and the message *"Falcon is analyzing this trace..."* while the analysis runs. +- Each completed widget is cached against the trace ID, so reopening the view on the same trace skips the LLM call. + +![Dynamic analysis skeleton loader on markdown widgets](/screenshot/product/falcon/13.png) + +A **Rerun** button appears in each dynamic widget's title bar once analysis completes. Click it to discard the cached result and run the analysis again. + +--- + +## Reliability + +Dynamic analysis runs through a Temporal workflow with built-in retries, so transient failures from the model provider do not surface in the UI. + +| Step | Timeout | Retry policy | +|------|---------|--------------| +| Fetch trace data | 30 s | Up to 2 attempts | +| LLM analysis | 90 s | Up to 5 attempts with exponential backoff (5 s to 30 s) | +| Save result | 10 s | Default | + +If the LLM step exhausts its retries, the widget records a failure state in the database. Click **Rerun** to try again once the model provider recovers. + +--- + +## Rate limits + +The chat panel shares Falcon AI's rate limit of 10 messages per 60 seconds per user. Dynamic analysis re-runs do not count against this limit; they go through a dedicated single-shot endpoint with a 45-second timeout. + +--- + +## Next Steps + + + + Open the chat, ask questions, upload files, and follow responses. + + + Use built-in workflows or create custom slash commands. + + + Connect external tools like Linear, Slack, and GitHub. + +