Record

Questa pagina presenta i tipi di valore dei record restituiti dalle aree di memorizzazione della memoria di Oracle Agent e le API di ricerca.

Record base

classe oracleagentmemory.apis.records.Record

Basi: object

Record persistente di base restituito dalle aree di memorizzazione e dai risultati della ricerca.

• Parametri:
  • id str: identificativo stabile per il record memorizzato.
  • record_type str: tipo di record logico "message", "memory", "guideline", "fact", "preference", "thread", "user_profile" o "agent_profile" o "thread_summary".
  • content str | None: payload testuale facoltativo memorizzato per il record.
  • Indicatore data/ora str | None: data/ora salvata per il record. Rappresenta la data di creazione del record. Quando non è stato fornito alcun indicatore orario del chiamante, i negozi utilizzano l'ora in cui il record è stato aggiunto al negozio.
  • metadati MetadataValue: payload dei metadati facoltativo simile a JSON allegato al record.
  • stato RecordStatus: stato del ciclo di vita del record. Il valore predefinito dei negozi è RecordStatus.VALID.
  • linked_results Sequence tuple[[RecordRelation, Record]]: record correlati allegati da una ricerca espansa nel grafico. Ogni elemento contiene la relazione memorizzata e il record raggiunto attraverso di essa. I record restituiti al di fuori della ricerca con espansione del grafico hanno una sequenza vuota.

Stato record

classe oracleagentmemory.apis.records.RecordStatus

Basi: str, Enum

Stato del ciclo di vita di un record persistente.

VALID è lo stato attivo normale. INVALID conserva un record per uso cronologico e consente alle applicazioni di escluderlo dal recupero.

NON VALIDO = 'non valido'

VALIDO = 'valido'

Record con ambito

classe oracleagentmemory.apis.records.ScopedRecord

Basi: Record

Record persistente che espone gli identificativi di ambito pubblico.

ScopedRecord è la classe di base condivisa per i tipi di record la cui forma pubblica include attributi di ambito quali thread_id, user_id e agent_id. Esempi tipici sono thread, messaggi e memorie.

• Parametri:
  • thread_id str | None: identificativo facoltativo dell'ambito dei thread memorizzato con il record.
  • user_id str | None: identificativo facoltativo dell'ambito utente memorizzato nel record.
  • agent_id str | None: identificativo facoltativo dell'ambito dell'agente memorizzato nel record.
  • ID str
  • tipo_record str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Record messaggio

classe oracleagentmemory.apis.records.MessageRecord

Basi: ScopedRecord

Record messaggio chat memorizzato.

content accetta una stringa o una sequenza ordinata di parti di contenuto dei messaggi.

• Parametri:
  • ruolo str | None: ruolo facoltativo associato al messaggio, ad esempio "user" o "assistant".
  • content str | Sequence[MessageContent]: testo del messaggio per la costruzione diretta o sequenza ordinata di parti TextContent e ImageContent.
  • seq_no int: stabile richiesto, numero di sequenza crescente nel thread del messaggio. Sono consentite lacune. Utilizzarlo con i limiti dell'intervallo list_thread_messages() per recuperare una parte della cronologia di un thread.
  • ID str
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None

Record di memoria

classe oracleagentmemory.apis.records.MemoryRecord

Basi: ScopedRecord

Record di memoria durevole.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None

Record linee guida

classe oracleagentmemory.apis.records.GuidelineRecord

Basi: MemoryRecord

Record della linea guida memorizzato separatamente dalle memorie generali.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None

Record fact

classe oracleagentmemory.apis.records.FactRecord

Basi: MemoryRecord

Record fact memorizzato separatamente dalle memorie generali.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None

Record preferenze

classe oracleagentmemory.apis.records.PreferenceRecord

Basi: MemoryRecord

Record delle preferenze memorizzato separatamente dalle memorie generali.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None

Record profilo utente

classe oracleagentmemory.apis.records.UserProfileRecord

Basi: Record

Record profilo utente senza ambito.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Record profilo agente

classe oracleagentmemory.apis.records.AgentProfileRecord

Basi: Record

Record profilo agente senza ambito.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

Record immagine

classe oracleagentmemory.apis.records.ImageRecord

Basi: ScopedRecord

Record documento immagine persistente.

I byte delle immagini vengono omessi per impostazione predefinita. Una lista con ambito può caricare i byte per una lista di inclusione esplicita di identificatori di immagine.

• Parametri:
  • message_id str | None: identificativo facoltativo del messaggio contenente la parte immagine.
  • mime_type ImageMimeType – tipo MIME dell'immagine. Questa operazione è sempre obbligatoria, anche se bytes viene omesso dal record.
  • byte builtins.bytes | None: dati dell'immagine quando richiesti dall'operazione di recupero; altrimenti, None.
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None

Record thread

classe oracleagentmemory.apis.records.ThreadRecord

Basi: ScopedRecord

Record negozio con ambito thread.

• Parametri:
  • ID str
  • contenuto str | None
  • indicatore orario str | None
  • metadati MetadataValue
  • Stato RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • id_thread str | None
  • ID_utente str | None
  • id_agente str | None
  • config_runtime dict[str, Any] | None
  • stato_runtime dict[str, Any] | None

Applicazione di supporto

oracleagentmemory.apis.records.build_record

Costruisce l'implementazione di record più specifica per una riga memorizzata.

• Parametri:
  • record_type str: etichetta del tipo di record canonico.
  • record_id str: identificativo pubblico stabile per il record.
  • content str | dict[str, object] | Sequence[MessageContent] | None: payload dei record facoltativo. I record dei messaggi possono anche contenere una sequenza ordinata di parti di contenuto dei messaggi strutturati.
  • thread_id str | None: identificativo facoltativo dell'ambito dei thread per i tipi di record con ambito.
  • user_id str | None: identificativo facoltativo dell'ambito utente per i tipi di record con ambito.
  • agent_id str | None: identificativo facoltativo dell'ambito dell'agente per i tipi di record con ambito.
  • ruolo str | None: ruolo chat facoltativo, utilizzato solo per i record dei messaggi.
  • seq_no int | None: numero di sequenza dei messaggi stabile richiesto per i record dei messaggi. Viene ignorato per altri tipi di record.
  • Indicatore data/ora str | None: data/ora salvata per il record. Rappresenta la data di creazione del record. Se omesso, i negozi utilizzano l'ora in cui il record è stato aggiunto al negozio.
  • metadata dict[str, Any] | None: payload dei metadati facoltativo.
  • stato RecordStatus: stato del ciclo di vita del record. Il valore predefinito dei negozi è RecordStatus.VALID.
  • kwargs Any – Argomenti parola chiave aggiuntivi per tipi di record specifici.
• Restituzioni: la classe di record più specifica nota per record_type.
• Tipo restituito: record