> For the complete documentation index, see [llms.txt](https://help.aximo.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aximo.autify.com/memories/memory-overview.md).

# About memories

The Memories page has three types of content: **rules** that define instructions for the test agent, **shared memories** that users register in advance, and **learning memories** that the AI accumulates automatically from past sessions.

## Rules

Rules let you define instructions for the test agent that apply to every session, case run, and plan run in the workspace. Use rules to describe behaviors the AI should always follow, such as how to handle specific UI elements, how to treat errors, or which login flow to prefer.

When a specific test instruction conflicts with a rule, the test instruction takes precedence.

In rules, use the same placeholders as test instructions to reference variables, secrets, OTPs, and files registered in shared memories.

To add or update rules, open the **Memories** page, click the **Rules** tab, enter your instructions in the text area, and click **Save**. Rules can be up to 20,000 characters.

For how to write effective rules, see [Write rules](/memories/writing-rules.md).

<figure><img src="https://2741883337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU5yhqOP3GHGe2mG71Ote%2Fuploads%2Fgit-blob-468bbdf1abaad9fc03ba8d191a71493829f5fd57%2Fmemory-rules-tab.png?alt=media" alt="Screenshot of the Rules tab"><figcaption><p>Rules tab</p></figcaption></figure>

## Shared memories

Shared memories are execution-support data that users register in advance. Saved data is shared at the workspace level and can be referenced from sessions and cases in the same workspace.

Managing sensitive values or common input values in shared memories lets you keep test instructions and case content concise. This is useful when you want to reuse the same value across the entire workspace.

In session instructions, a case scenario, or rules, type `@` at the start of a word to search for and insert variables, OTPs, files, and fixed emails.

The items available in shared memories are as follows.

| Feature   | Overview                                                                            | Use case                                                                                                                                                                   |
| --------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Variables | Save common values that you use repeatedly                                          | When you want to reuse common values such as login credentials                                                                                                             |
| OTPs      | Save settings used to generate codes required for login or authentication           | When you want to perform operations that require two-factor authentication                                                                                                 |
| Hostnames | Save settings that resolve a specific hostname to a specified IPv4 address          | When you want to connect to a different destination such as a verification server while keeping the same hostname (used when creating a Web session or running a Web case) |
| Apps      | Save app files such as `.apk` and `.ipa`                                            | When you want to launch and test a mobile app (used when creating a mobile session)                                                                                        |
| Files     | Save attachment files to load during execution                                      | When you want to reference an uploaded file in a test                                                                                                                      |
| Emails    | Save fixed email addresses that keep the same address across sessions and plan runs | When a test needs the same email address on every run, such as logging back into the same account                                                                          |

For detailed steps for each item, see the following articles.

* [Variables](/memories/shared-memories/memory-variables.md)
* [OTPs](/memories/shared-memories/memory-otps.md)
* [Hostnames](/memories/shared-memories/memory-hostnames.md)
* [Apps](/memories/shared-memories/memory-apps.md)
* [Files](/memories/shared-memories/memory-files.md)
* [Fixed emails](/memories/shared-memories/memory-emails.md)

## Learning memories

Learning memories are test execution knowledge that the AI accumulates per workspace while running sessions. Unlike shared memories, learning memories are not registered in advance — the AI records and references them automatically. When a new session starts, the AI retrieves the learning memories most relevant to the execution content and uses them as references to assemble steps and avoid failures.

Learning memories send task text to OpenAI to find related learning memories. If learning memories are disabled for your organization, new sessions do not retrieve or record learning memories. Existing learning memories remain available on the **Learned** tab.

Learning memories handle two types of information.

* **Workflows**: Patterned scenarios from sessions that succeeded in the past. When a new session runs a similar test, the AI uses them as references to assemble steps. The more workflows accumulate, the more stably similar tests can be reproduced and the higher the success rate. A workflow consists of reusable operation units (skills) such as login or search, and the specific operations within them (steps).
* **Known failure patterns**: Records of failures that occurred in past sessions and how they were fixed. When the AI encounters a similar situation, it references these patterns to reduce repeated failures and improve test stability.

On the **Learned** tab of the **Memories** page, review workflows, skills, and failure patterns. Edit or delete items you no longer need.

For learning memories referenced in each session, see [Results](/test-case-creation/session-results.md#retrieved-memory-content).
