Article creation | Ada | Documentation

Need to update information in your AI Agent without adding that information to your knowledge base? You can do that by creating knowledge content directly in Ada.

Ada articles can be useful for use cases where you need your AI Agent to provide different content from the content in your knowledge base, like:

Temporary content, like a promotion
A product outage you need to communicate
Formatting in your knowledge base that your AI Agent can’t parse (e.g., images, complex tables, etc.), so you need to make an alternative version for your AI Agent

Before creating Ada articles, make sure you’re familiar with the best practices in Prepare your knowledge base as a source for AI generated content. Your AI Agent will be chunking and ingesting the information in this article like any other article in your knowledge base, so the more consistent you can make your content and its structure, the better chances you have of your AI Agent using your content to create relevant responses.

Create an Ada article

On the Ada dashboard, go to Training > Knowledge. Then, at the top of the page, click Create article. The Create article dialog opens.

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

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.

Beside Availability, you can click Edit to change which of your users this Ada article is visible to. The Set availability window opens.

To make the article available to all users, select Everyone.

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.

Under Where, in the Choose a variable list, select a variable.
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	- All text variables (including phone and email)	Match information in the variable that begins with certain text (partial match).
Ends With	- All text variables (including phone and email)	Match information in the variable that ends with certain text (partial match).
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	- All text variables (including phone and email) - Number variables	Match information in the variable that equals specific text exactly (exact match).
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	- All text variables (including phone and email) - Number variables - List variables	Match if there is no information contained in the variable.
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	- Number variables	Match if the information in the variable is greater than a specific value.
Less Than	- Number variables - List variables	Match if the information in the variable is less than a specific value.
Is True	- Yes/No variables	Match if the information in a variable is Yes (or True).
Is False	- Yes/No variables	Match if the information in a variable is No (or False).
Does Not Contain	- List variables	Match if none of the selected items contains this value.
Is Equal To	- List variables	Match if the customer selected a particular number of options in a List Option block.
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	- List variables	Match if the customer selected fewer than a particular number of options in a List Option block.

In the Value field, enter or select a value for the variable that you want to use to target users.
If required, add additional conditions.

To add a new top-level condition, click Add .
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 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.

Under Article Name, enter a name for the article, so both you and your AI Agent can get an idea of the information it contains.
Under Content, write your article content.
To save your article content as a draft, click Save. When you’re ready for your content to be available for customers, turn on the Active toggle to make it available for your AI Agent to use in its responses.

Edit or delete an Ada article

For articles that you created in Ada, you can also add updates directly in Ada, or delete them so your AI Agent stops using them in responses.

On the Ada dashboard, go to Training > Knowledge, then click the name of the article you want to edit.

To find all of your Ada articles, you can filter articles by source and select Created in Ada.
Click the name of your Ada article. The Article preview dialog opens, with your saved article in it.
Edit or delete the article.
- To edit it, click Edit, then make the edits to your article and click Save.
- To delete it, click Delete.