Datensätze

Auf dieser Seite werden die Datensatzwerttypen angezeigt, die von Oracle Agent-Speicherspeichern und Such-APIs zurückgegeben werden.

Basisdatensatz

Klasse oracleagentmemory.apis.records.Record

Basis: object

Permanenter Basisdatensatz, der von Speicherspeichern und Suchergebnissen zurückgegeben wird.

• Parameter:
  • id str: Stabile ID für den gespeicherten Datensatz.
  • record_type str: Logischer Datensatztyp, wie "message", "memory", "guideline", "fact", "preference", "thread", "user_profile" oder "agent_profile" oder "thread_summary".
  • content str | None: Optionale Text-Payload, die für den Datensatz gespeichert ist.
  • timestamp str | None: Zeitstempel, der für den Datensatz gespeichert wird. Es gibt an, wann der Datensatz erstellt wurde. Wenn kein Zeitstempel für den Anrufer angegeben wurde, verwenden Filialen die Zeit, zu der der Datensatz zur Filiale hinzugefügt wurde.
  • Metadaten MetadataValue – Optionale JSON-ähnliche Metadaten-Payload, die an den Datensatz angehängt ist.
  • status RecordStatus: Lebenszyklusstatus des Datensatzes. Speichert standardmäßig RecordStatus.VALID.
  • linked_results Sequence tuple[[RecordRelation, Record]]: Zugehörige Datensätze, die durch eine durch Diagramme erweiterte Suche angehängt werden. Jedes Element enthält die gespeicherte Beziehung und den durch sie erreichten Datensatz. Datensätze, die außerhalb der erweiterten Suche mit Diagrammen zurückgegeben werden, haben eine leere Sequenz.

Datensatzstatus

Klasse oracleagentmemory.apis.records.RecordStatus

Basis: str, Enum

Lebenszyklusstatus eines persistenten Datensatzes.

VALID ist der normale aktive Status. INVALID behält einen Datensatz für die historische Verwendung bei, während Anwendungen ihn vom Abruf ausschließen können.

UNGÜLTIG = 'ungültig'

GÜLTIG = 'VALID'

Geltungsbereichsbezogener Datensatz

Klasse oracleagentmemory.apis.records.ScopedRecord

Basis: Record

Persistierter Datensatz mit öffentlichen Geltungsbereichs-IDs.

ScopedRecord ist die gemeinsame Basisklasse für Datensatztypen, deren öffentliche Ausprägung Geltungsbereichsattribute wie thread_id, user_id und agent_id enthält. Typische Beispiele sind Threads, Nachrichten und Erinnerungen.

• Parameter:
  • thread_id str | None – Optionale Threadgeltungsbereich-ID, die mit dem Datensatz gespeichert wird.
  • user_id str | None: Optionale Benutzergeltungsbereich-ID, die im Datensatz gespeichert ist.
  • agent_id str | None: Optionale Agent-Geltungsbereichs-ID, die mit dem Datensatz gespeichert ist.
  • ID str
  • record_type str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Meldungsdatensätze

Klasse oracleagentmemory.apis.records.MessageRecord

Basis: ScopedRecord

Gespeicherter Chatnachrichtendatensatz.

content akzeptiert entweder eine Zeichenfolge oder eine geordnete Folge von Nachrichteninhaltsteilen.

• Parameter:
  • role str | None – Optionale Rolle, die mit der Nachricht verknüpft ist, wie "user" oder "assistant".
  • Inhalt str | Sequence[MessageContent] – Meldungstext für die direkte Erstellung oder eine geordnete Folge von TextContent- und ImageContent-Teilen.
  • seq_no int – Erforderlich, stabil, fortlaufende Nummer innerhalb des Nachrichten-Threads wird erhöht. Lücken sind erlaubt. Verwenden Sie es mit den Bereichsgrenzen list_thread_messages(), um einen Teil der Threadhistorie abzurufen.
  • ID str
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None

Speicherdatensätze

Klasse oracleagentmemory.apis.records.MemoryRecord

