feat: enhance AI Agent tool usage display with configurable verbosity levels and length limits

Author: owndev

README.md

@@ -117,10 +117,10 @@ The functions include a built-in encryption mechanism for sensitive information:
 > [!TIP]
 > **N8N Workflow Automation Integration**
 >
-> Connect Open WebUI with N8N to leverage powerful workflow automation. Includes AI Agent tool usage display for complete transparency into your agent's actions.
+> Connect Open WebUI with N8N to leverage powerful workflow automation. Includes configurable AI Agent tool usage display for complete transparency into your agent's actions.
 
 - Integrates **Open WebUI** with **N8N**, an automation and workflow platform.
-- **AI Agent Tool Usage Display (v2.2.0)** 🛠️: Shows tool calls from N8N AI Agent workflows with collapsible details (non-streaming mode only).
+- **AI Agent Tool Usage Display (v2.2.0)** 🛠️: Shows tool calls from N8N AI Agent workflows with three verbosity levels (minimal, compact, detailed) and customizable length limits (non-streaming mode only).
 - Streaming and non-streaming support for real-time and batch data processing.
 - Sends messages from Open WebUI to an **N8N webhook**.
 - Supports real-time message processing with dynamic field handling.

docs/n8n-integration.md

@@ -22,9 +22,15 @@ This integration allows Open WebUI to communicate with workflows created in **n8
 ## Features
 
 > [!TIP]
-> **AI Agent Tool Usage Display (NEW in v2.2.0)** 🛠️
+> **AI Agent Tool Usage Display (v2.2.0)** 🛠️
 >
-> Automatically extracts and displays tool calls from N8N AI Agent workflows in **non-streaming mode**. Shows tool names, inputs, and results in collapsible `<details>` sections. Parses the `intermediateSteps` array to provide transparency into the AI agent's workflow execution.
+> Automatically extracts and displays tool calls from N8N AI Agent workflows in **non-streaming mode**.
+>
+> - 📊 **Three verbosity levels**: `minimal` (names only), `compact` (names + preview), `detailed` (full info)
+> - 📏 **Customizable length limits**: Control input/output text length
+> - 🎯 **Flexible configuration**: Adapt display to your needs
+>
+> Shows tool names, inputs, and results from the `intermediateSteps` array to provide transparency into the AI agent's workflow execution.
 >
 > 📖 [Learn more about Tool Usage Display](./n8n-tool-usage-display.md)
 

docs/n8n-tool-usage-display.md

@@ -4,6 +4,8 @@
 
 Starting with version 2.2.0, the N8N pipeline automatically displays AI Agent tool calls in a user-friendly format. When your N8N workflow includes an AI Agent node that uses tools (like Wikipedia, Date/Time, Calculator, etc.), the pipeline will extract and display detailed information about each tool invocation.
 
+Version 2.2.0 includes **configurable verbosity levels** and **length limits** for tool display, allowing you to control how detailed the tool information is shown.
+
 ## Important Limitation
 
 > [!IMPORTANT]
@@ -17,30 +19,92 @@ Starting with version 2.2.0, the N8N pipeline automatically displays AI Agent to
 
 - Works with **non-streaming** N8N responses
 - Automatically extracts `intermediateSteps` from the N8N response payload
-- No additional configuration required
+- Configurable verbosity levels (v2.2.0+)
+- Customizable length limits for inputs and outputs (v2.2.0+)
+
+### Verbosity Levels (v2.2.0+)
+
+> [!TIP]
+> **Configure via Pipeline Settings**: Set `TOOL_DISPLAY_VERBOSITY` to control the detail level.
+
+#### 1. **Minimal** (`minimal`)
+
+Shows only tool names in a collapsible list:
+
+```txt
+🛠️ Tool Calls (4 steps) ▶
+  1. Date_Time
+  2. Crypto
+  3. Wikipedia
+  4. Calculator
+```
+
+**Best for**: Quick overview, minimal UI clutter, collapsible for space-saving
+
+#### 2. **Compact** (`compact`)
+
+Shows tool names with short result previews:
+
+```txt
+🛠️ Tool Calls (4 steps) ▶
+  Step 1: Date_Time → [{"currentDate":"2025-10-10T11:22:38.697+01:00"}]
+  Step 2: Crypto → [{"Property_Name":"uuid4","uuid4":"c28495ca-1eb8-419f-8941-7a38c753e809"}]
+  Step 3: Wikipedia → Page: List of tz database time zones...
+  Step 4: Calculator → 128675.5415958103
+```
+
+**Best for**: Balance between overview and detail
+
+#### 3. **Detailed** (`detailed`) - Default
+
+Shows full collapsible sections with all information:
+
+```txt
+🛠️ Tool Calls (4 steps) ▶
+  ├─ Step 1: Date_Time ▶
+  │   🔧 Tool: Date_Time
+  │   🆔 Call ID: call_i7JgGhwh7xV0ghqR9mD4qTJ9
+  │   📥 Input: {"Include_Current_Time": true, "Timezone": "Europe/London"}
+  │   📤 Result: [{"currentDate":"2025-10-10T11:22:38.697+01:00"}]
+  │   📝 Log: Invoking "Date_Time" with...
+  ├─ Step 2: Crypto ▶
+  └─ ...
+```
+
+**Best for**: Debugging, full transparency
 
