AMAZON.QinConnectIntent - Amazon Lex

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.QinConnectIntent

Nota

Per utilizzare le funzionalità di intelligenza artificiale generativa con Amazon Q In Connect, devi completare i seguenti prerequisiti:

  1. Accedi alla console Amazon Connect e crea la tua istanza. Se non ne hai già una, consulta la sezione Introduzione ad Amazon Connect.

  2. Abilita Amazon Q in Connect per la tua istanza, consulta Abilita Amazon Q in Connect per la tua istanza.

AMAZON. QinConnectIntent risponde alle domande dei clienti utilizzando l'evoluzione ottimizzata da LLM di Amazon Connect Wisdom che fornisce consigli in tempo reale per aiutare i clienti e gli agenti dei contact center a risolvere i problemi dei clienti in modo rapido e preciso. Questo intento si attiva quando un'enunciazione non è classificata in nessuno degli altri intenti presenti nel bot. Nota che questo intento non verrà attivato in caso di enunciazioni perse quando si ottiene un valore di slot. Una volta riconosciuto, AMAZON. QinConnectIntent, utilizza il dominio Q specificato in Connect per effettuare ricerche nella knowledge base configurata e rispondere alla domanda del cliente.

Nota

  • Non puoi usare AMAZON. QinConnectIntent insieme ad Amazon.qn AIntent nella stessa lingua del bot.

  • Se selezioni un'altra lingua oltre all'inglese americano, devi personalizzare i prompt self-service (SELF_SERVICE_PRE_PROCESSINGeSELF_SERVICE_ANSWER_GENERATION) per rispondere nella lingua specificata. Per ulteriori informazioni su come personalizzare il prompt, consulta Personalizza Amazon Q in Connect.

Se selezioni questo intento, devi configurare i seguenti campi e quindi selezionare Salva intento per aggiungere l'intento al bot.

  • Configurazione Amazon Q In Connect: fornisci l'Amazon Resource Name (ARN) dell'assistente Amazon Q in Connect. Assistente ARN Pattern:. ^arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}$>

Le risposte di QinConnectIntent verranno memorizzate negli attributi della richiesta come mostrato di seguito:

  • x-amz-lex:q-in-connect-response— La risposta QinConnectIntent alla domanda o all'enunciato.

Attributi di sessione restituiti da QinConnectIntent

L'interazione con l' QinConnect intento fornisce dati aggiuntivi sulla conversazione tramite gli attributi della sessione.

  1. x-amz-lex:q-in-connect:session-arn— Un identificatore univoco per la sessione creata con Amazon Q In Connect durante la conversazione.

  2. x-amz-lex:q-in-connect:conversation-status— Lo stato attuale della conversazione con l' QinConnect assistente o il dominio. Ci sono tre valori possibili per questo stato:

    • CLOSED

    • READY

    • PROCESSING

  3. x-amz-lex:q-in-connect:conversation-status-reason— Fornisce il motivo dello stato corrente riportato con l'attributo precedente. Le possibili ragioni sono le seguenti:

    • SUCCESS— Indica che il cliente non ha più nulla da chiedere e che alla domanda è stata data risposta con successo.

    • FAILED— Indica un errore durante la risposta alla domanda del cliente. Ciò è dovuto principalmente alla mancata comprensione della domanda del cliente.

    • REJECTED— Indica che l'assistente si rifiuta di rispondere alla domanda del cliente e raccomanda che la domanda venga gestita al di fuori dell'interazione con il bot, ad esempio parlando con una persona o un agente, per ottenere maggiori informazioni.

Nota

Quando QinConnectIntent viene richiamato un bot con durante le interazioni con i clienti guidate da un'istanza Amazon Connect, è necessario creare e trasmettere l'arn della sessione dall'istanza Amazon Connect. Per creare una sessione, Amazon Connect Flows può essere configurato con Amazon Q nella fase Connect.

Limitazioni

  • Non puoi usare AMAZON. QinConnectIntent insieme a intenti senza enunciazioni specifiche come Amazon.qn, AMAZONAIntent. BedrockAgentIntent nella stessa versione locale del bot.

  • Quando QinConnectIntent viene richiamato un bot con durante un'interazione con un cliente gestita da un'istanza Amazon Connect, è necessario creare e trasmettere l'arn della sessione dall'istanza Amazon Connect. Per creare una sessione, Amazon Connect Flows può essere configurato con la fase Amazon Q In Connect.

  • Non può esserci più di un AMAZON. QinConnectIntent per bot locale.

  • Il dominio Amazon Q in Connect utilizzato con AMAZON. QinConnectIntent deve trovarsi nella stessa regione AWS del bot Amazon Lex V2.

Autorizzazioni

Se l' QinConnect Intent viene utilizzato in un bot Amazon Lex V2 e il bot utilizza un Service Linked Role (SLR), il servizio Amazon Lex V2 dispone delle autorizzazioni per aggiornare le politiche appropriate sul ruolo per integrarlo con l'assistente Q in Connect. Se il bot utilizza un ruolo IAM personalizzato, l'utente deve aggiungere manualmente queste autorizzazioni al proprio ruolo IAM.

Il Service Linked Role verrà aggiornato con le seguenti autorizzazioni se l' QinConnect intento viene aggiunto. Verrà aggiunta una nuova politica per l' QinConnect accesso:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Sid": "QInConnectAssistantPolicy",
            "Action": [
                "wisdom:CreateSession",
                "wisdom:GetAssistant"
            ],
            "Resource": [
                "arn:aws:wisdom:*:{accountId}:assistant/[assistantId]",
                "arn:aws:wisdom:*:{accountId}:assistant/[assistantId]/*"
            ]
        },
        {
            "Effect": "Allow",
            "Sid": "QInConnectSessionsPolicy",
            "Action": [
                "wisdom:SendMessage",
                "wisdom:GetNextMessage"
            ],
            "Resource": [
                "arn:aws:wisdom:*:{accountId}:session/[assistantId]/*"
            ]
        }
    ]
}

Politica di fiducia

{
    "Effect": "Allow",
    "Sid": "LexV2InternalTrustPolicy",
    "Principal": {
        "Service": "lexv2.aws.internal"
    },
    "Action": "sts:AssumeRole",
    "Condition": {
        "StringEquals": {
            "aws:SourceAccount": "{accountId}"
        },
        "ArnLike": {
            "aws:SourceArn": "arn:aws:lex:*:{accountId}:bot-alias/{botId}/*"
        }
    }
}