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".
  • 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 dict[str, Any] | None – Optionale JSON-ähnliche Metadaten-Payload, die an den Datensatz angehängt ist.

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 dict[str, Any] | None

Meldungsdatensätze

Klasse oracleagentmemory.apis.records.MessageRecord

Basis: ScopedRecord

Chatnachrichtendatensatz.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten dict[str, Any] | None
  • thread_id str | None
  • Benutzer-ID str | None
  • agent_id str | None
  • Rolle str | None

Speicherdatensätze

Klasse oracleagentmemory.apis.records.MemoryRecord

Basis: ScopedRecord

Dauerhafter Speicherdatensatz.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten dict[str, Any] | None
  • 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 dict[str, Any] | None
  • 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 dict[str, Any] | None
  • 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 dict[str, Any] | None
  • 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 dict[str, Any] | None

Agent-Profildatensätze

Klasse oracleagentmemory.apis.records.AgentProfileRecord

Basis: Record

Nicht kopierter Agent-Profildatensatz.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten dict[str, Any] | None

Threaddatensätze

Klasse oracleagentmemory.apis.records.ThreadRecord

Basis: ScopedRecord

Speicherdatensatz mit Threadbereich.

• Parameter:
  • ID str
  • Inhalt str | None
  • Zeitstempel str | None
  • Metadaten dict[str, Any] | None
  • 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 | None – Optionale textuelle Payload.
  • 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.
  • 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.
  • 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