Вы находитесь здесь:
Настройка API шлюза для внешнего поиска хранилища
Представьте Amazon Bedrock или Amazon Kendra посредством AWS API, который принимает поисковые запросы Salesforce и возвращает поддерживаемые результаты поиска.
Перед началом настройте и протестируйте базу знаний Amazon Bedrock Knowledge или индекс Amazon Kendra.
- Создайте лямбда-функцию, принимающую запрос поиска внешнего хранилища.
- Настройте функцию на принятие естественно-языкового запроса, кодов Salesforce ContentDocument, дополнительных фильтров, максимального количества результатов и ручки поиска, в зависимости от обстоятельств.
- Настройте функцию для запроса выбранной службы поиска AWS и применения поддерживаемых фильтров.
-
Трансформируйте каждый результат в поля ответа, ожидаемые Salesforce.
Ответ должен содержать следующие значения, в зависимости от обстоятельств:
Поле Тип Описание contentDocumentIds Массив строк Нормализованные коды из поля метаданных contentDocumentId contentType Строка или ноль Тип файла отрывок Строка Соотнесенное содержимое.текст фрагмента externalDocumentInfo2 Строка URI Amazon S3 relevanceScore Число Оценка релевантности, возвращенная поисковой службой sourceUrl Строка URI Amazon S3 название Строка Имя файла, производное от Amazon S3 URI pageNumber Строка или ноль Номер страницы из метаданных фрагмента startTimeMs Число или ноль Соответствующее медиа-время начала в миллисекундах endTimeMs Число или ноль Соответствующее медиа-время окончания в миллисекундах - Предоставьте полномочие роли лямбда-выполнения для запроса выбранной службы поиска.
- В шлюзе API создайте REST API.
-
Создайте поисковый ресурс (например,
/search). - Создайте метод POST, использующий лямбда-функцию в качестве цели интеграции.
- Включите интеграцию лямбда-прокси.
- Установите авторизацию метода на AWS_IAM.
-
Разверните API на этапе (например,
prod). - Запишите URL-адрес вызова.
- Создайте субъект IAM с полномочием на вызов API шлюза.
- Отправьте тестовый запрос.
- Проверьте схему ответа, коды файлов Salesforce, рейтинги релевантности, фрагменты и расположения источников.
- 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 шлюза поиска внешнего хранилища.
Эта статья решила вашу проблему?
Оставьте свой отзыв, чтобы мы могли стать лучше!
