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 que configura e personaliza a experiência do agente de end-to-end IA. 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 Connect fornece os seguintes agentes de IA de sistema prontos para uso:

Cada caso de uso é configurado para usar um agente de sistema de IA padrão. Isso também pode ser personalizado.

Por exemplo, a imagem a seguir mostra uma experiência de agentes do Connect AI configurada para usar um agente de IA personalizado para o caso de uso do Agent Assistance e usa os agentes de IA padrão do sistema para o resto.

Veja como os agentes de IA personalizados funcionam:

Como criar agentes de IA

Associar um agente de IA a um fluxo

Para usar a funcionalidade padrão dos agentes out-of-the-box Connect AI, você adiciona um Assistente 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

Os agentes do Connect AI usam a versão do prompt de IA para sua funcionalidade, se uma for 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_CONNECT_AI_AGENT_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_CONNECT_AI_AGENT_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_CONNECT_AI_AGENT_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

Você pode usar agentes de IA para configurar quais associações assistentes os agentes do Connect AI devem usar e como devem ser usadas. A associação compatível com a personalização é a base de conhecimento, que permite:

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_CONNECT_AI_AGENT_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 as solicitações de IA, após a criação de um agente de IA, você pode criar uma versão que é uma instância imutável do agente de IA que pode ser usada pelos agentes do Connect AI em tempo de execução.

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_CONNECT_AI_AGENT_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>            

Defina agentes de IA para uso com os agentes Connect AI

Depois de criar as versões do prompt de IA e as versões do agente de IA para seu caso de uso, você pode configurá-las para uso com os agentes do Connect AI.

Defina as versões do agente de IA no Connect AI agents Assistant

Você pode definir uma versão do agente de IA como padrão para ser usada no Connect AI agents Assistant.

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 de agentes Connect AI associada forem criados.

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

Defina as versões do agente de IA nas sessões de agentes do Connect AI

Você também pode definir uma versão do agente de IA para cada sessão distinta de agentes do Connect AI 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_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --session-id <YOUR_CONNECT_AI_AGENT_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 do agente de IA definidas nas sessões têm precedência sobre as definidas no nível do Connect AI agents Assistant, que, por sua vez, tem 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_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --origin SYSTEM