-### Rich Display Format
+### Length Limits (v2.2.0+)
+
+> [!NOTE]
+> **Control Output Size**: Set `TOOL_INPUT_MAX_LENGTH` and `TOOL_OUTPUT_MAX_LENGTH` to limit text length.
+
+- **`TOOL_INPUT_MAX_LENGTH`** (default: 500): Maximum characters for tool input display in `detailed` and `compact` modes
+- **`TOOL_OUTPUT_MAX_LENGTH`** (default: 500): Maximum characters for tool output/observation display
+- Set to **0** for unlimited length (no truncation)
+
+> [!IMPORTANT]
+> **Behavior with `0` (unlimited)**:
+>
+> - **Detailed mode**: Shows complete input and output without any truncation
+> - **Compact mode**: For inputs, shows full data. For outputs, still uses a 100-character preview for UI readability
+
+**Example**: For very long Wikipedia results, set `TOOL_OUTPUT_MAX_LENGTH` to 200 to show only the first 200 characters, or set to 0 to show everything.
+
+### Rich Display Format (Detailed Mode)
 
 Each tool call is displayed with:
 
 - 🔧 **Tool Name**: The name of the tool that was invoked
 - 🆔 **Call ID**: Unique identifier for debugging (e.g., `call_FB0sIgrwuIGJkOaROor7raU2`)
-- 📥 **Input**: The parameters passed to the tool (formatted as JSON)
-- 📤 **Result**: The tool's response/observation
-- 📝 **Log**: Optional log messages from the tool execution
+- 📥 **Input**: The parameters passed to the tool (formatted as JSON, respects `TOOL_INPUT_MAX_LENGTH`)
+- 📤 **Result**: The tool's response/observation (respects `TOOL_OUTPUT_MAX_LENGTH`)
+- 📝 **Log**: Optional log messages from the tool execution (max 200 chars)
 
 ### Collapsible UI
 
 Uses HTML `<details>` tags for a clean, expandable interface:
 
-```txt
-🛠️ Tool Calls (3 steps) ▶
-  ├─ Step 1: Date_Time ▶
-  ├─ Step 2: Wikipedia ▶
-  └─ Step 3: Wikipedia ▶
-```
-
-Click to expand each step and view full details.
+Click to expand each step and view full details (in detailed mode).
 
 ## Example
 
@@ -169,6 +233,36 @@ The display works with any N8N tool, including:
 - 💾 Database queries
 - And any custom tools you create!
 
+## Configuration
+
+### Pipeline Settings
+
+Configure tool display in the N8N pipeline settings (Admin Panel → Functions → N8N Pipeline):
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `TOOL_DISPLAY_VERBOSITY` | `detailed` | Display mode: `minimal`, `compact`, or `detailed` |
+| `TOOL_INPUT_MAX_LENGTH` | `500` | Maximum characters for tool input. Set to `0` for unlimited (no truncation) |
+| `TOOL_OUTPUT_MAX_LENGTH` | `500` | Maximum characters for tool output. Set to `0` for unlimited in detailed mode (compact mode uses 100 char preview) |
+
+### Recommendations
+
+> [!TIP]
+> **For Production Use**:
+>
+> - Use `compact` mode for cleaner UI with essential info
+> - Set `TOOL_OUTPUT_MAX_LENGTH` to 200-300 for long outputs like Wikipedia
+>
+> **For Development/Debugging**:
+>
+> - Use `detailed` mode to see all information
+> - Set lengths to 0 (unlimited) to see complete data
+>
+> **For Minimal UI**:
+>
+> - Use `minimal` mode to just show tool names
+> - Perfect for when you only need to know which tools were called
+
 ## Troubleshooting
 
 ### Tool Calls Not Showing?
@@ -179,6 +273,7 @@ Check that:
 2. ✅ The response includes the `intermediateSteps` array
 3. ✅ The N8N pipeline version is 2.2.0 or higher
 4. ✅ The response structure matches the expected format (see examples above)
+5. ✅ You're using non-streaming mode (streaming doesn't support tool display)
 
 ### Debugging