Criar agentes de IA no Amazon Connect - Amazon Connect
Como criar agentes de IAAssociar um agente de IA a um fluxoExemplos de comandos da CLI

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

Criar agentes de IA no Amazon Connect

Um agente de IA é um recurso do Amazon Q in Connect que configura e personaliza a experiência do end-to-end Amazon Q in Connect. Por exemplo, o agente de IA diz ao Assistente de IA como lidar com uma pesquisa manual: quais prompts e barreiras de proteção de IA ele deve usar e qual localidade usar para a resposta.

O Amazon Q no Connect fornece um agente de IA do sistema para cada caso de uso:

  • Recomendação de resposta

  • Pesquisa manual

  • Autoatendimento

  • Visão geral de e-mails

  • Resposta generativa para e-mails

Os agentes de IA do sistema são preenchidos com os prompts de IA padrão para cada caso de uso.

Por exemplo, a imagem a seguir mostra uma experiência do Amazon Q no Connect que está configurada para usar agentes de IA personalizados para recomendações de respostas e pesquisas manuais, mas usa o agente de IA padrão do sistema para casos de uso de autoatendimento.

Os agentes de IA padrão especificados para uma experiência Amazon Q no Connect.

Veja como os agentes de IA personalizados funcionam:

  • Você pode substituir um ou mais agentes de IA do sistema por agentes de IA personalizados.

  • Seu agente de IA personalizado se torna padrão para o caso de uso especificado.

  • Ao criar um agente de IA personalizado, você pode especificar um ou mais prompts de IA personalizados e uma barreira de proteção.

  • A maioria dos casos de uso (Recomendação de resposta, Autoatendimento, Resposta de e-mail e Resposta generativa para e-mails) oferece suporte a dois tipos de prompts de IA. Se você optar por criar um prompt de IA para um tipo, mas não para o outro, o agente de IA continuará usando o padrão do sistema para o prompt de IA que você não substituiu. Dessa forma, você pode optar por substituir apenas partes específicas da experiência padrão do Amazon Q no Connect.

Como criar agentes de IA

  1. Faça login no site do Amazon Connect administrador em https://instance name.my.connect.aws/. Use uma conta de administrador ou uma conta com permissão para Amazon Q - Agentes de IA - Criar em seu perfil de segurança.

  2. No menu de navegação, escolha Amazon Q e Agentes de IA.

  3. Na página Agentes de IA, escolha Criar agente de IA.

  4. Na caixa de diálogo Criar agente de IA, em Tipo de agente de IA, use a caixa suspensa para escolher um dos seguintes tipos:

    • Recomendação de resposta: um agente de IA que impulsiona as recomendações automáticas baseadas em intenção que são enviadas aos agentes quando eles entram em contato com os clientes. Usa os seguintes tipos de prompt de IA:

      • Geração de rotulagem intencional: prompt de IA que gera as intenções para que o atendente do serviço de atendimento ao cliente possa escolher como primeira etapa.

      • Reformulação de consultas: prompt de IA após a escolha de uma intenção. Esse prompt é usado para formular uma consulta apropriada, que é então usada para buscar trechos relevantes da base de conhecimento.

      • Geração de respostas: a consulta gerada e os trechos são inseridos neste prompt usando as variáveis $.query e $.contentExcerpt, respectivamente.

    • Pesquisa manual: um agente de IA que produz soluções em resposta às pesquisas sob demanda iniciadas por um atendente. Usa o tipo de prompt de IA de Geração de respostas.

    • Autoatendimento: um agente de IA produz soluções para autoatendimento. Usa os tipos de prompt de IA de Geração de respostas por autoatendimento e Pré-processamento por autoatendimento.

    • Resposta de e-mail: um agente de IA que facilita o envio de uma resposta por e-mail de um script de conversa ao cliente final.

    • Visão geral de e-mails: um agente de IA que fornece uma visão geral do conteúdo do e-mail.

    • Resposta generativa para e-mails: um agente de IA que gera respostas a e-mails.

    Importante

    Recomendação de resposta e Autoatendimento oferecem suporte a dois tipos de prompt de IA. Se você optar por criar um prompt de IA para um tipo, mas não para o outro, o agente de IA continuará usando o padrão do sistema para o prompt que você não substituiu. Dessa forma, você pode optar por substituir apenas partes específicas da experiência padrão do Amazon Q no Connect.

  5. Na página Construtor de agentes, você pode especificar a localidade a ser usada para a resposta. Para obter uma lista das localidades compatíveis, consulte Códigos de localidades compatíveis.

    Você pode escolher a localidade para os tipos de agentes de IA de Recomendação de resposta, Pesquisa manual, Resposta de e-mail, Visão geral de e-mails e Resposta generativa para e-mails. Não é possível escolher a localidade para Autoatendimento; somente o inglês é compatível.

  6. Escolha os prompts de IA pelos quais deseja substituir os padrões. Observe que você está escolhendo uma versão publicada do prompt de IA, não apenas um prompt de IA salvo. Se desejar, adicione uma barreira de proteção de IA ao seu agente de IA.

    nota

    Se você não substituir especificamente um prompt de IA padrão por um personalizado, o padrão continuará sendo usado.

  7. Escolha Salvar. Você pode continuar atualizando e salvando o agente de IA até ter certeza de que está concluído.

  8. Para disponibilizar a nova versão do agente de IA como possível padrão, escolha Publicar.

