# Phrase Learning

Create a **Phrase Learning** to tell Kaiya what a single word or short phrase should mean (map it to a measure, dimension, or filter condition) in a specific Business View (BV) or across All Business Views.

1. Navigate **Kaiya → Open Side Bar → Manage Learnings**. The following page will be displayed. It will be default to Phrase Learnings.&#x20;

<figure><img src="https://content.gitbook.com/content/8GaK1h3pmgbR63x0ftET/blobs/7Y9Pi1thoivsTAh6EtZL/image.png" alt=""><figcaption></figcaption></figure>

2. You can sort and order the Learnings as follows.

<figure><img src="https://content.gitbook.com/content/8GaK1h3pmgbR63x0ftET/blobs/9Ckdv3iKhXYPlPVBkgzR/image.png" alt="" width="287"><figcaption></figcaption></figure>

* Select whether you need to view Learnings from all Business Views or from a specific Business View.
* Select which scope of Learnings should be displayed: User-level or Business View level.

<figure><img src="https://content.gitbook.com/content/8GaK1h3pmgbR63x0ftET/blobs/FLk0UuBRitz4uVwsff0x/image.png" alt="" width="375"><figcaption></figcaption></figure>

3. The following will be displayed for each Learning:

* **Phrase:** literal phrase/alias for which the Learning has been created
* **Intent/mapping:** the resolved meaning for the phrase
* **Level:** User level or Business View level Learning
* **Business View:** The Business View for which the Learning has been created
* Creator name and created time
* Click on the three-do kebab menu to edit or delete a Learning.

4. Click on **Create Learning** button and the following window will be displayed.&#x20;

<figure><img src="https://content.gitbook.com/content/8GaK1h3pmgbR63x0ftET/blobs/EzsbkmQw1dXzyOFqUZUY/image.png" alt="" width="563"><figcaption></figcaption></figure>

5. Select the relevant Business View which is applicable for the new Learning. You can also select **All Business Views** if you want to this Learning to be applicable for all BVs.
6. **Learning level:** Choose if you want the Learning should be visible only for the specific user or available across all Business Views.

* **User** — visible only to the creating user.
* **BV-level** — visible to all users. Admin role required.

7. **Phrase:** Provide the actual phrase you want to teach Kaiya. Use separate learnings for meaningfully different phrases.
8. In the **Instruction type**, you can choose to provide textual instructions in natural language or map keywords.

* **Keyword Mappings:** Creates a deterministic binding from the phrase to one or more concrete BV targets (measure/dimension/filter). Kaiya applies these exactly whenever the phrase occurs (within the selected scope). Ideal for repeatable, exact behavior. The phrase maps cleanly to a field, aggregation, or filter.

  * Click on **Add Mapping** and select from the sub menu as required.
  * **Aggregation:** Picks the metric and how to roll it up. Use when the word should always resolve to a specific metric/aggregation.\
    **Dimension:** Sets the *“group by”* field to break down results.\
    **Resolution:** Sets the time grain used for grouping without adding a date filter. Use for phrases like *“weekly revenue”.*\
    **Filter:** Applies a non-time condition on a column\
    **Time filter:** Constrains the time window or comparison periods

  <figure><img src="https://content.gitbook.com/content/8GaK1h3pmgbR63x0ftET/blobs/98pVVem0cjYJhRLUBs0n/image.png" alt="" width="153"><figcaption></figcaption></figure>

  * For each type, you can select the required column and the corresponding value.
* **Textual instructions:** Lets you write a short directive that guides Kaiya’s language understanding when a phrase appears. Ideal for human-readable rule and no single field/value cleanly represents it (early modeling, cross-BV wording, policy phrasing). In the textbox, write a concise, explicit directive in natural language.

<figure><img src="https://content.gitbook.com/content/8GaK1h3pmgbR63x0ftET/blobs/lvu0mzGF0HmmWD3dZfFe/image.png" alt=""><figcaption></figcaption></figure>

9. After providing all the required details, click on **Save Changes** to create the Learning. Or click on **Cancel** to dismiss.
10. If you want to delete a Learning, click on **Delete Learning** button. All the above fields are applicable when editing a Learning.<br>
