​
Overview

The “Show User Output” action displays information to users in a visually organized way. It lets you present data, results, or messages in different formats to make them easy to read and understand.

​
Use Cases

  • Real-time Feedback: Display data summaries or workflow outputs to users.
  • Interactive Reports: Present results in a structured format like tables or markdown.

​
How to Configure

​
Step 1: Add the Action

  1. In the Actions tab, click “Add action”
  2. Select “Show User Output” from the options

​
Step 2: Configuration Fields

​
Heading

  • Description: Provide a heading for the output display.
  • Example: “User Results” or “Analysis Summary.”
  • Required: No

​
Output Formatted

  • Description: Enter the formatted output in HTML, JSON, or Markdown.
  • Example:
  1. Can be text: “Here are your results”
  2. Or a variable: {{analysis_results}}
  3. Or a mix of both: “Analysis complete: {{analysis_results}}”
  • Required: Yes

​
Format

  • Description: Choose the format for output display.
  • Options: Auto, HTML, JSON, Table, Markdown, Audio, Text, JSX
  • Example: “HTML” for web-based formatting.
  • Required: Yes

​
Output Formats Explained

​
Auto

Agent.AI will try to detect the best format automatically based on your content. Use this when you’re unsure which format to choose.

​
HTML

Displays content with web formatting (like colors, spacing, and styles).
  • Example: <h1>Results</h1><p>Your information is ready.</p>
  • Good for: Creating visually structured content with different text sizes, colors, or layouts
  • Tip: When using AI tools like Claude or GPT, you can ask them to format their responses in HTML

​
Markdown

A simple way to format text with headings, lists, and emphasis.
  • Example: # Results\n\n- First item\n- Second item
  • Good for: Creating organized content with simple formatting needs
  • Tip: You can ask AI models to output their responses in Markdown format for easier display

​
JSON

Displays data in a structured format with keys and values.
  • Example: {“name”: “John”, “age”: 30, “email”: “[email protected]”}
  • Good for: Displaying data in an organized, hierarchical structure
  • To get a specific part of a JSON string, use dot notation:
    • {{user_data.name}} to display just the name
    • {{weather.forecast.temperature}} to display a nested value
    • For array items, use: {{items.0}} for the first item, {{items.1}} for the second, etc.
  • Tip: You can request AI models to respond in JSON format when you need structured data

​
Table

Shows information in rows and columns, like a spreadsheet.
  • Important: Tables requires a very specific format:
1) A JSON array of arrays: 
[
  ["Column 1", "Column 2", "Column 3"],
  ["Row 1 Data", "More Data", "Even More"],
  ["Row 2 Data", "More Data", "Even More"]
]
2) Or a CSV: 
Column 1,Column 2,Column 3
Row 1 Data,More Data,Even More
Row 2 Data,More Data,Even More
See this example agent for table output format.

​
Text

Simple plain text without any special formatting. What you type is exactly what the user sees.
  • Good for: Simple messages or information that doesn’t need special formatting

​
Audio

Displays an audio player to play sound files. See this agent as an example. 

​
JSX

For technical users who need to create complex, interactive displays.
  • Good for: Interactive components with special styling needs
  • Requires knowledge of React JSX formatting