기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon OpenSearch Service의 자연어 쿼리 생성
<a name="natural-language-query"></a>

Amazon OpenSearch Service의 자연어 쿼리 생성 기능을 사용하여 자연어를 통해 운영 및 보안 로그 데이터를 쿼리할 수 있습니다. OpenSearch는 확장성과 성능이 뛰어난 로그 분석 및 검색 엔진이므로 로그 데이터를 탐색하는 데 이상적인 옵션입니다. 이제 자연어를 사용하여 이러한 로그를 탐색할 수 있습니다. 이 기능을 사용하면 OpenSearch Piped Processing Language(PPL)에 의존하거나 쿼리를 빌드할 때 데이터 정의를 조회하지 않고도 문제를 식별할 수 있습니다. 버전 2.13 이상의 OpenSearch Service 도메인에서 자연어 쿼리 생성 기능을 사용할 수 있습니다. 세분화된 액세스 제어를 활성화해야 합니다.

이 기능은 [OpenSearch Assistant Toolkit](https://opensearch.org/docs/latest/ml-commons-plugin/opensearch-assistant/)을 사용하여 빌드되었습니다. 대규모 언어 모델에 연결하는 유사한 기능을 생성하려면 툴킷을 사용하여 자체 에이전트와 도구를 구성할 수 있습니다.

## 사전 조건
<a name="Prerequisites"></a>

자연어 쿼리 생성 기능을 사용하려면 먼저 도메인에 다음 조건이 갖추어져 있어야 합니다.
+ 버전 2.13 이상.
+ 서비스 소프트웨어 R20240520-P4 이상.
+ 세분화된 액세스 제어가 활성화된 상태입니다. 자세한 내용은 [세분화된 액세스 제어 활성화](fgac.md#fgac-enabling) 단원을 참조하십시오.

## 시작하기
<a name="natural-language-query-getting-started"></a>

자연어 쿼리 생성은 세분화된 액세스 제어가 활성화된 버전 2.13 이상에서 생성된 모든 도메인에서 기본적으로 활성화됩니다.

다른 도메인의 경우 **자연어 쿼리 생성 및 Amazon Q Developer 기능 활성화**를 선택하여 활성화합니다.

활성화한 후 OpenSearch Dashboards의 **로그** 페이지로 이동합니다. **이벤트 탐색기**를 선택하고 쿼리 도우미에 질문합니다.

## 권한 구성
<a name="natural-language-query-permissions"></a>

기존 OpenSearch Service 도메인에서 자연어 쿼리 생성을 활성화하면 도메인에 **query\$1assistant\$1access** 역할이 정의되지 않았을 수 있습니다. 관리자가 아닌 사용자는 이 역할에 매핑되어 세분화된 액세스 제어를 사용하는 도메인의 웜 인덱스를 관리해야 합니다. 수동으로 **query\$1assistant\$1access** 역할을 생성하려면 다음 단계를 수행합니다.

1. OpenSearch 대시보드에서 **보안**으로 이동하고 **역할**을 선택합니다.

1. **역할 생성**을 선택하고 다음 클러스터 권한을 구성합니다.
   + `cluster:admin/opensearch/ml/config/get`
   + `cluster:admin/opensearch/ml/execute`
   + `cluster:admin/opensearch/ml/predict`
   + `cluster:admin/opensearch/ppl`

1. 역할 이름을 **query\$1assistant\$1access**로 지정합니다.

1. **역할 생성**을 선택합니다. 이제 **query\$1assistant\$1access** 역할을 사용할 수 있습니다.
**참고**  
자연어 질문을 사용하려는 인덱스에 대한 `indices:admin/mappings/get` 및 `read` 인덱스 권한도 있어야 합니다.

## 구성 자동화
<a name="natural-language-query-automation"></a>

Flow Framework는 쿼리 생성 및 대화형 채팅과 같은 사용 사례에 대한 [OpenSearch 구성을 자동화](https://opensearch.org/docs/latest/automating-configurations/index/)하는 방법을 제공하는 OpenSearch 플러그인입니다. 플러그인은 자연어 쿼리 생성 기능을 활성화하는 리소스를 추적하므로 흐름 프레임워크 인덱스는 쿼리 지원을 사용하는 각 도메인에 대한 템플릿을 저장합니다.

흐름 프레임워크를 사용하면 [사전 정의된 템플릿](https://opensearch.org/docs/latest/automating-configurations/workflow-templates/) 세트에서 선택하거나 생성형 모델의 백엔드로 OpenSearch를 준비하는 기계 학습 커넥터, 도구, 에이전트 및 기타 구성 요소에 대한 자체 자동화를 생성할 수 있습니다.