

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.

# Bases de conocimientos
<a name="knowledge-base-integrations"></a>

Una base de conocimientos es una colección organizada e indexada de documentos o contenido de fuentes de datos optimizadas para la recuperación generativa y la respuesta a preguntas mediante IA. Ya sea que tu equipo almacene la documentación en Confluence, colabore o gestione archivos en el almacenamiento en la nube, puedes reunir toda esta información en una experiencia de búsqueda unificada mediante SharePoint la creación de bases de conocimiento.

 Las integraciones integradas se pueden configurar con tan solo unos clics para sincronizar tus datos en Quick y aprovechar sin esfuerzo los conocimientos de tu organización en Google Drive, Confluence OneDrive SharePoint, S3 y Web Crawler. Ya sea que tu equipo almacene la documentación en Confluence, colabore o gestione archivos almacenados en la nube, puedes reunir toda esta información en una experiencia de búsqueda unificada con la ayuda de las bases de conocimiento. SharePoint 

## Funcionamiento de las bases de conocimientos
<a name="how-knowledge-bases-work"></a>

La base de conocimientos es una colección indexada de documentos o contenido de fuentes de datos como Google Drive, optimizada para la recuperación generativa y la respuesta a preguntas mediante IA. Se pueden crear varias bases de conocimiento a partir de la misma fuente y todas pueden residir en un índice rápido compartido. Por ejemplo, si sincronizas dos carpetas de Google Drive y creas dos bases de conocimiento: una para «Documentos de política» para responder a preguntas como *«Cuál es nuestra política de reembolsos»* y otra para «Comentarios de los clientes» para responder a preguntas como *«Cuáles son las quejas más frecuentes de los clientes»*, ambas pueden formar parte del mismo índice. Quick los distingue mediante el identificador de la base de conocimientos, por lo que las consultas se pueden filtrar para recuperar solo los documentos relevantes de la base de conocimientos deseada. Esto permite a los usuarios organizar, proteger y recuperar información relevante para diferentes dominios o casos de uso, aunque los datos subyacentes estén indexados juntos.

Sus bases de conocimiento se pueden utilizar de forma individual o compartirse con los miembros del equipo a través de Amazon Quick Spaces. Nuestro exhaustivo control de acceso garantiza la seguridad a nivel de la base de conocimientos, lo que garantiza que los usuarios solo reciban información de las bases de conocimiento a las que estén autorizados a acceder.

### Proceso de creación
<a name="knowledge-base-creation-process"></a>

Puede crear bases de conocimiento al mismo tiempo que configura una nueva integración de acceso a los datos y utilizar las integraciones existentes para crear bases de conocimiento adicionales:

1. **Configuración de integración de acceso a datos**: Conéctese a su fuente de datos externa

1. **Selección de contenido**: elija qué contenido desea incluir mediante los filtros y la configuración del alcance

1. **Indexación**: Amazon Quick procesa e indexa el contenido seleccionado

1. **Disponibilidad**: la base de conocimientos pasa a estar disponible para su uso en los espacios y por parte de los agentes de IA

### Capacidades
<a name="knowledge-base-capabilities"></a>

Cada base de conocimientos ofrece las siguientes capacidades:
+ **Indexación de contenido**: procesa texto, documentos y datos estructurados de fuentes externas
+ Búsqueda **semántica: permite realizar búsquedas** mediante inteligencia artificial en todo el contenido indexado
+ **Sincronización automática**: mantiene el contenido up-to-date con programas de sincronización configurables
+ **Control de acceso detallado**: garantiza que los usuarios solo reciban información de las bases de conocimiento a las que están autorizados a acceder.
+ **Uso de varios espacios**: se puede usar en varios espacios y por diferentes agentes de IA

## Flujo de trabajo general
<a name="general-workflow"></a>

El flujo de trabajo típico para trabajar con bases de conocimiento sigue estos pasos:

1. **Configura la integración de la fuente de datos**: Conéctate a tu aplicación externa (como SharePoint Google Drive o Confluence) con la autenticación adecuada. Para obtener más información, consulte [Guías específicas de integración](integration-guides.md).

1. **Crea una base de conocimientos**: puedes crear una base de conocimientos mientras configuras tu nueva integración. Configure sus filtros de contenido configurando filtros de inclusión, restricciones de tipos de archivos y selecciones de carpetas para centrarse en el contenido relevante.

1. **Establece un programa de sincronización**: la frecuencia de actualización de datos está configurada de forma diaria de forma predeterminada. Puede editar la frecuencia de sincronización para configurar la frecuencia con la que se debe actualizar la base de conocimientos con contenido nuevo de la fuente.

1. **Supervise y administre**: revise el estado de la sincronización y administre los permisos de acceso.

## Parámetros de configuración comunes
<a name="common-configuration-settings"></a>

