UpdateQuerySuggestionsConfig - Amazon Kendra

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.

UpdateQuerySuggestionsConfig

Actualiza la configuración de las sugerencias de consulta de un índice.

Amazon Kendra admite actualizaciones parciales, por lo que solo tienes que proporcionar los campos que quieres actualizar.

Si una actualización se está procesando actualmente (es decir, «está sucediendo»), debe esperar a que finalice la actualización antes de realizar otra actualización.

Es posible que las actualizaciones de la configuración de sugerencias de consultas no surtan efecto de inmediato. El tiempo para que la configuración actualizada surta efecto depende de las actualizaciones realizadas y del número de consultas de búsqueda del índice.

Aún puedes habilitar/deshabilitar las sugerencias de consultas en cualquier momento.

UpdateQuerySuggestionsConfigNo se admite actualmente enAWSRegión GovCloud (EE. UU. Oeste).

Sintaxis de la solicitud

{ "IncludeQueriesWithoutUserInformation": boolean, "IndexId": "string", "MinimumNumberOfQueryingUsers": number, "MinimumQueryCount": number, "Mode": "string", "QueryLogLookBackWindowInDays": number }

Parámetros de solicitud

Para obtener información sobre parámetros que son comunes a todas las acciones, consulteParámetros comunes.

La solicitud acepta los siguientes datos en formato JSON.

IncludeQueriesWithoutUserInformation

TRUEpara incluir consultas sin información del usuario (es decir, todas las consultas, independientemente del usuario), de lo contrarioFALSEpara incluir únicamente consultas con información de usuario.

Si transfiere información de usuario a Amazon Kendra junto con las consultas, puede establecer este indicador enFALSEe indique a Amazon Kendra que solo tenga en cuenta las consultas con información de usuario.

Si configuras comoFALSE, Amazon Kendra solo considera las consultas buscadas al menosMinimumQueryCountveces transversalMinimumNumberOfQueryingUsersusuarios únicos para sugerencias.

Si configuras comoTRUE, Amazon Kendra ignora toda la información del usuario y aprende de todas las consultas.

Type: Booleano

Obligatorio: No

IndexId

Identificador del índice para el que desea actualizar la configuración de sugerencias de consultas.

Type: Cadena

Restricciones de longitud: Longitud fija de 36.

Patrón: [a-zA-Z0-9][a-zA-Z0-9-]*

Obligatorio: Sí

MinimumNumberOfQueryingUsers

El número mínimo de usuarios únicos que deben buscar una consulta para que la consulta pueda sugerir a los usuarios.

Aumentar este número podría disminuir el número de sugerencias. Sin embargo, esto garantiza que muchos usuarios busquen una consulta y que sea realmente popular para sugerir a los usuarios.

La forma de ajustar este ajuste depende de sus necesidades específicas.

Type: Entero

Rango válido: Valor mínimo de 1. Valor máximo de 10000.

Obligatorio: No

MinimumQueryCount

El número mínimo de veces que debe buscarse una consulta para poder sugerir a los usuarios.

Al disminuir este número se incrementa el número de sugerencias. Sin embargo, esto afecta a la calidad de las sugerencias, ya que establece una barra baja para que una consulta se considere popular para sugerir a los usuarios.

La forma de ajustar este ajuste depende de sus necesidades específicas.

Type: Entero

Rango válido: Valor mínimo de 1. Valor máximo de 10000.

Obligatorio: No

Mode

Establezca el modo enENABLEDoLEARN_ONLY.

De forma predeterminada, Amazon Kendra habilita sugerencias de consultas.LEARN_ONLYpermite desactivar las sugerencias de consultas. Puede actualizarlo en cualquier momento.

EnLEARN_ONLY, Amazon Kendra sigue aprendiendo de las nuevas consultas para mantener las sugerencias actualizadas para cuando estés listo para volver a cambiar al modo HABILITADO.

Type: Cadena

Valores válidos: ENABLED | LEARN_ONLY

Obligatorio: No

QueryLogLookBackWindowInDays

Qué tan recientes son las consultas en la ventana de tiempo del registro de consultas.

El plazo es el número de días desde el día actual hasta los días pasados.

De forma predeterminada, Amazon Kendra lo establece en 180.

Type: Entero

Obligatorio: No

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

Errores

Para obtener información sobre errores que son comunes a todas las acciones, consulteErrores comunes.

AccessDeniedException

Código de estado HTTP: 400

ConflictException

Código de estado HTTP: 400

InternalServerException

Código de estado HTTP: 500

ResourceNotFoundException

Código de estado HTTP: 400

ThrottlingException

Código de estado HTTP: 400

ValidationException

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: