검색
이 페이지에서는 개발자 관련 범위 지정 도우미와 구체적인 Oracle 검색 결과 유형을 함께 제공합니다.
범위
클래스 oracleagentmemory.apis.scope.Scope
기준: object
정보 삽입 또는 검색에 대한 범위를 나타냅니다.
- 매개변수:
- user_id
str | None - agent_id
str | None - thread_id
str | None
- user_id
user_id
고객 ID입니다. NOT_SET_MARKER는 필드가 생략되었으며 작업별 기본값으로 해결되어야 함을 의미합니다. 명시적 None는 작업별 규칙에 따라 보존되고 해석됩니다. OracleAgentMemory.search()와 같은 상위 레벨의 클라이언트 API는 사용자 범위를 명시적으로 요구할 수 있습니다. 해당 API에서 None는 범위가 지정되지 않은 레코드만 대상으로 지정할 수 있습니다.
- 유형: str | None
에이전트 ID
에이전트 ID. NOT_SET_MARKER는 필드가 생략되었으며 작업별 기본값으로 해결되어야 함을 의미합니다. 명시적 None는 작업별 규칙에 따라 보존되고 해석됩니다.
- 유형: str | None
thread_id
스레드 ID. NOT_SET_MARKER는 필드가 생략되었으며 작업별 기본값으로 해결되어야 함을 의미합니다. 명시적 None는 작업별 규칙에 따라 보존되고 해석됩니다.
- 유형: str | None
클래스 oracleagentmemory.apis.searchscope.SearchScope
기준: Scope
검색 질의의 범위를 나타내므로 반환할 수 있는 항목을 제한합니다.
- 매개변수:
- user_id
str | None - agent_id
str | None - thread_id
str | None - exact_user_match
bool - exact_agent_match
bool - exact_thread_match
bool
- user_id
user_id
고객 ID입니다. 해결된 exact_user_match 값이 True인 경우 이 ID는 None를 포함하여 정확히 일치됩니다. False인 경우 사용자 차원이 제한되지 않습니다. NOT_SET_MARKER는 작업별 기본값으로 바뀝니다. OracleAgentMemory.search()와 같은 상위 레벨의 클라이언트 API는 사용자 범위를 명시적으로 요구할 수 있습니다. 해당 API에서 None는 exact_user_match가 True로 확인될 때 범위가 지정되지 않은 레코드만 대상으로 지정합니다.
- 유형: str | None
에이전트 ID
에이전트 ID. 해결된 exact_agent_match 값이 True인 경우 이 ID는 None를 포함하여 정확히 일치됩니다. False인 경우 에이전트 차원이 제한되지 않습니다. NOT_SET_MARKER는 범위를 사용하는 작업에 따라 기본값으로 바뀝니다.
- 유형: str | None
thread_id
스레드 ID. 해결된 exact_thread_match 값이 True인 경우 이 ID는 None를 포함하여 정확히 일치됩니다. False인 경우 스레드 차원이 제한되지 않습니다. NOT_SET_MARKER는 범위를 사용하는 작업에 따라 기본값으로 바뀝니다.
- 유형: str | None
정확한_사용자_일치
해결된 user_id와 정확히 일치할지 여부입니다. True는 None를 포함하여 정확히 일치합니다. False는 사용자 차원을 제약 없는 상태로 유지합니다. NOT_SET_MARKER는 작업에 따라 기본값으로 바뀝니다. OracleAgentMemory.search()와 같은 상위 레벨 클라이언트 API의 경우 이를 True로 유지해야 할 수 있습니다.
- 유형: bool
정확한_agent_일치
해결된 agent_id와 정확히 일치할지 여부입니다. True는 None를 포함하여 정확히 일치합니다. False는 에이전트 차원을 제약 없는 상태로 유지합니다. NOT_SET_MARKER는 작업에 따라 기본값으로 바뀝니다.
- 유형: bool
정확한_스레드_일치
해결된 thread_id와 정확히 일치할지 여부입니다. True는 None를 포함하여 정확히 일치합니다. False는 스레드 차원을 제약 없는 상태로 유지합니다. NOT_SET_MARKER는 작업에 따라 기본값으로 바뀝니다.
- 유형: bool
결과
클래스 oracleagentmemory.core.OracleSearchResult
기준: SearchResult
Oracle 스레드에서 반환된 검색 결과입니다.
- 매개변수:
- distance
float– 쿼리 벡터로부터의 거리입니다(더 작을수록 좋습니다). - record
Record– 지속된 항목에 대한 메타데이터 정보를 포함하는 레코드 객체입니다. - id
str | None– 저장된 레코드와 연관된 선택적 식별자입니다.
- distance
등록 정보 content
- 반품 유형: str
- 설명: 일치된 레코드에 대한 기본 텍스트 콘텐츠를 반환합니다.
등록 정보 formatted_content
- 반품 유형: str
- 설명: 프롬프트에 사용되는 기본 XML 안전 렌더링을 반환합니다.
재산 id
-
반품 유형: str 없음 - 설명: 일치된 레코드의 안정적인 식별자를 반환합니다(사용 가능한 경우).
등록 정보 metadata
-
반품 유형: dict[str, Any] 없음 - 설명: 레코드 메타데이터(사용 가능한 경우)를 반환합니다.
등록 정보 record
- 반품 유형: 레코드
- 설명: 일치된 레코드를 반환합니다.
방법 render_formatted_content
결과 컨텐트의 구조화된 XML 안전 표현을 반환합니다.
- 매개변수:
- show_thread_id
bool - show_distance
bool - show_timestamp
bool - show_role
bool - show_user_id
bool - show_agent_id
bool
- show_thread_id
- 반환 유형: str
등록 정보 timestamp
-
반품 유형: str 없음 - 설명: 가능한 경우 레코드 시간 기록을 반환합니다.