Associar um agente de IA a um fluxo

Para usar a funcionalidade padrão do out-of-the-box Amazon Q in Connect, você adiciona um Amazon Q no Connect bloco aos seus fluxos. Esse bloco associa o Assistente ao mapeamento padrão dos agentes de IA.

Para substituir esse comportamento padrão, crie uma função do Lambda e use o bloco Função AWS Lambda para adicioná-la aos seus fluxos.

Exemplos de comandos da CLI para criar e gerenciar agentes de IA

Esta seção fornece vários exemplos de comandos da AWS CLI para ajudá-lo a criar e gerenciar agentes de IA.

Criar um agente de IA que use todas as versões de prompts de IA personalizados

O Amazon Q no Connect usa a versão do prompt de IA para sua funcionalidade, caso haja uma especificada para um agente de IA. Caso contrário, assume o comportamento do sistema por padrão.

Use o exemplo de comando da AWS CLI a seguir para criar um agente de IA que usa todas as versões personalizadas do prompt de IA para recomendações de respostas.


aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "intentLabelingGenerationAIPromptId": "<INTENT_LABELING_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "queryReformulationAIPromptId": "<QUERY_REFORMULATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

Configurar parcialmente um agente de IA

É possível configurar parcialmente um agente de IA especificando que ele deve usar algumas versões de prompts de IA personalizados. Para o que não for especificado, ele usará os prompts de IA padrão.

Use o exemplo de comando da AWS CLI a seguir para criar um agente de IA de recomendação de respostas que usa uma versão personalizada do prompt de IA e permite que os padrões do sistema cuidem do resto. 


aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

Configurar uma versão de prompt de IA para pesquisas manuais

O tipo de agente de IA de pesquisa manual tem apenas uma versão de prompt de IA, portanto, não há nenhuma configuração parcial possível.

Use o exemplo de comando da AWS CLI a seguir para especificar uma versão do prompt de IA para pesquisa manual.


aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

Usar agentes de IA para substituir a configuração da base de conhecimento

É possível usar agentes de IA para configurar quais associações de assistentes o Amazon Q no Connect deve usar e como deve usá-las. A associação compatível com a personalização é a base de conhecimento, que permite:

  • Especificar a base de conhecimento a ser usada por meio de associationId.

  • Especificar filtros de conteúdo para a pesquisa realizada na base de conhecimento associada usando contentTagFilter.

  • Especificar o número de resultados a serem usados de uma pesquisa na base de conhecimento por meio de maxResults.

  • Especificar um overrideKnowledgeBaseSearchType que pode ser usado para controlar o tipo de pesquisa realizada na base de conhecimento. As opções são SEMANTIC, que usam incorporações vetoriais ou HYBRID, que usam incorporações vetoriais e texto bruto.

