letta-server/docs/data_sources.md

title, excerpt, category

title	excerpt	category
Attaching data sources	Connecting external data to your MemGPT agent	6580d34ee5e4d00068bf2a1d

MemGPT supports pre-loading data into archival memory. In order to made data accessible to your agent, you must load data in with memgpt load, then attach the data source to your agent. You can configure where archival memory is stored by configuring the storage backend.

Viewing available data sources

You can view available data sources with:

memgpt list sources

+----------------+----------+----------+
|      Name      | Location | Agents   |
+----------------+----------+----------+
| short-stories  |  local   |  agent_1 |
|      arxiv     |  local   |          |
|  memgpt-docs   |  local   |  agent_1 |
+----------------+----------+----------+

The Agents column indicates which agents have access to the data, while Location indicates what storage backend the data has been loaded into.

Attaching data to agents

Attaching a data source to your agent loads the data into your agent's archival memory to access. You can attach data to your agent in two ways:

[Option 1] From the CLI, run:

memgpt attach --agent <AGENT-NAME> --data-source <DATA-SOURCE-NAME>

[Option 2] While chatting with the agent, enter the /attach command and select the data source

> Enter your message: /attach
? Select data source (Use arrow keys)
 » short-stories
   arxiv
   memgpt-docs

👍 Hint To encourage your agent to reference its archival memory, we recommend adding phrases like "search your archival memory..." for the best results.

Loading a file or directory

You can load a file, list of files, or directry into MemGPT with the following command:

memgpt load directory --name <NAME> \
    [--input-dir <DIRECTORY>] [--input-files <FILE1> <FILE2>...] [--recursive]

Loading a database dump

You can load database into MemGPT, either from a database dump or a database connection, with the following command:

memgpt load database --name <NAME>  \
    --query <QUERY> \ # Query to run on database to get data
    --dump-path <PATH> \ # Path to dump file
    --scheme <SCHEME> \ # Database scheme
    --host <HOST> \ # Database host
    --port <PORT> \ # Database port
    --user <USER> \ # Database user
    --password <PASSWORD> \ # Database password
    --dbname <DB_NAME> # Database name

Loading a vector database

If you already have a vector database containing passages and embeddings, you can load them into MemGPT by specifying the table name, database URI, and the columns containing the passage text and embeddings.

memgpt load vector-database --name <NAME> \
    --uri <URI> \ # Database URI
    --table_name <TABLE-NAME> \ # Name of table containing data
    --text_column <TEXT-COL> \ # Name of column containing text
    --embedding_column <EMBEDDING-COL> # Name of column containing embedding

Since embeddings are already provided, MemGPT will not re-compute the embeddings.

Loading a LlamaIndex dump

If you have a Llama Index VectorIndex which was saved to disk, you can load it into MemGPT by specifying the directory the index was saved to:

memgpt load index --name <NAME> --dir <INDEX-DIR>

Since Llama Index will have already computing embeddings, MemGPT will not re-compute embeddings.

Loading other types of data

We highly encourage contributions for new data sources, which can be added as a new CLI data load command. We recommend checking for Llama Index connectors that may support ingesting the data you're interested in loading.