Creación de agentes de IA en Amazon Connect - Amazon Connect
Creación de agentes de IAAsociación con un agente de IA con un flujoEjemplos de comandos de la CLI

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación de agentes de IA en Amazon Connect

Un agente de IA es un recurso de Amazon Q in Connect que configura y personaliza la experiencia de end-to-end Amazon Q in Connect. Por ejemplo, el agente de IA le indica al Asistente de IA cómo gestionar una búsqueda manual: qué peticiones y barreras de protección de IA debe utilizar y qué configuración regional debe utilizar para la respuesta.

Amazon Q en Connect proporciona un agente de IA del sistema para cada caso de uso:

  • Recomendación de respuesta

  • Búsqueda manual

  • Autoservicio

  • Información general del correo electrónico

  • Respuesta generativa de correo electrónico

Los agentes de IA del sistema se rellenan con las peticiones de IA predeterminadas para cada caso de uso.

Por ejemplo, la siguiente imagen muestra una experiencia de Amazon Q en Connect que está configurada para usar agentes de IA personalizados para recomendaciones de respuestas y búsquedas manuales, pero usa el agente de IA predeterminado del sistema para casos de uso de autoservicio.

Los agentes de IA predeterminados especificados para una experiencia de Amazon Q en Connect.

Así es como funcionan los agentes de IA personalizados:

  • Puede sustituir uno o varios de los agentes de IA del sistema por sus agentes de IA personalizados.

  • A continuación, el agente de IA personalizado pasará a ser el predeterminado para el caso de uso especificado.

  • Al crear un agente de IA personalizado, puede especificar una o varias de sus propias peticiones de IA personalizadas y una barrera de protección.

  • La mayoría de los casos de uso (Recomendación de respuestas, Autoservicio, Respuesta por correo electrónico y Respuesta generativa por correo electrónico) admiten dos tipos de peticiones de IA. Si decide crear una nueva petición de IA para un tipo pero no para el otro, el agente de IA seguirá utilizando la petición de IA predeterminada del sistema que no haya anulado. De esta forma, puede optar por anular únicamente partes específicas de la experiencia predeterminada de Amazon Q en Connect.

Creación de agentes de IA

  1. Inicie sesión en el sitio web de Amazon Connect administración en https://instance name.my.connect.aws/. Usa una cuenta de administrador o una cuenta con el permiso Amazon Q - Agentes de IA - Crear en su perfil de seguridad.

  2. En el menú de navegación, elija Amazon Q, Agentes de IA.

  3. Vaya a la página Agentes de IA y seleccione Crear agente de IA.

  4. En el cuadro de diálogo Crear agente de IA, para Tipo de agente de IA, utilice el cuadro desplegable para elegir uno de los siguientes tipos:

    • Recomendación de respuesta: un agente de IA que gestiona las recomendaciones automáticas basadas en la intención que se envían a un agente cuando interactúa con un cliente. Utiliza los siguientes tipos de petición de IA:

      • Generación de etiquetado de intenciones: petición de IA para generar las intenciones que el agente de servicio al cliente puede elegir como primer paso.

      • Reformulación de consultas: petición de IA después de elegir una intención. Utiliza esta petición para formular una consulta adecuada, que luego se utiliza para obtener extractos relevantes de la base de conocimiento.

      • Generación de respuestas: la consulta y los extractos generados se introducen en esta petición con las variables $.query y $.contentExcerpt respectivamente.

    • Búsqueda manual: un agente de IA que produce soluciones en respuesta a las búsquedas bajo demanda iniciadas por un agente. Utiliza el tipo Generación de respuestas de la petición de IA.

    • Autoservicio: un agente de IA produce soluciones para el autoservicio. Utiliza los tipos de petición de IA Generación de respuestas de autoservicio y Preprocesamiento de autoservicio.

    • Respuesta por correo electrónico: un agente de IA que facilita el envío de una respuesta por correo electrónico de un guion de conversación al cliente final.

    • Información general del correo electrónico: un agente de IA que proporciona información general del contenido del correo electrónico.

    • Respuesta generativa de correo electrónico: un agente de IA que genera respuestas por correo electrónico.

    importante

    Recomendación de respuestas y Autoservicio admiten dos tipos de peticiones de IA. Si decide crear una nueva petición de IA para un tipo pero no para el otro, el agente de IA seguirá utilizando la predeterminada del sistema por la que no ha reemplazado. De esta forma, puede optar por anular únicamente partes específicas de la experiencia predeterminada de Amazon Q en Connect.

  5. En la página Creador de agentes, puede especificar la configuración regional que se debe utilizar para la respuesta. Para ver una lista de las configuraciones regionales admitidas, consulte Códigos de configuración regional.

    Puede elegir la configuración regional para los tipos de agente de IA Recomendación de respuesta, Búsqueda manual, Respuesta por correo electrónico, Información general del correo electrónico y Respuesta generativa de correo electrónico. No puede elegir la configuración regional para Autoservicio; solo se admite el inglés.

  6. Elija las peticiones de IA con las que desee anular las predeterminadas. Tenga en cuenta que está eligiendo una versión de la petición de IA publicada, no solo una petición de IA guardada. Si lo desea, puede añadir una barrera de protección de IA a su agente de IA.

    nota

    Si no anula específicamente una petición de IA predeterminada con una personalizada, se seguirá utilizando la predeterminada.

  7. Seleccione Save. Puede seguir actualizando y guardando el agente de IA hasta que esté seguro de que esté completo.

  8. Para que la nueva versión del agente de IA esté disponible como posible opción predeterminada, seleccione Publicar.

Asociación con un agente de IA con un flujo

