Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AMAZON.KendraSearchIntent

Per cercare documenti che hai indicizzato con Amazon Kendra, usa l'intento. AMAZON.KendraSearchIntent Quando Amazon Lex V2 non è in grado di determinare l'azione successiva in una conversazione con l'utente, attiva l'intento di ricerca.

AMAZON.KendraSearchIntentÈ disponibile solo nelle impostazioni locali in inglese (USA) (en-US) e nelle regioni Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon) ed Europa (Irlanda).

Amazon Kendra è machine-learning-based un servizio di ricerca che indicizza documenti in linguaggio naturale come PDF documenti o file di Microsoft Word. Può ricercare documenti indicizzati e restituire i seguenti tipi di risposte a una domanda:

Per un esempio di utilizzo di AMAZON.KendraSearchIntent, consulta Esempio: creazione di un FAQ bot per un indice Amazon Kendra.

Se configuri un AMAZON.KendraSearchIntent intento per il tuo bot, Amazon Lex V2 chiama l'intento ogni volta che non è in grado di determinare l'espressione dell'intento da parte dell'utente. Se non viene ricevuta alcuna risposta da Amazon Kendra, la conversazione continua come configurato nel bot.

Quando usi il AMAZON.KendraSearchIntent con lo AMAZON.FallbackIntent stesso bot, Amazon Lex V2 utilizza gli intenti come segue:

Esistono tre modi per inviare una richiesta AMAZON.KendraSearchIntent ad Amazon Kendra:

Per specificare il queryFilterString parametro quando crei un bot o per specificare il kendraQueryFilterString campo quando richiami l'delegateazione in una funzione Lambda di dialogo, specifichi una stringa che viene utilizzata come filtro degli attributi per la query Amazon Kendra. Se la stringa non è un filtro di attributo valido, si otterrà un'eccezione InvalidBotConfigException in fase di runtime. Per ulteriori informazioni sui filtri degli attributi, consulta Using document attributes to filter query nella Amazon Kendra Developer Guide.

Per avere il controllo sulla query che Amazon Lex V2 invia ad Amazon Kendra, puoi specificare una query kendraQueryRequestPayload nel campo della tua funzione Lambda. Se la query non è valida, Amazon Lex V2 restituisce un'InvalidLambdaResponseExceptioneccezione. Per ulteriori informazioni, consulta l'operazione di interrogazione nella Amazon Kendra Developer Guide.

Per un esempio di come utilizzare AMAZON.KendraSearchIntent, consulta Esempio: creazione di un FAQ bot per un indice Amazon Kendra.

IAMPolitica per Amazon Kendra Search

Per utilizzare l'AMAZON.KendraSearchIntentintento, è necessario utilizzare un ruolo che fornisca AWS Identity and Access Management (IAM) politiche che consentano ad Amazon Lex V2 di assumere un ruolo di runtime autorizzato a chiamare l'intento di Amazon Kendra. Query Le IAM impostazioni che utilizzi dipendono dal fatto che tu crei AMAZON.KendraSearchIntent utilizzando la console Amazon Lex V2 o utilizzando un AWS SDK o il AWS Command Line Interface (AWS CLI). Quando usi la console, puoi scegliere tra aggiungere l'autorizzazione per chiamare Amazon Kendra al ruolo collegato al servizio Amazon Lex V2 o utilizzare un ruolo specifico per chiamare l'operazione Amazon Kendra. Query Quando usi AWS CLI o un SDK per creare l'intento, devi usare un ruolo specifico per chiamare l'operazione. Query

Collegamento di autorizzazioni

Puoi utilizzare la console per associare le autorizzazioni per accedere all'operazione Query Amazon Kendra al ruolo predefinito collegato al servizio Amazon Lex V2. Quando associ le autorizzazioni al ruolo collegato al servizio, non devi creare e gestire un ruolo di runtime specifico per connetterti all'indice Amazon Kendra.

