Natural Language Example Gallery

User Problem

Users creating charts in Plotly Studio often struggle to understand the full range of possibilities they can achieve through natural language prompts. Since the system translates these prompts into commands for the underlying Plotly graphing library, there's a disconnect. Users don't inherently know which chart types are supported or what specific options (like custom colors, labels, or aggregations) they can ask for using everyday language, leading to frustration and underutilization of the tool's capabilities.

What is it?

A natural language Example Gallery integrated into the Plotly Studio documentation. It serves as a dedicated resource where users can browse various chart types and see clear, working examples of the natural language phrases and commands that successfully generate them. The gallery presents the Studio's capabilities by focusing entirely on the user's natural language input, completely omitting the technical code or API syntax that the system uses internally.

What does it allow users to do?

The Natural Language Example Gallery allows users to:

• Discover Supported Chart Types: Users can quickly see the entire catalog of available visualizations, such as bar charts, scatter plots, heatmaps, and line graphs, that Plotly Studio can generate.

• Learn Effective Prompting: For each chart type, the gallery provides multiple examples of natural language prompts. This helps users understand the specific vocabulary, phrasing, and structure they can use to achieve complex results.

• Explore Customization Options: Users can see examples of how to request specific options without knowing the code. This includes requesting:

  • Data Aggregation: ("Show the total sales grouped by region")

  • Styling: ("Make the bars blue and label the axes 'X' and 'Y'")

  • Filtering: ("Only include data points where profit is above 500")

• Bridge the Natural Language Gap: By providing concrete, natural language examples, the gallery acts as a direct reference guide, helping users effectively translate their visualization needs into successful prompts for the Plotly Studio interface.