Introduction to AgentQ¶
AgentQ is the AI assistant built into Qualytics. It answers questions about your workspace, explains what it finds, and carries out platform actions on your behalf, all from a chat.
The Deep Dive explains AgentQ in depth. Here you will learn what AgentQ is and what it does, where it appears and how a single turn runs, which AI providers can run it and how to connect them, what it is allowed to see and share with the model, how its actions are governed and recorded, and how to get good results from it. It explains the machinery rather than the clicks. For step-by-step instructions, such as connecting a provider or managing your chats, see the How-tos.
Where to Start¶
Read How It Works first. It sets out the surfaces AgentQ appears on, what happens during a single turn, and the two limits that decide what it can reach. Everything else here goes deeper on one piece of that picture.
From there the section falls into four groups, the same ones you see in the navigation.
- Using AgentQ. The Chat Interface, Conversations, Responses & Context, and AgentQ Limits cover the chat controls, writing good prompts and reading the answers, and the ceilings you will meet.
- Tools. AgentQ in Action, Tool Catalog, and Semantic Reporting cover what AgentQ can do. External clients connect through the separate Qualytics MCP server.
- AI Providers. Supported AI Providers and Amazon Bedrock Authentication cover what can run AgentQ and how to authenticate to it.
- Governance. Access Controls and AgentQ Audit cover how much of your data AgentQ may send to the model, and what is recorded.
The section closes with Examples of worked scenarios, Best Practices for getting good results without burning through your provider budget, and Permissions, which covers who may use and configure AgentQ. To build your own applications on the same capabilities, see the AgentQ API.
What This Section Covers¶
-
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.
See Also¶
-
How It Works
Where AgentQ appears, how a turn runs, what it is allowed to see, and its built-in features, including description suggestions.
-
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.
-
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.
-
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.
-
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.