L'utente, il ruolo o il gruppo che usi per accedere alla console Amazon Lex V2 deve disporre delle autorizzazioni per gestire le politiche dei ruoli. Allega la seguente IAM policy al ruolo di accesso alla console. Quando si concedono queste autorizzazioni, il ruolo dispone delle autorizzazioni necessarie per modificare la policy del ruolo collegato ai servizi esistente.

{
"Version": "2012-10-17",
"Statement": [
    {
        "Effect": "Allow",
        "Action": [
            "iam:AttachRolePolicy",
            "iam:PutRolePolicy",
            "iam:GetRolePolicy"
        ],
        "Resource": "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexBots*"
    },
    {
        "Effect": "Allow",
        "Action": "iam:ListRoles",
        "Resource": "*"
    }
]
}

Specifica di un ruolo

Puoi usare la console AWS CLI, o il API per specificare un ruolo di runtime da usare quando chiami l'operazione Amazon Query Kendra.

L'utente, il ruolo o il gruppo che usi per specificare il ruolo di runtime deve disporre dell'iam:PassRoleautorizzazione. La policy seguente definisce l'autorizzazione. È possibile utilizzare le chiavi di contesto di condizione iam:AssociatedResourceArn e iam:PassedToService per limitare ulteriormente l'ambito delle autorizzazioni. Per ulteriori informazioni, consulta IAMe AWS STS Condition Context Keys nella Guida AWS Identity and Access Management per l'utente.

{
"Version": "2012-10-17",
"Statement": [
    {
        "Effect": "Allow",
        "Action": "iam:PassRole",
        "Resource": "arn:aws:iam::account:role/role"
    }
]
}

Il ruolo di runtime che Amazon Lex V2 deve utilizzare per chiamare Amazon Kendra deve disporre delle autorizzazioni. kendra:Query Quando utilizzi un IAM ruolo esistente per ottenere l'autorizzazione a chiamare l'operazione Amazon Query Kendra, al ruolo deve essere associata la seguente politica.

Puoi utilizzare la IAM console IAMAPI, il o il AWS CLI per creare una policy e associarla a un ruolo. Queste istruzioni utilizzano il AWS CLI per creare il ruolo e le politiche.

Puoi scegliere di aggiornare il ruolo collegato al servizio Amazon Lex V2 o di utilizzare un ruolo che hai creato quando crei il ruolo AMAZON.KendraSearchIntent per il tuo bot. La procedura seguente mostra come scegliere il IAM ruolo da utilizzare.

Utilizzo degli attributi di richiesta e di sessione come filtri

Per filtrare la risposta di Amazon Kendra agli elementi relativi alla conversazione corrente, utilizza gli attributi di sessione e richiesta come filtri aggiungendo queryFilterString il parametro quando crei il bot. Specifichi un segnaposto per l'attributo quando crei l'intento, quindi Amazon Lex V2 sostituisce un valore prima di chiamare Amazon Kendra. Per ulteriori informazioni sugli attributi di richiesta, consulta Impostazione degli attributi della richiesta. Per ulteriori informazioni sugli attributi di sessione, consulta Impostazione degli attributi della sessione.

Di seguito è riportato un esempio di queryFilterString parametro che utilizza una stringa per filtrare la query di Amazon Kendra.

"{"equalsTo": {"key": "City", "value": {"stringValue": "Seattle"}}}"

Di seguito è riportato un esempio di queryFilterString parametro che utilizza un attributo di sessione chiamato "SourceURI" per filtrare la query di Amazon Kendra.

"{"equalsTo": {"key": "SourceURI","value": {"stringValue": "[FileURL]"}}}"

Di seguito è riportato un esempio di queryFilterString parametro che utilizza un attributo request chiamato "DepartmentName" per filtrare la query di Amazon Kendra.

"{"equalsTo": {"key": "Department","value": {"stringValue": "((DepartmentName))"}}}"

I AMAZON.KendraSearchInteng filtri utilizzano lo stesso formato dei filtri di ricerca di Amazon Kendra. Per ulteriori informazioni, consulta Utilizzo degli attributi del documento per filtrare i risultati di ricerca nella guida per sviluppatori di Amazon Kendra.

