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 que configura y personaliza la experiencia del end-to-end agente de IA. 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 Connect proporciona los siguientes agentes de IA del sistema listos para usar: + Orquestación + Respuesta: recomendación + Búsqueda manual + Autoservicio + Respuesta por correo electrónico + Descripción general del correo electrónico + Respuesta generativa por correo electrónico + Toma de notas + Asistencia de agentes + Resumen de casos Cada caso de uso está configurado para usar un agente del sistema de IA predeterminado. Esto también se puede personalizar. Por ejemplo, la siguiente imagen muestra una experiencia de agentes de Connect AI que está configurada para usar un agente de IA personalizado para el caso de uso de Agent Assistance y usa los agentes de IA predeterminados del sistema para el resto. ![Los agentes de IA predeterminados y personalizados especificados para Amazon Connect](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ai-agent-default.png) 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 solo partes específicas de la experiencia predeterminada de los agentes de Connect AI. ## Creación de agentes de IA 1. Inicie sesión en el sitio web de Connect Customer administración en https://{{instance name}}.my.connect.aws/. Utilice una cuenta de administrador o una cuenta con un **diseñador de agentes de IA (**agentes de IA****): **cree** un permiso en su perfil de seguridad. 1. En el menú de navegación, selecciona el **diseñador de agentes de IA** y **los agentes de IA**. 1. Vaya a la página **Agentes de IA** y seleccione **Crear agente de IA**. 1. 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: + **Orquestación**: un agente de IA con capacidades de agente que organiza diferentes casos de uso según las necesidades del cliente. Puede entablar una conversación en varios turnos e invocar herramientas preconfiguradas. Utiliza un mensaje de IA de tipo **orquestación**. + **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 solo partes específicas de la experiencia predeterminada de los agentes de Connect AI. 1. 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](ai-agent-configure-language-support.md#supported-locale-codes-q). Puedes elegir la configuración regional de los agentes de IA para elegir **la configuración regional, la** **recomendación de respuestas**, la **búsqueda manual**, la **respuesta por correo** **electrónico, el resumen del correo** **electrónico y las respuestas generativas** por correo electrónico. No puede elegir la configuración regional para **Autoservicio**; solo se admite el inglés. 1. 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. 1. Seleccione **Save**. Puede seguir actualizando y guardando el agente de IA hasta que esté seguro de que esté completo. 1. 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 utilizar la funcionalidad predeterminada de out-of-the-box Connect AI agents, añada un [Connect Assistant](connect-assistant-block.md) 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 ](invoke-lambda-function-block.md) 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. **Topics** + [Creación de un agente de IA que utilice todas las versiones personalizadas de peticiones de IA](#cli-ai-agents-sample1) + [Configuración parcial de un agente de IA](#cli-ai-agents-sample2) + [Configuración de una versión de peticiones de IA para búsquedas manuales](#cli-ai-agents-sample3) + [Uso de agentes de IA para anular la configuración de la base de conocimiento](#cli-ai-agents-sample4) + [Creación de versiones de agentes de IA](#cli-ai-agents-sample5) + [Configure los agentes de IA para usarlos con los agentes de Connect AI](#cli-ai-agents-sample6) + [Recuperación de los valores predeterminados del sistema](#cli-ai-agents-sample6b) ### Creación de un agente de IA que utilice todas las versiones personalizadas de peticiones de IA Los agentes de Connect AI utilizan la versión AI prompt 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 \   --name example_answer_recommendation_ai_agent \   --visibility-status PUBLISHED \   --type ANSWER_RECOMMENDATION \   --configuration '{     "answerRecommendationAIAgentConfiguration": {       "answerGenerationAIPromptId": "",       "intentLabelingGenerationAIPromptId": "",       "queryReformulationAIPromptId": ""     }   }' ``` ### 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 \   --name example_answer_recommendation_ai_agent \   --visibility-status PUBLISHED \   --type ANSWER_RECOMMENDATION \   --configuration '{     "answerRecommendationAIAgentConfiguration": {       "answerGenerationAIPromptId": ""     }   }' ``` ### 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 \   --name example_manual_search_ai_agent \   --visibility-status PUBLISHED \   --type MANUAL_SEARCH \   --configuration '{     "manualSearchAIAgentConfiguration": {       "answerGenerationAIPromptId": ""     }   }' ``` ### Uso de agentes de IA para anular la configuración de la base de conocimiento Puede usar los agentes de IA para configurar qué asociaciones de asistentes deben usar los agentes de Connect AI y cómo deben 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 \   --name example_manual_search_ai_agent \   --visibility-status PUBLISHED \   --type MANUAL_SEARCH \   --configuration '{     "manualSearchAIAgentConfiguration": {       "answerGenerationAIPromptId": "",       "associationConfigurations": [         {           "associationType": "KNOWLEDGE_BASE",           "associationId": "",           "associationConfigurationData": {             "knowledgeBaseAssociationConfigurationData": {               "overrideKnowledgeBaseSearchType": "SEMANTIC",               "maxResults": 5,               "contentTagFilter": {                 "tagCondition": { "key": "", "value": "" }               }             }           }         }       ]     }   }' ``` ### Creación de versiones de agentes de IA Al igual que las instrucciones de IA, una vez creado un agente de IA, puedes crear una versión que sea una instancia inmutable del agente de IA que puedan utilizar los agentes de Connect AI 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 \   --ai-agent-id  ``` Después de crear una versión, el ID del agente de IA se puede calificar con el siguiente formato: ``` : ``` ### Configure los agentes de IA para usarlos con los agentes de Connect AI Una vez que haya creado las versiones de comandos de IA y las versiones de los agentes de IA para su caso de uso, puede configurarlas para que se usen con los agentes de Connect AI. #### Configura las versiones de los agentes de IA en Connect AI Agents Assistant Puede configurar una versión de agente de IA como predeterminada para usarla en el Asistente de agentes de Connect AI. 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 creen el siguiente Connect Customer contacto y la sesión de agentes de Connect AI asociada. ``` aws qconnect update-assistant-ai-agent \   --assistant-id {{}} \   --ai-agent-type MANUAL_SEARCH \   --configuration '{     "aiAgentId": ""   }' ``` #### Configure las versiones de los agentes de IA en las sesiones de Connect AI Agents También puede configurar una versión del agente de IA para cada sesión distinta de los agentes de Connect AI 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 {{}} \   --session-id {{}} \   --ai-agent-configuration '{     "ANSWER_RECOMMENDATION": { "aiAgentId": "" },     "MANUAL_SEARCH": { "aiAgentId": "" }   }' ``` Las versiones de los agentes de IA configuradas en las sesiones tienen prioridad sobre las configuradas en el nivel del Asistente de agentes de Connect AI, que a su vez tiene 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](connect-lambda-functions.md). ### 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 {{}} \   --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. Una vez que aparezcan las versiones de los agentes de IA, utilícelas para restablecer la experiencia predeterminada de los agentes de Connect AI en el nivel del asistente o la sesión de Connect AI agents; utilice el comando CLI que se describe en[Configure los agentes de IA para usarlos con los agentes de Connect AI](#cli-ai-agents-sample6).