

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.

# Crea, personaliza e implementa agentes de chat con tecnología de IA en Amazon Quick
<a name="working-with-agents"></a>

Los agentes de chat de Amazon Quick ayudan a los usuarios a explorar datos, analizar información y realizar acciones. Los usuarios pueden interactuar con los agentes de chat mediante la interfaz de chat rápido. Los agentes de chat brindan asistencia a través de conversaciones abiertas respaldadas por objetivos específicos, fuentes de conocimiento y cualquier herramienta conectada. Los agentes de chat pueden pasar de ser simples interfaces de preguntas y respuestas a funciones más avanzadas que organizan flujos de trabajo complejos.

Puede usar los agentes de chat para:
+ Genera contenido y proporciona respuestas a través de conversaciones en lenguaje natural
+ Analice y resuma la información de los espacios conectados, los paneles, los temas, los conjuntos de datos y los archivos cargados
+ Invoque acciones para realizar pasos predefinidos y obtener resultados consistentes y repetibles

**nota**  
Para obtener más información sobre cómo chatear con agentes de chat, consulte [Uso del chat rápido de Amazon](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html).

**Topics**
+ [Tipos de agentes de chat](#agent-types)
+ [Interacción rápida de los usuarios de Amazon con los agentes de chat](#user-agent-actions)
+ [Permisos de usuario de Amazon Quick para agentes de chat](#user-agent-permissions)
+ [Permisos personalizados para los agentes de chat](#custom-permissions-chat-agents)
+ [Agente de chat del sistema](default-assistant.md)
+ [Agentes de chat personalizados](custom-agents.md)
+ [Fuentes de contexto y prácticas recomendadas para los agentes de chat](agent-knowledge-sources-best-practices.md)
+ [Usa un agente de chat](use-agents.md)

## Tipos de agentes de chat
<a name="agent-types"></a>

Amazon Quick admite dos tipos de agentes de chat:
+ **Agente de chat del sistema**: este agente de chat («Mi asistente») está disponible automáticamente para todos los usuarios de forma predeterminada. El agente de chat del sistema sirve como planificador básico sin datos ni acciones propias. Accede de forma dinámica a los recursos disponibles para cada usuario durante el tiempo de conversación, lo que permite adaptarlo a los permisos individuales de cada usuario y al contenido disponible. Los usuarios administradores controlan la configuración del agente de chat del sistema asignando a usuarios específicos como propietarios para que puedan personalizar su personalidad y otros ajustes.

  El agente de chat del sistema cuenta con todas las funciones de chat, incluidas la función de carga de archivos, el acceso a los conocimientos de LLM, la toxicidad y otras funciones de protección y la búsqueda en la web. También incluye mecanismos de análisis del alcance de los datos del chat que permiten acceder a espacios, temas, paneles, bases de conocimiento y acciones en función de los permisos de los usuarios.
+ **Agentes de chat personalizados: los** usuarios con capacidades de creación de agentes de chat en Amazon Quick pueden crear y personalizar estos agentes de chat para casos de uso específicos y compartirlos con cualquier persona. Los administradores pueden optar por restringir a usuarios y grupos específicos la creación de agentes de chat personalizados y, al mismo tiempo, permitir que los usuarios usen los agentes de chat a través del chat. Los agentes de chat devuelven las respuestas relacionadas con el contenido para el que los usuarios que las invocan tienen permisos.

Los agentes de chat personalizados pueden interactuar con los recursos de Amazon Quick de las siguientes maneras:
+ **Preconfigurados con recursos**: estos agentes de chat utilizan solo los recursos configurados (por ejemplo, los espacios como fuentes de conocimiento, los conectores de acción como herramientas) cuando buscan respuestas u organizan acciones según su comportamiento predeterminado. Mientras chatean, los usuarios pueden adjuntar recursos adicionales según sus necesidades o invocar acciones directamente. Por ejemplo, los agentes de chat configurados solo con espacios que contienen archivos no pueden realizar acciones de forma predeterminada a menos que los usuarios las invoquen explícitamente. Del mismo modo, los agentes de chat configurados solo con acciones se basan en los conocimientos de LLM, a menos que los usuarios adjunten un espacio o un panel de control para las respuestas específicas de la empresa. Sin embargo, los usuarios pueden adjuntar espacios adicionales o invocar directamente otras acciones a las que tengan acceso dentro de la interfaz de chat.
+ **No son obstinados en el momento de la creación**: estos agentes de chat no se configuran inicialmente con recursos cuando se crean (espacios, conectores de acciones o ambos). El chat determina el límite de recursos del agente de chat. Por ejemplo, si no hay ningún espacio configurado para el agente de chat, el chat utilizará de forma predeterminada todos los espacios o conocimientos de LLM hasta que el usuario realice un cambio. Si no hay ningún conector de acción configurado para el agente de chat, durante el chat, todas las acciones a las que tenga acceso el usuario estarán disponibles para el agente hasta que el usuario seleccione un recurso que no incluya acciones.

  La selección de los recursos del usuario durante el chat afecta al comportamiento del agente de chat. Si un usuario selecciona un espacio, el agente de chat solo responderá con los datos que se encuentren dentro de ese espacio y tomará las medidas que estén disponibles en ese espacio (si no es una opinión al momento de crearlo). Si un usuario selecciona un panel, un tema o una base de conocimientos, el agente de chat solo responderá desde esa fuente y no realizará ninguna acción, ya que el enfoque pasa a centrarse en una fuente de datos específica. Se espera que los usuarios seleccionen todos los recursos relevantes del chat para obtener una asistencia integral.
**nota**  
El agente de chat del sistema es un agente de chat poco obstinado por diseño. Si desea que los agentes de chat accedan a todas las acciones independientemente del enfoque de datos, configure los agentes de chat con conectores de acción.

## Interacción rápida de los usuarios de Amazon con los agentes de chat
<a name="user-agent-actions"></a>

En la siguiente tabla, se muestra lo que puede hacer con los agentes de chat de la consola de administración y no como usuario de Amazon Quick. Para obtener más información sobre los roles que pueden acceder a estas funciones, consulta el documento de [precios de Amazon Quick](https://aws.amazon.com/quicksuite/pricing/).


| Nivel de acceso | Capacidades | 
| --- | --- | 
| Consola de administración |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html)  | 
| Usuario de Amazon Quick |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html)  | 

## Permisos de usuario de Amazon Quick para agentes de chat
<a name="user-agent-permissions"></a>

Lo que puedes hacer con un agente de chat también depende de los permisos que se te asignen. Hay dos tipos de permisos que se pueden asignar a los usuarios:
+ **Propietario**: los propietarios pueden editar, compartir y eliminar el agente de chat.
+ **Visor**: los espectadores pueden ver y usar el agente de chat.

**nota**  
Si no tienes acceso a un recurso vinculado como espectador o propietario, los recursos que otro propietario haya añadido al agente de chat aparecerán como «Recurso no disponible». Puedes eliminar estos recursos como propietario, pero no puedes incluirlos en la lista ni añadirlos porque es necesario compartirlos a nivel de recursos.

Los administradores rápidos deben conceder a los usuarios el permiso para crear agentes de chat. Para obtener información sobre los roles que pueden crear agentes de chat, consulta la documentación de [precios de Amazon Quick](https://aws.amazon.com/quicksuite/pricing/). Para obtener información sobre cómo proporcionar acceso a estas funciones, consulte [los permisos personalizados](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) en la Guía rápida de administración.

En la siguiente tabla se describe cómo los permisos de usuario determinan lo que puede hacer con un agente de Amazon Quick Chat:


| Tipo de permisos | Permisos | 
| --- | --- | 
| Propietarios |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html)  | 
| Espectadores |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html)  | 

## Permisos personalizados para los agentes de chat
<a name="custom-permissions-chat-agents"></a>

De forma predeterminada, Amazon Quick habilita todas las nuevas funciones disponibles para la cuenta Amazon Quick para que los usuarios puedan acceder a ellas inmediatamente en función de su suscripción. Puedes usar [permisos personalizados](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) para restringir funciones específicas. Como administrador, al crear un perfil de permisos personalizado, puede crear dos tipos de restricciones para los agentes de chat:
+ Puedes deshabilitar por completo todas las funciones del agente de chat para los usuarios, como chatear con el agente predeterminado, chatear con agentes personalizados y crear nuevos agentes. Esto se puede hacer restringiendo la capacidad del **agente de chat**.
+ También puedes restringir específicamente la capacidad de crear agentes sin que ello afecte al chat con los agentes. Para ello, puede crear un perfil de permisos personalizado y restringir únicamente la función **Crear agentes de chat**.

**nota**  
Si desea que sus usuarios puedan chatear con el agente del sistema, pero no quiere que creen agentes de chat, restrinja únicamente sus capacidades de creación de agentes de chat.

Los permisos de los agentes en Amazon Quick se pueden configurar en varias combinaciones para satisfacer las necesidades de su organización. Para ayudarle a entender cómo configurar los permisos, en la siguiente sección se proporciona un enfoque basado en casos de uso que agrupa los escenarios más comunes:


| Situación de caso de uso | Qué pueden hacer los usuarios | 
| --- | --- | 
| Agente con todas las capacidades(No hay restricciones en cuanto a los agentes, los espacios, las bases de conocimiento, las acciones o los flujos de chat) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html) | 
| Acceso a los agentes solo por chat(Las funciones del agente están habilitadas, pero la creación de agentes de chat está restringida) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html) | 
| Acceso limitado a otras capacidades(Los agentes de chat están habilitados, pero sus capacidades específicas están restringidas) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html) | 
| No hay acceso a un agente de chat(Las capacidades del agente están completamente restringidas) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/working-with-agents.html) | 