Para usar la funcionalidad predeterminada de out-of-the-box Amazon Q in Connect, añada un Amazon Q en Connect bloque a sus flujos. Este bloque asocia el asistente y la asignación predeterminada de los agentes de IA.

Para anular este comportamiento predeterminado, cree una función de Lambda y, a continuación, utilice el bloque Función de AWS Lambda para añadirla a sus flujos.

Ejemplos de comandos de la CLI para crear y administrar agentes de IA

En esta sección se proporcionan varios ejemplos de comandos de AWS CLI para ayudarle a crear y gestionar agentes de IA.

Creación de un agente de IA que utilice todas las versiones personalizadas de peticiones de IA

Amazon Q en Connect utiliza la versión de la petición de IA para su funcionalidad si se especifica una para un agente de IA. De lo contrario, se ajusta al comportamiento predeterminado del sistema.

Utilice el siguiente comando AWS CLI de ejemplo para crear un agente de IA que utilice todas las versiones de mensajes de IA personalizadas para responder a las recomendaciones.


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>"
    }
  }'

Configuración parcial de un agente de IA

También puede configurar parcialmente un agente de IA especificando que debería utilizar algunas de las versiones de la petición de IA. Para lo que no se especifique, utiliza las peticiones de IA predeterminadas.

Utilice el siguiente comando AWS CLI de ejemplo para crear un agente de IA de recomendación de respuestas que utilice una versión de línea de comandos de IA personalizada y deje que los valores predeterminados del sistema se encarguen del 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>"
    }
  }'

Configuración de una versión de peticiones de IA para búsquedas manuales

El tipo de agente de IA de búsqueda manual solo tiene una versión de la petición de IA, por lo que no se puede realizar una configuración parcial.

Utilice el siguiente comando AWS CLI de ejemplo para especificar una versión de indicador de IA para la búsqueda 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>"
    }
  }'

Uso de agentes de IA para anular la configuración de la base de conocimiento

También puede usar agentes de IA para configurar qué asociaciones de asistentes debe usar Amazon Q en Connect y cómo usarlas. La asociación compatible para la personalización es la base de conocimiento que permite:

  • Especificar la base de conocimiento que se utilizará a través de su associationId.

  • Especificar los filtros de contenido para la búsqueda realizada en la base de conocimiento asociada mediante contentTagFilter.

  • Especificar el número de resultados que se utilizará en una búsqueda en la base de conocimiento mediante maxResults.

  • Especificar un overrideKnowledgeBaseSearchType que pueda usarse para controlar el tipo de búsqueda realizada en la base de conocimiento. Las opciones son SEMANTIC que utilizan incrustaciones vectoriales o HYBRID que utilizan incrustaciones vectoriales y texto sin procesar.

Por ejemplo, utilice el siguiente comando AWS CLI para crear un agente de IA con una configuración de base de conocimientos personalizada.

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>" }
              }
            }
          }
        }
      ]
    }
  }'

Creación de versiones de agentes de IA

Al igual que las peticiones de IA, una vez creado un agente de IA, puede crear una versión que es una instancia inmutable del agente de IA que Amazon Q en Connect puede utilizar en tiempo de ejecución.

Utilice el siguiente comando AWS CLI de ejemplo para crear una versión del agente de IA.

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

Después de crear una versión, el ID del agente de IA se puede calificar con el siguiente formato: 

 <AI_AGENT_ID>:<VERSION_NUMBER>

Configuración de agentes de IA para su uso con Amazon Q en Connect

Una vez que haya creado las versiones de la petición de IA y del agente de IA para su caso de uso, podrá configurarlos para usarlos con Amazon Q en Connect.

Configuración de las versiones del agente de IA en el asistente de Amazon Q en Connect

Puede establecer una versión del agente de IA como la predeterminada que se utilizará en el Asistente de Amazon Q en Connect.

Utilice el siguiente comando AWS CLI de ejemplo para establecer la versión del agente de IA como predeterminada. Una vez configurada la versión del agente de IA, se utilizará cuando se cree el siguiente Amazon Connect contacto y la sesión de Amazon Q in Connect asociada. 

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>"
  }'

Configuración de las versiones del agente de IA en las sesiones de Amazon Q en Connect

También puede configurar una versión del agente de IA para cada sesión distinta de Amazon Q en Connect al crear o actualizar una sesión.

Utilice el siguiente comando AWS CLI de ejemplo para configurar la versión del agente de IA para cada sesión 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>" }
  }'

Las versiones del agente de IA configuradas en las sesiones tienen prioridad sobre las configuradas en el asistente de Amazon Q en Connect, que a su vez tienen prioridad sobre las predeterminadas del sistema. Este orden de prioridad se puede utilizar para configurar las versiones del agente de IA en las sesiones creadas para segmentos empresariales específicos de los centros de contacto. Por ejemplo, mediante el uso de flujos para automatizar la configuración de las versiones del agente de IA para determinadas colas de Amazon Connect mediante un bloque de flujo de Lambda.

Recuperación de los valores predeterminados del sistema

También puede volver a las versiones predeterminadas del agente de IA si es necesario borrar la personalización por cualquier motivo.

Utilice el siguiente comando AWS CLI de ejemplo para enumerar las versiones de los agentes de IA y volver a las originales.

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

--origin SYSTEM se especifica como argumento para obtener las versiones del agente de IA del sistema. Sin este argumento, se mostrarán las versiones personalizadas del agente de IA. Cuando aparezcan las versiones del agente de IA, podrá utilizarlas para restablecer la experiencia predeterminada de Amazon Q en Connect en el asistente o de la sesión de Amazon Q en Connect; para ello, use el comando de la CLI descrito en Configuración de agentes de IA para su uso con Amazon Q en Connect.