Configure Agent Memory

Configure Agent Memory to let Agent Builder workflows store, retrieve, inspect, and delete durable memories for user conversations.

Agent Memory uses an embedding model configured in Application Settings. Memory is scoped to the current user and workflow. Agent Factory does not share memory across users or across different workflows.

Note: If you upgraded Agent Factory from release 26.4 to 26.7 and use a database release earlier than 23.26.1.0, run the following commands before you enable Agent Memory in Agent Builder. This requirement applies to both Quick Start and Production installation modes.

1. Connect to the database container as the oracle user:

   podman exec -it -u oracle oracle-database bash -c "sqlplus / as sysdba"

2. Run the following SQL commands:

   SHOW CON_NAME;
   
   ALTER SESSION SET CONTAINER = CDB$ROOT;
   ALTER SYSTEM SET vector_memory_size = 512M SCOPE=SPFILE SID='*';
   
   SHUTDOWN IMMEDIATE;
   STARTUP;
   
   ALTER PLUGGABLE DATABASE ALL OPEN;
   
   ALTER SESSION SET CONTAINER = FREEPDB1;
   ALTER SYSTEM SET vector_memory_size = 256M SCOPE=BOTH;
   SELECT value FROM v$parameter WHERE name = 'vector_memory_size';

Configure the Agent Memory Embedding Model

Before workflow builders can use Agent Memory, an administrator must configure the embedding model used for memory storage and retrieval.

1. Sign in to Agent Factory as an administrator.

2. In the left navigation menu, select Application Settings.

3. Select the Agent Memory tab.

4. Select the embedding model to use for Agent Memory.

   

   Description of the illustration agent-memory-config-model.png

5. Click Configure.

After Agent Memory is configured from Application Settings, workflow builders will be able to enable or disable the Agent Memory for an agent in Agent Builder. See Enable Agent Memory for a Workflow.