위치:
외부 저장소 검색을 위한 게이트웨이 API 구성
Salesforce 검색 요청을 수락하고 지원되는 검색 결과를 반환하는 AWS API를 통해 Amazon Bedrock 또는 Amazon Kendra를 표시합니다.
시작하기 전에 Amazon Bedrock Knowledge 자료 또는 Amazon Kendra 인덱스를 설정하고 테스트하십시오.
- 외부 저장소 검색 요청을 수용하는 람다 함수를 만듭니다.
- 해당하는 경우 자연어 쿼리, Salesforce ContentDocument ID, 추가 필터, 최대 결과 수, 검색 핸들을 허용하도록 함수를 구성합니다.
- 함수를 구성하여 선택한 AWS 검색 서비스를 쿼리하고 지원되는 필터를 적용합니다.
-
각 결과를 Salesforce에서 예상하는 응답 필드로 변환합니다.
해당하는 경우 응답에 다음 값이 포함되어야 합니다.
필드 유형 설명 contentDocumentIds 문자열 배열 contentDocumentId 메타데이터 필드의 정규화된 ID contentType 문자열 또는 null 파일 유형 excerpt 문자열 일치하는 청크의 content.text externalDocumentInfo2 문자열 Amazon S3 URI relevanceScore 숫자 검색 서비스에서 반환되는 관련성 점수 sourceUrl 문자열 Amazon S3 URI title 문자열 Amazon S3 URI에서 파생된 파일 이름 pageNumber 문자열 또는 null 청크 메타데이터의 페이지 번호 startTimeMs 숫자 또는 null 관련 미디어 시작 시간(밀리초 단위) endTimeMs 숫자 또는 null 관련 미디어 종료 시간(밀리초) 샘플 입력 및 출력 응답을 참조하십시오.
- 람다 실행 역할에 선택한 검색 서비스를 쿼리할 수 있는 권한을 부여합니다.
- API 게이트웨이에서 REST API를 만듭니다.
-
검색 자원을 만듭니다(예:
/search). - 람다 함수를 통합 대상으로 사용하는 POST 메서드를 만듭니다.
- 람다 프록시 통합을 활성화합니다.
- 메서드 권한 부여를 AWS_IAM으로 설정합니다.
-
prod등 스테이지에 API를 배포합니다. - 호출 URL을 기록합니다.
- 게이트웨이 API를 호출할 수 있는 권한이 있는 IAM 주체를 만듭니다.
- 테스트 요청을 보냅니다.
- 응답 스키마, Salesforce 파일 ID, 관련도 점수, 발췌 및 소스 위치를 확인합니다.
- 게이트웨이 API를 Salesforce에 연결할 준비가 되었습니다.
Here is a sample input:
{
"searchQuery": "Jason image",
"contentDocumentIds": [
"069xx0000004Dea",
"069LT000001BuuL",
"069xx0000004Deb",
"069LT000001Bv41"
],
"additionalFilters": {},
"maxResults": 100,
"searchHandle": null
}
Here is a sample output:
{
"executionTimeMs": 1720,
"hasMore": false,
"nextSearchHandle": null,
"results": [
{
"contentDocumentIds": [
"069xx0000004Dea",
"069xx0000004CIi"
],
"contentType": "PDF",
"excerpt": "Jason...",
"externalDocumentInfo2": "s3://my-bucket/Stockholm-Resume-Template-Simple.pdf",
"relevanceScore": 0.3837699,
"sourceUrl": "s3://my-bucket/Stockholm-Resume-Template-Simple.pdf",
"title": "Stockholm-Resume-Template-Simple.pdf",
"pageNumber": "1",
"startTimeMs": null,
"endTimeMs": null
},
{
"contentDocumentIds": [
"069LT000001BuuL"
],
"contentType": "MP3",
"excerpt": "",
"externalDocumentInfo2": "s3://my-bucket/__sfdcroot__/Case/500LT00000K5Ty5YAF/Hyde_1783590525379.mp3",
"relevanceScore": 0.3344161,
"sourceUrl": "s3://my-bucket/__sfdcroot__/Case/500LT00000K5Ty5YAF/Hyde_1783590525379.mp3",
"title": "Hyde_1783590525379.mp3",
"pageNumber": null,
"startTimeMs": 730,
"endTimeMs": 55110
},
{
"contentDocumentIds": [
"069xx0000004Deb"
],
"contentType": "MP4",
"excerpt": "",
"externalDocumentInfo2": "s3://my-bucket/Multi-File Edit.mp4",
"relevanceScore": 0.34692305,
"sourceUrl": "s3://my-bucket/Multi-File Edit.mp4",
"title": "Multi-File Edit.mp4",
"pageNumber": null,
"startTimeMs": 0,
"endTimeMs": 27849
},
{
"contentDocumentIds": [
"069LT000001Bv41"
],
"contentType": "PNG",
"excerpt": "The image describes...",
"externalDocumentInfo2": "s3://my-bucket/__sfdcroot__/Case/500LT00000K5Ty5YAF/image_1783590602375.png",
"relevanceScore": 0.3374139,
"sourceUrl": "s3://my-bucket/__sfdcroot__/Case/500LT00000K5Ty5YAF/image_1783590602375.png",
"title": "image_1783590602375.png",
"pageNumber": null,
"startTimeMs": null,
"endTimeMs": null
}
]
}
Bedrock 서비스에 대한 자세한 지침은 다음 AWS 문서 참조를 참조하십시오.
Kendra 서비스에 대한 자세한 지침은 다음 AWS 문서 참조를 참조하십시오.
- 샘플 입력 및 출력 응답
외부 저장소 검색 게이트웨이 API에 대한 샘플 요청 및 응답 페이로드를 검토합니다.
이 기사를 통해 문제를 해결했습니까?
개선을 위한 의견을 보내주세요.
