記錄

此頁面顯示 Oracle 代理程式記憶體儲存和搜尋 API 傳回的記錄值類型。

基準記錄

類別 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 – 為記錄儲存的選擇性文字有效負載 (Payload)。
  • 時間戳記 str | None – 儲存給記錄的時間戳記。它代表記錄的建立時間。若未提供來電者時間戳記，商店會使用記錄新增至商店的時間。
  • 中繼資料 MetadataValue – 附加至記錄的選擇性類似 JSON 的中繼資料有效負載。
  • 狀態 RecordStatus – 記錄的生命週期狀態。儲存預設為 RecordStatus.VALID。
  • linked_results Sequence tuple[[RecordRelation, Record]] – 依圖形展開搜尋附加的相關記錄。每個項目都包含儲存的關係和透過該關係到達的記錄。圖形展開搜尋外部傳回的記錄序號空白。

記錄狀態

類別 oracleagentmemory.apis.records.RecordStatus

基礎：str、Enum

持續記錄的生命週期狀態。

VALID 為一般作用中狀態。INVALID 會保留記錄供歷史使用，同時允許應用程式將其從擷取中排除。

= 'INVALID' 無效

VALID = 'VALID'

已設定範圍的記錄

類別 oracleagentmemory.apis.records.ScopedRecord

基本：Record

顯示公用範圍識別碼的持續性記錄。

ScopedRecord 是記錄類型的共用基礎類別，其公用資源配置包含範圍屬性 (例如 thread_id、user_id 及 agent_id)。典型的範例包括執行緒、訊息以及記憶體。

• 參數：
  • thread_id str | None – 儲存在記錄中的選擇性繫線範圍 ID。
  • user_id str | None – 儲存在記錄中的選擇性使用者範圍識別碼。
  • agent_id str | None – 儲存在記錄中的選擇性代理程式範圍 ID。
  • ID str
  • 記錄類型 str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

訊息記錄

類別 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
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None

記憶體記錄

類別 oracleagentmemory.apis.records.MemoryRecord

基本：ScopedRecord

持久性記憶體記錄。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None

準則記錄

類別 oracleagentmemory.apis.records.GuidelineRecord

基本：MemoryRecord

與一般備忘錄分開儲存的準則記錄。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None

事實記錄

類別 oracleagentmemory.apis.records.FactRecord

基本：MemoryRecord

事實記錄與一般記憶分開儲存。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None

偏好記錄

類別 oracleagentmemory.apis.records.PreferenceRecord

基本：MemoryRecord

偏好記錄與一般記憶分開儲存。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None

使用者設定檔記錄

類別 oracleagentmemory.apis.records.UserProfileRecord

基本：Record

無作用領域的使用者資料檔記錄。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

專員資料檔記錄

類別 oracleagentmemory.apis.records.AgentProfileRecord

基本：Record

無作用領域的服務人員資料檔記錄。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

影像記錄

類別 oracleagentmemory.apis.records.ImageRecord

基本：ScopedRecord

持續性影像文件記錄。

預設會省略影像位元組。範圍設定清單可以載入明確的影像 ID 允許清單的位元組。

• 參數：
  • message_id str | None – 包含此影像部分之訊息的選擇性 ID。
  • mime_type ImageMimeType – 影像的 MIME 類型。一律為必要項目，包括從記錄省略 bytes 時。
  • bytes builtins.bytes | None – 擷取作業要求時影像資料；否則為 None。
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None

繫線記錄

類別 oracleagentmemory.apis.records.ThreadRecord

基本：ScopedRecord

執行緒範圍商店記錄。

• 參數：
  • ID str
  • 內容 str | None
  • 時間戳記 str | None
  • 中繼資料 MetadataValue
  • 狀態 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_idstr | None
  • 代理程式 ID str | None
  • runtime_config dict[str, Any] | None
  • runtime_state dict[str, Any] | None

協助者

oracleagentmemory.apis.records.build_record

建構儲存列的最特定記錄實作。

• 參數：
  • record_type str – 正規記錄類型標籤。
  • record_id str – 記錄的穩定公用識別碼。
  • content str | dict[str, object] | Sequence[MessageContent] | None – 選擇性記錄有效負載 (Payload)。訊息記錄也可以包含結構化訊息內容部分的順序。
  • thread_id str | None – 作用領域記錄類型的選擇性執行緒範圍識別碼。
  • user_id str | None – 作用領域記錄類型的選擇性使用者範圍識別碼。
  • agent_id str | None – 作用領域記錄類型的選擇性代理程式範圍識別碼。
  • 角色 str | None – 選擇性線上交談角色，僅用於訊息記錄。
  • seq_no int | None – 訊息記錄所需的穩定訊息序號。其他記錄類型會忽略此設定。
  • 時間戳記 str | None – 儲存給記錄的時間戳記。它代表記錄的建立時間。省略時，商店會使用記錄新增至商店的時間。
  • 中繼資料 dict[str, Any] | None – 選擇性中繼資料有效負載。
  • 狀態 RecordStatus – 記錄的生命週期狀態。儲存預設為 RecordStatus.VALID。
  • kwargs Any - 特定記錄類型的其他關鍵字引數。
• 傳回：最特定的 record_type 記錄類別。
• 傳回類型：記錄