Basis: ScopedRecord

Dauerhafter Speicherdatensatz.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None

Richtliniendatensätze

Klasse oracleagentmemory.apis.records.GuidelineRecord

Basis: MemoryRecord

Richtliniendatensatz getrennt von allgemeinen Speichern gespeichert.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None

Faktendatensätze

Klasse oracleagentmemory.apis.records.FactRecord

Basis: MemoryRecord

Faktdatensatz getrennt von allgemeinen Speichern gespeichert.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None

Voreinstellungsdatensätze

Klasse oracleagentmemory.apis.records.PreferenceRecord

Basis: MemoryRecord

Voreinstellungsdatensatz getrennt von allgemeinen Speichern gespeichert.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None

Benutzerprofildatensätze

Klasse oracleagentmemory.apis.records.UserProfileRecord

Basis: Record

Nicht kopierter Benutzerprofildatensatz.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Agent-Profildatensätze

Klasse oracleagentmemory.apis.records.AgentProfileRecord

Basis: Record

Nicht kopierter Agent-Profildatensatz.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Bilddatensätze

Klasse oracleagentmemory.apis.records.ImageRecord

Basis: ScopedRecord

Persistierter Bilddokumentdatensatz.

Bildbyte werden standardmäßig ausgelassen. Eine Liste mit Geltungsbereichen kann Byte für eine explizite Ausnahmeliste von Bild-IDs laden.

• Parameter:
  • message_id str | None: Optionale ID der Nachricht, die diesen Bildteil enthält.
  • mime_type ImageMimeType – MIME-Typ des Images. Dies ist immer erforderlich, auch wenn bytes aus dem Datensatz ausgelassen wird.
  • Byte builtins.bytes | None – Bilddaten, wenn sie vom Abrufvorgang angefordert werden. Andernfalls wird None verwendet.
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None

Threaddatensätze

Klasse oracleagentmemory.apis.records.ThreadRecord

Basis: ScopedRecord

Speicherdatensatz mit Threadbereich.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten MetadataValue
  • Status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None
  • runtime_config dict[str, Any] | None
  • runtime_state dict[str, Any] | None

Helper

oracleagentmemory.apis.records.build_record

Spezifische Record-Implementierung für eine gespeicherte Zeile erstellen

• Parameter:
  • record_type str: Beschriftung des kanonischen Datensatztyps.
  • record_id str: Stabile öffentliche ID für den Datensatz.
  • content str | dict[str, object] | Sequence[MessageContent] | None: Optionale Datensatz-Payload. Meldungsdatensätze können auch eine geordnete Folge strukturierter Nachrichteninhaltsteile enthalten.
  • thread_id str | None – Optionale Threadgeltungsbereichs-ID für Geltungsbereichsdatensatztypen.
  • user_id str | None: Optionale Benutzergeltungsbereich-ID für Geltungsbereich-Datensatztypen.
  • agent_id str | None: Optionale Agent-Geltungsbereichs-ID für Geltungsbereichsdatensatztypen.
  • Rolle str | None - Optionale Chatrolle, die nur für Nachrichtendatensätze verwendet wird.
  • seq_no int | None – Stabile Nachrichtensequenznummer ist für Meldungsdatensätze erforderlich. Wird für andere Datensatztypen ignoriert.
  • timestamp str | None: Zeitstempel, der für den Datensatz gespeichert wird. Es gibt an, wann der Datensatz erstellt wurde. Wenn diese Option ausgelassen wird, verwenden Filialen die Zeit, zu der der Datensatz zur Filiale hinzugefügt wurde.
  • metadata dict[str, Any] | None – Optionale Metadaten-Payload.
  • status RecordStatus: Lebenszyklusstatus für den Datensatz. Speichert standardmäßig RecordStatus.VALID.
  • kwargs Any – Zusätzliche Schlüsselwortargumente für bestimmte Datensatztypen.
• Rückgaben: Die spezifischste Datensatzklasse, die für record_type bekannt ist.
• Rückgabetyp: Datensatz