Por exemplo, use o seguinte comando da AWS CLI para criar um agente de IA com uma configuração personalizada da base de conhecimento.

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "associationConfigurations": [
        {
          "associationType": "KNOWLEDGE_BASE",
          "associationId": "<ASSOCIATION_ID>",
          "associationConfigurationData": {
            "knowledgeBaseAssociationConfigurationData": {
              "overrideKnowledgeBaseSearchType": "SEMANTIC",
              "maxResults": 5,
              "contentTagFilter": {
                "tagCondition": { "key": "<KEY>", "value": "<VALUE>" }
              }
            }
          }
        }
      ]
    }
  }'

Criar versões de agentes de IA

Assim como os prompts de IA, depois que um agente de IA é criado, você pode criar uma versão, que é uma instância imutável do agente de IA que pode ser usada pelo Amazon Q no Connect no runtime.

Use o exemplo de comando da AWS CLI a seguir para criar uma versão do agente de IA.

aws qconnect create-ai-agent-version \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --ai-agent-id <YOUR_AI_AGENT_ID>

Depois que uma versão é criada, o ID do agente de IA pode ser qualificado usando o seguinte formato: 

 <AI_AGENT_ID>:<VERSION_NUMBER>

Configurar agentes de IA para uso com o Amazon Q no Connect

Depois de criar as versões do prompt de IA e do agente de IA para seu caso de uso, você pode configurá-las para uso com o Amazon Q no Connect.

Configurar versões de agentes de IA no assistente do Amazon Q no Connect

É possível definir uma versão de agente de IA como padrão para ser usada no Assistente do Amazon Q no Connect.

Use o exemplo de comando da AWS CLI a seguir para definir a versão do agente de IA como padrão. Depois que a versão do agente de IA for definida, ela será usada quando o próximo Amazon Connect contato e a sessão associada do Amazon Q in Connect forem criados. 

aws qconnect update-assistant-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --ai-agent-type MANUAL_SEARCH \
  --configuration '{
    "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>"
  }'

Configurar versões de agentes de IA em sessões do Amazon Q no Connect

Também é possível definir uma versão de agente de IA para cada sessão distinta do Amazon Q no Connect ao criar ou atualizar uma sessão.

Use o exemplo de comando da AWS CLI a seguir para definir a versão do agente de IA para cada sessão distinta.

aws qconnect update-session \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --session-id <YOUR_Q_IN_CONNECT_SESSION_ID> \
  --ai-agent-configuration '{
    "ANSWER_RECOMMENDATION": { "aiAgentId": "<ANSWER_RECOMMENDATION_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" },
    "MANUAL_SEARCH": { "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" }
  }'

As versões de agentes de IA definidas nas sessões têm precedência sobre as definidas no nível do assistente do Amazon Q no Connect, que por sua vez têm precedência sobre os padrões do sistema. Essa ordem de precedência pode ser usada para definir versões de agentes de IA em sessões criadas para segmentos de negócios específicos da central de atendimento. Por exemplo, usando fluxos para automatizar a configuração de versões do agente de IA para filas específicas do Amazon Connect usando um bloco de fluxo do Lambda.

Reverter para os padrões do sistema

Você pode reverter para as versões padrão do agente de IA se, por algum motivo, for necessário apagar as personalizações.

Use o seguinte exemplo de comando da AWS CLI para listar as versões do agente de IA e reverter para as originais.

aws qconnect list-ai-agents \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --origin SYSTEM
nota

--origin SYSTEM é especificado como um argumento para buscar as versões do agente de IA do sistema. Sem esse argumento, as versões de agentes de IA personalizados serão listadas. Após listar as versões do agente de IA, use-as para redefinir o padrão do Amazon Q no Connect na experiência no nível do Assistente do Amazon Q no Connect ou da sessão. Use o comando da CLI descrito em Configurar agentes de IA para uso com o Amazon Q no Connect.