submit_feedback
Description: Submit structured feedback on data quality, tool behavior, or results. Feedback is associated with a workflow session and optionally linked to specific tool executions.
Tool Identifier: submit_feedback
Input Parameters
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| workflow_id | string | Yes | - | Valid UUID | Workflow session identifier (must be validated) |
| feedback_items | array | Yes | - | Min 1 item | Array of feedback items |
Parameter Details:
workflow_id:
- Required validated workflow ID from a previous tool call
- Cannot submit feedback without an active workflow session
- Used to associate feedback with specific query context
feedback_items:
- Array of feedback objects, each containing:
tool_trace_id(optional): Reference to specific tool executionfeedback(required): Feedback text (min 1 character)
- At least one feedback item required
- Example:
{ "feedback_items": [ { "tool_trace_id": "a1b2c3d4e5f6", "feedback": "Email addresses returned were outdated" }, { "feedback": "Query performance was excellent" } ] }
Request Schema:
{
workflow_id: string; // Required, must exist
feedback_items: Array<{
tool_trace_id?: string;
feedback: string; // min 1 char
}>; // min 1 item
}Output Format
Success Response:
{
workflow_id: string,
feedback_id: string,
message: string,
submitted_at: string,
stored_items: number,
invalid_items?: number,
warnings?: string[],
tool_trace_id: string
}Response Fields:
| Field | Type | Description |
|---|---|---|
| workflow_id | string | Workflow session identifier |
| feedback_id | string | Unique identifier for this feedback submission |
| message | string | Confirmation message |
| submitted_at | string | ISO 8601 timestamp of submission |
| stored_items | number | Number of feedback items successfully stored |
| invalid_items | number | Number of items that failed validation (optional) |
| warnings | array | Validation warnings (optional) |
| tool_trace_id | string | Trace ID for this feedback submission |
Example Response:
{
"workflow_id": "550e8400-e29b-41d4-a716-446655440000",
"feedback_id": "fb_abc123def456",
"message": "Feedback submitted successfully",
"submitted_at": "2025-01-16T14:30:00Z",
"stored_items": 2,
"tool_trace_id": "a1b2c3d4e5f6"
}Error Handling
Common Errors:
- Invalid
workflow_id: "Workflow ID not found or expired" - Empty
feedback_itemsarray: "At least one feedback item required" - Empty feedback text: "Feedback text cannot be empty"
Usage Examples
Example 1: Feedback on specific tool execution
{
"workflow_id": "550e8400-e29b-41d4-a716-446655440000",
"feedback_items": [
{
"tool_trace_id": "a1b2c3d4e5f6",
"feedback": "The resolved email addresses appear to be outdated for person_id 123456"
}
]
}Example 2: General workflow feedback
{
"workflow_id": "550e8400-e29b-41d4-a716-446655440000",
"feedback_items": [
{
"feedback": "Query performance was excellent, results were highly relevant"
}
]
}Example 3: Multiple feedback items
{
"workflow_id": "550e8400-e29b-41d4-a716-446655440000",
"feedback_items": [
{
"tool_trace_id": "trace_001",
"feedback": "Address normalization worked well"
},
{
"tool_trace_id": "trace_002",
"feedback": "Cluster analytics were very insightful"
}
]
}