Method: corpora.query
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Corpus
에 대해 시맨틱 검색을 수행합니다.
HTTP 요청
POST https://generativelanguage.googleapis.com/v1beta/{name=corpora/*}:query
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 |
name |
string
필수 항목입니다. 쿼리할 Corpus 의 이름입니다. 예: corpora/my-corpus-123
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"query": string,
"metadataFilters": [
{
object (MetadataFilter )
}
],
"resultsCount": integer
} |
필드 |
query |
string
필수 항목입니다. 시맨틱 검색을 수행할 쿼리 문자열입니다.
|
metadataFilters[] |
object (MetadataFilter )
선택사항입니다. Chunk 및 Document 메타데이터를 필터링합니다. 각 MetadataFilter 객체는 고유 키에 대응해야 합니다. 여러 MetadataFilter 객체가 논리적 'AND'로 결합됩니다. 문서 수준 검색어의 예: (2020년 >= 또는 2010년 <) AND (장르 = 드라마 OR 장르 = 액션) MetadataFilter object list: metadataFilters " [{key = "document.custom_metadata.year"condition = [{int_value = 2020, action = GREATER_EQUAL}, {int_value = 2010, job = LESS}]}, {key = "document. courses = <ph type="x-smartling-placeholder">{1}</ph> = <ph type="x-smartling-placeholder">{1}</ph> <ph type="x-smartling-placeholder">{1/}</ph> 객체 목록: metadata = '
숫자 값 범위에 대한 단위 수준의 쿼리 예: (연도 > 2015 AND 연도 <= 2020) MetadataFilter 객체 목록: metadataFilters = [ {key = "chunk.custom_metadata.year" terms = [{int_value = 2015, Operations = GREATER}]}, {key = "chunk.custom_metadata.year" terms = [{int_value = 2020, job = LESS_EQUAL}]}]
참고: 동일한 키에 대한 'AND'는 숫자 값에만 지원됩니다. 문자열 값은 동일한 키에 'OR'만 지원합니다.
|
resultsCount |
integer
선택사항입니다. 반환할 최대 Chunk 수입니다. 서비스에서 더 적은 Chunk 를 반환할 수도 있습니다. 지정하지 않으면 최대 10개의 Chunk 가 반환됩니다. 지정된 최대 결과 수는 100개입니다.
|
응답 본문
관련 청크 목록이 포함된 corpora.query
의 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
필드 |
relevantChunks[] |
object (RelevantChunk )
관련 청크
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
자세한 내용은 인증 개요를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-04-19(UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"필요한 정보가 없음"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"너무 복잡함/단계 수가 너무 많음"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"오래됨"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"번역 문제"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"샘플/코드 문제"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"기타"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"이해하기 쉬움"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"문제가 해결됨"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"기타"
}]