Overview

The Debugger Agent is an AI-powered assistant that helps you understand why search results behave the way they do. It explains ranking, result inclusion, and result exclusion for a given search query using natural language.

Instead of manually analyzing debug panels or trying to infer ranking logic, users can directly ask the agent questions such as why a product is ranked at a certain position or why a product is missing from the results. The agent translates system decisions into clear, easy-to-understand explanations.

The Debugger Agent is designed for merchandisers, business users, and support teams who need visibility into search behavior without deep technical expertise.

Access Debugger Agent

The Debugger Agent is available within the Search Previewin Unbxd console.

📘
Note
The agent remains accessible while the preview page is open and does not appear outside the search preview or debugging context.

Use Case

Use Case	User Scenario	What the Debugger Agent Explains	Outcome for the User
Search Ranking Explanation	A user wants to understand why a product is ranked at a specific position for a query.	Explains why a product appears at its current rank by analyzing: ranking relevance decisions.	The user gains clarity on ranking behavior without manually reviewing debug data.
Missing Product Investigation	A user notices that a product is not appearing for a search query and wants to know why.	Explains why a product is not part of the result set by analyzing retrieval and eligibility conditions.	The user can identify issues affecting product visibility and take corrective action.
Query-Level Debugging	A user wants to troubleshoot unexpected behavior for a specific search query.	Analyzes the active query and result set and answers follow-up questions during the same session.	The user can efficiently diagnose and validate search behavior across different queries.

User Scenario

What the Debugger Agent Explains

Outcome for the User

Search Ranking Explanation

A user wants to understand why a product is ranked at a specific position for a query.

Explains why a product appears at its current rank by analyzing:

ranking relevance decisions.

The user gains clarity on ranking behavior without manually reviewing debug data.

Missing Product Investigation

A user notices that a product is not appearing for a search query and wants to know why.

Explains why a product is not part of the result set by analyzing retrieval and eligibility conditions.

The user can identify issues affecting product visibility and take corrective action.

Query-Level Debugging

A user wants to troubleshoot unexpected behavior for a specific search query.

Analyzes the active query and result set and answers follow-up questions during the same session.

The user can efficiently diagnose and validate search behavior across different queries.