Las bases de conocimiento comparten patrones de configuración comunes en las distintas integraciones de fuentes de datos. Comprender estos ajustes le ayuda a optimizar la indexación del contenido y a gestionar el comportamiento de sincronización de forma eficaz.

**nota**  
Si bien estas opciones de configuración están disponibles en la mayoría de las integraciones, los ajustes específicos y las opciones disponibles pueden variar en función de la integración de fuente de datos que elija.

### Límites de tamaño y contenido de los archivos
<a name="file-size-and-content-limits"></a>

Configure los límites de tamaño de los archivos para optimizar el rendimiento del procesamiento y administrar los costos de almacenamiento. Los límites específicos varían según el tipo de contenido y se muestran en la consola al configurar la base de conocimientos.

**Documentos de texto estándar**  
Se aplica a documentos como PDFs archivos de Word y archivos de texto. El límite de tamaño de los archivos es de 500 MB.

**Archivos de vídeo**  
Disponible cuando el procesamiento de vídeo está activado. Los formatos compatibles incluyen`.mp4`,`.mov`,`.m4v`. El límite de tamaño del archivo es de 10 GB (10240 MB). Quick Index admite hasta **10 archivos de vídeo por GB de almacenamiento**. Si su caso de uso requiere volúmenes de vídeo más altos, abra un ticket con el servicio de AWS asistencia para ampliar este límite.

**Archivos de audio**  
Disponible cuando el procesamiento de audio está activado. Los formatos compatibles incluyen `.mp3` ` .wav`` .m4a`,`.flac`, y` .ogg`. El límite es de 2 GB (2048 MB) para los archivos de audio.  
Los archivos cuyo texto extraído supere el límite de 30 MB del sistema no se indexan, independientemente del tamaño del archivo original. La cantidad máxima de texto que se puede extraer de un único documento es de 30 MB.

**Imágenes**  
Quick Index aplica los siguientes límites a las imágenes:  
+ **Límite por documento**: 500 imágenes por documento
+ **Límite por GB**: 10 000 imágenes por GB de almacenamiento indexado
+ **Límite por índice**: 2 millones de imágenes por índice
Si su caso de uso requiere volúmenes de imágenes más altos, abra un ticket con el servicio de AWS asistencia para ampliar estos límites.

### Sincronice el cronograma y las medidas
<a name="sync-schedule-and-safeguards"></a>

Configure la frecuencia con la que su base de conocimientos se actualiza y protéjala contra la eliminación involuntaria de contenido:

#### Frecuencia de sincronización
<a name="sync-frequency"></a>

La frecuencia de actualización de datos se establece en diaria de forma predeterminada. Puede editar la frecuencia de sincronización para configurar la frecuencia con la que la base de conocimientos debe actualizarse con contenido nuevo de la fuente

#### Protección contra la eliminación de documentos
<a name="document-deletion-safeguard"></a>

Proteja su contenido indexado de la eliminación masiva accidental mediante el establecimiento de un límite máximo de porcentaje de eliminación. Si un trabajo de sincronización elimina más documentos de los que permite tu límite, se omite la fase de eliminación y se preserva el contenido indexado existente.

Esta protección protege contra problemas temporales de red, cambios de permisos o problemas en el sistema de origen que podrían hacer que el contenido no esté disponible temporalmente.

# Mejores prácticas de gestión ACLs en bases de conocimiento
<a name="acl-best-practices-kb"></a>

Al utilizar bases de conocimiento con listas de control de acceso (ACLs), usted es responsable de mantener la precisión de las identidades y permisos de los usuarios. Esto garantiza que las personas adecuadas puedan acceder a los documentos correctos. De forma predeterminada, Quick sincroniza automáticamente los cambios de identidad y de ACL a nivel de documento cada 24 horas. Cualquier actualización de los usuarios o permisos tardará hasta un día en aparecer en el sistema, a menos que haya configurado un programa de actualización diferente para sus bases de conocimientos.

Para obtener más información sobre la configuración ACLs de una fuente de datos específica, consulte[Integración de Amazon S3](s3-integration.md).

**nota**  
Quick trata todas las direcciones de correo electrónico sin distinguir entre mayúsculas y minúsculas. `JohnDoe@example.com`,`johndoe@example.com`, y todas `JOHNDOE@example.com` se consideran el mismo usuario.

## Escenarios importantes de administración de usuarios
<a name="acl-user-management-scenarios"></a>

**Descripción de la vinculación de correos electrónicos**

Las direcciones de correo electrónico se vinculan a los usuarios de Quick de forma dinámica cuando los usuarios inician interacciones de chat. Esta encuadernación sigue un first-come-first-serve enfoque. El primer usuario que chatee con una dirección de correo electrónico determinada establece el enlace para esa identidad dentro del espacio de nombres.

**Cuando un empleado deja su organización**

