Magic Title Rule Creation Guide

Updated by Stephen Boss

🚀 Purpose of Title Prompts

The purpose of title prompts is to generate concise, clear, and actionable titles for tickets. This ensures consistency, quick comprehension, and ease of management across all requests. Titles should focus on summarizing the core issue or request without adding unnecessary details.

🎯 Objectives of Title Prompts

  1. Ensure concise and clear ticket titles.
  2. Avoid unnecessary or redundant information (e.g., greetings, filler words).
  3. Maintain consistency across all categories of requests.
  4. Align titles with predefined categories or formats when applicable.

📌 Guidelines for Writing Title Prompts

  • Keep titles concise (3-4 words maximum).
  • Avoid greetings, pleasantries, or generic terms (e.g., "Hi," "Help").
  • Focus on the specific issue or action required.
  • Use clear, descriptive language to ensure quick understanding.

Example Templates for Prompts

Use these templates as a foundation for crafting effective prompts:

  1. Default Prompt Example
    "Provide a short and concise title for the ticket, including the initial problem. Ignore words like greetings or help."
  2. Format-Specific Prompt
    "Write a concise, three-word title summarizing the issue. Use action-oriented language and avoid filler words."
  3. Keyword Extraction Prompt
    "Analyze the request details and extract the most relevant keywords to form a clear and concise title."
  4. Role-Based Prompt
    "Imagine you’re a technician receiving this request. Summarize the issue in a title that is actionable and clear, using 3-4 words."
  5. Prefix-Based Prompt
    “Generate a title with the correct prefix based on the request type: ACC: Access requests (e.g., ‘ACC - Permissions Needed’); SFWI: Software issues (e.g., ‘SFWI - Installation Error’); HWI: Hardware problems (e.g., ‘HWI - Printer Offline’); PSWR: Password resets (e.g., ‘PSWR - Reset Password’); ACCI: Account issues (e.g., ‘ACCI - Locked Account’); CONN: Connectivity issues (e.g., ‘CONN - VPN Failure’). Use the prefix and summarize the issue in 3-4 words. Example: ‘SFWI - App Crash.’”

🛠️ Categories of Titles

When applicable, categorize titles into predefined groups for clarity and standardization. Example categories include:

  1. Access Requests: e.g., "Access Permissions Needed"
  2. Software Issues: e.g., "Software Installation Error"
  3. Hardware Issues: e.g., "Printer Connection Failed"

💡 Best Practices

  1. Be Consistent: Use the same structure and tone across all prompts.
  2. Iterate Based on Feedback: Regularly refine prompts based on user input.
  3. Test for Clarity: Ensure prompts are easy to understand and follow.
  4. Consider Automation: Align prompts with AI systems to automate title generation effectively.

How did we do?