기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기

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 참조를 참조하십시오.

  1. Qlik Sense 앱이나 스크립트를 만들고 데이터 로드 편집기 또는 스크립트를 엽니다.

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

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

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

  5. 필요한 구성을 선택합니다. 사용할 수 있는 각 옵션에 대한 자세한 내용은 사용할 수 있는 커넥터 구성을 참조하십시오.

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

  7. Azure API 버전을 입력합니다. 이 필드는 이미 현재 기본값으로 채워져 있습니다.
  8. 필요에 따라 다른 기본 매개 변수 값을 조정합니다.

    매개 변수에 대한 추가 설명은 구성 가능한 설정을 참조하십시오.

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

데이터 연결은 앱이 만들어진 공간에 저장되므로 다른 Qlik Sense 앱이나 스크립트에서 재사용할 수 있습니다.

연결을 만든 후에는 이를 사용하여 OpenAI로 보낼 데이터를 로드할 수 있습니다. 또한 차트 표현식에서 사용할 수 있습니다. 자세한 내용은 Azure OpenAI 연결에서 데이터 선택 및 로드시각화 표현식에서 Azure OpenAI 연결 사용를 참조하십시오.

구성 가능한 설정

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

연결 대화 상자에서 구성 가능한 설정
필드 설명
구성 선택 구성에서 커넥터 구성을 선택합니다. 자세한 내용은 사용할 수 있는 커넥터 구성을 참조하십시오.
인증 Azure OpenAI API 키를 입력합니다. 자세한 내용은 Azure OpenAI Service REST API 참조를 참조하십시오.
Azure OpenAI 요청
  • Azure 리소스 이름: Microsoft Azure에서 설정한 리소스 프로젝트입니다.

    Azure 배포 이름: 선택한 OpenAI 모델에 대해 설정한 특정 배포입니다.

  • Azure API 버전: Azure의 API 버전입니다. 이는 현재 기본값으로 미리 채워져 있습니다.

OpenAI 요청
  • 온도: 사용할 샘플링 온도입니다.

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

  • 상단 P: 핵 샘플링을 조정합니다. 이는 온도 샘플링의 대안으로 변경할 수 있습니다.

  • 빈도 페널티: 모델이 기존 토큰에서 그대로 반복되는 새 토큰에 페널티를 적용하는 정도입니다.

  • 존재 페널티: 도입되는 시점까지 텍스트에 이미 포함된 새 토큰에 모델이 페널티를 적용하는 정도입니다.

  • 사용자: 정책 위반을 모니터링하는 데 도움이 되는 최종 사용자 ID입니다.

연결

고유 식별자를 포함하는 입력 데이터 테이블의 필드인 연결 필드를 지정합니다.

키를 사용하여 소스 필드 테이블과 연결되도록 반환된 결과 테이블에 대한 종료 지점 요청을 수행할 때 소스 데이터에 이 필드를 포함해야 합니다. 지정된 필드는 응답의 필드로 반환되며 응답이 데이터 모델의 소스 데이터와 연결되도록 합니다. 소스 데이터에서 또는 테이블 로드 프로세스의 일부로 고유 ID를 가진 모든 필드가 될 수 있습니다.

이름 연결의 이름입니다. 이름을 입력하지 않으면 기본 이름이 사용됩니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!