Enregistrements

Cette page présente les types de valeur d'enregistrement renvoyés par les banques de mémoire d'agent Oracle et les API de recherche.

Enregistrement de base

classe oracleagentmemory.apis.records.Record

Bases : object

Enregistrement persistant de base renvoyé par les banques de mémoire et les résultats de recherche.

• Paramètres:
  • id str – Identificateur stable de l'enregistrement stocké.
  • record_type str – Type d'enregistrement logique tel que "message", "memory", "guideline", "fact", "preference", "thread", "user_profile" ou "agent_profile".
  • content str | None – Charge utile textuelle facultative stockée pour l'enregistrement.
  • timestamp str | None : horodatage facultatif de l'événement associé à l'enregistrement.
  • metadata dict[str, Any] | None – Charge utile de métadonnées de type JSON facultative attachée à l'enregistrement.

Enregistrement ciblé

classe oracleagentmemory.apis.records.ScopedRecord

Bases : Record

Enregistrement persistant qui expose les identificateurs de portée publique.

ScopedRecord est la classe de base partagée pour les types d'enregistrement dont la forme publique inclut des attributs de portée tels que thread_id, user_id et agent_id. Les exemples typiques sont les fils, les messages et les mémoires.

• Paramètres:
  • thread_id str | None : identificateur de portée de thread facultatif stocké avec l'enregistrement.
  • user_id str | None : identificateur de portée utilisateur facultatif stocké avec l'enregistrement.
  • agent_id str | None : identificateur de portée d'agent facultatif stocké avec l'enregistrement.
  • id str
  • record_type str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None

Enregistrements de message

classe oracleagentmemory.apis.records.MessageRecord

Bases : ScopedRecord

Enregistrement de message de discussion.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • rôle str | None

Enregistrements mémoire

classe oracleagentmemory.apis.records.MemoryRecord

Bases : ScopedRecord

Enregistrement de mémoire durable.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de directives

classe oracleagentmemory.apis.records.GuidelineRecord

Bases : ScopedRecord

Enregistrement de ligne directrice stocké séparément des mémoires générales.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de faits

classe oracleagentmemory.apis.records.FactRecord

Bases : ScopedRecord

Enregistrement de faits stocké séparément des mémoires générales.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de préférences

classe oracleagentmemory.apis.records.PreferenceRecord

Bases : ScopedRecord

Enregistrement de préférences stocké séparément des mémoires générales.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de profil utilisateur

classe oracleagentmemory.apis.records.UserProfileRecord

Bases : Record

Enregistrement de profil utilisateur non ciblé.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None

Enregistrements de profil d'agent

classe oracleagentmemory.apis.records.AgentProfileRecord

Bases : Record

Enregistrement de profil d'agent non ciblé.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None

Enregistrements de thread

classe oracleagentmemory.apis.records.ThreadRecord

Bases : ScopedRecord

Enregistrement de magasin de niveau thread.

• Paramètres:
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées dict[str, Any] | None
  • thread_id str | None
  • user_id str | None
  • agent_id str | None
  • runtime_config dict[str, Any] | None

Assistant

oracleagentmemory.apis.records.build_record

Construire l'implémentation d'enregistrement la plus spécifique pour une ligne stockée.

• Paramètres:
  • record_type str – Libellé de type d'enregistrement canonique.
  • record_id str – Identificateur public stable de l'enregistrement.
  • content str | None : charge utile textuelle facultative.
  • thread_id str | None – Identificateur de portée de thread facultatif pour les types d'enregistrement de portée.
  • user_id str | None : identificateur de portée utilisateur facultatif pour les types d'enregistrement de portée.
  • agent_id str | None : identificateur de portée d'agent facultatif pour les types d'enregistrement de portée.
  • role str | None : rôle de discussion facultatif, utilisé uniquement pour les enregistrements de message.
  • timestamp str | None : horodatage d'événement facultatif.
  • metadata dict[str, Any] | None : charge utile de métadonnées facultative.
  • kwargs Any – Arguments de mot-clé supplémentaires pour des types d'enregistrement spécifiques.
• Retours : classe d'enregistrement la plus spécifique connue pour record_type.
• Type renvoyé : Enregistrement