Loading
Een Gateway-API configureren voor zoeken naar externe opslag

U bent hier:

  1. Help van Salesforce
  2. Documenten
  3. Openbare sector

Een Gateway-API configureren voor zoeken naar externe opslag

Stel Amazon Bedrock of Amazon Kendra beschikbaar via een AWS-API die Salesforce-zoekopdrachten accepteert en ondersteunde zoekresultaten retourneert.

Voordat u begint, stelt u een Amazon Bedrock Knowledge Base of Amazon Kendra-index in en test u deze.

  1. Maak een lambdafunctie die het verzoek Zoeken naar externe opslag accepteert.
  2. Configureer de functie voor het accepteren van een query met natuurlijke taal, Salesforce ContentDocument-ID's, extra filters, een maximale telling van resultaten en een zoekhandle, indien van toepassing.
  3. Configureer de functie voor het uitvoeren van een query op de geselecteerde AWS-zoekservice en het toepassen van ondersteunde filters.
  4. Transformeer elk resultaat naar de reactievelden die Salesforce verwacht.

    De respons moet deze waarden bevatten, zoals van toepassing:

    Veld Type Beschrijving
    contentDocumentIds Tekenreeksmatrix Genormaliseerde ID's uit het metagegevensveld contentDocumentId
    contentType Tekenreeks of null Bestandstype
    excerpt Tekenreeks Overeenkomende brok inhoud.tekst
    externalDocumentInfo2 Tekenreeks Amazon S3-URI
    relevanceScore Getal Relevantiescore geretourneerd door de zoekservice
    sourceUrl Tekenreeks Amazon S3-URI
    title Tekenreeks Bestandsnaam afgeleid van de Amazon S3 URI
    pageNumber Tekenreeks of null Paginanummer uit metagegevens in blokken
    startTimeMs Getal of null Relevante mediabegintijd in milliseconden
    endTimeMs Getal of null Relevante media-eindtijd in milliseconden

    Zie Voorbeeld van invoer- en uitvoerrespons.

  5. Verleen de machtiging Lambda-uitvoeringsrol om een query uit te voeren op de geselecteerde zoekservice.
  6. Maak in API Gateway een REST-API.
  7. Maak een zoekresource, zoals /search.
  8. Maak een POST-methode die de Lambda-functie als integratiedoel gebruikt.
  9. Schakel Lambda-proxy-integratie in.
  10. Stel de methodeautorisatie in op AWS_IAM.
  11. Implementeer de API naar een fase, zoals prod.
  12. Noteer de URL voor aanroepen.
  13. Maak een IAM-principal met de machtiging om de gateway-API aan te roepen.
  14. Verzend een testverzoek.
  15. Controleer het reactieschema, Salesforce-bestands-ID's, relevantiescores, uittreksels en bronlocaties.
  16. De gateway-API is gereed om verbinding te maken met Salesforce.

Voorbeeld van invoer- en uitvoerrespons 

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
        }
    ]
}

Zie deze AWS-documentatieverwijzingen voor gedetailleerde instructies voor de Bedrock-service:

Zie deze AWS-documentatieverwijzingen voor gedetailleerde instructies voor de Kendra-service:

 
Wordt geladen
Salesforce Help | Article