레코드

이 페이지에는 Oracle 에이전트 메모리 저장소 및 검색 API에서 반환된 레코드 값 유형이 표시됩니다.

기본 레코드

클래스 oracleagentmemory.apis.records.Record

기준: object

메모리 저장소 및 검색 결과에서 기본 지속 레코드를 반환했습니다.

• 매개변수:
  • id str – 저장된 레코드에 대한 안정적인 식별자입니다.
  • record_type str – "message", "memory", "guideline", "fact", "preference", "thread", "user_profile" 또는 "agent_profile" 또는 "thread_summary"와 같은 논리적 레코드 유형입니다.
  • content str | None – 레코드에 대해 저장된 선택적 텍스트 페이로드입니다.
  • timestamp str | None – 레코드에 대해 저장된 시간 기록입니다. 레코드가 생성된 시기를 나타냅니다. 호출자 시간기록이 제공되지 않은 경우 점포는 레코드가 점포에 추가된 시간을 사용합니다.
  • 메타데이터 MetadataValue – 레코드에 연결된 선택적 JSON과 유사한 메타데이터 페이로드입니다.
  • status RecordStatus – 레코드의 수명 주기 상태입니다. 저장소의 기본값은 RecordStatus.VALID입니다.
  • linked_results Sequence tuple[[RecordRelation, Record]] – 그래프 확장 검색으로 연결된 관련 레코드입니다. 각 항목에는 저장된 관계와 이 관계를 통해 도달한 레코드가 포함됩니다. 그래프 확장 검색 외부에서 반환된 레코드의 순서가 비어 있습니다.

레코드 상태

클래스 oracleagentmemory.apis.records.RecordStatus

기준: str, Enum

지속 레코드의 수명 주기 상태입니다.

VALID는 일반 활성 상태입니다. INVALID는 애플리케이션이 검색에서 제외하도록 허용하는 동안 과거 사용에 대한 레코드를 보유합니다.

잘못된 = 'INVALID'

VALID = 'VALID'

범위가 지정된 레코드

클래스 oracleagentmemory.apis.records.ScopedRecord

기준: Record

공개 범위 식별자를 노출하는 지속 레코드입니다.

ScopedRecord는 thread_id, user_id 및 agent_id와 같은 범위 지정 속성이 공용 구성에 포함된 레코드 유형에 대한 공유 기본 클래스입니다. 일반적인 예로는 스레드, 메시지 및 메모리가 있습니다.

• 매개변수:
  • thread_id str | None – 레코드와 함께 저장된 선택적 스레드 범위 식별자입니다.
  • user_id str | None – 레코드와 함께 저장된 선택적 사용자 범위 식별자입니다.
  • agent_id str | None – 레코드와 함께 저장된 선택적 에이전트 범위 식별자입니다.
  • id str
  • record_type str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

메시지 레코드

클래스 oracleagentmemory.apis.records.MessageRecord

기준: ScopedRecord

저장된 채팅 메시지 레코드입니다.

content는 메시지 콘텐츠 부분의 문자열 또는 정렬된 시퀀스를 받아들입니다.

• 매개변수:
  • role str | None – 메시지와 연관된 선택적 역할(예: "user" 또는 "assistant")입니다.
  • content str | Sequence[MessageContent] – 직접 구성을 위한 메시지 텍스트 또는 TextContent 및 ImageContent 부품의 순서가 지정된 시퀀스입니다.
  • seq_no int – 안정적으로 필요하며 메시지 스레드 내에서 시퀀스 번호가 증가합니다. 간격이 허용됩니다. list_thread_messages() 범위 경계와 함께 사용하여 스레드 내역의 일부를 검색합니다.
  • id str
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

메모리 레코드

클래스 oracleagentmemory.apis.records.MemoryRecord

기준: ScopedRecord

영구 메모리 레코드입니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

지침 레코드

클래스 oracleagentmemory.apis.records.GuidelineRecord

기준: MemoryRecord

