QualiSense

QualiSense is Agora's AI-powered accessibility analysis assistant that provides intelligent, contextual guidance for fixing accessibility violations. This advanced feature requires an AI license and offers AI-driven recommendations for specific accessibility issues found during scans.

Overview

QualiSense provides:

• One-Click AI Analysis for individual accessibility violations
• Contextual Remediation Guidance specific to your HTML markup
• Streaming AI Responses with detailed explanations
• Violation-Specific Analysis tailored to each accessibility issue
• Code Examples and Fixes with practical implementation guidance

License Requirements

QualiSense requires:

• ✅ Active Agora License: Basic Agora functionality
• ✅ Active AI License: Required for AI-powered analysis
• ✅ Internet Connection: AI processing requires cloud connectivity
• ✅ Available API Credits: AI analysis consumes API credits

How QualiSense Works

AI Analysis Interface

QualiSense provides one-time AI analysis for individual accessibility violations:

Real-time Analysis

• Violation Type Recognition: Understands the specific accessibility rule that was violated
• HTML Markup Analysis: Examines the exact HTML code causing the issue
• Context Understanding: Considers the element's role and purpose on the page
• User Impact Assessment: Explains how the violation affects users with disabilities

Streaming Responses

• Progressive Display: Responses are streamed in real-time as the AI processes
• Markdown Formatting: Rich text formatting for code examples and explanations
• Structured Guidance: Organized recommendations with clear action items
• Modal Interface: Clean overlay display for focused AI analysis

Violation-Specific Analysis

QualiSense tailors its analysis to each specific accessibility violation:

Targeted Recommendations

• Rule-Specific Guidance: Advice specific to the WCAG rule that was violated
• Code-Specific Fixes: Solutions that work with your exact HTML markup
• Implementation Steps: Clear, actionable instructions for fixing the issue
• Best Practice Alignment: Recommendations that follow accessibility standards

Using QualiSense

Accessing the AI Assistant

QualiSense is available in Live scan or in single URL view:

From Violation Results

1. Navigate to Violations: View accessibility scan results for any URL
2. Select a Violation: Click on any violation to see affected elements
3. Choose Element: Review the list of elements affected by this violation
4. Click QualiSense: Click the "QualiSense" button next to any element for AI analysis

License Verification

• Feature Availability: QualiSense button is only enabled with active AI license
• Tooltip Guidance: Disabled button shows license requirement message
• Real-time Checking: License status is verified before each AI request

AI Analysis Process

Input Processing

QualiSense analyzes three key pieces of information:

• Violation Type: The specific accessibility rule that was violated
• HTML Markup: The exact HTML code of the problematic element
• Violation Description: Context about why this element violates accessibility standards

Response Generation

• Streaming Output: AI responses are delivered progressively as they're generated
• Contextual Analysis: AI considers the specific element and violation context
• Practical Solutions: Focuses on actionable fixes for the identified issue
• Code Examples: Provides specific code changes when applicable

QualiSense Response Features

Rich Markdown Content

QualiSense responses include sophisticated formatting for clear guidance:

Text Formatting

• Headings and Sections: Organized structure for easy scanning
• Emphasis and Bold: Highlighting important information
• Code Blocks: Syntax-highlighted HTML, CSS, and JavaScript examples
• Inline Code: Specific attribute names and values clearly marked

Code Examples

• Before/After Comparisons: Shows current code and improved version
• Complete Solutions: Full HTML snippets with proper accessibility markup
• Incremental Changes: Step-by-step modifications to existing code
• Alternative Approaches: Multiple solutions when applicable

AI Analysis Display

Analysis Flow

• Issue Understanding: AI comprehends the specific accessibility issue
• Contextual Analysis: Response is tailored to your exact HTML and violation
• Progressive Display: Information is presented in digestible sections as it streams
• Actionable Guidance: Every analysis includes concrete next steps

Error Handling

• Network Issues: Graceful handling of connectivity problems
• API Limitations: Clear messaging when API credits are exhausted
• Timeout Management: Appropriate handling of long-running requests
• Fallback Information: Basic guidance when AI analysis fails

Best Practices for QualiSense

Effective Usage

Getting the most value from QualiSense AI assistance:

When to Use QualiSense

• Complex Violations: Use for violations that aren't immediately obvious how to fix
• Implementation Questions: Get specific guidance on how to implement fixes
• WCAG Clarification: Understand the reasoning behind accessibility requirements
• Code-Specific Help: Receive tailored solutions for your exact HTML markup

Maximizing Response Quality

• Clear Context: The more specific your violation context, the better the AI analysis
• Complete HTML: Ensure the full element context is available for analysis
• Review Thoroughly: Read the complete AI analysis for comprehensive understanding
• Apply Recommendations: Test suggested fixes to validate their effectiveness

Integration with Development Workflow

During Development

• Code Review Aid: Use QualiSense to understand violations found during testing
• Learning Tool: Gain deeper understanding of accessibility principles
• Quick Reference: Get immediate guidance without leaving the application
• Quality Assurance: Verify that fixes address the underlying accessibility issues

Team Collaboration

• Knowledge Sharing: Share QualiSense responses with team members
• Training Resource: Use AI explanations to educate developers about accessibility
• Documentation: Reference AI guidance in code comments and documentation
• Standards Alignment: Ensure fixes follow established accessibility patterns

Getting Started with QualiSense

Prerequisites

Before using QualiSense, ensure you have:

License Requirements

• Agora License: Basic Agora functionality must be active
• AI License: Separate AI license required for QualiSense features
• Organization Setup: AI features must be enabled for your organization
• Internet Connection: Required for real-time AI analysis
• Available API Credits: AI analysis consumes API credits

First Steps

Running Your First Analysis

1. Scan a Website: Complete an accessibility scan to generate violations
2. Navigate to Results: View the scan results for any URL
3. Select a Violation: Click on any accessibility violation to see details
4. View Elements: See the specific HTML elements that have violations
5. Click QualiSense: Use the QualiSense button next to any element for AI analysis
6. Review Analysis: Read the streaming AI-generated remediation guidance
7. Apply Fixes: Implement the suggested accessibility improvements
8. Verify Results: Re-scan to confirm violations are resolved

Making the Most of QualiSense

• Start with Complex Issues: Focus on violations that are difficult to understand
• Read Complete Analysis: AI provides comprehensive guidance worth reading fully
• Analyze Multiple Elements: Use QualiSense on different elements with the same violation
• Share Knowledge: Distribute insights with your development team
• Track Progress: Monitor how AI guidance improves your accessibility scores

Ready to learn about generating reports? Continue to Reports.