Records

This page presents the record value types returned by Oracle Agent Memory stores and search APIs.

Base Record

class oracleagentmemory.apis.records.Record

Bases: object

Base persisted record returned by memory stores and search results.

• Parameters:
  • id str – Stable identifier for the stored record.
  • record_type str – Logical record type such as "message", "memory", "guideline", "fact", or "preference".
  • content str | None – Optional textual payload stored for the record.
  • thread_id str | None – Optional thread scope identifier.
  • user_id str | None – Optional user scope identifier.
  • agent_id str | None – Optional agent scope identifier.
  • timestamp str | None – Optional event timestamp associated with the record.
  • metadata dict[str, Any] | None – Optional JSON-like metadata payload attached to the record.

Message Records

class oracleagentmemory.apis.records.MessageRecord

Bases: Record

Chat message record.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None
  • role str | None

Memory Records

class oracleagentmemory.apis.records.MemoryRecord

Bases: Record

Durable memory record.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None

Guideline Records

class oracleagentmemory.apis.records.GuidelineRecord

Bases: Record

Guideline record stored separately from general memories.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None

Fact Records

class oracleagentmemory.apis.records.FactRecord

Bases: Record

Fact record stored separately from general memories.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None

User Profile Records

class oracleagentmemory.apis.records.UserProfileRecord

Bases: Record

User profile record.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None

Agent Profile Records

class oracleagentmemory.apis.records.AgentProfileRecord

Bases: Record

Agent profile record.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None

Thread Records

class oracleagentmemory.apis.records.ThreadRecord

Bases: Record

Thread-scoped store record.

• Parameters:
  • id str
  • content str | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • timestamp str | None
  • metadata dict[str, Any] | None
  • runtime_config dict[str, Any] | None

Helper

oracleagentmemory.apis.records.build_record

Construct the most specific record implementation for a stored row.

• Parameters:
  • record_type str – Canonical record type label.
  • record_id str – Stable public identifier for the record.
  • content str | None – Optional textual payload.
  • thread_id str | None – Optional thread scope identifier.
  • user_id str | None – Optional user scope identifier.
  • agent_id str | None – Optional agent scope identifier.
  • role str | None – Optional chat role, used only for message records.
  • timestamp str | None – Optional event timestamp.
  • metadata dict[str, Any] | None – Optional metadata payload.
  • kwargs Any – Additional keyword arguments for specific record types.
• Returns: The most specific record class known for record_type.
• Return type: Record