La stringa del filtro di interrogazione utilizzata con AMAZON.KendraSearchIntent deve utilizzare lettere minuscole per la prima lettera di ogni filtro. Ad esempio, quanto segue è un filtro di interrogazione valido per. AMAZON.KendraSearchIntent

{
"andAllFilters": [
    {
        "equalsTo": {
            "key": "City",
            "value": {
                "stringValue": "Seattle"
            }
        }
    },
    {
        "equalsTo": {
            "key": "State",
            "value": {
                "stringValue": "Washington"
            }
        }
    }
]
}

Utilizzo della risposta di ricerca

Amazon Kendra restituisce la risposta a una ricerca in una risposta dalla dichiarazione di intento. IntentClosingSetting L'intento deve avere un'closingResponseistruzione a meno che una funzione Lambda non produca un messaggio di risposta di chiusura.

Amazon Kendra offre cinque tipi di risposte.

Le risposte vengono restituite in attributi request. Possono esserci fino a cinque risposte per ogni attributo, numerate da 1 a 5. Per ulteriori informazioni sulle risposte, consulta Tipi di risposta nella Amazon Kendra Developer Guide.

L'istruzione closingResponse deve avere uno o più gruppi di messaggi. Ogni gruppo di messaggi contiene uno o più messaggi. Ogni messaggio può contenere una o più variabili segnaposto che vengono sostituite da attributi di richiesta nella risposta di Amazon Kendra. Nel gruppo di messaggi deve essere presente almeno un messaggio in cui tutte le variabili del messaggio vengono sostituite dai valori degli attributi di richiesta nella risposta runtime oppure nel gruppo deve essere presente un messaggio senza variabili segnaposto. Gli attributi della richiesta sono impostati con doppie parentesi ("((" "))"). I seguenti messaggi del gruppo di messaggi corrispondono a qualsiasi risposta di Amazon Kendra:

Utilizzo di una funzione Lambda per gestire la richiesta e la risposta

L'AMAZON.KendraSearchIntentintent può utilizzare l'hook del codice di dialogo e il codice di evasione dell'ordine per gestire la richiesta ad Amazon Kendra e la risposta. Usa la funzione Dialog Code Hook Lambda quando desideri modificare la query che invii ad Amazon Kendra e la funzione Fulfillment code hook Lambda quando desideri modificare la risposta.

Creazione di una query con l'hook del codice di dialogo

Puoi utilizzare l'hook di codice di dialogo per creare una query da inviare ad Amazon Kendra. L'utilizzo dell'hook del codice di dialogo è facoltativo. Se non specifichi un hook di codice di dialogo, Amazon Lex V2 crea una query a partire dall'enunciato dell'utente e utilizza queryFilterString quello che hai fornito quando hai configurato l'intento, se ne hai fornito uno.

Puoi utilizzare due campi nella risposta del codice hook di dialogo per modificare la richiesta ad Amazon Kendra:

Dopo aver creato il filtro o la stringa di query, invii la risposta ad Amazon Lex V2 con il dialogAction campo della risposta impostato delegate su. Amazon Lex V2 invia la query ad Amazon Kendra e quindi restituisce la risposta alla query all'hook del codice di evasione dell'ordine.

Utilizzo dell'hook del codice di adempimento per la risposta

Dopo che Amazon Lex V2 invia una query ad Amazon Kendra, la risposta alla query viene restituita alla funzione Lambda di AMAZON.KendraSearchIntent adempimento. L'evento di input del code hook contiene la risposta completa di Amazon Kendra. I dati della query hanno la stessa struttura di quelli restituiti dall'operazione Amazon Query Kendra. Per ulteriori informazioni, consulta la sintassi della risposta alle query nella Amazon Kendra Developer Guide.

L'hook del codice di adempimento è facoltativo. Se non ne esiste uno o se il code hook non restituisce un messaggio nella risposta, Amazon Lex V2 utilizza l'closingResponseistruzione per le risposte.