# MemorySettings

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/memorysettings/
> Summary: OpenAPI request or response schema for MemorySettings, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

Determines the memory providers bound to an agent.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `enableFileMemory` | no | `boolean` | Gets a value that turns on file-based memory. It reads whichever `AgentFileStore` is registered; the built-in store keeps files in memory, so they do not survive a restart unless you register your own. | — |
| `enableTodo` | no | `boolean` | Gets a value that turns on todo tracking. | — |
| `enableTextSearch` | no | `boolean` | Gets a value that turns on text search over the file store. The search runs over the registered `AgentFileStore`, which is the in-memory store unless you register another one. | — |
| `enableVectorSearch` | no | `boolean` | Gets a value that turns on the `search_knowledge` tool. PostgreSQL only: the single concrete implementation of IVectorSearchStore lives in `Tracon.PostgreSql`. When this flag is turned on while another provider is registered, the build stops with TraconCompilationException; it does not silently return an empty result. | — |
| `vectorCollection` | no | `string` | Gets the name of the collection to search. The agent name is used when it is empty. | — |
| `enableConversationMemory` | no | `boolean` | Gets a value that turns on conversation memory: the agent finds what the same user said to this agent in earlier sessions and gets it as context. | — |
| `conversationMemorySearch` | no | [`ConversationMemorySearch`](/http-api/schemas/conversationmemorysearch/) | Gets when the agent searches its conversation memory. Read only while `EnableConversationMemory` is on. | — |
| `conversationMemoryMaxResults` | no | `integer (int32)` | Gets the most records one search returns. The framework's default (3) applies when it is `null`. Must be between 1 and 20. | pattern `^-?(?:0\\|[1-9]\d*)$` |