Getting Started with AgentQ¶
Using AgentQ
AgentQ is available with every module combination. The actions it takes follow the same module requirements and permissions as the rest of the platform. When a requested action needs a module that is not enabled, AgentQ explains the requirement and can help with the available parts of your task.
AgentQ is the AI assistant built into Qualytics. You ask in plain language, and it explores your datastores, investigates anomalies, creates quality checks, and runs operations on your behalf. This section covers:
- What AgentQ is, how it works, and what it can reach on your behalf
- The AI providers that can run AgentQ, and how to connect, change, or remove one
- Access controls, the audit, and the permissions behind each action
- How to start, find, and manage your chats step by step
- Troubleshooting, the AgentQ API, and answers to common questions
Permissions
Every user with the Member role or higher can chat with AgentQ once an AI provider is connected. Connecting or changing the provider and setting the access level requires the Manager or Admin role, and opening the AgentQ audit requires Admin. What AgentQ does on your behalf follows your role and team permissions. See AgentQ Permissions for the full matrix.
Deep Dive¶
-
Introduction
What this section covers, and the order to read it in.
-
How It Works
Where AgentQ appears, how a turn runs, what it is allowed to see, and its built-in features, including description suggestions.
Using AgentQ¶
-
The Chat Interface
Every control in the full-page and floating chat, and what the input accepts.
-
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.
Tools¶
-
AgentQ in Action
Worked examples of AgentQ, its tools, and the steps shown in chat.
-
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.
AI Providers¶
-
Supported AI Providers
Every provider you can connect and which ones support file attachments.
-
Amazon Bedrock Authentication
The three ways to authenticate to Bedrock, and what an IAM role setup expects.
Governance¶
-
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.
-
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.
-
Select Dates
Change the period the audit reports on, beyond the last 30 calendar days it opens with.
-
Sort and Filter the History
Narrow the audit to the users you want to review, and order it by time, conversation, or 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.