Add AgentQ Integration
AgentQ uses the AI provider configured for your deployment. You can select the Qualytics-managed provider (Beta) without supplying a separate model or API key, or connect a supported external provider with your organization's credentials. This guide covers both options.
AgentQ Configuration Fields
The setup below opens the AgentQ Configuration dialog. Use this reference to understand what each field expects before going through the steps:
| # | Field | Description |
|---|---|---|
| 1 | Provider (required) | Select Qualytics (Beta) or a supported external provider. Qualytics is selected by default when it is available. |
| 2 | Model (external providers, when shown) | Choose an available model or type a custom model name when the provider supports it. The field is hidden for the Qualytics provider. |
| 3 | API Key (most external providers) | Enter the credential required by the selected provider. The field is hidden for the Qualytics provider and for provider authentication methods that do not use an API key. |
| 4 | Base URL (external providers, optional) | Provide a custom endpoint for a compatible provider, such as Ollama, OpenRouter, or LiteLLM. The field is hidden for the Qualytics provider. |
| 5 | Business Context (required) | Describe your organization's data quality focus, responsibilities, and domain. AgentQ uses this context to make its suggestions and answers more relevant to your organization. Up to 2000 characters. |
| 6 | Provider-specific fields (when shown) | Complete any additional fields required by the selected provider or authentication method. For Azure OpenAI, this includes API Version. |
When you select Qualytics, the form displays a notice explaining that AgentQ data is processed on Amazon Web Services (AWS), which acts as a data processor. Review the notice and your organization's data-handling requirements before saving the configuration.
Prerequisites
- A Qualytics account with Manager role or higher to configure the LLM integration.
- If you choose an external provider, the credentials and provider-specific configuration it requires.
Setup
The AgentQ Configuration dialog can be opened from two places. Both paths lead to the same form. Pick the one that matches where you are in the app.
Step 1: Click the Settings icon in the bottom-left sidebar.
Step 2: The Settings page opens on the Connections tab.
Step 3: Click the Integrations tab.
Step 1: Click AgentQ in the left sidebar to open the AgentQ page.
Step 2: The No LLM Integration Configured page appears.
Step 3: Click Configure LLM. You are redirected to Settings > Integrations.
Configure the LLM Provider
Once you are on the Integrations tab, continue from this step regardless of which path you took above.
Step 4: The Integrations page lists every integration available in Qualytics, grouped by category. The AgentQ section is at the top with the AI Provider entry.
Step 5: Click Connect next to AI Provider.
Step 6: The AgentQ Configuration dialog opens. Select a provider and complete the fields that appear. The Qualytics provider does not require a model, API key, or Base URL.
Step 7: Click Save to complete the configuration.
Info
Qualytics sends a minimal request to the selected provider to test the connection before storing the configuration. For an external provider, this test also validates the supplied credentials. If the test fails or the provider is unreachable, an error appears.
Step 8: A confirmation message appears and the AgentQ entry shows a Connected badge with the active provider. External providers also show the selected model; the Qualytics provider shows Managed.
Once saved, AgentQ is ready to use. See AgentQ Overview for next steps.
How It Works
The AI provider configuration is a single, deployment-wide setting, not a per-user choice. A Manager or Admin selects the provider and completes any required credentials once. AgentQ then becomes available to users with the Member role or higher. Only one provider configuration is active at a time.
AgentQ uses the Business Context with each user's conversation context to make responses and suggestions more relevant to your organization's domain. Do not include secrets or information that your configured AI provider should not process.
Supported LLM Providers
| Provider | Example Models |
|---|---|
| Qualytics (Beta) | Managed by Qualytics; no model selection required |
| OpenAI | gpt-4o, gpt-4-turbo, o1, o3-mini |
| Anthropic | claude-sonnet-4, claude-opus-4, claude-3-5-sonnet |
| Google Gemini | gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash |
| Google Vertex AI | gemini-2.0-flash, gemini-1.5-pro (via Google Cloud Vertex AI) |
| Amazon Bedrock | Region-specific model IDs |
| Azure OpenAI | OpenAI models via Azure deployments |
| Groq | llama-3.3-70b, llama-3.1-8b, mixtral-8x7b |
| Mistral | mistral-large, mistral-medium, codestral |
| Cohere | command-r-plus, command-r |
| DeepSeek | deepseek-chat, deepseek-coder |
| xAI | grok-2, grok-beta |
| Ollama | Any locally-hosted model (requires Base URL) |
| OpenRouter | Any model via OpenRouter (requires Base URL) |
| LiteLLM | Any model via LiteLLM proxy (requires Base URL) |
| Perplexity | sonar-pro, sonar |
| Heroku | Anthropic Claude models via Heroku Managed Inference |
| Fireworks | Any Fireworks-hosted model |
| GitHub Models | GitHub-hosted models |
| Hugging Face | Inference endpoint models |
| Together AI | Any Together AI model |
| Cerebras | llama-3.3-70b, llama-3.1-8b |
| Moonshot AI | moonshot-v1-32k, kimi-k2 |
Note
The Qualytics provider does not require your organization to supply an LLM API key. For an external provider, your organization supplies the credentials and is responsible for that provider's usage and commercial terms.
File Uploads in Chat
When the active provider supports binary content, the chat input shows an Attach icon for sending PDFs, Word, Excel, CSV, JSON, XML, plain text, and Markdown files. The button is shown for Anthropic, Google Gemini, Google Vertex AI, Amazon Bedrock (Claude models), OpenAI, Azure OpenAI, and Heroku. Other providers can still receive document content via the Paste Large Content flow. See Attach a File for limits and supported formats.
Using Azure API Management (APIM) with Azure OpenAI
If you front your Azure OpenAI endpoint with Azure API Management (APIM), you can point the Azure OpenAI integration at the APIM gateway instead of the Azure OpenAI endpoint directly. APIM acts as an OpenAI-compatible proxy. Two configuration details have to line up.
1. Base URL
Enter the APIM Gateway URL host the same way you would a native Azure OpenAI endpoint. Use only the host, without a trailing /openai:
The Azure OpenAI client appends /openai/deployments/{deployment}/...?api-version=... on its own, so adding /openai yourself doubles the path and causes 404s. On the APIM side, the Azure OpenAI API should be imported with its URL suffix set to openai so the gateway path mirrors a native Azure OpenAI endpoint (an APIM admin setting, not entered in Qualytics).
2. API Key / header name
Use the APIM subscription key as the API Key. The Azure OpenAI client sends its credential in the api-key HTTP header, but APIM expects the subscription key in Ocp-Apim-Subscription-Key by default. In APIM, go to API → Settings → Subscription → Header name and change it from Ocp-Apim-Subscription-Key to api-key. After that change, the subscription key flows through in the header the client already uses, making it a clean drop-in.
Note
Confirm the deployment name and api-version match what's deployed behind APIM (the standard Azure OpenAI import passes these through). APIM handles authenticating to the real Azure OpenAI backend on its side, so the backend model credentials are never exposed to Qualytics.
For more detail, see the Azure API Management documentation on authenticating and authorizing to LLM APIs, importing an Azure OpenAI API, and subscriptions and custom header names.
What's Next?
Want to connect external AI clients like ChatGPT, Claude Desktop, Cursor, or VS Code directly to the Qualytics MCP server? See Connecting External AI Clients for step-by-step setup guides.