# Azure OpenAI 연결 만들기

Azure OpenAI와 통신하려면 Azure OpenAI 분석 소스에 대한 연결을 만듭니다.

이러한 연결에서 수신된 데이터는 로드 스크립트 및 차트 표현식에서 사용되어 Qlik Sense 분석 응용 프로그램 또는 스크립트를 향상시킬 수 있습니다.

## 시작하기 전에

Microsoft Azure 계정 내에서 Azure OpenAI 서비스는 Azure의 Cognitive Services에 위치하며 기본적으로 활성화되어 있지 않습니다. Azure OpenAI 서비스를 활성화하는 데 도움이 필요하면 Microsoft에 문의하십시오.

## 사용할 수 있는 커넥터 구성

다음 구성 중 하나로 Azure OpenAI 분석 연결을 설정합니다.

### OpenAI 완료 API

이 구성은 완료 API에 질문으로 데이터의 각 행을 보냅니다(성능 향상을 위해 작은 배치로). 각 응답은 입력과 동일한 수의 행이 있는 테이블에 텍스트로 저장됩니다.

이 구성은 로드 스크립트와 차트 표현식 모두에서 사용할 수 있습니다.

### OpenAI 채팅 완료 API

이 구성은 각 데이터 행을 OpenAI 채팅 완료 API에 대한 요청으로 보냅니다. 이 경우 요청은 "사용자" 메시지 역할로 이루어지며 Qlik의 각 데이터 행은 별도의 요청으로 전송됩니다.

정보 메모여러 행을 채팅 컨텍스트로 보내는 것은 지원되지 않습니다. 단일 요청 행에 모든 질문을 포함해야 합니다.

이 구성은 로드 스크립트와 차트 표현식 모두에서 사용할 수 있습니다.

## 연결 만들기

Azure OpenAI 분석 커넥터에 대한 연결을 분석 활동 센터의 만들기 페이지에서 또는 이미 만든 응용 프로그램의 데이터 로드 편집기에서 만들 수 있습니다. 연결을 만들려면 아래 단계를 따르십시오.

매개 변수 값을 설정하는 방법에 대한 자세한 내용은 [Azure OpenAI Service REST API 참조](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)를 참조하십시오.

다음과 같이 하십시오.

1. 새 Qlik Sense 응용 프로그램 또는 스크립트를 만들고 데이터 로드 편집기 또는 스크립트을(를) 엽니다.

2. 새 연결 만들기를 클릭합니다.

3. 공간에서 연결이 위치할 공간을 선택합니다.

4. 분석 소스에서 Azure OpenAI를 클릭합니다.

5. 필요한 구성을 선택합니다. 사용할 수 있는 각 옵션에 대한 자세한 내용은 [사용할 수 있는 커넥터 구성](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl)을 참조하십시오.

6. Azure OpenAI API 키를 입력합니다.

7. Azure API 버전을 입력합니다. 이 필드는 이미 현재 기본값으로 채워져 있습니다.

8. 필요에 따라 다른 기본 매개 변수 값을 조정합니다.

   매개 변수에 대한 추가 설명은 [구성 가능한 설정](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Configur)을 참조하십시오.

   정보 메모필요에 따라 연결이 제대로 작동하려면 거의 항상 최대 토큰 매개 변수 값을 변경해야 합니다. 이 매개 변수는 생성될 응답의 크기를 제어합니다.

9. 만들기를 클릭합니다.

데이터 연결은 응용 프로그램이 생성된 공간에 저장되므로 다른 Qlik Sense 응용 프로그램 또는 스크립트에서 재사용할 수 있습니다.

연결을 만들면 이를 사용하여 Azure OpenAI로 보낼 데이터를 로드할 수 있습니다. 또한 차트 표현식에서 사용할 수 있습니다. 자세한 내용은 [Azure OpenAI 연결에서 데이터 선택 및 로드](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-load.htm) 및 [시각화 표현식에서 Azure OpenAI 연결 사용](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-use.htm)를 참조하십시오.

## 구성 가능한 설정

다음 표의 설정은 연결 대화 상자에서 구성할 수 있습니다.

연결 대화 상자에서 구성 가능한 설정

| 필드 | 설명 |
| --- | --- |
| 구성 선택 | 구성에서 커넥터 구성을 선택합니다. 자세한 내용은 [사용할 수 있는 커넥터 구성](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl)을 참조하십시오. |
| 인증 | Azure OpenAI API 키를 입력합니다. 자세한 내용은 [Azure OpenAI Service REST API 참조](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)를 참조하십시오. |
| Azure OpenAI 요청 | <ul> <li> <p><span>Azure 리소스 이름</span>: <span>Microsoft Azure</span>에서 설정한 리소스 프로젝트입니다.</p> <p><span>Azure 배포 이름</span>: 선택한 OpenAI 모델에 대해 설정한 특정 배포입니다.</p> </li> <li> <p><span>Azure API 버전</span>: Azure의 API 버전입니다. 이는 현재 기본값으로 미리 채워져 있습니다.</p> </li> </ul> |
| OpenAI 요청 | <ul> <li> <p><span>온도</span>: 사용할 샘플링 온도입니다.</p> </li> <li> <p><span>최대 토큰</span>: 이 매개 변수는 생성할 최대 토큰 수를 조정합니다. 즉, 생성될 응답의 크기를 제어합니다. 필요에 따라 연결이 제대로 작동하려면 거의 항상 기본값을 변경해야 합니다.</p> </li> <li> <p><span>상단 P</span>: 핵 샘플링을 조정합니다. 이는 <span>온도</span> 샘플링의 대안으로 변경할 수 있습니다.</p> </li> <li> <p><span>빈도 페널티</span>: 모델이 기존 토큰에서 그대로 반복되는 새 토큰에 페널티를 적용하는 정도입니다.</p> </li> <li> <p><span>존재 페널티</span>: 도입되는 시점까지 텍스트에 이미 포함된 새 토큰에 모델이 페널티를 적용하는 정도입니다.</p> </li> <li> <p><span>사용자</span>: 정책 위반을 모니터링하는 데 도움이 되는 최종 사용자 ID입니다.</p> </li> </ul> |
| 연결 | 고유 식별자를 포함하는 입력 데이터 테이블의 필드인 연결 필드를 지정합니다.<br><br>키를 사용하여 소스 필드 테이블과 연결되도록 반환된 결과 테이블에 대한 종료 지점 요청을 수행할 때 소스 데이터에 이 필드를 포함해야 합니다. 지정된 필드는 응답의 필드로 반환되며 응답이 데이터 모델의 소스 데이터와 연결되도록 합니다. 소스 데이터에서 또는 테이블 로드 프로세스의 일부로 고유 ID를 가진 모든 필드가 될 수 있습니다. |
| 이름 | 연결의 이름입니다. 이름을 입력하지 않으면 기본 이름이 사용됩니다. |

## 자세한 정보

* [Azure OpenAI 서비스 REST API 참조](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)