> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Article management

After you've imported your articles, they appear in the Knowledge page,
sorted so the articles that were most recently updated in your knowledge
base appear first. From there, you control whether your AI Agent can use
individual articles when it's creating responses to send to your customers.

## Control whether your AI Agent can create content from individual articles\[#enable-disable-articles]

By default, when you connect your knowledge base to Ada, all of the articles in your knowledge base are active, which means your AI Agent can create responses from them. If necessary, you can exclude articles from appearing in your AI Agent's responses.

1. On the Ada dashboard, go to **Training** > **Knowledge**.

2. Change settings for articles one by one, or select the articles you want to include or exclude all at once. If you want to see any of your articles in more detail, you can click an article's name to open it in a new tab.

   * To include or exclude an individual article from your AI Agent's response content, toggle the **Active** setting beside it.

   * To change article status in bulk, select the relevant check boxes to the left of the article name.

     To find articles, you can enter search terms in the **Search by article name** field, or click the **Filter** list to filter articles by:

     * Whether the articles are currently active
     * The source they came from
     * The language they're in
     * Any custom [article tags](https://developers.ada.cx/reference/tags-knowledge-api) you associated with them using the Knowledge API

     Then, you can select articles from your results.

     At the bottom of the list of articles, you can also change how many articles to display at a time, or move between pages. Even if you scroll through different pages onscreen, the dashboard remembers the articles you've already selected.

3. At the bottom of the page, click either **Set as inactive** or
   **Set as active**. Your AI Agent immediately adds or removes your selected articles from the content it can use to generate responses.

## Restrict articles to certain groups of users\[#article-rules]

If required, you can restrict Ada articles to certain users, based on information your AI Agent collects about your users and saves in variables.

> **Note**
>
> You can only use variables your AI Agent can collect through your browser, or that you collect in a block and allow to be available outside of the structured content the block is in. You can't use variables your AI Agent collects using Actions.

1. On the Ada dashboard, go to **Training** > **Knowledge**.

2. Select the articles you want to change the availability for.

   To find articles, you can enter search terms in the **Search by article name** field, or click the **Filter** list to filter articles by:

   * Whether the articles are currently active
   * The source they came from
   * The language they're in
   * Any custom [article tags](https://developers.ada.cx/reference/tags-knowledge-api) you associated with them using the Knowledge API

   Then, you can select articles from your results.

   At the bottom of the list of articles, you can also change how many articles to display at a time, or move between pages. Even if you scroll through different pages onscreen, the dashboard remembers the articles you've already selected.

3. Click **Set availability**. The Set availability window opens.

   * To restrict the article to certain users, select **Based on the following rules**.
   * A section expands where you can enter the logic your AI Agent will use to decide whether to serve the article.

     1. Under **Where**, in the **Choose a variable** list, select a variable.
     2. In the next dropdown, select an operator so you can define a relationship between the variable and the value you want to target.
     #### Understand comparison operators
     Comparison operators are logic statements that tell your AI Agent to match customer information that's captured in the variable you're using. The available operators vary based on the variable type you're using:
     | **Operator**                                                                                                                                                                | **Variable types**                                                                   | **Description**                                                                                  |
     | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
     | ![Begins With icon](/_fern-files/_img/e8b9c807586a4238654793da51b49ec15e7045c0691d461567178070e57a1840.webp) **Begins With**           | - All text variables (including phone and email)                                     | Match information in the variable that begins with certain text (partial match).                 |
     | ![Ends With icon](/_fern-files/_img/9bc404d3db5ea684a901bf8426485894bb62abb8369e498b98dc4e4f3807a5ec.webp) **Ends With**               | - All text variables (including phone and email)                                     | Match information in the variable that ends with certain text (partial match).                   |
     | ![Contains icon](/_fern-files/_img/a4f0225811b1ecde2f125de907c2ad1b084268805cd89a00f465649ddbf8eaa2.webp) **Contains**                 | - All text variables (including phone and email)- List variables                     | Match information in the variable that contains certain text in any position (partial match).    |
     | ![Is icon](/_fern-files/_img/7266dedcf2da1af5c496469379bd4fb68d5e65492c190e9567c75edbbbf7e260.webp) **Is**                             | - All text variables (including phone and email) - Number variables                  | Match information in the variable that equals specific text exactly (exact match).               |
     | ![Is Not icon](/_fern-files/_img/d94952ab65e9f266413c582390a1d702ebb32c7a2023709ee96741b6df1b17e4.webp) **Is Not**                     | - All text variables (including phone and email) - Number variables                  | Match information in the variable that does not equal specific text exactly (exact match).       |
     | ![Is Not Set icon](/_fern-files/_img/283cad3d89c7d92f279d722592cd958630a40527266a47d316ab3b3b2051b71f.webp) **Is Not Set**             | - All text variables (including phone and email) - Number variables - List variables | Match if there is no information contained in the variable.                                      |
     | ![Is Set icon](/_fern-files/_img/8c1019797a0482018682d52622c9e2fe56ddc5aef8925dc3e3db678c121c6869.webp) **Is Set**                     | - All text variables (including phone and email) - Number variables - List variables | Match if there is any information contained in the variable.                                     |
     | ![Greater Than icon](/_fern-files/_img/45636711dfe933087353da3923c6865b6816ea671ad6e9db4739aeea4c80a697.webp) **Greater Than**         | - Number variables                                                                   | Match if the information in the variable is greater than a specific value.                       |
     | ![Less Than icon](/_fern-files/_img/f2448b33a8931270e63ea8daab74e67ade1fdfdf1f8853529c2fb0a3e5abda55.webp) **Less Than**               | - Number variables - List variables                                                  | Match if the information in the variable is less than a specific value.                          |
     | ![Is True icon](/_fern-files/_img/fcf3fe21099df957ee22609d5a5c211601d3e402fcc8402c12115f4680a692b0.webp) **Is True**                   | - Yes/No variables                                                                   | Match if the information in a variable is Yes (or True).                                         |
     | ![Is False icon](/_fern-files/_img/2b5c661e7e4445f1ea8f7736ee5b58b14f72283faf2dbd4f01220a26d621b238.webp) **Is False**                 | - Yes/No variables                                                                   | Match if the information in a variable is No (or False).                                         |
     | ![Does Not Contain icon](/_fern-files/_img/2a459cf7a992abeb5cbdf8438f9f1be356bb5fcf915f55f7f1c2cdc3173b101d.webp) **Does Not Contain** | - List variables                                                                     | Match if none of the selected items contains this value.                                         |
     | ![Is Equal To icon](/_fern-files/_img/7266dedcf2da1af5c496469379bd4fb68d5e65492c190e9567c75edbbbf7e260.webp) **Is Equal To**           | - List variables                                                                     | Match if the customer selected a particular number of options in a List Option block.            |
     | ![Is Greater Than icon](/_fern-files/_img/45636711dfe933087353da3923c6865b6816ea671ad6e9db4739aeea4c80a697.webp) **Is Greater Than**   | - List variables                                                                     | Match if the customer selected more than a particular number of options in a List Option block.  |
     | ![Is Less Than icon](/_fern-files/_img/f2448b33a8931270e63ea8daab74e67ade1fdfdf1f8853529c2fb0a3e5abda55.webp) **Is Less Than**         | - List variables                                                                     | Match if the customer selected fewer than a particular number of options in a List Option block. |
     6. In the **Value** field, enter or select a value for the variable that you want to use to target users.
     7. If required, add additional conditions.
     * To add a new **top-level** condition, click **Add** ![](/_fern-files/_img/b0aa6bd9ade574c33763556b72bedb3fb7ba2384bf0c25ef6cc5401eab220757.webp).

       If you're adding your first additional top-level condition, in the dropdown that appears, choose **And** or **Or** as the operator for all of your top-level conditions.
     * To create or add to a **group** of conditions, click the **Add to group** icon ![](/_fern-files/_img/881a5902ee010bd99b16914b2ac663810ad93cade88c2fddc273b4c3bc508b28.webp) beside a condition you want to include in the group.

       If you're creating a group, in the dropdown that appears, choose **And** or **Or** as the operator for all of the conditions in that group.

4. Click **Save**. Your AI Agent updates the availability for the selected articles, and lists the rules you set in the Availability column.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).