> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Activate Knowledge AI

<a href="/release-notes/4.80"><Badge className="version-badge" color="blue">Updated in 4.80</Badge></a>

To activate Knowledge AI, first complete the following steps:

1. [Apply for a license](#apply-for-a-license)
2. [Set quotas](#set-quotas)
3. [Activate the feature flag](#activate-the-feature-flag)
4. [Familiarize yourself with Knowledge AI metrics](#view-metrics)

## Apply for a License

You need to obtain a license from Cognigy to use Knowledge AI. The license allows you to use Knowledge AI with your installation and allocate Knowledge Chunks quotas to your organizations. If you exceed your quotas, you can't create new Knowledge AI resources or edit existing ones.

A user with `admin` rights needs to add the license to your installation. If you are using a SaaS installation with version 4.78 or later, contact [Cognigy technical support](/help/get-help) to add a quota for your organization. For on-premises SaaS installations, contact Customer Success Management or Account Executives at Cognigy.

## Set Quotas

After adding the license, you need to set your Knowledge Chunk quotas based on the number of quotas you purchased within your license. You can set quotas to only one organization or distribute them among multiple organizations.

Only a user with `admin` rights for the Management UI can set quotas via the Management UI or the Cognigy.AI API. If you use a shared SaaS environment, contact [Cognigy technical support](/help/get-help) to configure quotas. For on-premises installations, contact Customer Success Management or Account Executives at Cognigy.

### Set Quotas in Management UI

To set quotas in [Management UI](https://management-ui-v4.cognigy.ai/), select an organization on the **Organisations** page. Then, click <img src="https://mintcdn.com/cognigy-15abf2ba/sIAERK2J23A3FpS0/_assets/icons/black-and-white/vertical-ellipsis.svg?fit=max&auto=format&n=sIAERK2J23A3FpS0&q=85&s=6d2d4d534ed7e5d4ea9442c1c11f87c8" alt="vertical-ellipsis" width="20" height="20" data-path="_assets/icons/black-and-white/vertical-ellipsis.svg" /> **> Change Organisation Quotas** in the upper-right corner and enter the value in the **Max knowledge chunks** field.

### Set Quotas via API

To set quotas via the [Cognigy.AI API](https://api-trial.cognigy.ai/openapi), follow these steps:

1. Under **AUTHENTICATION > HTTP Basic**, enter your Management UI credentials, then click **SET**.
2. Send the following HTTP request for a new or an existing organization:

<Tabs>
  <Tab title="New Organization">
    Use the [POST /management/v2.0/organisations](https://api-trial.cognigy.ai/openapi#post-/management/v2.0/organisations) request.
    Send the request with a JSON body. In the JSON body, specify a unique name for the new organization and the maximum number of Knowledge Chunks in the `quotaMaxKnowledgeChunks` parameter.

    ```bash theme={null}
    POST /management/v2.0/organisations
    Content-Type: application/json

    {
      "name": "My Organization",
      "quotaMaxKnowledgeChunks": 1000
    }
    ```

    If the response is successful, the server returns a `200` status code with the `organisationId` and set quota.
  </Tab>

  <Tab title="Existing Organization">
    Use the [PATCH /management/v2.0/organisations/{organisationId}](https://api-trial.cognigy.ai/openapi#patch-/management/v2.0/organisations/-organisationId-) request.
    Include the `organisationId` parameter in the path and a JSON body. In the JSON body, specify the maximum number of Knowledge Chunks in the `quotaMaxKnowledgeChunks` parameter. Find `organisationId` in the **ID** column under **Management UI > Organisations**.

    ```bash theme={null}
    PATCH /management/v2.0/organisations/{organisationId}
    Content-Type: application/json

    {
      "quotaMaxKnowledgeChunks": 1000
    }
    ```

    If the response is successful, the server returns a `200` status code with an empty body.
  </Tab>
</Tabs>

### Billable Units

Knowledge Chunks and Knowledge Queries are billable units:

* **Number of Knowledge Chunks** — Knowledge AI calculates the number of Knowledge Chunks you consume when creating or editing Knowledge Sources or Knowledge Chunks. If your quota is exceeded, you can't edit any Knowledge Sources or create new ones.
* **Number of Knowledge Queries** — Knowledge AI counts the number of Queries performed to retrieve relevant Knowledge Chunks. The number of Knowledge Queries is unlimited. However, you will be billed based on the Queries you have performed. Each time the following Nodes are executed they increase the number of performed Knowledge Queries by one:
  * [AI Agent Node](/ai/agents/develop/node-reference/ai/ai-agent)
  * [Search Extract Output Node](/ai/agents/develop/node-reference/other-nodes/search-extract-output)
  * [Copilot: Knowledge Tile Node](/ai/agents/develop/node-reference/agent-copilot/knowledge-tile)

## Activate the Feature Flag

To activate the Knowledge AI feature flag, contact [Cognigy technical support](/help/get-help).

## View Metrics

Familiarize yourself with the [Admin Center](/ai/administer/access/admin-center/overview) page. On this page, you can monitor Knowledge AI metrics to manage the consumption of Knowledge AI resources effectively.

<Frame>
  <img class="image-center" src="https://mintcdn.com/cognigy-15abf2ba/gMdd3UtLaZzJw9j6/_assets/ai/administer/access/knowledge-ai.png?fit=max&auto=format&n=gMdd3UtLaZzJw9j6&q=85&s=6b054ed0864c81a43318f9a098ea0af6" alt="Knowledge AI metrics in the Admin Center showing queries and chunks" style={{ width: 'auto' }} width="3466" height="766" data-path="_assets/ai/administer/access/knowledge-ai.png" />
</Frame>

The Knowledge AI metrics include the following:

1. The number of Knowledge Queries performed within the selected period.
2. The total number of Knowledge Queries performed.
3. The number of Knowledge Chunks currently available in the organization.
4. The maximum number of Knowledge Chunks allocated to the organization.