Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions docs/agent-q/deep-dive/agentic.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
# Agentic API
# Agentic Endpoints

The Qualytics Agentic API brings the same conversational AI capabilities available through [MCP](./mcp.md){:target="_blank"} directly into your applications and workflows. Using your own LLM API key, you can integrate natural language data quality management into custom tools, scripts, automation pipelines, and internal platforms.
The Qualytics agentic endpoints bring the same conversational AI capabilities available through [MCP](./mcp.md){:target="_blank"} directly into your applications and workflows. Using your own LLM API key, you can integrate natural language data quality management into custom tools, scripts, automation pipelines, and internal platforms.

## Overview

While the MCP integration is designed for interactive AI assistants like Claude Desktop, the Agentic API enables you to:
While the MCP integration is designed for interactive AI assistants like Claude Desktop, the agentic endpoints enable you to:

- Build custom applications that leverage natural language for data quality tasks
- Integrate AI-powered data quality into existing automation workflows
- Create internal tools and chatbots that interact with your data infrastructure
- Use your preferred LLM provider and manage your own API costs

The Agentic API provides the same capabilities as MCP—datastore exploration, data transformations, quality check creation, and anomaly investigation—accessible through standard REST endpoints.
The agentic endpoints provide the same capabilities as MCP—datastore exploration, data transformations, quality check creation, and anomaly investigation—accessible through standard REST calls.

## Authentication

All Agentic API endpoints require authentication using your Qualytics Personal API Token (PAT) or a designated service account token.
All agentic endpoints require authentication using your Qualytics Personal API Token (PAT) or a designated service account token.

Include the token in the `Authorization` header:

Expand All @@ -27,11 +27,11 @@ For instructions on generating a token, see [Tokens](../../settings/access-token

## LLM Configuration

Before using the Agentic API, you must configure your LLM provider credentials. This allows Qualytics to use your API key when making calls to the language model.
Before using the agentic endpoints, you must configure your LLM provider credentials. This allows Qualytics to use your API key when making calls to the language model.

### Supported Providers

The Agentic API supports 22+ LLM providers. For the full list, see [Supported LLM Providers](../managing/add-integration.md#supported-llm-providers){:target="_blank"} in the Add Integration guide.
The agentic endpoints support 22+ LLM providers. For the full list, see [Supported LLM Providers](../managing/add-integration.md#supported-llm-providers){:target="_blank"} in the Add Integration guide.

Common providers include:

Expand Down
4 changes: 2 additions & 2 deletions docs/agent-q/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -179,13 +179,13 @@ Any other MCP-compatible client that supports **Streamable HTTP** transport can

External MCP clients share the same tool set as AgentQ — they connect to the same MCP server and have access to the same tools for exploration, quality checks, transformations, anomalies, operations, and integrations. However, features specific to the Qualytics UI (context injection, smart suggestions, session management, PDF export) are only available in the built-in AgentQ chat.

### What is the difference between AgentQ, the MCP server, and the Agentic API?
### What is the difference between AgentQ, the MCP server, and the agentic endpoints?

| Component | Purpose |
|-----------|---------|
| **AgentQ** | The built-in chat UI inside Qualytics. Full session management, context injection, streaming, PDF export. |
| **MCP Server** | An open-protocol endpoint. External clients (Claude Desktop, ChatGPT, Cursor) connect to it directly with your API token. |
| **Agentic API** | REST endpoints for integrating AgentQ capabilities into custom applications, scripts, and automation pipelines. |
| **Agentic endpoints** | REST endpoints that use an agent to service the request, for integrating conversational AI capabilities into custom applications, scripts, and automation pipelines. |

All three use the same underlying MCP tools and capabilities — they differ only in how you access them.

Expand Down
6 changes: 3 additions & 3 deletions docs/agent-q/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,13 +57,13 @@ You can interact with AgentQ in several ways: through the **full-page chat** ope

[:octicons-arrow-right-24: Limits](deep-dive/limits.md)

- :material-api:{ .lg .middle } **Agentic API**
- :material-api:{ .lg .middle } **Agentic Endpoints**

---

Building custom applications with the Agentic API — integration patterns, best practices, and code examples.
Building custom applications with the agentic endpoints — integration patterns, best practices, and code examples.

[:octicons-arrow-right-24: Agentic API](deep-dive/agentic.md)
[:octicons-arrow-right-24: Agentic Endpoints](deep-dive/agentic.md)

</div>

Expand Down
4 changes: 2 additions & 2 deletions docs/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -258,9 +258,9 @@ An AI assistant or agent (like Claude Desktop, ChatGPT, Cursor, or AgentQ) that

A discrete capability exposed by an MCP server that an AI assistant can call. Each tool has a name, description, input schema, and structured output. Examples include `list_datastores`, `create_quality_check`, and `anomaly_describe`.

### <a name="agentic-api"></a>__Agentic API__
### <a name="agentic-endpoints"></a>__Agentic Endpoints__

REST API endpoints that bring AgentQ's conversational AI capabilities directly into custom applications and automation workflows. Provides the same capabilities as MCP through standard REST calls. Learn more in [Agentic API](agent-q/deep-dive/agentic.md).
Qualytics API endpoints that use an agent to service the request, bringing conversational AI capabilities directly into custom applications and automation workflows. Because they delegate to an agent, they are non-deterministic. They provide the same capabilities as MCP through standard REST calls. Learn more in [Agentic Endpoints](agent-q/deep-dive/agentic.md).

### <a name="llm"></a>__LLM (Large Language Model)__

Expand Down
2 changes: 1 addition & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -483,7 +483,7 @@ nav:
- Conversations, Responses & Context: agent-q/deep-dive/conversations.md
- Best Practices: agent-q/deep-dive/best-practices.md
- AgentQ Limits: agent-q/deep-dive/limits.md
- Agentic API: agent-q/deep-dive/agentic.md
- Agentic Endpoints: agent-q/deep-dive/agentic.md
- Managing:
- Connecting External AI Clients: agent-q/managing/connecting-external-ai-clients.md
- Add Integration: agent-q/managing/add-integration.md
Expand Down
Loading