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", "agent_profile" ou "thread_summary".
  • content str | None – Payload textual opcional armazenado para o registro.
  • timestamp str | None – Timestamp salvo para o registro. Ele representa quando o registro foi criado. Quando nenhum timestamp de chamador foi fornecido, as lojas usam o horário em que o registro foi adicionado à loja.
  • metadata MetadataValue – payload de metadados semelhante ao JSON opcional anexado ao registro.
  • status RecordStatus – Status do ciclo de vida do registro. Armazena o padrão para RecordStatus.VALID.
  • linked_results Sequence tuple[[RecordRelation, Record]] – Registros relacionados anexados pela pesquisa expandida por gráfico. Cada item contém a relação armazenada e o registro alcançado por meio dela. Os registros retornados fora da pesquisa expandida por gráfico têm uma sequência vazia.

Status de Registro

classe oracleagentmemory.apis.records.RecordStatus

Bases: str, Enum

Status do ciclo de vida de um registro persistente.

VALID é o status ativo normal. INVALID retém um registro para uso histórico, permitindo que os aplicativos o excluam da recuperação.

INVALID = 'inválido'

VÁLIDO = 'válido'

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

Registros de Mensagem

classe oracleagentmemory.apis.records.MessageRecord

Bases: ScopedRecord

Registro de mensagem de bate-papo armazenado.

content aceita uma string ou uma sequência ordenada de partes do conteúdo da mensagem.

• Parâmetros:
  • função str | None – Função opcional associada à mensagem, como "user" ou "assistant".
  • content str | Sequence[MessageContent] – Texto da mensagem para construção direta ou uma sequência ordenada de partes de TextContent e ImageContent.
  • seq_no int – É necessário um número de sequência estável e crescente dentro do thread da mensagem. Lacunas são permitidas. Use-o com limites de faixa list_thread_messages() para recuperar uma parte do histórico de um thread.
  • id str
  • marcador de data/hora str | None
  • metadados MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • id_usuário str | None
  • id_agente 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 MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de Diretriz

classe oracleagentmemory.apis.records.GuidelineRecord

Bases: MemoryRecord

Registro de diretrizes armazenado separadamente das memórias gerais.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de Fato

classe oracleagentmemory.apis.records.FactRecord

Bases: MemoryRecord

Registro de fatos armazenado separadamente das memórias gerais.

• Parâmetros:
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None

Registros de preferência

classe oracleagentmemory.apis.records.PreferenceRecord

Bases: MemoryRecord

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

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

Registros de imagem

classe oracleagentmemory.apis.records.ImageRecord

Bases: ScopedRecord

Registro de documento de imagem persistente.

Bytes de imagem são omitidos por padrão. Uma listagem com escopo pode carregar bytes para uma lista de permissões explícita de identificadores de imagem.

• Parâmetros:
  • message_id str | None – Identificador opcional da mensagem que contém essa parte da imagem.
  • mime_type ImageMimeType – tipo MIME da imagem. Isso é sempre obrigatório, inclusive quando bytes é omitido do registro.
  • bytes builtins.bytes | None – Os dados da imagem quando solicitados pela operação de recuperação; caso contrário, None.
  • id str
  • conteúdo str | None
  • marcador de data/hora str | None
  • metadados MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | 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 MetadataValue
  • status RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • id_usuário str | None
  • id_agente str | None
  • runtime_config dict[str, Any] | None
  • runtime_state 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 | dict[str, object] | Sequence[MessageContent] | None – Payload de registro opcional. Os registros de mensagem também podem conter uma sequência ordenada de partes de conteúdo de mensagem estruturada.
  • 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.
  • seq_no int | None – Número de sequência de mensagem estável necessário para registros de mensagem. Ele é ignorado para outros tipos de registro.
  • timestamp str | None – Timestamp salvo para o registro. Ele representa quando o registro foi criado. Quando omitidas, as lojas utilizam a hora em que o registro foi adicionado à loja.
  • metadados dict[str, Any] | None – Payload de metadados opcional.
  • status RecordStatus – Status do ciclo de vida do registro. Armazena o padrão para RecordStatus.VALID.
  • 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