Reports
Reports provide an automated way to gain both high-level and detailed insights into your product and customers. To get started, navigate to the Reports section under the Insights tab in the Markprompt dashboard. Here, you’ll find a list of all reports generated within your project. Each report analyzes a set of tickets, offering both an individual ticket analysis and a comprehensive overview of trends, problem areas, sentiment, and other insights across the entire group of tickets.
Generating a Report
To generate a report, click the + icon in the upper-right corner of the Reports page.
Next, specify filters to define the tickets you want to include in the report, such as a date range and metadata filters.
Metadata Filters
You can filter based on any metadata field attached to the tickets synced in the Knowledge tab of the Markprompt dashboard. The filters use SQL-inspired syntax, and each filter you add will narrow down the set of tickets — the final list of tickets will be the intersection of all the filters added. For example, to filter tickets by organization ID, you can use the following filter:
| Key | Operator | Value |
|---|---|---|
organization_id | = | org_123 |
Or, to filter all high priority tickets from an organization, you can use this filter:
| Key | Operator | Value |
|---|---|---|
organization_id | = | org_123 |
priority | = | high |
Alternatively, to filter tickets containing a custom field with the ID 123 and value product1, use this filter (@> represents “contains”):
| Key | Operator | Value |
|---|---|---|
custom_fields | @> | '[{"id": 123, "value": "product1"}]' |
When you add a metadata filter, a list of available keys will appear. To determine the exact values you would like to filter on for those keys, search the tickets in the Knowledge tab. Each ticket is displayed as a file, and the attached metadata fields are visible in the file viewer. If you need assistance with metadata filters, don’t hesitate to contact the Markprompt team.
Refinement Instructions
You can include Refinement Instructions to tailor both the ticket-level analysis and the overall report analysis. Enter these optional instructions in the Refinement Instructions fields for each section of the report.
Examples of refinement instructions include:
- Summarize each ticket in no more than two concise sentences.
- Highlight the top three most common billing issues in the report.
Report Logs
During the report generation process, logs are displayed on the report page. These logs provide updates on the report’s progress and insights into its generation. When the process is complete, you’ll have access to the full text of the report, including the ticket-level analysis and the overall report analysis, if selected.