# Agente de chat del sistema
<a name="default-assistant"></a>

El agente de chat del sistema Amazon Quick se crea automáticamente cuando te registras en Quick. Sirve como la interfaz principal para que todos los usuarios interactúen con sus datos y realicen diversas tareas en el entorno Quick. Viene equipado con barandas predeterminadas.

El administrador rápido gestiona la propiedad del agente de chat del sistema. Los administradores pueden deshabilitar el chat con los agentes de chat, incluido el agente de chat del sistema, mediante [permisos personalizados](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html). Si está activado, los usuarios que no tienen funciones de administrador (autores y lectores) pueden ver, enumerar, invocar y utilizar el agente de chat Quick Chat. Sus respuestas se filtran en función de los permisos de los usuarios para acceder a los activos.

El agente de chat del sistema Quick está configurado para utilizar todas las funciones de chat de forma inmediata y requiere una personalización mínima. Si bien estas funciones también están disponibles para los agentes de chat personalizados, deben configurarse durante la creación del agente de chat. El agente de chat del sistema incluye:
+ El personaje predeterminado es el asistente rápido, con un tono y un estilo de respuesta profesionales
+ La función de carga de archivos en el chat está habilitada
+ Se ha activado el chat de conocimientos sobre un modelo de lenguaje amplio (LLM)
+ Utiliza barandillas predeterminadas configuradas para el chat en la consola de administración
+ Acceso a todos los espacios, temas, paneles, bases de conocimiento y acciones en función de los permisos de los usuarios
+ Capacidades de búsqueda en la web

