# How to create a new memory

There are five ways to add memories to Kaiya. Two are manual (you create them directly) and the rest are conversational (Kaiya proposes them during interactions and you approve).

Under **Kaiya**, click to open the side panel and select **Manage Learnings** in the bottom. The following window will be displayed.&#x20;

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2F7WjH0IL1eNd18lgBLRly%2Fimage.png?alt=media&#x26;token=86dc2a4a-15c5-46be-8872-48083755c573" alt="" width="563"><figcaption></figcaption></figure>

Click on **Add Memory** button. The following two options will be displayed.

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FdzDsFcag7I2qI8BG7jDI%2Fimage.png?alt=media&#x26;token=0eb26c53-e53e-472a-b4bd-f7cd42182950" alt="" width="375"><figcaption></figcaption></figure>

### Import document

This method lets you upload a file containing business rules, data dictionaries, glossaries, or any reference material, and Kaiya extracts individual memory items from it automatically.

1. The following window will be opened.

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FYYb4rvnlloFUDEATFImB%2Fimage.png?alt=media&#x26;token=1f36195b-6693-490a-b481-e2a4fdbff5c7" alt="" width="375"><figcaption></figcaption></figure>

2. Optionally, select a Business View from the dropdown at the top. This scopes the extracted memories to that BV. If left blank, the scope defaults based on the content.
3. Drag and drop a file into the upload area, or click to browse. The upload limit is 1 file up to 10 MB. Supported file types: PDF, DOCX, XLSX, CSV, MD, PPTX, HTML.
4. Kaiya parses the document and extracts individual knowledge items. Each item is displayed in a preview table with columns for **Include** (checkbox), **Type** (auto-classified), **Content** (the extracted text), and an **Edit** button.

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FNy0XguXzxLtdJW1WDvSI%2Fimage.png?alt=media&#x26;token=fe318b74-d037-4b69-a9d2-ec9dbc27d7c6" alt="" width="563"><figcaption></figcaption></figure>

5. Review the extracted items and edit individual items if needed.
6. Click **Add to Knowledge Base** to save all selected items.&#x20;

### Describe Memory

This method lets you type a memory directly in natural language, and Kaiya extracts structured knowledge items from your description.

1. A dialog opens with a Business View dropdown (optional) and a rich text editor labeled **"Your Text"** with formatting options. For example: "When analyzing revenue, always include YoY comparison and breakdown by region".

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FsGTILUYMgwEZVRq3yome%2Fimage.png?alt=media&#x26;token=a36a35f6-37ce-4119-a1dc-9b06c5a86deb" alt="" width="375"><figcaption></figcaption></figure>

2. Type or paste your memory content into the editor. You can enter a single instruction or a longer block of text containing multiple rules.
3. Click **Extract Memories**. Kaiya parses your text and presents the extracted knowledge items in the same preview table as the Import Document flow (with **Include**, **Type**, **Content**, and **Edit** columns).
4. Review, edit if needed, and click **Add to Knowledge Base** to save.

### Clarification-based memories

This is the most common way memories are created. When Kaiya encounters ambiguity in your question, it asks a clarification question with numbered options. Your response becomes a memory that Kaiya applies automatically in future conversations.

When your question references a term that maps to multiple columns or definitions in the Business View, Kaiya pauses and asks for clarification before proceeding. The clarification appears with "I need some clarification before proceeding" followed by numbered options. You select your choice by typing out your option.

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FT2gutDqRK7L7Yg8qnlp4%2Fimage.png?alt=media&#x26;token=6d2e322a-01db-464b-84d7-9470f1cecd1b" alt="" width="563"><figcaption></figcaption></figure>

#### **Kaiya asks whether to remember the clarifications**

After Kaiya completes an analysis that involved one or more clarifications, a **"Should I remember this?"** button appears at the bottom of the analysis results, next to the thumbs up/down feedback icons.

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FUg1boBFFIcWJcIvCxdpp%2Fimage.png?alt=media&#x26;token=8427acba-db2b-4683-9dac-64290928717e" alt="" width="563"><figcaption></figcaption></figure>

Clicking this button triggers the **"Worth Remembering"** prompt as follow, allowing you to save relevant clarifications and preferences from the current conversation.

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FgJ1ANi79badrEcKrvbWe%2Fimage.png?alt=media&#x26;token=6c763f67-0ecc-40a5-9d98-cf134435e032" alt="" width="563"><figcaption></figcaption></figure>

* The prompt lists each clarification you made during the conversation as a checkbox item.
* You select which clarifications you want Kaiya to remember and deselect any you do not.
* There is also an **"Add another preferences"** section with a text input where you can type additional preferences beyond the ones Kaiya suggested.

Click **Remember** to save the selected items. Kaiya confirms with a *"Locked into Memory!"* banner. The memories are saved under **"Preference"** type.

### Workflow-based routing

When Kaiya routes a query to a specific workflow (for example, Deep Insight or text-to-SQL), and you correct that routing, Kaiya can persist the correction as a memory.

For instance, if Kaiya proposes sending your query to **Deep Insight** but you indicate it should be a direct SQL query, Kaiya asks whether you want to remember this routing preference. If you confirm, the correction is saved as an Instructional-type memory and applied automatically to similar queries in future sessions.

### Explicitly command Kaiya to "Memorize it"

You can also create memories directly within a Kaiya conversation by using the "memorize it:" prefix in the chat input. Type "Memorize it:" followed by the statement you want Kaiya to remember. For example:

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FQR7q9j59IhLGNX1VYJbf%2Fimage.png?alt=media&#x26;token=f9bf1d7e-3577-4729-8710-8ef3f33d2a27" alt="" width="563"><figcaption></figcaption></figure>

Kaiya saves the statement as a memory. Kaiya automatically classifies it as **Instructional** based on the content.

### Editing a Memory

To edit an existing memory, click the three-dot menu on the memory row in the **Memory Management** table and select **Edit**. The following dialog opens:

<figure><img src="https://3702984147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GaK1h3pmgbR63x0ftET%2Fuploads%2FEPx244JCb4XTJkf6jj12%2Fimage.png?alt=media&#x26;token=a7cb1aed-e178-4227-933f-56be5dd99184" alt="" width="375"><figcaption></figcaption></figure>

* **Content:** A text area containing the memory text. You can modify the text directly.
* **Type:** A dropdown to change the memory type. Available options: Constraint, Preference, Fact, Instructional, Ontological, Procedural, Insight.
* **Scope:** Radio buttons to select User, Business View, or System.
* **Business View:** A BV selector dropdown that appears when the scope is set to Business View. Select the specific BV this memory applies to.
* **Status:** Toggle on to keep the memory active; toggle off to deactivate it without deleting.

Click **Save Changes** to apply your edits, or **Cancel** to discard.

{% hint style="info" icon="square-dashed-circle-plus" %}
When a new memory is being saved, whether from a conversation, manual entry, or document import, Kaiya runs a semantic similarity check against all existing memories. This prevents duplicate or near-duplicate entries from accumulating over time.
{% endhint %}