Cuando un empleado se vaya, limpie su acceso lo antes posible:

1. Actualice los archivos de configuración de la ACL para eliminar las referencias a su dirección de correo electrónico. Por ejemplo, en Amazon S3, actualice el archivo ACL global o los archivos de metadatos.

1. Actualice las bases de conocimiento para aplicar los cambios.

Esto evita posibles problemas de seguridad si el correo electrónico se reasigna posteriormente a otra persona.

**Cuando se reasigna una dirección de correo electrónico a un nuevo empleado**
+ El acceso a la base de conocimientos compatible con ACL se bloquea automáticamente para la dirección de correo electrónico reasignada a fin de proteger la seguridad de los datos.
+ Póngase en contacto con Quick Support para limpiar el acceso del usuario anterior antes de que el nuevo empleado pueda acceder a los documentos asociados a ese correo electrónico.

## Limitaciones
<a name="acl-limitations"></a>

Al configurar el nivel de documento ACLs para sus bases de conocimientos, tenga en cuenta estas limitaciones:
+ La **configuración de la ACL a nivel de documento es permanente**: no se puede habilitar ACLs en bases de conocimiento creadas sin el soporte de la ACL. Tampoco puede deshabilitarla ACLs una vez habilitada. Para cambiar la configuración de la ACL, cree una nueva base de conocimientos con la configuración que desee desde el principio.
+ **Direcciones de correo electrónico compartidas dentro de un espacio de nombres**: si varios usuarios de Quick comparten la misma dirección de correo electrónico dentro de un espacio de nombres, el sistema deniega el acceso a todos los que utilicen ese correo electrónico compartido. Esta protección evita que se conceda accidentalmente el acceso a los documentos a la persona equivocada.
+ **Alcance de la resolución de las ACL**: todas ACLs se resuelven en el espacio de nombres Quick del creador de la base de conocimientos. Esto se aplica tanto si se ACLs especifican por dirección de correo electrónico como por nombre de grupo. Quick busca las identidades en el contexto organizativo del creador para garantizar una resolución coherente de las identidades.
+ Plazos **de reciclaje de direcciones de correo electrónico**: si tu organización reasigna una dirección de correo electrónico de un empleado a otro, hay que tener en cuenta el momento oportuno. Si el empleado anterior nunca usó Quick para chatear o interactuar con la IA, y el correo electrónico se reasigna antes de la siguiente actualización de la ACL, el nuevo empleado puede acceder temporalmente a los documentos destinados al empleado anterior.

  Para evitarlo, complete los siguientes pasos en orden:

  1. Actualice su ACLs (si corresponde, como en Amazon S3) para eliminar el usuario anterior y añadir el nuevo.

  1. Actualice manualmente su base de conocimientos o espere a que se actualice automáticamente todos los días.

  1. Asigne la dirección de correo electrónico al nuevo empleado.

  Esto garantiza que los permisos de acceso estén sincronizados correctamente antes de que el nuevo usuario comience a usar Quick.
+ **Compatibilidad con la investigación**: las bases de conocimiento con el nivel de documento ACLs activado actualmente no son compatibles con Quick Research. Si necesita utilizar documentos de una base de conocimientos habilitada para ACL con fines de investigación, cree una base de conocimientos independiente sin ACLs esos documentos.

# Bases de conocimiento para la solución
<a name="troubleshooting-knowledge-bases"></a>

Cuando tenga problemas con su base de conocimientos de Quick, puede utilizar esta guía de solución de problemas para identificar y resolver problemas comunes. Los problemas de la base de conocimientos suelen estar relacionados con la sincronización de documentos, los errores en los trabajos de actualización o los permisos de acceso.

## Los documentos no aparecen en la base de conocimientos
<a name="documents-not-appearing"></a>

Si los documentos que espera ver no aparecen en su base de conocimientos, este problema puede estar provocado por varios factores.

**Causas habituales:**
+ **Sincronización en curso**: es posible que los documentos aún se estén procesando. Compruebe el estado de la actualización para confirmar que se ha completado.
+ **Formato de archivo no compatible**: compruebe que sus documentos estén en formatos compatibles: Word, Excel, PDF PowerPoint, CSV, TXT, RTF, JSON, XML, HTML
+ **Tamaño de archivo demasiado grande**: cada archivo debe tener menos de 50 MB.
+ **Permisos de acceso insuficientes**: confirme que la base de conocimientos tenga los permisos adecuados para acceder a la fuente del documento.
+ **Filtrado de documentos**: compruebe si los filtros o las reglas de exclusión impiden la indexación de determinados documentos.

**Para solucionar problemas:**

1. Revisa el historial de actualizaciones para ver los mensajes de error relacionados con documentos específicos que no se pudieron sincronizar.

1. Comprueba que los formatos de los documentos y los tamaños de los archivos cumplen los requisitos.

