Registros

Esta página presenta los tipos de valores de registro devueltos por los almacenes de memoria del agente de Oracle y las API de búsqueda.

Registro base

clase oracleagentmemory.apis.records.Record

Bases: object

Registro base persistente devuelto por los almacenes de memoria y los resultados de búsqueda.

• Parámetros:
  • id str: identificador estable para el registro almacenado.
  • record_type str: tipo de registro lógico, como "message", "memory", "guideline", "fact", "preference", "thread", "user_profile", "agent_profile" o "thread_summary".
  • content str | None: carga útil de texto opcional almacenada para el registro.
  • timestamp str | None: registro de hora guardado para el registro. Representa el momento en que se creó el registro. Cuando no se ha proporcionado ningún registro de hora de emisor de llamada, las tiendas utilizan el tiempo que el registro se ha agregado a la tienda.
  • metadata MetadataValue: carga útil de metadatos opcional similar a JSON asociada al registro.
  • status RecordStatus: estado del ciclo de vida del registro. Almacena el valor por defecto en RecordStatus.VALID.
  • linked_results Sequence tuple[[RecordRelation, Record]]: registros relacionados anexados por la búsqueda ampliada por gráficos. Cada elemento contiene la relación almacenada y el registro alcanzado a través de ella. Los registros devueltos fuera de la búsqueda ampliada por gráficos tienen una secuencia vacía.

Estado de Registro

clase oracleagentmemory.apis.records.RecordStatus

Bases: str, Enum

Estado del ciclo de vida de un registro guardado.

VALID es el estado activo normal. INVALID conserva un registro para uso histórico, al tiempo que permite a las aplicaciones excluirlo de la recuperación.

INVALID = 'no válido'

VALID = 'válido'

Registro con ámbito

clase oracleagentmemory.apis.records.ScopedRecord

Bases: Record

Registro persistente que expone los identificadores de ámbito público.

ScopedRecord es la clase base compartida para los tipos de registro cuya unidad pública incluye atributos de ámbito como thread_id, user_id y agent_id. Los ejemplos típicos son hilos, mensajes y recuerdos.

• Parámetros:
  • thread_id str | None: identificador de ámbito de subproceso opcional almacenado con el registro.
  • user_id str | None: identificador de ámbito de usuario opcional almacenado con el registro.
  • agent_id str | None: identificador de ámbito de agente opcional almacenado con el registro.
  • id str
  • tipo_registro str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Registros de mensajes

clase oracleagentmemory.apis.records.MessageRecord

Bases: ScopedRecord

Registro de mensaje de chat almacenado.

content acepta una cadena o una secuencia ordenada de partes de contenido de mensaje.

• Parámetros:
  • role str | None: rol opcional asociado con el mensaje, como "user" o "assistant".
  • content str | Sequence[MessageContent]: texto del mensaje para la construcción directa o una secuencia ordenada de partes de TextContent e ImageContent.
  • seq_no int: se requiere un número de secuencia estable y creciente dentro del subproceso del mensaje. Se permiten lagunas. Utilícelo con límites de rango list_thread_messages() para recuperar una parte del historial de un thread.
  • id str
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None

Registros de memoria

clase oracleagentmemory.apis.records.MemoryRecord

Bases: ScopedRecord

Registro de memoria duradero.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None

Registros de directriz

clase oracleagentmemory.apis.records.GuidelineRecord

Bases: MemoryRecord

Registro de directriz almacenado por separado de las memorias generales.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None

Registros de hechos

clase oracleagentmemory.apis.records.FactRecord

Bases: MemoryRecord

Registro de hechos almacenado por separado de las memorias generales.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None

Registros de preferencias

clase oracleagentmemory.apis.records.PreferenceRecord

Bases: MemoryRecord

Registro de preferencias almacenado por separado de las memorias generales.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None

Registros de perfil de usuario

clase oracleagentmemory.apis.records.UserProfileRecord

Bases: Record

Registro de perfil de usuario sin ámbito.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Registros de perfil de agente

clase oracleagentmemory.apis.records.AgentProfileRecord

Bases: Record

Registro de perfil de agente sin ámbito.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Registros de imagen

clase oracleagentmemory.apis.records.ImageRecord

Bases: ScopedRecord

Registro de documento de imagen persistente.

Los bytes de imagen se omiten por defecto. Una lista de ámbito puede cargar bytes para una lista de permitidos explícita de identificadores de imagen.

• Parámetros:
  • message_id str | None: identificador opcional del mensaje que contiene esta parte de la imagen.
  • mime_type ImageMimeType: tipo MIME de la imagen. Esto siempre es necesario, incluso cuando se omite bytes del registro.
  • bytes builtins.bytes | None: datos de imágenes cuando la operación de recuperación lo solicita; de lo contrario, None.
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None

Registros de thread

clase oracleagentmemory.apis.records.ThreadRecord

Bases: ScopedRecord

Registro de almacén de ámbito de thread.

• Parámetros:
  • id str
  • contenido str | None
  • registro de hora str | None
  • metadatos MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • ID_usuario str | None
  • agent_id str | None
  • runtime_config dict[str, Any] | None
  • runtime_state dict[str, Any] | None

Ayudante

oracleagentmemory.apis.records.build_record

Creación de la implantación de registros más específica para una fila almacenada.

• Parámetros:
  • record_type str: etiqueta de tipo de registro canónico.
  • record_id str: identificador público estable para el registro.
  • content str | dict[str, object] | Sequence[MessageContent] | None: carga útil de registro opcional. Los registros de mensajes también pueden contener una secuencia ordenada de partes de contenido de mensajes estructurados.
  • thread_id str | None: identificador de ámbito de subproceso opcional para tipos de registro de ámbito.
  • user_id str | None: identificador de ámbito de usuario opcional para tipos de registro de ámbito.
  • agent_id str | None: identificador de ámbito de agente opcional para tipos de registro de ámbito.
  • role str | None: rol de chat opcional, que solo se utiliza para registros de mensajes.
  • seq_no int | None: número de secuencia de mensajes estable necesario para los registros de mensajes. Se ignora para otros tipos de registro.
  • timestamp str | None: registro de hora guardado para el registro. Representa el momento en que se creó el registro. Cuando se omite, las tiendas utilizan el tiempo que el registro se ha agregado a la tienda.
  • metadata dict[str, Any] | None: carga útil de metadatos opcional.
  • status RecordStatus: estado del ciclo de vida del registro. Almacena el valor por defecto en RecordStatus.VALID.
  • kwargs Any: argumentos de palabras clave adicionales para tipos de registro específicos.
• Devoluciones: la clase de registro más específica conocida por record_type.
• Tipo de valor devuelto: Registro