Para obtener información sobre cómo personalizar un agente de chat del sistema como propietario administrador, consulte [Administrar la personalización del agente de chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-agent.html). Para obtener información sobre cómo controlar el acceso al agente de chat del sistema, consulte [Administrar activos](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-qs-assets.html).

# Agentes de chat personalizados
<a name="custom-agents"></a>

Los agentes de chat personalizados permiten a los usuarios de Amazon Quick crear interfaces de conversación personalizadas para necesidades empresariales específicas. A diferencia del agente de chat del sistema, que está disponible de forma predeterminada para todos los usuarios con permisos de chat, los usuarios autorizados pueden compartir y configurar los agentes de chat personalizados de forma selectiva.

Los usuarios con capacidades de creación de agentes de chat pueden personalizar la personalidad, el estilo de respuesta y las capacidades del agente de chat mediante una interfaz de lenguaje natural o mediante el flujo de configuración del generador de agentes. Estos usuarios también pueden configurar estos agentes de chat con fuentes de conocimiento específicas (como espacios) y flujos de trabajo (como acciones) y, al mismo tiempo, mantener el control sobre los permisos de acceso y uso compartido de cada uno de esos recursos por separado. O bien, los agentes de chat pueden dejarse desvinculados para un uso general, lo que permite a los usuarios finales utilizar el agente con todos o algunos de sus recursos.

