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 no Connect, você deve preencher os seguintes pré-requisitos:

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

  2. Habilite o Amazon Q no Connect para a instância. Consulte Habilitar o Amazon Q no Connect para a 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 Amazon Bedrock 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 selecionar outro idioma além do inglês dos EUA, você deverá personalizar os prompts de autoatendimento (SELF_SERVICE_PRE_PROCESSING e SELF_SERVICE_ANSWER_GENERATION) para responder no idioma especificado. Para obter mais informações sobre como personalizar o prompt, consulte Personalizar o Amazon Q no Connect.

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

  • Configuração do Amazon Q no Connect: informe o nome do recurso da Amazon (ARN) do assistente do 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 no 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. Existem três valores possíveis para este 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 motivos possíveis são os seguintes:

    • SUCCESS: indica que o cliente não tem mais nada a perguntar e que a pergunta foi respondida com êxito.

    • FAILED: indica uma falha durante a resposta à 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 a pessoa ou o atendente, para obter mais informações.

nota

Quando um bot com QinConnectIntent é invocado durante interações com o cliente 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, os fluxos do Amazon Connect podem ser configurados com a etapa do Amazon Q no 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, os fluxos do Amazon Connect podem ser configurados com a etapa do Amazon Q no 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 estivesse usando um perfil do IAM personalizado, o usuário precisaria adicionar manualmente essas permissões ao perfil 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:

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