지침 레코드는 일반 메모리와 별도로 저장됩니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

팩트 레코드

클래스 oracleagentmemory.apis.records.FactRecord

기준: MemoryRecord

팩트 레코드는 일반 추억과 별도로 저장됩니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

기본설정 레코드

클래스 oracleagentmemory.apis.records.PreferenceRecord

기준: MemoryRecord

기본설정 레코드는 일반 메모리와 별도로 저장됩니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

사용자 프로파일 레코드

클래스 oracleagentmemory.apis.records.UserProfileRecord

기준: Record

범위가 지정되지 않은 사용자 프로파일 레코드입니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

에이전트 프로파일 레코드

클래스 oracleagentmemory.apis.records.AgentProfileRecord

기준: Record

범위가 지정되지 않은 에이전트 프로파일 레코드입니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]

이미지 레코드

클래스 oracleagentmemory.apis.records.ImageRecord

기준: ScopedRecord

지속 이미지 문서 레코드입니다.

이미지 바이트는 기본적으로 생략됩니다. 범위가 지정된 목록은 명시적 허용 목록 이미지 식별자에 대한 바이트를 로드할 수 있습니다.

• 매개변수:
  • message_id str | None – 이 이미지 부분을 포함하는 메시지의 선택적 식별자입니다.
  • mime_type ImageMimeType – 이미지의 MIME 유형입니다. 레코드에서 bytes를 생략하는 경우를 포함하여 항상 필요합니다.
  • bytes builtins.bytes | None – 검색 작업에서 요청하는 경우 이미지 데이터, 그렇지 않은 경우 None입니다.
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 RecordStatus
  • linked_results Sequence tuple[[RecordRelation, Record]]
  • thread_id str | None
  • user_id str | None
  • agent_id str | None

스레드 레코드

클래스 oracleagentmemory.apis.records.ThreadRecord

기준: ScopedRecord

스레드 범위의 저장소 레코드입니다.

• 매개변수:
  • id str
  • 콘텐츠 str | None
  • 시간 기록 str | None
  • 메타데이터 MetadataValue
  • 상태 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

도우미

oracleagentmemory.apis.records.build_record

내장 행에 대해 가장 구체적인 레코드 구현을 생성합니다.

• 매개변수:
  • record_type str – 표준 레코드 유형 레이블입니다.
  • record_id str – 레코드에 대한 안정적인 공용 식별자입니다.
  • content str | dict[str, object] | Sequence[MessageContent] | None – 선택적 레코드 페이로드입니다. 메시지 레코드에는 구조화된 메시지 콘텐츠 부분의 순서가 지정된 순서가 포함될 수도 있습니다.
  • thread_id str | None – 범위가 지정된 레코드 유형에 대한 선택적 스레드 범위 식별자입니다.
  • user_id str | None – 범위가 지정된 레코드 유형에 대한 선택적 사용자 범위 식별자입니다.
  • agent_id str | None – 범위가 지정된 레코드 유형에 대한 선택적 에이전트 범위 식별자입니다.
  • role str | None – 메시지 레코드에 대해서만 사용되는 선택적 채팅 역할입니다.
  • seq_no int | None – 메시지 레코드에 필요한 안정적인 메시지 시퀀스 번호입니다. 다른 레코드 유형에서는 무시됩니다.
  • timestamp str | None – 레코드에 대해 저장된 시간 기록입니다. 레코드가 생성된 시기를 나타냅니다. 생략할 경우 점포는 레코드가 점포에 추가된 시간을 사용합니다.
  • metadata dict[str, Any] | None – 선택적 메타데이터 페이로드입니다.
  • status RecordStatus – 레코드의 수명 주기 상태입니다. 저장소의 기본값은 RecordStatus.VALID입니다.
  • kwargs Any – 특정 레코드 유형에 대한 추가 키워드 인수입니다.
• 반환: record_type로 알려진 가장 구체적인 레코드 클래스입니다.
• 반품 유형: 레코드