Registros

Esta página apresenta os tipos de valor de registro retornados pelos armazenamentos de Memória do Agente Oracle e APIs de pesquisa.

Registro base

classe oracleagentmemory.apis.records.Record

Bases: object

Registro de base persistente retornado por armazenamentos de memória e resultados de pesquisa.

• Parâmetros:
  • id str – Identificador estável para o registro armazenado.
  • record_type str – Tipo de registro lógico como "message", "memory", "guideline", "fact", "preference", "thread", "user_profile" ou "agent_profile".
  • content str | None – Payload textual opcional armazenado para o registro.
  • timestamp str | None – Timestamp de evento opcional associado ao registro.
  • metadata dict[str, Any] | None – payload de metadados semelhante ao JSON opcional anexado ao registro.

Registro com Escopo

classe oracleagentmemory.apis.records.ScopedRecord

Bases: Record

Registro persistente que expõe identificadores de escopo público.

ScopedRecord é a classe base compartilhada para tipos de registro cuja forma pública inclui atributos de escopo como thread_id, user_id e agent_id. Exemplos típicos são tópicos, mensagens e memórias.

• Parâmetros:
  • thread_id str | None – Identificador de escopo de thread opcional armazenado com o registro.
  • user_id str | None – Identificador de escopo de usuário opcional armazenado com o registro.
  • agent_id str | None – Identificador de escopo de agente opcional armazenado com o registro.
  • id str
  • tipo_registro str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None

Registros de Mensagem

classe oracleagentmemory.apis.records.MessageRecord

Bases: ScopedRecord

Registro de mensagem de bate-papo.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None
  • função str | None

Registros de memória

classe oracleagentmemory.apis.records.MemoryRecord

Bases: ScopedRecord

Registro de memória durável.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de Diretriz

classe oracleagentmemory.apis.records.GuidelineRecord

Bases: ScopedRecord

Registro de diretrizes armazenado separadamente das memórias gerais.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de Fato

classe oracleagentmemory.apis.records.FactRecord

Bases: ScopedRecord

Registro de fatos armazenado separadamente das memórias gerais.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de preferência

classe oracleagentmemory.apis.records.PreferenceRecord

Bases: ScopedRecord

Registro de preferência armazenado separadamente das memórias gerais.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de Perfil do Usuário

classe oracleagentmemory.apis.records.UserProfileRecord

Bases: Record

Registro de perfil de usuário sem escopo.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None

Registros de Perfil do Agente

classe oracleagentmemory.apis.records.AgentProfileRecord

Bases: Record

Registro de perfil do agente sem escopo.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None

Registros de Thread

classe oracleagentmemory.apis.records.ThreadRecord

Bases: ScopedRecord

Registro de armazenamento com escopo de thread.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados dict[str, Any] | None
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None
  • runtime_config dict[str, Any] | None

Auxiliador

oracleagentmemory.apis.records.build_record

Construir a implementação de registro mais específica para uma linha armazenada.

• Parâmetros:
  • record_type str – Rótulo de tipo de registro canônico.
  • record_id str – Identificador público estável para o registro.
  • content str | None – Payload textual opcional.
  • thread_id str | None – Identificador de escopo de thread opcional para tipos de registro com escopo.
  • user_id str | None – Identificador de escopo de usuário opcional para tipos de registro com escopo.
  • agent_id str | None – Identificador de escopo de agente opcional para tipos de registro com escopo.
  • função str | None – Função de chat opcional, usada apenas para registros de mensagem.
  • timestamp str | None – Timestamp de evento opcional.
  • metadados dict[str, Any] | None – Payload de metadados opcional.
  • kwargs Any – Argumentos de palavra-chave adicionais para tipos de registro específicos.
• Retorna: A classe de registro mais específica conhecida por record_type.
• Tipo da devolução: Registro