Los administradores rápidos deben conceder a los usuarios el permiso para crear agentes de chat. Para obtener información sobre los roles que pueden crear agentes de chat, consulta la documentación de [precios de Amazon Quick](https://aws.amazon.com/quicksuite/pricing/). Para obtener información sobre cómo proporcionar o restringir el acceso a estas funciones, consulte [los permisos personalizados](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) en la Guía rápida de administración.

**Topics**
+ [Crea y previsualiza agentes de chat personalizados](#create-custom-agents)
+ [Comparte agentes de chat personalizados](#share-custom-agents)
+ [Inserta agentes de chat personalizados](#embed-custom-agents)
+ [Actualice los agentes de chat personalizados](#update-custom-agents)
+ [Administra el acceso a un agente de chat personalizado](#remove-access-custom-agents)
+ [Ver agentes de chat](#view-agents)
+ [Vea los detalles del agente de chat](#view-agent-details)
+ [Duplica agentes de chat personalizados](#duplicate-agents)
+ [Elimina los agentes de chat](#delete-agents)

## Crea y previsualiza agentes de chat personalizados
<a name="create-custom-agents"></a>

Puede crear agentes de chat personalizados en Amazon Quick desde el menú **Agentes de chat** de la página de inicio de Amazon Quick. Puede obtener una vista previa de su agente de chat y probarlo a medida que lo crea. Cuando creas un agente de chat personalizado, se te asigna como propietario de forma predeterminada. El siguiente procedimiento describe cómo crear un agente de chat personalizado.

------
#### [ Using natural language ]

**Para crear un agente de chat personalizado mediante un mensaje en lenguaje natural**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat** y, a continuación, selecciona **Crear agente de chat**.

1. En **Nuevo agente de chat**, haz lo siguiente:

   1. En el cuadro de entrada de texto, introduce una descripción en lenguaje natural del tipo de agente de chat que deseas crear. Este es el mensaje que utilizará Amazon Quick para crear tu agente de chat. También puedes usar los ejemplos de instrucciones sugeridos en la página para crear tu agente de chat.

   1. Luego, selecciona **Generar**. Al seleccionar **Generar**, se toman las instrucciones o los objetivos proporcionados y se amplían a las instrucciones y configuraciones del agente de chat. También analiza los recursos disponibles del usuario (espacios y conectores de acción) y busca las coincidencias más relevantes en función de la intención del agente de chat proporcionada. La interfaz de usuario ampliada del generador se abre con estas configuraciones para que el usuario las revise, personalice, pruebe e inicie.

1. En la página **Configurar el agente de chat**, asegúrate de que tu agente de chat tiene los ajustes correctos y personalízalo aún más. Haga clic en **Actualizar vista previa** para asegurarse de que todos los cambios se hayan guardado antes de probar el agente de chat en la vista previa.

1.  Cuando estés listo, selecciona **Iniciar el agente de chat** para publicar tu agente de chat personalizado en la biblioteca de agentes de chat y usarlo en el chat.
**nota**  
Hasta que selecciones **Iniciar el agente de chat**, tu agente de chat no estará disponible en la biblioteca de agentes de chat. Si sales del proceso de creación sin iniciarlo, la versión preliminar se eliminará y el agente de chat no se guardará.
Cuando lanzas un agente de chat, permanece privado de forma predeterminada. El agente de chat solo estará disponible en las bibliotecas de otros usuarios después de compartirlo. Una vez compartido, las ediciones e inicios posteriores publicarán los cambios en el mismo agente de chat para todos los usuarios que tengan acceso a él.

------
#### [ Using builder view directly ]

**Para crear un agente de chat personalizado mediante el modo generador**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat** y, a continuación, selecciona **Crear agente de chat**.

1. En **Agent Creator**, selecciona **Omitir**. Se abrirá la página de configuración del agente de chat desde la que podrá crear y personalizar su agente de chat.

1. Agrega un nombre para tu agente de chat personalizado. Este es el nombre con el que se identificará a tu agente de chat.

1. (Opcional) Agrega una descripción para tu agente de chat personalizado que ayude a los usuarios a entender el propósito del agente de chat.

1. (Opcional) Selecciona un icono para tu agente de chat.

1. En **Configurar el agente de chat**, personalice las siguientes secciones:

   1. En **AGENT PERSONA**, configura la personalidad, la identidad, el tono y el estilo de respuesta de tu agente de chat:
      + Para la **identidad del agente**: defina la identidad de su agente de chat. Por ejemplo, puedes darle instrucciones sobre su nombre y personalidad. Amazon Quick utilizará los valores predeterminados si se dejan en blanco.
      + Para obtener **instrucciones sobre Persona**: añade instrucciones sobre cómo tu agente de chat interactúa con los usuarios durante el chat. Por ejemplo, puedes definir cuáles son las tareas principales de tu agente de chat. Amazon Quick las usa para personalizar la personalidad de tu agente de chat.

   1. En el **estilo de comunicación**, para el **ajuste preestablecido Elija un estilo de respuesta**, elija un estilo de respuesta. Puede elegir entre los siguientes estilos preestablecidos de respuesta o añadir instrucciones personalizadas:
      + **Ejecutivo**: optimizado para una comunicación empresarial de alto nivel y conocimientos estratégicos.
      + **Técnico**: optimizado para ofrecer explicaciones técnicas detalladas y resolver problemas técnicos.
      + **Creativo**: configuración estándar para interacciones de uso general.

      Cada ajuste preestablecido tiene los siguientes ajustes:
      + Para **el tono**: añada un mensaje en lenguaje natural para definir el tono de su agente. Amazon Quick lo usará para personalizar la personalidad de tu agente de chat.
      + Para el **formato de respuesta**: añade un mensaje en lenguaje natural para definir el estilo de respuesta de tu agente de chat. Amazon Quick lo usará para personalizar el estilo de respuesta de tu agente de chat. Defina el formato de las respuestas de su agente de chat, por ejemplo: «Use viñetas para listas de más de 3 elementos».
      + Para la **longitud**: especifique la longitud de las respuestas de su agente de chat. Defina la longitud de las respuestas de su agente de chat, por ejemplo: «Mantenga las respuestas en menos de 100 palabras».

      Cuando eliges un ajuste preestablecido para usar, Amazon Quick rellena automáticamente las instrucciones de **tono**, **formato de respuesta** y **longitud** de las respuestas de tu agente de chat en función del estilo elegido. Puede personalizar aún más las indicaciones existentes utilizando un lenguaje natural o crear otras nuevas.

   1. En **los documentos de referencia**, carga archivos que permanezcan activos en la memoria de tu agente de chat para guiar todas las interacciones. Para obtener más información sobre cómo funcionan los documentos de referencia con otros tipos de contexto, consulte [Tipos de contexto de agente](quicksuite/latest/userguide/agent-knowledge-sources-best-practices.html).
      + Seleccione **Cargar archivos** o arrastre y suelte los documentos para adjuntar archivos que sirvan de guía para las respuestas de su agente de chat.
      + Puede adjuntar documentos en formato.pdf, .txt, .html, .md, .csv, .doc o.docx. Se extraerán y aceptarán hasta 100 000 caracteres de texto de los documentos cargados.

1. (Opcional) En **Fuentes de conocimiento**, elige entre las siguientes opciones:
   + Continúe sin vincular las fuentes de conocimiento
     + Su agente de chat generará respuestas a partir del conocimiento del modelo de lenguaje extenso (LLM) y de todos los recursos de Amazon Quick a los que tenga acceso el usuario que interactúa. Puedes elegir una fuente de conocimiento específica en la que centrarte durante el chat. Elige esta opción si quieres crear un agente de chat de uso general.
   + Para vincular espacios específicos existentes
     + Selecciona **Enlazar**.
     + En el modal **Vincular espacios**, selecciona los espacios que quieres vincular a tu agente de chat y, a continuación, selecciona **Vincular**.

       El sistema muestra un mensaje de éxito para indicar que la vinculación se ha realizado correctamente.

       Si vincula un agente de chat a una fuente de conocimiento, su agente de chat generará respuestas únicamente a partir de datos y conocimientos sobre modelos lingüísticos extensos (LLM) a partir de los recursos enlazados. Puedes añadir hasta 1 fuente de conocimiento más a este agente de chat como contexto temporal durante el chat.
   + Para crear y vincular un nuevo espacio
     + Seleccione **Crear**.
     + En la ventana **Crear espacio** que se abre, selecciona los activos que quieres añadir a tu espacio y, a continuación, selecciona **Crear**.

       Si vinculas un agente de chat a una fuente de conocimiento, generará respuestas únicamente a partir de datos y conocimientos sobre modelos lingüísticos extensos (LLM) a partir de los recursos enlazados. Puedes añadir hasta 1 fuente de conocimiento más a este agente de chat como contexto temporal durante el chat.
**nota**  
Para obtener más información sobre la creación y el uso de espacios, consulte [Trabajar con espacios en Amazon Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-spaces.html).

       El sistema muestra un mensaje de éxito para indicar que se ha creado correctamente un espacio. Vuelva a la ventana de creación del agente de chat.
     + En la ventana de creación del agente de chat, en **Fuentes de conocimiento**, selecciona **Enlazar**.
     + En el modal **Vincular espacios**, selecciona el espacio que acabas de crear y, a continuación, selecciona **Vincular**.

       El sistema muestra un mensaje de éxito para indicar que la vinculación se ha realizado correctamente.

1. (Opcional) En **Acciones**, para **Acciones**: elija entre las siguientes opciones:
   + Para vincular acciones existentes específicas
     + Selecciona **Enlazar**.
     + En el modal **Vincular conectores de acción**, selecciona los conectores de acción que quieres vincular a tu agente de chat y, a continuación, selecciona **Siguiente**.
     + En **Acciones**, selecciona las acciones que quieres añadir y, a continuación, selecciona **Vincular**.

       El sistema muestra un mensaje de éxito para indicar que la vinculación se ha realizado correctamente.
   + Para crear un conector de acciones y vincular nuevas acciones
     + Seleccione **Crear**.
     + En la página de inicio de **Acciones**, selecciona **Nueva acción**.
     + En la ventana **Nueva acción**, en **Fuentes**, seleccione el conector de acciones que desee añadir y, a continuación, seleccione **Siguiente**.
     + En **Acciones**, revise las acciones disponibles y, a continuación, seleccione **Siguiente**.
     + En **Detalles de la conexión**, introduce los detalles de conexión necesarios y selecciona **Añadir**.
**nota**  
Para obtener más información sobre la creación y el uso de conectores de [acciones, consulte Actions in Amazon Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/qbs-actions.html).

       El sistema muestra un mensaje de éxito para indicar que la acción se ha añadido correctamente. Vuelva a la ventana de creación del agente de chat.
     + En la ventana de creación del agente de chat, en **Acciones**, selecciona **Vincular**.
     + En el modal **Vincular conectores de acciones**, selecciona el conector de acciones que acabas de crear y, a continuación, selecciona **Vincular**.

       El sistema muestra un mensaje de éxito para indicar que la vinculación se ha realizado correctamente.

1. En **Personalización**, haga lo siguiente:

   1. Para el **mensaje de bienvenida**: añada un mensaje de bienvenida para que su agente de chat se lo muestre al usuario final.

   1. Para **mensajes sugeridos:** añada mensajes de ejemplo para iniciar la conversación para informar a sus usuarios finales de las capacidades del agente de chat.

1. Seleccione **Iniciar agente de chat para crear su agente** de chat personalizado.
**nota**  
Hasta que selecciones **Iniciar agente de chat**, tu agente de chat no estará disponible en la biblioteca de agentes de chat. Si sales del proceso de creación sin iniciarlo, la versión preliminar se eliminará y el agente de chat no se guardará.
Cuando lanzas un agente de chat, permanece privado de forma predeterminada. El agente de chat solo estará disponible en las bibliotecas de otros usuarios después de compartirlo. Una vez compartido, las ediciones e inicios posteriores publicarán los cambios en el mismo agente de chat para todos los usuarios que tengan acceso a él.

------

## Comparte agentes de chat personalizados
<a name="share-custom-agents"></a>

Al crear un agente de chat, se le asigna como propietario de forma predeterminada. Puedes elegir compartir un agente de chat de tu propiedad con otros usuarios de Amazon Quick mediante los siguientes permisos:
+ Permisos de *propietario*: el usuario puede editar, compartir, usar y eliminar el agente de chat.
+ Permisos de *visualización*: el usuario puede ver y usar el agente de chat.

También puede definir los permisos de acceso para un agente de chat de forma global, concediendo a todos los usuarios acceso a un agente de chat y definiendo después permisos de acceso más detallados para usuarios y grupos específicos.

El siguiente procedimiento le muestra cómo compartir y asignar permisos a los agentes de chat.

**Para compartir agentes de chat personalizados**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la columna **Acciones** del agente de chat que quieras compartir, selecciona el icono del menú y, a continuación, selecciona **Compartir**.

1. En el modal **Compartir agente de chat** que se abre, introduce el nombre de usuario o grupo con el que quieres compartir el agente de chat. Cuando aparezca el nombre del usuario o del grupo, selecciónelo. Repite la acción para todos los grupos o usuarios con los que quieras compartir el agente de chat. El modal muestra los usuarios y grupos que estás añadiendo.

1. Asigna permisos e información de acceso a cada usuario o grupo con el que compartes tu agente de chat mediante el menú desplegable situado junto al nombre del usuario o grupo. Puedes asignar una de estas dos funciones:
   + **Propietario**: el usuario puede editar, compartir y eliminar el agente de chat.
   + **Visor**: el usuario puede ver y usar el agente de chat.

1. Seleccione **Compartir**.

## Inserta agentes de chat personalizados
<a name="embed-custom-agents"></a>

Puedes incrustar un agente de chat personalizado en un sitio web o aplicación externo para que los usuarios puedan interactuar con él fuera de la consola Amazon Quick. Para incrustar un agente de chat, primero debes permitir el dominio de alojamiento en la configuración de administración de Amazon Quick y, a continuación, generar el código de inserción a partir de las opciones de uso compartido del agente de chat.

Para incrustar un agente de chat hay que seguir dos pasos:

1. **Permitir el dominio de alojamiento**: un administrador de Amazon Quick debe añadir el dominio (y, opcionalmente, sus subdominios) en el que se alojará el agente de chat integrado a la lista de dominios permitidos.

1. **Genere el código de inserción**: el propietario del agente de chat o un usuario autorizado genera el código de inserción a partir de las opciones de uso compartido del agente de chat.

### Permita un dominio para los agentes de chat integrados
<a name="embed-agents-allow-domain"></a>

Para poder insertar un agente de chat en un sitio web externo, un administrador de Amazon Quick debe añadir el dominio de alojamiento a la lista de permitidos. Debes ser administrador de Amazon Quick para completar este procedimiento. Esto garantiza que solo los dominios aprobados puedan alojar agentes de chat integrados.

**Para permitir la incrustación de un dominio**

1. Inicia sesión en la consola Amazon Quick.

1. Selecciona el icono del perfil.

1. Selecciona **Administrar cuenta**.

1. En el panel de navegación, en **Seguridad**, selecciona **Administrar dominios**.

1. En el campo **Dominio**, introduce el nombre de dominio en el que quieres alojar el agente de chat integrado (por ejemplo,`https://example.com`).

1. (Opcional) Seleccione **Incluir subdominios** para permitir que los agentes de chat estén integrados en todos los subdominios del dominio especificado.

1. Elija **Añadir**.

El dominio aparece ahora en la lista de dominios permitidos. Puede editar o eliminar los dominios existentes seleccionando los iconos de edición o eliminación situados junto a cada dominio de la lista.

### Genera el código de inserción para un agente de chat
<a name="embed-agents-generate-code"></a>

Una vez que permitas el dominio de alojamiento, puedes generar el código de inserción para un agente de chat.

**Para generar el código de inserción de un agente de chat**

1. Inicia sesión en la consola Amazon Quick.

1. En el panel de navegación, selecciona **Agentes de chat**.

1. En la columna **Acciones** del agente de chat que quieras insertar, selecciona el icono del menú y, a continuación, selecciona **Editar**.

1. En el editor del agente de chat, selecciona **Compartir**.

1. En las opciones para compartir, selecciona **Compartir mediante incrustación**.

1. Copia el código de inserción proporcionado y pégalo en el código HTML de tu sitio web o aplicación donde quieras que aparezca el agente de chat.

El agente de chat integrado ya está disponible en su sitio web. Los usuarios que visiten la página pueden interactuar directamente con el agente de chat.

## Actualice los agentes de chat personalizados
<a name="update-custom-agents"></a>

Puede actualizar los agentes de chat personalizados en Amazon Quick desde el menú **Agentes** de la página de inicio de Amazon Quick. El siguiente procedimiento describe cómo hacerlo.

**nota**  
Puede obtener una vista previa del rendimiento de las actualizaciones de personalización del agente de chat, mientras configura el agente de chat, en la interfaz de chat de vista previa. Asegúrese de seleccionar **Actualizar vista previa** antes de probar un cambio. Una vez que se hayan probado todos los cambios en la vista previa, selecciona **Iniciar** para publicar los cambios en el agente de chat que se esté utilizando actualmente.

**Para actualizar un agente de chat personalizado**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la columna **Acciones** del agente de chat que quieras compartir, selecciona el icono del menú y, a continuación, selecciona **Editar**. Esto crea una versión preliminar de tu agente de chat para actualizarla y probarla antes de publicarla.

1. En el **agente de edición**, actualiza la configuración del agente de chat y, a continuación, selecciona **Iniciar**.

## Administra el acceso a un agente de chat personalizado
<a name="remove-access-custom-agents"></a>

Si eres el propietario de un agente de chat, puedes elegir cambiar los permisos de acceso de usuario de un agente de chat. También puedes eliminar el acceso de usuarios y grupos a un agente de chat. El siguiente procedimiento indica cómo se hace.

**Para administrar el acceso a los agentes de chat personalizados**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la columna **Acciones** del agente de chat que quieras compartir, selecciona el icono del menú y, a continuación, selecciona **Compartir**.

1. En el modal **Compartir agente de chat** que se abre, selecciona el usuario y el grupo para los que quieres cambiar los permisos. Cuando aparezca el nombre del usuario o grupo, selecciónelo y cambie los permisos. Repita la acción para todos los grupos o usuarios cuyos permisos desee cambiar. El modal muestra los permisos de usuarios y grupos que estás cambiando. Puedes realizar las tres acciones siguientes:
   + Cambiar de **propietario**: el usuario puede editar, compartir y eliminar el agente de chat.
   + Cambiar a **visor**: el usuario puede ver y usar el agente de chat.
   + **Eliminar el acceso**: elimina el acceso de un usuario o grupo a un agente de chat.
**nota**  
También puede definir los permisos de acceso a un agente de chat de forma global, concediendo a todos los usuarios el acceso a un agente de chat y, a continuación, definiendo permisos de acceso más detallados para usuarios y grupos específicos. Para ello, selecciona **Configuración** y, a continuación, utiliza **la configuración global** para activar o desactivar esta función.

1. Seleccione **Compartir**.

## Ver agentes de chat
<a name="view-agents"></a>

Puede ver una lista de los agentes de chat que ha creado o a los que tiene acceso. El siguiente procedimiento indica cómo se hace.

**Para ver los agentes de chat personalizados**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. Los agentes de chat que ha creado o a los que tiene acceso se mostrarán en la página de inicio de **los agentes de chat**.

## Vea los detalles del agente de chat
<a name="view-agent-details"></a>

Puede ver los detalles de los agentes de chat creados por usted o compartidos con usted, incluidos todos los espacios y acciones asociados a cada agente de chat.

**Para ver los detalles del agente de chat**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la lista de agentes de chat, en la columna **Nombre**, haz clic en el nombre del agente de chat del que quieres ver los detalles. Se abrirá un modal detallado.
**nota**  
También puedes ver los detalles del agente de chat navegando hasta la columna **Acciones** del agente de chat que quieres compartir, seleccionando el icono del menú y, a continuación, seleccionando **Ver detalles del agente de chat**.

1. En el modal de detalles del agente de chat que se abre, verás los siguientes detalles:

   1. **Descripción**: la descripción del agente de chat.

   1. **Resumen de instrucciones**: resumen de las instrucciones definidas para el agente de chat.

   1. **Creado por**: detalla si el agente de chat fue creado por ti o por otra persona.

   1. **Última modificación**: la hora en que se modificó por última vez el agente de chat.

   1. En **Capacidades**:
      + **Conocimiento**: las fuentes de conocimiento a las que está vinculado el agente de chat o a las que tiene acceso. Si tu agente de chat está vinculado a un espacio, podrás ver a qué espacio está vinculado.
      + **Acciones: las** acciones a las que el agente de chat está asociado o a las que tiene acceso. También puedes verla haciendo clic en la **información** situada junto al nombre del agente en el selector de agentes de la interfaz de chat.

## Duplica agentes de chat personalizados
<a name="duplicate-agents"></a>

Puede duplicar los agentes de chat personalizados existentes sin tener que crear uno desde cero. Los usuarios pueden duplicar los agentes de chat de la página de lista mediante el botón de acción **Duplicar**. Cuando duplicas un agente de chat, Amazon Quick crea un nuevo agente de chat con el formato de nombre «[Nombre original] (copia)», que puedes editar. Todos los campos y configuraciones del agente de chat original se copian en la nueva versión del agente de chat. Una vez duplicados, puede asignar permisos de acceso de usuario personalizados al agente de chat duplicado y compartirlos.

El siguiente procedimiento describe cómo duplicar los agentes de chat.

**Para duplicar agentes de chat personalizados**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la columna **Acciones** del agente de chat que quieras compartir, selecciona el icono del menú y, a continuación, selecciona **Duplicar**.

   Se te redirigirá a un modal de duplicación de un agente de chat con campos rellenados previamente.

1. Realiza los cambios que necesites, como añadir los permisos de usuario y grupo correctos y vincularlos a los recursos que desees. A continuación, selecciona **Iniciar para lanzar** tu agente de chat duplicado.

## Elimina los agentes de chat
<a name="delete-agents"></a>

Puedes eliminar un agente de Amazon Quick chat de tu propiedad. A continuación se muestra el procedimiento para hacerlo.

**Para eliminar un agente de chat personalizado**

1. Inicia sesión en la consola Amazon Quick.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la columna **Acciones** del agente de chat que quieras compartir, selecciona el icono del menú y, a continuación, selecciona **Eliminar**.

# Fuentes de contexto y prácticas recomendadas para los agentes de chat
<a name="agent-knowledge-sources-best-practices"></a>

Al crear agentes de chat personalizados en Amazon Quick, tiene varias opciones para influir en el comportamiento de los agentes de chat y estructurar sus flujos de trabajo. La forma en que configure el contexto y las instrucciones del agente de chat tiene un impacto significativo en la forma en que su agente de chat actúa y responde a las interacciones de los usuarios. Saber cuándo utilizar las instrucciones, los documentos de referencia y los espacios es fundamental para crear agentes de chat eficaces que satisfagan las necesidades específicas de su empresa y ofrezcan resultados consistentes y fiables. En las siguientes secciones, se describe la mejor manera de utilizar el contexto y los conocimientos del agente de chat para su caso de uso.

**Topics**
+ [Tipos de contexto de agente](#knowledge-source-types)

## Tipos de contexto de agente
<a name="knowledge-source-types"></a>

Amazon Quick proporciona tres métodos distintos para configurar el comportamiento de los agentes de chat, cada uno de los cuales sirve para diferentes propósitos en el desarrollo de agentes de chat. Entender cómo cada método procesa el contenido y cuándo usarlo constituye la base de una configuración eficaz de los agentes de chat.

Los tres tipos de contexto disponibles en Amazon Quick son:
+ **Instrucciones de Persona**: orientación de alto nivel que Amazon Quick mejora mediante generativas AI
+ **Documentos de referencia**: documentos que proporcionan instrucciones exactas y permanecen activos en la memoria del agente de chat
+ **Spaces**: colecciones de recursos y documentos de Amazon Quick con capacidad de búsqueda desde los que los agentes de chat recuperan información para responder a las preguntas

La siguiente sección detalla cuáles son y las mejores prácticas para utilizarlos.

**Topics**
+ [Instrucciones para el personaje del agente de chat](#agent-instructions)
+ [Documentos de referencia para agentes de chat](#in-context-files)
+ [Agentes y espacios de chat](#spaces)

### Instrucciones para el personaje del agente de chat
<a name="agent-instructions"></a>

Las instrucciones sobre el personaje del agente de chat se proporcionan en el campo de **instrucciones de Persona** al crear el agente de chat personalizado. Estas instrucciones sobre el personaje se perfeccionan mediante la IA generativa para garantizar que funcionan con todas las funciones y recursos del chat configurados para el agente de chat. Este enfoque es ideal cuando quieres que el sistema se base en tu dirección fundamental. Cuando utilizas instrucciones personales, Amazon Quick utiliza el generativo AI para interpretar y ampliar tus instrucciones personales en el backend, aumentar la orientación sencilla con contexto y capacidades adicionales, optimizar la solicitud para mejorar el rendimiento del agente de chat y mejorar la eficacia mediante AI mejoras impulsadas.

**Usa las instrucciones personales para:**
+ Proporcione orientación de alto nivel sobre el comportamiento y los objetivos, que Amazon Quick AI ha mejorado para personalizar las respuestas de los agentes
+ Indique cómo aprovechar los documentos de referencia para interacciones detalladas
+ Proporcione una guía general sobre el uso de los espacios y los conectores de acción en sus respuestas

Este enfoque funciona mejor para los agentes de chat de uso general y para los casos de uso exploratorio en los que desee obtener AI asistencia en el diseño de los agentes de chat.

**nota**  
El proceso AI de mejora puede modificar la redacción y la estructura originales para mejorar el rendimiento del agente de chat. En su lugar, las directrices fundamentales que deben permanecer inalteradas deberían colocarse en los documentos de referencia.

### Documentos de referencia para agentes de chat
<a name="in-context-files"></a>

Los documentos de referencia proporcionan plantillas específicas de procesos y respuestas que los agentes de chat deben seguir. Estos documentos de referencia forman parte del contexto permanente del agente de chat e incluyen hand-in-hand instrucciones personales y un estilo de respuesta para informar su comportamiento general.

Los documentos de referencia proporcionan un control total sobre el comportamiento de los agentes de chat al conservar el contenido tal y como está escrito. Este enfoque es esencial cuando la precisión y la coherencia son fundamentales. Al cargar documentos de referencia, Amazon Quick conserva la redacción precisa y las instrucciones específicas, mantiene el formato y la estructura exactos, proporciona un control directo sobre el comportamiento de los agentes de chat y garantiza la coherencia en todas las interacciones.

**Usa documentos de referencia cuando necesites:**
+ Control exacto en el que se deben conservar una redacción precisa y unas instrucciones específicas
+ Coherencia de la marca con tonos, terminología o formatos de respuesta específicos
+ Flujos de trabajo complejos con procesos de varios pasos que deben seguir secuencias exactas
+ Comportamiento predecible con respuestas consistentes en todas las interacciones

**Formatos de archivo compatibles:**
+ `.pdf`,`.txt`,`.html`, `.md` — Instrucciones, plantillas y directrices
+ `.csv`— Datos de referencia, tablas de consulta y ejemplos
+ `.doc`, `.docx` — Documentación detallada del proceso

Puede adjuntar hasta 10 archivos de un tamaño total de 50 MB como documentos de referencia. Amazon Quick extrae el texto de estos documentos y aplica un límite de 100 000 caracteres tras su procesamiento.

**Priorización y comportamiento de los archivos**  
Los marcos de comportamiento y los datos de referencia de los archivos permanecen activos incluso cuando los usuarios adjuntan contenido alternativo.
Las plantillas de respuesta pueden ajustarse temporalmente si los usuarios proporcionan instrucciones de formato contradictorias.

Los documentos de referencia sirven como manual de instrucciones del agente de chat y proporcionan el marco de comportamiento que permanece constante en todas las interacciones del usuario con el agente de chat.

### Agentes y espacios de chat
<a name="spaces"></a>

Los espacios proporcionan repositorios de conocimiento dinámicos y con capacidad de búsqueda que los agentes de chat consultan durante las conversaciones para recuperar información específica. Al vincular los espacios a los agentes de chat, los agentes de chat de Amazon Quick buscan respuestas dentro del espacio para generarlas. Los espacios se destacan en la gestión del conocimiento organizacional que evoluciona con el tiempo, lo que permite a varios miembros del equipo contribuir y actualizar la información y, al mismo tiempo, mantener los límites de seguridad adecuados a través del sistema de permisos de Amazon Quick.

Utilice los espacios con agentes de chat para:
+ Permitir a los agentes de chat buscar y recuperar datos empresariales actuales
+ Proporcionar a los agentes de chat acceso a los repositorios de conocimiento de la organización
+ Permitir que los agentes de chat respeten los límites de permisos existentes
+ Conectar los agentes de chat con colecciones de documentos colaborativos
+ Dar a los agentes de chat acceso a información actualizada periódicamente
+ Permitir a los agentes de chat consultar paneles y conjuntos de datos en vivo

Los espacios funcionan como la capa de conocimiento dinámica del agente de chat, lo que permite el acceso en tiempo real a la información de la organización y, al mismo tiempo, mantiene los límites de seguridad y los flujos de trabajo colaborativos.

# Usa un agente de chat
<a name="use-agents"></a>

Puedes usar un agente de Amazon Quick Chat para hacer preguntas y realizar tus tareas. Cuando haces una pregunta, el agente de chat analiza los últimos datos aprobados que se han compartido contigo para generar una respuesta completa.

Puede hacer preguntas complejas en un lenguaje sencillo y obtener una respuesta detallada. También puedes usar un agente de Quick Chat para que realice tareas por ti, como redactar un mensaje de correo electrónico, crear un ticket o usar flujos.

**Para usar agentes de chat personalizados**

1. Inicie sesión en la consola rápida.

1. En el menú de navegación de la izquierda, selecciona **Agentes de chat**

1. A continuación, en la columna **Acciones** del agente de chat que quieras compartir, selecciona el icono del menú y, a continuación, selecciona **Chat**.

   Se abrirá una interfaz de chat que podrás usar para interactuar con tu agente de chat.

Puedes interactuar con un agente de chat de las siguientes maneras:
+ Vea ejemplos de instrucciones y acceda a ellas para demostrar posibles preguntas y tareas
+ Obtenga respuestas contextuales de las fuentes de datos de la organización
+ Continúe o inicie nuevas conversaciones
+ Analice los datos, incluidos el resumen y el análisis comparativo
+ Tome medidas como programar reuniones y crear tickets
+ Vea las citas de origen de las respuestas con referencias numeradas en las que se puede hacer clic
+ Carga de archivos
+ Ver el historial de conversaciones

**sugerencia**  
También puedes usar tus agentes de chat mientras automatizas tus tareas rutinarias con Quick Flows. Para obtener más información, consulte [Agente de chat](ai-response-steps.md#chat-agent-step).

Para obtener más información sobre cómo chatear con agentes de chat, consulte [Uso del chat rápido de Amazon](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html).