Loading
Gateway API:n määrittäminen ulkoisen tallennustilan haulle

Olet tässä:

  1. Salesforce-ohje
  2. Asiakirja
  3. Julkinen sektori

Gateway API:n määrittäminen ulkoisen tallennustilan haulle

Näytä Amazon Bedrock tai Amazon Kendra AWS API:n kautta, joka hyväksyy Salesforcen hakupyynnöt ja palauttaa tuettuja hakutuloksia.

Ennen kuin aloitat, määritä ja testaa Amazon Bedrock Knowledge -tietämyskanta tai Amazon Kendra -indeksi.

  1. Luo lambda-funktio, joka hyväksyy Ulkoinen tallennustila -haun pyynnön.
  2. Määritä funktio hyväksymään luonnollisen kielen kysely, Salesforce ContentDocument -tunnukset, lisäsuodattimet, tulosten enimmäismäärä ja haun kahva, jos sellainen on.
  3. Määritä funktio kyselemään valittua AWS-hakupalvelua ja käyttämään tuettuja suodattimia.
  4. Muunna jokainen tulos Salesforcen odottamiin vastauskenttiin.

    Vastauksen täytyy sisältää seuraavat arvot, jos sellainen on:

    Kenttä Tyyppi Kuvaus
    contentDocumentIds Merkkijonotaulukko Normalisoidut tunnukset contentDocumentId -metadatakentästä
    contentType Merkkijono tai null Tiedostotyyppi
    excerpt Merkkijono Täsmätyn osan content.teksti
    externalDocumentInfo2 Merkkijono Amazon S3 URI
    relevanceScore Numero Hakupalvelun palauttamat relevanttiuspisteet
    sourceUrl__c Merkkijono Amazon S3 URI
    title Merkkijono Amazon S3 URI -osoitteesta saatu tiedostonimi
    sivunumero Merkkijono tai null Sivunumero osan metadatasta
    startTimeMs Numero tai null Asiaankuuluva mediatason alkamisaika millisekunteina
    endTimeMs Numero tai null Asiaankuuluva median päättymisaika millisekunteina

    Katso Esimerkki input- ja output-vastauksesta.

  5. Myönnä lambda-suoritusroolin käyttöoikeus kysellä valittua hakupalvelua.
  6. Luo API-yhdyskäytävässä REST API.
  7. Luo hakuresurssi, kuten /search.
  8. Luo POST-metodi, joka käyttää Lambda-funktiota integraatiokohteenaan.
  9. Ota lambda-välityspalvelimen integrointi käyttöön.
  10. Määritä metodin valtuutukseksi AWS_IAM.
  11. Ota API käyttöön vaiheeseen, kuten prod.
  12. Tallenna kutsun URL.
  13. Luo IAM-pääkäyttäjä, jolla on gateway API:n kutsumisoikeus.
  14. Lähetä testipyyntö.
  15. Vahvista vastausten skeema, Salesforce-tiedostojen tunnukset, relevanttiuspisteet, koodikatkelmat ja lähdesijainnit.
  16. Gateway API on valmiina yhdistettäväksi Salesforceen.

Esimerkki input- ja output-vastauksesta 

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

Katso Bedrock-palvelun yksityiskohtaiset ohjeet näistä AWS-dokumentaation viiteoppaista:

Lisätietoja Kendra-palvelusta on näissä AWS-dokumentaation viitteissä:

 
Ladataan
Salesforce Help | Article