.NET API
MemorySettings
Tracon.Abstractions.dllDetermines the memory providers bound to an agent.
public sealed record MemorySettings : IEquatable<MemorySettings>- Inheritance
- object ← MemorySettings
- Implements
- IEquatable<MemorySettings>
- Inherited Members
- object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”MemorySettings.EnableVectorSearch and MemorySettings.EnableConversationMemory are different things. The first opens a semantic search tool over a knowledge base a host loaded; the second remembers what one user said to this agent in earlier sessions.
Constructors
Section titled “Constructors”MemorySettings()
Section titled “ MemorySettings()”public MemorySettings()Properties
Section titled “Properties”ConversationMemoryMaxResults
Section titled “ ConversationMemoryMaxResults”Gets the most records one search returns. The framework’s default (3) applies when it is null. Must be between 1 and 20.
public int? ConversationMemoryMaxResults { get; init; }Property Value
Section titled “Property Value”int?
ConversationMemorySearch
Section titled “ ConversationMemorySearch”Gets when the agent searches its conversation memory. Read only while
EnableConversationMemory is on.
public ConversationMemorySearch ConversationMemorySearch { get; init; }Property Value
Section titled “Property Value”EnableConversationMemory
Section titled “ EnableConversationMemory”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.
public bool EnableConversationMemory { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”It needs UseConversationMemory and a VectorStore in the service collection;
when either is missing, the build stops with TraconCompilationException and
names it. Records are scoped by tenant, agent and user. A run with no user, or no session,
neither reads nor writes memory. The records live in the host’s vector store and go when
their session goes: an erasure of its data subject, DELETE /api/sessions/{id} or its
retention period.
The store embeds what it keeps; Tracon does not see that model call, so its tokens and cost are not on the run.
EnableFileMemory
Section titled “ EnableFileMemory”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.
public bool EnableFileMemory { get; init; }Property Value
Section titled “Property Value”EnableTextSearch
Section titled “ EnableTextSearch”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.
public bool EnableTextSearch { get; init; }Property Value
Section titled “Property Value”EnableTodo
Section titled “ EnableTodo”Gets a value that turns on todo tracking.
public bool EnableTodo { get; init; }Property Value
Section titled “Property Value”EnableVectorSearch
Section titled “ EnableVectorSearch”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.
public bool EnableVectorSearch { get; init; }Property Value
Section titled “Property Value”VectorCollection
Section titled “ VectorCollection”Gets the name of the collection to search. The agent name is used when it is empty.
public string? VectorCollection { get; init; }Property Value
Section titled “Property Value”Methods
Section titled “Methods”Equals(object?)
Section titled “ Equals(object?)”public override bool Equals(object? obj)Parameters
Section titled “Parameters”obj object?
Returns
Section titled “Returns”Equals(MemorySettings?)
Section titled “ Equals(MemorySettings?)”public bool Equals(MemorySettings? other)Parameters
Section titled “Parameters”other MemorySettings?
Returns
Section titled “Returns”GetHashCode()
Section titled “ GetHashCode()”public override int GetHashCode()Returns
Section titled “Returns”ToString()
Section titled “ ToString()”public override string ToString()Returns
Section titled “Returns”Operators
Section titled “Operators”operator ==(MemorySettings?, MemorySettings?)
Section titled “ operator ==(MemorySettings?, MemorySettings?)”public static bool operator ==(MemorySettings? left, MemorySettings? right)Parameters
Section titled “Parameters”left MemorySettings?
right MemorySettings?
Returns
Section titled “Returns”operator !=(MemorySettings?, MemorySettings?)
Section titled “ operator !=(MemorySettings?, MemorySettings?)”public static bool operator !=(MemorySettings? left, MemorySettings? right)Parameters
Section titled “Parameters”left MemorySettings?
right MemorySettings?