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.

# Generación de consultas en lenguaje natural en Amazon OpenSearch Service
<a name="natural-language-query"></a>

La función de generación de consultas en lenguaje natural de Amazon OpenSearch Service te permite consultar los datos del registro operativo y de seguridad mediante un lenguaje natural. OpenSearch es una opción ideal para explorar los datos de registro, ya que es un motor de búsqueda y análisis de registros altamente escalable y eficiente, y ahora puede utilizar el lenguaje natural para explorar estos registros. Esta función le permite identificar problemas sin tener que recurrir al lenguaje de procesamiento OpenSearch canalizado (PPL) ni tener que buscar las definiciones de los datos al crear las consultas. Puede utilizar la función de generación de consultas en lenguaje natural en los dominios de OpenSearch servicio con la versión 2.13 y posteriores. Debe tener el control de acceso detallado habilitado. 

Esta función se creó con el kit de [herramientas OpenSearch Assistant](https://opensearch.org/docs/latest/ml-commons-plugin/opensearch-assistant/). Si desea crear características similares que se conecten a sus modelos lingüísticos de gran tamaño, puede utilizar el kit de herramientas para configurar sus propios agentes y herramientas.

## Requisitos previos
<a name="Prerequisites"></a>

Antes de poder utilizar la característica de generación de consultas en lenguaje natural, su dominio debe tener lo siguiente:
+ Versión 2.13 o posterior.
+ Software del servicio R20240520-P4 o superior.
+ Control de acceso detallado habilitado. Para obtener más información, consulte [Habilitar el control de acceso detallado](fgac.md#fgac-enabling).

## Introducción
<a name="natural-language-query-getting-started"></a>

La generación de consultas en lenguaje natural está habilitada de forma predeterminada en todos los dominios creados con la versión 2.13 o posterior que tengan el control de acceso detallado habilitado.

Para otros dominios, habilítelo seleccionando **Habilitar generación de consulta en lenguaje natural y características de Amazon Q Developer**.

Después de habilitarla, vaya a la página de **registros** en los OpenSearch paneles de control. Seleccione **Explorador de eventos** y haga una pregunta con el asistente para consultas.

## Configuración de permisos
<a name="natural-language-query-permissions"></a>

Si habilita la generación de consultas en lenguaje natural en un dominio de OpenSearch servicio preexistente, es posible que la función **query\$1assistant\$1access** no esté definida en el dominio. Los usuarios que no sean administradores deben estar asignados a este rol para poder administrar índices templados en los dominios mediante un control de acceso detallado. Para crear el rol **query\$1assistant\$1access** de forma manual, siga estos pasos:

1. ****En los OpenSearch paneles, vaya a Seguridad y elija Roles.****

1. Elija **Crear rol** y configure los siguientes permisos de clúster: 
   + `cluster:admin/opensearch/ml/config/get`
   + `cluster:admin/opensearch/ml/execute`
   + `cluster:admin/opensearch/ml/predict`
   + `cluster:admin/opensearch/ppl`

1. Asigne al rol el nombre **query\$1assistant\$1access**.

1. Elija **Crear rol**. El rol **query\$1assistant\$1access** ya está disponible.
**nota**  
También debe tener los permisos de índice `indices:admin/mappings/get` y `read` para los índices con los que desee utilizar las preguntas en lenguaje natural.

## Automatización de la configuración
<a name="natural-language-query-automation"></a>

Flow Framework es un OpenSearch complemento que proporciona una forma de [automatizar OpenSearch las configuraciones](https://opensearch.org/docs/latest/automating-configurations/index/) para casos de uso, como la generación de consultas y el chat conversacional. Como el complemento rastrea los recursos que permiten la característica de generación de consultas en lenguaje natural, el índice de Flow Framework almacena una plantilla para cada dominio que utiliza el asistente para consultas.

Flow Framework te permite seleccionar entre un conjunto de [plantillas predefinidas](https://opensearch.org/docs/latest/automating-configurations/workflow-templates/) o crear tus propias automatizaciones para los conectores, las herramientas, los agentes y otros componentes del aprendizaje automático que sirven de base OpenSearch para los modelos generativos.