# Getting Started with AgentQ Source: https://userguide.qualytics.io/agentq/getting-started/ 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 > **Info: 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](https://userguide.qualytics.io/agentq/deep-dive/permissions/) for the full matrix. --- ## Deep Dive - **Introduction** What this section covers, and the order to read it in. [Introduction](https://userguide.qualytics.io/agentq/deep-dive/introduction/) - **How It Works** Where AgentQ appears, how a turn runs, what it is allowed to see, and its built-in features, including description suggestions. [How It Works](https://userguide.qualytics.io/agentq/deep-dive/how-it-works/) ### Using AgentQ - **The Chat Interface** Every control in the full-page and floating chat, and what the input accepts. [The Chat Interface](https://userguide.qualytics.io/agentq/deep-dive/chat-interface/) - **Conversations, Responses & Context** How to write prompts, read AgentQ responses, and work with context-aware chats. [Conversations, Responses & Context](https://userguide.qualytics.io/agentq/deep-dive/conversations/) - **AgentQ Limits** Rate limits, token usage, timeouts, SQL constraints, and scope constraints. [AgentQ Limits](https://userguide.qualytics.io/agentq/deep-dive/limits/) ### Tools - **AgentQ in Action** Worked examples of AgentQ, its tools, and the steps shown in chat. [AgentQ in Action](https://userguide.qualytics.io/agentq/deep-dive/in-action/) - **Tool Catalog** Every tool AgentQ can call, what each one does, and what it shares with the model. [Tool Catalog](https://userguide.qualytics.io/agentq/deep-dive/tool-catalog/) - **Semantic Reporting** The structured query interface AgentQ uses to count, filter, and inspect platform resources. [Semantic Reporting](https://userguide.qualytics.io/agentq/deep-dive/semantic-reporting/) ### AI Providers - **Supported AI Providers** Every provider you can connect and which ones support file attachments. [Supported AI Providers](https://userguide.qualytics.io/agentq/deep-dive/supported-ai-providers/) - **Amazon Bedrock Authentication** The three ways to authenticate to Bedrock, and what an IAM role setup expects. [Amazon Bedrock Authentication](https://userguide.qualytics.io/agentq/deep-dive/bedrock-authentication/) ### Governance - **Access Controls** How an administrator chooses what chat may share with the model, and what each level unlocks. [Access Controls](https://userguide.qualytics.io/agentq/deep-dive/access-controls/) - **AgentQ Audit** What each audit entry holds, how cost estimates work, and what the period summary reports. [AgentQ Audit](https://userguide.qualytics.io/agentq/deep-dive/audit/) - **Examples** Worked scenarios showing what you ask AgentQ, what it does, and the shape of the answer. [Examples](https://userguide.qualytics.io/agentq/deep-dive/examples/) - **Best Practices** Prompt design, cost management, guardrail behavior, rate limits, and async operation patterns. [Best Practices](https://userguide.qualytics.io/agentq/deep-dive/best-practices/) - **Permissions** The user roles behind chatting with AgentQ, configuring it, and reading the audit. [Permissions](https://userguide.qualytics.io/agentq/deep-dive/permissions/) --- ## How-tos - **Add Integration** Connect AgentQ from its own Settings page, with Easy setup on Qualytics AI or Custom setup on your own provider. [Add Integration](https://userguide.qualytics.io/agentq/how-tos/integration/add-integration/) - **Update Integration** Switch between Easy and Custom setup, or change the provider, model, key, or Business Context. [Update](https://userguide.qualytics.io/agentq/how-tos/integration/update-integration/) - **Remove Integration** Disconnect your AI provider from AgentQ. [Remove](https://userguide.qualytics.io/agentq/how-tos/integration/remove-integration/) - **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. [Connect Through APIM](https://userguide.qualytics.io/agentq/how-tos/integration/connect-azure-openai-through-apim/) - **Configure Access Controls** Pick how much AgentQ can see, with each level previewing the capabilities it turns on. [Configure](https://userguide.qualytics.io/agentq/how-tos/integration/configure-access-controls/) - **Select Dates** Change the period the audit reports on, beyond the last 30 calendar days it opens with. [Select Dates](https://userguide.qualytics.io/agentq/how-tos/audit/select-dates/) - **Sort and Filter the History** Narrow the audit to the users you want to review, and order it by time, conversation, or user. [Sort and Filter](https://userguide.qualytics.io/agentq/how-tos/audit/sort-and-filter-the-history/) - **Start a New Chat** Create a fresh conversation from the sidebar, chat header, or floating chat. [Start](https://userguide.qualytics.io/agentq/how-tos/interaction/start-a-new-chat/) - **Resume a Chat** Return to a previous conversation and continue from where you left off. [Resume](https://userguide.qualytics.io/agentq/how-tos/interaction/resume-a-chat/) - **Rename a Chat** Give a conversation a descriptive title for easier navigation. [Rename](https://userguide.qualytics.io/agentq/how-tos/interaction/rename-a-chat/) - **Archive a Chat** Move a conversation out of the active list into the archived section. [Archive](https://userguide.qualytics.io/agentq/how-tos/interaction/archive-a-chat/) - **Restore a Chat** Bring an archived conversation back to the active list. [Restore](https://userguide.qualytics.io/agentq/how-tos/interaction/restore-a-chat/) - **Delete a Chat** Permanently remove an archived conversation. [Delete](https://userguide.qualytics.io/agentq/how-tos/interaction/delete-a-chat/) - **Search Chats** Filter active conversations by title or message content to find a specific conversation. [Search](https://userguide.qualytics.io/agentq/how-tos/interaction/search-chats/) --- ## Reference - **Troubleshooting** Symptoms, causes, and resolutions for setting AgentQ up, using it, and capabilities that are switched off. [Troubleshooting](https://userguide.qualytics.io/agentq/troubleshooting/) - **API** REST API reference for AgentQ: chat, sessions, specialized endpoints, and configuration management. [API](https://userguide.qualytics.io/agentq/api/) - **FAQ** Answers to frequently asked questions about AgentQ, security, usage limits, and troubleshooting. [FAQ](https://userguide.qualytics.io/agentq/faq/) *Last updated: November 7, 2026.*