As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Geração de consultas em linguagem natural no Amazon OpenSearch Service
<a name="natural-language-query"></a>

O recurso de geração de consultas em linguagem natural no Amazon OpenSearch Service permite que você consulte seus dados de log operacionais e de segurança por meio de linguagem natural. OpenSearch é uma opção ideal para explorar dados de registro porque é um mecanismo de pesquisa e análise de registros altamente escalável e eficiente, e agora você pode usar linguagem natural para explorar esses registros. Esse recurso permite identificar problemas sem depender da OpenSearch Piped Processing Language (PPL) ou ter que pesquisar definições de dados ao criar suas consultas. Você pode usar o recurso de geração de consultas de linguagem natural em domínios OpenSearch de serviço com a versão 2.13 e posterior. O controle de acesso refinado deve estar habilitado. 

Esse recurso foi criado com o [OpenSearch Assistant Toolkit](https://opensearch.org/docs/latest/ml-commons-plugin/opensearch-assistant/). Se quiser criar atributos semelhantes que se conectem aos seus modelos grandes de linguagem, você poderá usar o kit de ferramentas para configurar seus próprios atendentes e ferramentas.

## Pré-requisitos
<a name="Prerequisites"></a>

Antes de usar o atributo de geração de consultas em linguagem natural, o domínio deve ter o seguinte:
+ Versão 2.13 ou posterior.
+ Software de serviço R20240520-P4 ou superior.
+ Controle de acesso refinado habilitado. Para saber mais, consulte [Habilitar o controle de acesso detalhado](fgac.md#fgac-enabling).

## Introdução
<a name="natural-language-query-getting-started"></a>

A geração de consultas em linguagem natural é habilitada por padrão em todos os domínios criados com a versão 2.13 ou posterior que tenha controle de acesso refinado habilitado.

Para outros domínios, habilite-a selecionando **Habilitar os recursos de geração de consultas em linguagem natural e o Amazon Q Developer**.

Depois de habilitá-lo, navegue até a página de **registros** em OpenSearch painéis. Escolha **Explorador de eventos** e faça uma pergunta com o assistente de consulta.

## Configurar permissões do
<a name="natural-language-query-permissions"></a>

Se você habilitar a geração de consultas de linguagem natural em um domínio de OpenSearch serviço preexistente, a função **query\$1assistant\$1access** pode não estar definida no domínio. Os usuários não administradores deverão ser mapeados nessa função para poderem gerenciar índices warm usando o controle de aceso detalhado. Para criar manualmente o perfil **query\$1assistant\$1access**, realize as seguintes etapas:

1. Em OpenSearch Painéis, acesse **Segurança** e escolha **Funções**.

1. Escolha **Criar perfil** e configure as seguintes permissões de cluster: 
   + `cluster:admin/opensearch/ml/config/get`
   + `cluster:admin/opensearch/ml/execute`
   + `cluster:admin/opensearch/ml/predict`
   + `cluster:admin/opensearch/ppl`

1. Nomeie o perfil **query\$1assistant\$1access**.

1. Selecione **Criar perfil**. O perfil **query\$1assistant\$1access** agora está disponível.
**nota**  
Você também deve ter as permissões de índice `indices:admin/mappings/get` e `read` para os índices com os quais deseja usar perguntas em linguagem natural.

## Automação de configuração
<a name="natural-language-query-automation"></a>

O Flow Framework é um OpenSearch plug-in que fornece uma maneira de [automatizar OpenSearch configurações](https://opensearch.org/docs/latest/automating-configurations/index/) para casos de uso, como geração de consultas e bate-papo conversacional. Como o plug-in rastreia os recursos que habilitam o atributo de geração de consultas em linguagem natural, o índice da estrutura de fluxo armazena um modelo para cada domínio que usa o assistente de consulta.

O Flow Framework permite que você selecione um conjunto de [modelos predefinidos](https://opensearch.org/docs/latest/automating-configurations/workflow-templates/) ou crie suas próprias automações para conectores, ferramentas, agentes e outros componentes de aprendizado de máquina que se preparam OpenSearch como back-end para modelos generativos.