Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Generazione di query in linguaggio naturale in Amazon OpenSearch Service
<a name="natural-language-query"></a>

La funzionalità di generazione di query in linguaggio naturale di Amazon OpenSearch Service ti consente di interrogare i dati dei log operativi e di sicurezza tramite linguaggio naturale. OpenSearch è un'opzione ideale per esplorare i dati di log perché è un motore di analisi e ricerca dei log altamente scalabile e performante, e ora puoi usare il linguaggio naturale per esplorare questi log. Questa funzionalità consente di identificare i problemi senza fare affidamento sul OpenSearch Piped Processing Language (PPL) o dover cercare le definizioni dei dati durante la creazione delle query. È possibile utilizzare la funzionalità di generazione di query in linguaggio naturale sui domini di OpenSearch servizio con la versione 2.13 e successive. È necessario che il controllo granulare degli accessi sia abilitato. 

[Questa funzionalità è stata creata con l'Assistant ToolkitOpenSearch .](https://opensearch.org/docs/latest/ml-commons-plugin/opensearch-assistant/) Se desideri creare funzionalità simili che si colleghino ai tuoi modelli linguistici di grandi dimensioni, puoi utilizzare il toolkit per configurare agenti e strumenti personalizzati.

## Prerequisiti
<a name="Prerequisites"></a>

Prima di poter utilizzare la funzionalità di generazione di query in linguaggio naturale, il dominio deve avere quanto segue:
+ Versione 2.13 o successiva.
+ Software di assistenza R20240520-P4 o versione successiva.
+ Controllo granulare degli accessi abilitato. Per ulteriori informazioni, consulta [Abilitazione del controllo granulare degli accessi](fgac.md#fgac-enabling).

## Nozioni di base
<a name="natural-language-query-getting-started"></a>

La generazione di query in linguaggio naturale è abilitata per impostazione predefinita su tutti i domini creati con la versione 2.13 o successiva che hanno abilitato il controllo granulare degli accessi.

Per gli altri domini, abilitalo selezionando le **funzionalità Enable Natural Language Query Generation e Amazon Q Developer**.

Dopo averlo abilitato, vai alla pagina **Logs** in OpenSearch Dashboards. Scegli **Event Explorer** e fai una domanda con l'assistente alle query.

## Configurazione delle autorizzazioni
<a name="natural-language-query-permissions"></a>

Se abiliti la generazione di query in linguaggio naturale su un dominio di OpenSearch servizio preesistente, il ruolo **query\_assistant\_access** potrebbe non essere definito nel dominio. Gli utenti senza privilegi di amministratore devono essere mappati a questo ruolo in modo da gestire gli indici a caldo sui domini che utilizzano il controllo granulare degli accessi. Per creare manualmente il ruolo **query\_assistant\_access, effettuate le seguenti operazioni**:

1. ****In OpenSearch Dashboards, vai a Sicurezza e scegli Ruoli.****

1. Scegli **Crea ruolo** e configura le seguenti autorizzazioni del cluster: 
   + `cluster:admin/opensearch/ml/config/get`
   + `cluster:admin/opensearch/ml/execute`
   + `cluster:admin/opensearch/ml/predict`
   + `cluster:admin/opensearch/ppl`

1. Assegna un nome al ruolo **query\_assistant\_access**.

1. Scegli **Crea ruolo**. **Il ruolo query\_assistant\_access è ora disponibile.**
**Nota**  
È inoltre necessario disporre delle autorizzazioni `indices:admin/mappings/get` e `read` indicizzazione per gli indici con cui si desidera utilizzare le domande in linguaggio naturale.

## Automazione della configurazione
<a name="natural-language-query-automation"></a>

Flow Framework è un OpenSearch plug-in che fornisce un modo per [automatizzare OpenSearch le configurazioni](https://opensearch.org/docs/latest/automating-configurations/index/) per casi d'uso come la generazione di query e la chat conversazionale. Poiché il plug-in tiene traccia delle risorse che abilitano la funzionalità di generazione di query in linguaggio naturale, l'indice del framework flow memorizza un modello per ogni dominio che utilizza l'assistenza alle query.

Flow Framework consente di scegliere tra un set di [modelli predefiniti](https://opensearch.org/docs/latest/automating-configurations/workflow-templates/) o di creare automazioni personalizzate per connettori, strumenti, agenti e altri componenti di machine learning da preparare OpenSearch come backend per modelli generativi.