1. Compruebe los permisos de acceso y la configuración de conexión.

## El trabajo de actualización falla
<a name="refresh-job-fails"></a>

Un trabajo de actualización suele fallar cuando hay un error de configuración en la base de conocimientos o en la conexión a la fuente de datos.

**Causas habituales:**
+ **Problemas de permisos**: la integración carece de permisos suficientes para acceder a la fuente de datos.
+ **Errores de configuración**: configuración de conexión a la fuente de datos URLs o incorrecta.
+ **Limitaciones de recursos**: limitación de velocidad desde el sistema de origen.

**Para resolverlo:**

1. Compruebe los detalles del historial de actualizaciones para ver si hay mensajes de error específicos.

1. Compruebe que todos los ajustes y permisos de conexión estén configurados correctamente.

1. Realice la acción recomendada en función del mensaje de error.

## El trabajo de actualización finaliza con problemas
<a name="refresh-job-completes-with-issues"></a>

Cuando un trabajo de actualización finaliza con problemas, el trabajo se ha procesado correctamente, pero ha detectado problemas con algunos documentos.

**Qué significa esto:**
+ **Éxito parcial**: algunos documentos se sincronizaron correctamente y otros fallaron.
+ **Errores a nivel de documento: los** archivos individuales pueden tener problemas de formato, estar dañados o tener problemas de acceso.
+ Problemas con **los metadatos: problemas** con los metadatos del documento o la información asociada.
+ **Infracciones de tamaño o formato**: algunos archivos pueden superar los límites de tamaño o estar en formatos no compatibles.

**Para resolverlo:**

1. Revise los informes de actualización detallados para identificar qué documentos presentaron problemas.

1. Aborde los problemas de los documentos individuales.

1. Ejecute otra actualización después de resolver los problemas.

## El trabajo de actualización se realiza correctamente, pero no aparece ningún documento
<a name="refresh-job-succeeds-no-documents"></a>

Si un trabajo de actualización se muestra correctamente pero no aparece ningún documento en la base de conocimientos, compruebe estas posibles causas.

**Causas habituales:**
+ **Fuente vacía**: la ubicación de la fuente de datos configurada no contiene ningún documento.
+ **Configuración de ruta incorrecta**: la ruta de origen o los ajustes de conexión no apuntan a la ubicación correcta.
+ **Filtros de documentos: los** criterios de inclusión o exclusión pueden filtrar todos los documentos.
+ **Faltan permisos de lectura**: el trabajo se conectó correctamente, pero no tenía permisos para leer los documentos reales.

**Para resolverlo:**

1. Compruebe que la configuración de la fuente de datos apunta a la ubicación correcta.

1. Confirme que los documentos estén presentes en la ubicación especificada.

1. Compruebe que los permisos de acceso adecuados estén configurados.

1. Revise todos los filtros de documentos que puedan excluir contenido.

## Problemas de formato de archivo durante la actualización
<a name="file-format-issues"></a>

Las bases de conocimiento rápidas admiten formatos de archivo específicos. Los archivos deben cumplir los requisitos de formato, tamaño y límite de caracteres.

**Requisitos:**
+ **Formatos compatibles:** Word, Excel PowerPoint, PDF, CSV, TXT, RTF, JSON, XML, HTML
+ **Límite de tamaño de archivo:** 50 MB por archivo
+ **Estado del archivo:** no está dañado ni está protegido con contraseña

**Para resolver problemas de formato:**

1. Compruebe que los archivos cumplen los requisitos de formato y tamaño.

1. Convierte los formatos no compatibles en formatos compatibles.

1. Elimine la protección con contraseña de los archivos.

1. Compruebe que los archivos no estén dañados.

## Errores de acceso denegado
<a name="access-denied-errors"></a>

Los errores de acceso denegado suelen producirse debido a problemas de autenticación o autorización.

**Causas habituales:**
+ **Credenciales no válidas**: es posible que los identificadores de autenticación o las contraseñas hayan caducado.
+ **Permisos insuficientes**: la cuenta utilizada en la integración carece de acceso de lectura a la fuente de datos.
+ **Restricciones de red**: el firewall o las políticas de seguridad bloquean el acceso.
+ Problemas **de SSL/TLS: problemas con los** certificados en las conexiones seguras.

**Para resolverlos:**

1. **Verificar las credenciales de autenticación**: confirme que las credenciales de autenticación estén actualizadas y sean válidas. Edite la integración para volver a autenticarse y generar un nuevo token.

1. **Para las fuentes de datos de rastreadores web**: compruebe que las conexiones seguras estén configuradas correctamente y que los certificados SSL estén configurados correctamente y sean confiables.

1. **Póngase en contacto con el administrador del sistema**: si sigue teniendo problemas de acceso, póngase en contacto con el administrador del sistema. Es posible que tengan que ajustar los permisos o la configuración de seguridad.