BadgerFy.ai Docs

Quiz Agent

The Quiz Agent simplifies the creation of product and service-focused quizzes, leveraging AI for intelligent scoring based on your provided dataset. It can also use AI to generate quiz questions, streamlining the entire process compared to manual quiz building.

Overview

This agent is designed to guide users through an interactive experience, ultimately providing personalized recommendations or insights based on their answers.

Data Source Instructions

Like all BadgerFy.ai agents, the Quiz Agent utilizes a data source as its knowledge base. This can be a .txt, .json, .pdf, or .csv file, or content from a website scrape.

Tips for Quiz Data Sources

  • Relevant Content: Remove any extra information that is not directly useful for the quiz's purpose or scoring.
  • Product Details: For product recommendation quizzes, include comprehensive information about each product, including its name and URL. The URL will be displayed with each recommendation.
  • Scoring Attributes: Add specific details or attributes about your products to assist the AI with accurate scoring. For example, include factors like "cooling score" or "edge support rating" for a mattress quiz.
  • Focused Dataset: Ensure your dataset is sufficiently focused on the criteria relevant for quiz scoring.

Quiz Instructions

The Quiz Instructions field is crucial for aligning the Quiz Agent's scoring and results screen with your specific goals. You can provide a concise prompt here to ensure the AI follows your directives.

Customizing Quiz Instructions

  1. Define Quiz Purpose: Clearly guide the AI on the overall purpose of the quiz. Be specific about how the quiz should be scored and which parameters are most important.
  2. Structure Results: Provide clear guidance on how the results should be structured. For example: "Recommend 3 products that would work best for the user, along with a brief summary."
  3. Include Display Details: Specify formatting details like the inclusion of links, bolding, or other HTML elements. The Quiz Results screen supports HTML.

Content Customization

The Quiz Agent offers various options for content and behavioral customization:

  • Title: Customize the main title of your quiz.
  • Custom Trigger Button: Configure a specific HTML element (by ID) on your page to open the quiz modal.
  • Load Delay: Set a delay (in seconds) before the quiz button or auto-loaded modal appears.
  • Auto-Load: The quiz can be configured to auto-load on the first page a user visits in a session.
  • Question Types: Design your quiz with multiple-choice or single-answer questions.
  • Open-Ended Questions: Include up to one open-ended question per question set, which can also be used by the AI in scoring.

Styling

The color and overall style of the Quiz Agent can be customized using the intuitive WYSIWYG tool in your dashboard. For advanced styling needs, you can add global CSS rules to target the quiz's specific CSS classes.

Analytics

BadgerFy.ai tracks various metrics related to your quiz's usage, including opens, completions, and token consumption. You can download the quiz results history for diagnostic purposes.

Testing

Each Quiz Agent comes with a dedicated test page in your dashboard. It's highly recommended to test your quiz's flow and scoring in this sandboxed environment before deploying it to your live website.

Test Environment Notes

  • Default Enabled: While your quiz is disabled by default upon creation, it is automatically enabled in the test environment for immediate testing.
  • Token Usage: Token usage and analytics are recorded in the test environment and count against your included tokens per plan.