AMAZON.QinConnectIntent - Guia do desenvolvedor

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AMAZON.QinConnectIntent

nota

Para usar recursos de IA generativa usando o Amazon Q In Connect, você deve preencher os seguintes pré-requisitos:

  1. Navegue até o console do Amazon Connect e crie sua instância. Se você ainda não tiver uma, consulte Comece a usar o Amazon Connect.

  2. Ative o Amazon Q in Connect para sua instância, consulte Habilitar o Amazon Q in Connect para sua instância.

AMAZÔNIA. QinConnectIntent responde às perguntas dos clientes usando a evolução aprimorada do LLM do Amazon Connect Wisdom, que fornece recomendações em tempo real para ajudar os clientes e agentes da central de atendimento a resolver os problemas dos clientes com rapidez e precisão. Essa intenção será ativada quando um enunciado não for classificado em nenhuma das outras intenções presentes no bot. Observe que essa intenção não será ativada para enunciados perdidos ao inferir um valor de slot. Uma vez reconhecido, o AMAZON. QinConnectIntent, usa o domínio Q in Connect especificado para pesquisar a base de conhecimento configurada e responder à pergunta do cliente.

nota

  • Você não pode usar a AMAZON. QinConnectIntent junto com Amazon.qn AIntent na mesma localidade do bot.

  • Se você selecionar outro idioma além do inglês americano, deverá personalizar as solicitações de autoatendimento (SELF_SERVICE_PRE_PROCESSINGeSELF_SERVICE_ANSWER_GENERATION) para responder no idioma especificado. Para obter mais informações sobre como personalizar sua solicitação, consulte Personalizar o Amazon Q no Connect.

Se você selecionar essa intenção, precisará configurar os campos a seguir e selecionar Salvar intenção para adicionar a intenção ao bot.

  • Configuração do Amazon Q In Connect - Forneça o nome de recurso da Amazon (ARN) do assistente Amazon Q in Connect. Padrão ARN do assistente:. ^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}$>

As respostas do QinConnectIntent serão armazenadas nos atributos da solicitação, conforme mostrado abaixo:

  • x-amz-lex:q-in-connect-response— A resposta da QinConnectIntent pergunta ou enunciado.

Atributos da sessão retornados de QinConnectIntent

A interação com a QinConnect intenção fornece dados adicionais sobre a conversa por meio dos atributos da sessão.

  1. x-amz-lex:q-in-connect:session-arn— Um identificador exclusivo para a sessão criada com o Amazon Q In Connect durante a conversa.

  2. x-amz-lex:q-in-connect:conversation-status— O status atual da conversa com o QinConnect assistente ou domínio. Há três valores possíveis para esse status:

    • CLOSED

    • READY

    • PROCESSING

  3. x-amz-lex:q-in-connect:conversation-status-reason— Fornece o motivo do status atual relatado com o atributo acima. Os possíveis motivos são os seguintes:

    • SUCCESS— Indica que o cliente não tem mais nada a perguntar e que a pergunta foi respondida com sucesso.

    • FAILED— Indica uma falha ao responder à pergunta do cliente. Isso se deve principalmente a falhas em entender a pergunta do cliente.

    • REJECTED— Indica que o assistente está se recusando a responder à pergunta do cliente e recomendando que a pergunta seja tratada fora da interação do bot, como conversar com uma pessoa ou agente, para obter mais informações.

nota

Quando um bot com QinConnectIntent é invocado durante interações com clientes conduzidas por uma instância do Amazon Connect, seu arn de sessão precisa ser criado e passado da instância do Amazon Connect. Para criar uma sessão, o Amazon Connect Flows pode ser configurado com o Amazon Q na etapa Connect.

Limitações

  • Você não pode usar a AMAZON. QinConnectIntent junto com intenções sem expressões específicas, como Amazon.qn, AMAZONAIntent. BedrockAgentIntent na mesma localidade do bot.

  • Quando um bot com QinConnectIntent é invocado durante uma interação com o cliente conduzida por uma instância do Amazon Connect, seu arn de sessão precisa ser criado e passado da instância do Amazon Connect. Para criar uma sessão, o Amazon Connect Flows pode ser configurado com a etapa Amazon Q In Connect.

  • Não pode haver mais do que uma AMAZON. QinConnectIntent por localidade do bot.

  • O domínio Amazon Q in Connect usado com a AMAZON. QinConnectIntent deve estar na mesma região da AWS que o bot Amazon Lex V2.

Permissões

Se o QinConnect Intent for usado em um bot do Amazon Lex V2 e o bot estiver usando uma função vinculada ao serviço (SLR), o serviço Amazon Lex V2 tem as permissões para atualizar as políticas apropriadas sobre a função para integrá-la ao assistente Q in Connect. Se o bot estiver usando uma função personalizada do IAM, o usuário precisaria adicionar manualmente essas permissões à função do IAM.

A função vinculada ao serviço será atualizada com as seguintes permissões se a QinConnect intenção for adicionada. Uma nova política será adicionada para QinConnect acesso:

{
    "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]/*"
            ]
        }
    ]
}

Política de confiança

{
    "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}/*"
        }
    }
}