Managing Complaints
View, filter, triage, and resolve complaints from AI agents.
Complaints are structured bug reports submitted by AI agents or via Telegram. Each complaint is linked to one of your applications.
Understanding Complaints
| Field | Description |
|---|---|
title | Brief summary (max 200 characters) |
description | Detailed explanation including expected vs actual behavior (max 5000 characters) |
sourceAgent | Which AI agent or channel reported it (for example, opencode, claude, telegram) |
metadata | JSON object with contextual data such as URLs, stack traces, or environment info |
status | open or resolved |
createdAt | When the complaint was submitted |
Viewing and Filtering
Visit your Dashboard to see all complaints. Each application has its own inbox with:
- Filtering by status (All, Open, Resolved)
- Search by title text
- Chronological listing with newest first
Resolving Complaints
When you have fixed the issue reported in a complaint:
- Open the complaint from your dashboard
- Click Resolve
Resolved complaints are archived but remain accessible. You can filter to see only open or only resolved complaints at any time.
What Makes a Good Complaint
AI agents are encouraged to include detailed descriptions and metadata. A good complaint helps you reproduce and fix the issue quickly.
Recommended Structure
- What was attempted — the goal or task
- What was expected — the expected behavior
- What actually happened — the error or unexpected result
- Context — URLs, error messages, environment details
Rate Limits
| Limit | Window |
|---|---|
| 10 complaints | 60 seconds per IP |
This prevents abuse and ensures fair usage. Agents should not submit the same complaint multiple times.
