记录

此页显示 Oracle Agent Memory 存储和搜索 API 返回的记录值类型。

基本记录

class oracleagentmemory.apis.records.Record

基准：object

内存存储和搜索结果返回的基本保留记录。

• 参数：
  • id str- 存储记录的稳定标识符。
  • record_type str- 逻辑记录类型，例如 "message"、"memory"、"guideline"、"fact"、"preference"、"thread"、"user_profile" 或 "agent_profile" 或 "thread_summary"。
  • content str | None- 为记录存储的可选文本有效负载。
  • timestamp str | None- 为记录保存的时间戳。它表示创建记录的时间。未提供呼叫者时间戳时，门店将使用将记录添加到门店的时间。
  • metadata MetadataValue- 附加到记录的可选类似 JSON 的元数据有效负载。
  • status RecordStatus- 记录的生命周期状态。存储默认设置为 RecordStatus.VALID。
  • linked_results Sequence tuple[[RecordRelation, Record]]- 图形展开搜索附加的相关记录。每个项目都包含存储的关系和通过它达到的记录。在图形展开搜索外部返回的记录具有空序列。

记录状态

class oracleagentmemory.apis.records.RecordStatus

基础：str、Enum

持久记录的生命周期状态。

VALID 是正常的活动状态。INVALID 保留记录供历史使用，同时允许应用程序将其从检索中排除。

无效 = ‘ INVALID ’

VALID = ‘ VALID ’

范围记录

class oracleagentmemory.apis.records.ScopedRecord

基础：Record

公开公共范围标识符的持久记录。

ScopedRecord 是记录类型的共享基类，其公共配置包括范围属性，如 thread_id、user_id 和 agent_id。典型的例子是线程、消息和记忆。

• 参数：
  • thread_id str | None- 随记录一起存储的可选线程范围标识符。
  • user_id str | None- 随记录一起存储的可选用户范围标识符。
  • agent_id str | None- 随记录一起存储的可选代理范围标识符。
  • id str
  • record_type str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

消息记录

class oracleagentmemory.apis.records.MessageRecord

基础：ScopedRecord

存储的聊天消息记录。

content 接受消息内容部分的字符串或有序序列。

• 参数：
  • role str | None- 与消息关联的可选角色，例如 "user" 或 "assistant"。
  • content str | Sequence[MessageContent]- 用于直接构造的消息文本，或 TextContent 和 ImageContent 部分的有序序列。
  • seq_no int- 要求稳定，增大消息线程中的序列号。允许存在间隙。将其与 list_thread_messages() 范围边界一起使用可检索线程历史记录的一部分。
  • id str
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

内存记录

class oracleagentmemory.apis.records.MemoryRecord

基础：ScopedRecord

持久性内存记录。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

准则记录

class oracleagentmemory.apis.records.GuidelineRecord

基础：MemoryRecord

指引记录与一般记忆分开存储。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

事实记录

class oracleagentmemory.apis.records.FactRecord

基础：MemoryRecord

事实记录与一般记忆分开存储。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

首选项记录

class oracleagentmemory.apis.records.PreferenceRecord

基础：MemoryRecord

偏好记录与一般记忆分开存储。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

用户概要信息记录

class oracleagentmemory.apis.records.UserProfileRecord

基础：Record

未定义范围的用户概要信息记录。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

代理概要信息记录

class oracleagentmemory.apis.records.AgentProfileRecord

基础：Record

未界定的代理概要信息记录。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

图像记录

class oracleagentmemory.apis.records.ImageRecord

基础：ScopedRecord

持久图像文档记录。

默认情况下会省略图像字节数。范围列表可以为映像标识符的显式允许列表加载字节。

• 参数：
  • message_id str | None- 包含此映像部分的消息的可选标识符。
  • mime_type ImageMimeType- 映像的 MIME 类型。这始终是必需的，包括从记录中省略 bytes 时。
  • bytes builtins.bytes | None- 检索操作请求时的映像数据；否则为 None。
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

线程记录

class oracleagentmemory.apis.records.ThreadRecord

基础：ScopedRecord

线程范围的存储记录。

• 参数：
  • id str
  • 内容 str | None
  • timestamp（时间戳）str | None
  • metadata（元数据）MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • runtime_config dict[str, Any] | None
  • runtime_state dict[str, Any] | None

帮助器

oracleagentmemory.apis.records.build_record

为存储行构建最具体的记录实施。

• 参数：
  • record_type str-Canonical 记录类型标签。
  • record_id str- 记录的稳定公共标识符。
  • content str | dict[str, object] | Sequence[MessageContent] | None- 可选的记录有效负载。消息记录还可能包含结构化消息内容部分的有序序列。
  • thread_id str | None- 范围记录类型的可选线程范围标识符。
  • user_id str | None- 范围记录类型的可选用户范围标识符。
  • agent_id str | None- 范围记录类型的可选代理范围标识符。
  • role str | None- 可选聊天角色，仅用于消息记录。
  • seq_no int | None- 消息记录所需的稳定消息序列号。对于其他记录类型，它将被忽略。
  • timestamp str | None- 为记录保存的时间戳。它表示创建记录的时间。省略时，门店会使用将记录添加到门店的时间。
  • metadata dict[str, Any] | None- 可选的元数据有效负载。
  • status RecordStatus- 记录的生命周期状态。存储默认设置为 RecordStatus.VALID。
  • kwargs Any- 特定记录类型的其他关键字参数。
• 返回：最具体的 record_type 记录类。
• 退货类型：记录