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" ou "thread_summary".
  • content str | None – Charge utile textuelle facultative stockée pour l'enregistrement.
  • timestamp str | None – Horodatage enregistré pour l'enregistrement. Il indique la date de création de l'enregistrement. Lorsqu'aucun horodatage d'appelant n'a été fourni, les magasins utilisent l'heure à laquelle l'enregistrement a été ajouté au magasin.
  • metadata MetadataValue – Charge utile de métadonnées de type JSON facultative attachée à l'enregistrement.
  • status RecordStatus – Statut du cycle de vie de l'enregistrement. Cette valeur est définie par défaut sur RecordStatus.VALID.
  • linked_results Sequence tuple[[RecordRelation, Record]] – Enregistrements associés joints par la recherche développée par graphique. Chaque élément contient la relation stockée et l'enregistrement atteint. Les enregistrements renvoyés en dehors de la recherche développée par le graphique ont une séquence vide.

Statut d'enregistrement

classe oracleagentmemory.apis.records.RecordStatus

Bases : str, Enum

Statut de cycle de vie d'un enregistrement persistant.

VALID est le statut actif normal. INVALID conserve un enregistrement à des fins d'historique tout en permettant aux applications de l'exclure de l'extraction.

INVALID = 'non valide'

VALID = 'valide'

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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Enregistrements de message

classe oracleagentmemory.apis.records.MessageRecord

Bases : ScopedRecord

Enregistrement de message de discussion stocké.

content accepte une chaîne ou une séquence ordonnée de parties de contenu de message.

• Paramètres:
  • role str | None : rôle facultatif associé au message, tel que "user" ou "assistant".
  • content str | Sequence[MessageContent] – Texte du message pour la construction directe ou séquence ordonnée de parties TextContent et ImageContent.
  • seq_no int : nombre de séquences stable et croissant requis dans le thread du message. Les écarts sont autorisés. Utilisez-le avec des limites de plage list_thread_messages() pour extraire une partie de l'historique d'un thread.
  • id str
  • horodatage str | None
  • métadonnées MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id 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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de directives

classe oracleagentmemory.apis.records.GuidelineRecord

Bases : MemoryRecord

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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de faits

classe oracleagentmemory.apis.records.FactRecord

Bases : MemoryRecord

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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

Enregistrements de préférences

classe oracleagentmemory.apis.records.PreferenceRecord

Bases : MemoryRecord

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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • 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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

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 MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Enregistrements d'image

classe oracleagentmemory.apis.records.ImageRecord

Bases : ScopedRecord

Enregistrement de document d'image conservé.

Les octets d'image sont omis par défaut. Une liste ciblée peut charger des octets pour une liste d'autorisation explicite d'identificateurs d'image.

• Paramètres:
  • message_id str | None : identificateur facultatif du message qui contient cette partie de l'image.
  • mime_type ImageMimeType – Type MIME de l'image. Ceci est toujours requis, y compris lorsque bytes est omis de l'enregistrement.
  • bytes builtins.bytes | None – Données d'image lorsque l'opération d'extraction le demande ; sinon, None.
  • id str
  • contenu str | None
  • horodatage str | None
  • métadonnées MetadataValue
  • statut RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | 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 MetadataValue
  • statut 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

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 | dict[str, object] | Sequence[MessageContent] | None : charge utile d'enregistrement facultative. Les enregistrements de message peuvent également contenir une séquence ordonnée de parties de contenu de message structuré.
  • 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.
  • seq_no int | None – Numéro de séquence de message stable requis pour les enregistrements de message. Il est ignoré pour les autres types d'enregistrement.
  • timestamp str | None – Horodatage enregistré pour l'enregistrement. Il indique la date de création de l'enregistrement. Lorsqu'il est omis, les magasins utilisent l'heure à laquelle l'enregistrement a été ajouté au magasin.
  • metadata dict[str, Any] | None : charge utile de métadonnées facultative.
  • status RecordStatus – Statut du cycle de vie de l'enregistrement. Cette valeur est définie par défaut sur RecordStatus.VALID.
  • 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