AgentQ Overview
AgentQ is the AI assistant built into the Qualytics platform. It gives people and AI systems natural-language access to shared, governed context and the actions available through their Qualytics permissions. Powered by the Model Context Protocol (MCP) and the AI provider configured for your deployment, AgentQ can help you explore datastores, build transformations, create quality checks, investigate anomalies, and take other supported actions.
AgentQ supports your data quality work, but it does not replace your judgment. Review generated interpretations and platform changes before relying on them, especially when they affect business-critical or regulated data.
You can interact with AgentQ through the full-page chat opened from the left sidebar, the floating chat widget available on every page (toggle with Q), and the assistant embedded in quality check and check template dialogs. Before an AI provider is connected, the AgentQ page shows a live preview of what it does, headed Ask about your data. Act on the answer., with Easy setup and Custom setup cards for Managers and Admins and a note for everyone else that an administrator connects a provider once and it turns on for all. AgentQ is set up and managed from that page, under Manage in its sidebar. See Add Integration. The AgentQ API supports custom integrations, while external MCP-compatible clients (Claude Desktop, ChatGPT, Cursor, and others) can connect to the Qualytics MCP server.
Built-In Intelligence
- Smart Suggestions: when you start a new conversation, AgentQ generates personalized prompt suggestions based on your data assets and active anomalies.
- Context Awareness: AgentQ automatically detects the page you're on and injects relevant context (datastore, container, field, check, or anomaly) into the conversation.
- Review-Before-Save Proposals: In quality check and check template dialogs, AgentQ can propose settings from a plain-language request. Nothing is saved until you apply the proposal to the form, review the highlighted changes, and save the item. Only the most recent proposal in a conversation can be applied, so an outdated configuration cannot reach the form by mistake.
- Permission-Aware Actions: AgentQ uses your Qualytics identity and permissions, so it can only access data and perform actions available to your account.
- Co-Authorship Tracking: when a change is made with AgentQ's help, the item's own Timeline records the assistant as a co-author alongside you, providing a record of AI-assisted actions.
- Admin Audit Reporting: administrators can review workspace-wide AgentQ prompts, responses, tool calls, recorded actions, usage, and cost estimates for a selected date range and set of invoking users.
- Conversation Memory: long conversations are automatically managed through context compression, keeping recent messages in full detail while summarizing older context. See Conversations, Responses & Context for details.
- Background Streaming: if you navigate away while AgentQ is generating, the stream continues in the background. The response is waiting when you return to that session.
- PDF Export: export any AgentQ response as a PDF for sharing and reporting.
Description Suggestions
The sparkle control next to any description editor lets you request an AI-generated description built from the asset's metadata. It is only visible when an AI provider is configured under AgentQ.
Click the sparkle, review the suggestion in the preview area, and either accept it (Use this), regenerate for a different take, or dismiss it. When the description field already holds text you have not saved, the accept button reads Replace draft instead, so it is clear what the suggestion will overwrite. The suggested text only enters the description field when you accept it. Regenerating, dismissing, or navigating away leaves the current description untouched.
Where the sparkle appears
| Where | What the suggestion is based on |
|---|---|
| Datastores | The datastore's connection type, the containers it exposes, and its tags. |
| Tables | The table's fields, sample field types, and any tags on the table. |
| Computed Tables | The source containers or SQL definition, the resulting fields, and any tags on the computed table. |
| Files | The file's fields and any tags on the file. |
| Computed Files | The source containers or SQL definition, the resulting fields, and any tags on the computed file. |
| Fields | The field's data type, profile statistics, and neighboring fields in the same table. |
| Computed Fields | The transformation type, source fields, target type or SQL expression, and the parent container's field schema. |
| Computed Joins | The source containers, join keys, the resulting fields, and any tags on the computed join. |
| Anomalies | The anomaly's rule type, the fields it flagged, and the messages from failed checks. |
| Quality Checks | The rule type, target fields, filter, and coverage settings. |
| Quality Check Templates | The template's rule type and default settings. |
The suggestion draws on the metadata Qualytics already stores about the asset. It does not read live data rows.
What to expect
- Length. Suggestions are usually a sentence or two. They can run longer, and use headings and lists, when the asset has enough detail to justify it. The upper bound is the same 8,000-character limit that applies to any description you type yourself, so an accepted suggestion always fits the field.
- Same across surfaces. The interaction (sparkle to preview to Use this / Regenerate / Dismiss) is identical whether you are on a datastore, a field, or a quality check template.
- Language. The suggestion follows the language behavior of the AI provider and model you have configured. If you need to translate the result, edit the accepted text after using it.
- Retries. Each Regenerate click starts a new AI request and can use a different framing, such as the audience, business process, downstream impact, or consequence of missing data. Results vary by provider and model, so two attempts may still produce similar suggestions. Usage is subject to the provider and commercial terms configured for your deployment.
When suggestions are not available
Even with an AI provider configured, the platform can still refuse a suggestion in a few cases:
| Situation | What the platform does |
|---|---|
| AI provider not configured | The sparkle is hidden. See Add Integration to connect a provider. |
| Not enough context | Very sparse assets (for example, an empty datastore with no containers yet) do not have enough metadata to produce a useful description. Add or connect data first, then try again. |
| Too much context | Very large assets (for example, a container with hundreds of fields) can exceed the request budget. Narrow the scope by suggesting on a smaller asset (a field instead of the whole table, for example). |
| Provider timeout | If the AI provider takes too long, the platform returns a timeout error. Retry, or use a faster model in your AgentQ provider configuration. |
| Provider error | If the provider itself rejects the request (rate limit, quota, invalid API key), the error message from the provider is surfaced verbatim. See Update Integration to change model or credentials. |
On most surfaces (Computed Tables, Computed Files, Computed Fields, Computed Joins, and Quality Checks), the sparkle uses the same permission as editing the description manually: if you can edit, you can also request a suggestion. Anomalies are an exception: the sparkle appears for anyone with the Reporter team permission (or above), even though editing the anomaly description itself requires Author. Archived anomalies never show the sparkle.
Deep Dive
-
Getting Started
What this section covers, and the order to read it in.
-
How It Works
Where AgentQ appears, how a turn runs, and what it is allowed to see.
-
The Chat Interface
Every control in the full-page and floating chat, and what the input accepts.
-
MCP
What the Model Context Protocol is, how it works, and why it matters.
-
AgentQ in Action
How Qualytics implements MCP, with its endpoint, tools, and tool step labels.
-
Tool Catalog
Every tool AgentQ can call, what each one does, and what it shares with the model.
-
Semantic Reporting
The structured query interface AgentQ uses to count, filter, and inspect platform resources.
-
Access Controls
How an administrator chooses what chat may share with the model, and what each level unlocks.
-
AgentQ Audit
What each audit entry holds, how cost estimates work, and what the period summary reports.
-
Supported AI Providers
Every provider you can connect, what the Beta badge means, and which ones take file attachments.
-
Amazon Bedrock Authentication
The three ways to authenticate to Bedrock, and what an IAM role setup expects.
-
Conversations, Responses & Context
How to write prompts, read AgentQ responses, and work with context-aware chats.
-
AgentQ Limits
Rate limits, token usage, timeouts, SQL constraints, and scope constraints.
-
Examples
Worked scenarios showing what you ask AgentQ, what it does, and the shape of the answer.
-
Best Practices
Prompt design, cost management, guardrail behavior, rate limits, and async operation patterns.
-
Permissions
The user roles behind chatting with AgentQ, configuring it, and reading the audit.
How-tos
-
Add Integration
Connect AgentQ from its own Settings page, with Easy setup on Qualytics AI or Custom setup on your own provider.
-
Update Integration
Switch between Easy and Custom setup, or change the provider, model, key, or Business Context.
-
Remove Integration
Disconnect your AI provider from AgentQ.
-
Connect Azure OpenAI Through APIM
Point the Azure OpenAI provider at an APIM gateway, with the Base URL and header name that make it work.
-
Configure Access Controls
Pick how much AgentQ can see, with each level previewing the capabilities it turns on.
-
Connecting External AI Clients
Connect ChatGPT, Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, or Amazon Q Developer to the Qualytics MCP server.
-
Select Dates
Change the period the audit reports on, beyond the last 30 calendar days it opens with.
-
Filter the History
Narrow the audit to the users you want to review.
-
Sort the History
Order the entries by the time each turn ran, by conversation, or by invoking user.
-
Start a New Chat
Create a fresh conversation from the sidebar, chat header, or floating chat.
-
Resume a Chat
Return to a previous conversation and continue from where you left off.
-
Rename a Chat
Give a conversation a descriptive title for easier navigation.
-
Archive a Chat
Move a conversation out of the active list into the archived section.
-
Restore a Chat
Bring an archived conversation back to the active list.
-
Delete a Chat
Permanently remove an archived conversation.
-
Search Chats
Filter active conversations by title or message content to find a specific conversation.
Reference
-
Troubleshooting
Symptoms, causes, and resolutions for setting AgentQ up, using it, and capabilities that are switched off.
-
API
REST API reference for AgentQ: chat, sessions, specialized endpoints, and configuration management.
-
FAQ
Answers to frequently asked questions about AgentQ, security, usage limits, and troubleshooting.