Tableau Server에서 AI를 사용하기 위한 필수 요건

Tableau Server에 Tableau Agent를 구성하고 설정하려면 다음이 필요합니다.

• Tableau Server 관리자 역할. Tableau의 AI 사이트 설정은 해당 사이트로 국한되며, 사용하도록 설정하면 해당 사이트에 액세스할 수 있는 모든 사용자가 AI 기능을 사용할 수 있습니다.

• 활성 LLM 공급자 계정 또는 사용자 지정 게이트웨이 끝점. 인증 방법에 따라 API 키, 끝점 URL 또는 OAuth 자격 증명을 포함하는 활성 배포 환경이 필요합니다.

• API 키. API 키 인증 모드를 사용할 경우 Tableau Server를 OpenAI, Azure OpenAI LLM 공급자 또는 사용자 지정 게이트웨이에 연결하려면 이 정보가 필요합니다. 표준 보안 모범 사례를 따르고 API 키를 정기적으로 교체하는 것이 좋습니다.

• Azure OpenAI를 사용하는 경우 Azure에 배포된 채팅/완성 모델 및 임베딩 모델.

• Tableau Agent가 사용자 요청을 이해하고 관련 출력을 반환하는 등의 작업을 완료하는 데 사용할 LLM 모델. 버전 2026.3부터 OpenAI 직접 연결을 사용하는 경우 제안된 기본값을 그대로 사용할 수 있습니다. 또한 사용자의 자체 모델을 선택할 수도 있습니다. Azure OpenAI 또는 사용자 지정 게이트웨이 연결을 사용하는 경우 사용할 모델을 직접 선택해야 합니다.

  Tableau에서는 최상의 결과를 위해 다음과 같은 모델을 권장합니다.

  • 사용자 요청 이해(소형/빠른 작업 모델): gpt-4o-mini 이상

  • 분석 작업 수행(복잡한 추론 또는 대규모 모델): gpt-4o 이상 또는 Claude Songnet 4.6 이상

  • 데이터 컨텍스트 처리(임베딩 모델): text-embedding-3-small 또는 LLM 공급자가 지원하는 유사한 소형 임베딩 모델.

• Tableau Server의 정방향 프록시를 사용하는 경우 LLM과 통신하도록 프록시를 구성해야 합니다. 자세한 내용은 정방향 프록시 구성을 참조하십시오.

지원되는 연결

사용 가능한 기능

Tableau Server에서 다음 Tableau의 AI 기능을 사용할 수 있습니다.

• Tableau 웹 작성: 대화형 UI를 사용하여 비주얼리제이션을 작성하거나 작업 완료: 사용자가 Tableau Server 웹 작성 및 Tableau Desktop(버전 2025.3 이상)에서 Tableau Agent의 도움을 받아 데이터를　탐색하고　비주얼리제이션을 작성하고 계산을 만들고 인사이트를 발견할 수 있습니다. Tableau Agent에 대한 자세한 내용은 Tableau Agent로 데이터 탐색(링크가 새 창에서 열림)을 참조하십시오.

• 대시보드의 Tableau Agent(베타): Tableau Server+가 필요합니다. OAuth 인증과 함께 사용자 지정 게이트웨이를 사용하는 경우에는 사용할 수 없습니다. 이 기능을 설정하려면 베타 프로그램에 참여해야 합니다. 대시보드 소비자 및 작성자는 대시보드 개요 또는 대시보드의 비주얼리제이션에 대한 인사이트를 빠르게 확인할 수 있습니다. 또한 대시보드 Q&A를 사용하여 자신의 데이터에 대해 질문할 수도 있습니다. 대시보드 작성자는 대시보드 수준에서 각 기능을 사용하도록 설정하거나 해제할 수 있습니다. 특정 워크시트를 포함 또는 제외하거나 특정 유형의 인사이트에만 집중하도록 대시보드 인사이트를 구성할 수도 있습니다. 자세한 내용은 대시보드의 Tableau Agent(베타)(링크가 새 창에서 열림)를 참조하십시오.

  참고: 대시보드의 Tableau Agent를 사용하려면 Tableau Agent를 사용하려는 모든 통합 문서에 대한 AI 액세스 및 전체 데이터 쿼리 사용 권한 기능이 사용자에게 필요합니다. 전체 데이터 쿼리 사용 권한이 있어야 Tableau Agent 작동에 필요한 기초 데이터에 액세스할 수 있습니다. 자세한 내용은 사용 권한(링크가 새 창에서 열림)을 참조하십시오.

• Tableau Prep의 Tableau Agent: 데이터 정리 및 변환을 위한 단계 제안: 사용자가 Tableau Agent를 사용하여 데이터를 정리하고, 계산된 필드를 만들고, 흐름을 작성할 수 있습니다. 이 기능은 Tableau Server의 Tableau Prep 웹 작성 및 Tableau Prep Builder(버전 2025.3 이상)에서 사용할 수 있습니다. Tableau Prep의 Tableau Agent에 대한 자세한 내용은 Tableau Agent를 사용하여 Tableau Prep 흐름 작성(링크가 새 창에서 열림)을 참조하십시오.

Tableau의 AI 구성

Tableau의 AI를 구성하는 단계와 입력해야 하는 정보는 선택한 LLM 공급자에 따라 다릅니다. 사이트별로 다른 LLM 공급자를 구성할 수 있습니다.

1단계: LLM 공급자 또는 사용자 지정 게이트웨이에 연결

1. Tableau Server에 서버 관리자로 로그인합니다.

2. 생성형 AI 기능을 설정하려는 사이트에서 설정을 선택합니다.

3. Tableau의 AI에서 연결을 클릭합니다.

   

4. LLM에 연결 대화 상자의 LLM 공급자 드롭다운에서 공급자를 선택합니다.

   

5. 선택에 따라 다음을 수행합니다.

   • OpenAI: API 키를 입력합니다.

   • Azure OpenAI: API 키 및 리소스 이름을 입력합니다.

   • 사용자 지정 게이트웨이(베타): 고지 사항에 동의하여 베타 프로그램에 참여합니다.

     • 사용자 지정 게이트웨이 URL을 입력합니다(예: https://gateway.example.com/v1).

     • 인증 모드를 선택합니다.

       • 인증 없음: 게이트웨이가 내부 네트워크 규칙(예: IP 허용 목록 또는 VPC/VPN 경계)을 통해 보호되는 경우 선택합니다.

       • API 키: 내부 API 게이트웨이에 필요한 토큰/키를 입력합니다.

       • OAuth: 필요한 OAuth 클라이언트 세부 정보를 제공합니다.

         • 클라이언트 ID 및 클라이언트 암호: ID 공급자가 생성한 응용 프로그램 자격 증명입니다.

         • 리디렉션 URL: Tableau Server에 필요한 콜백 끝점입니다. /auth/add_oauth_token으로 끝나는 유효한 URL을 입력하십시오(예: https://<your-server-name>/auth/add_oauth_token). HTTPS 대신 HTTP를 사용하는 경우 도메인 이름은 localhost여야 합니다.

         • OAuth 구성 파일: IDP용으로 구성된 사용자 지정 XML 구성 파일을 업로드합니다. 자세한 내용은 Tableau 커넥터 SDK에서 XML 요소(링크가 새 창에서 열림)를 참조하십시오.

6. 연결을 클릭합니다.

2단계: 모델 설정 구성

OpenAI를 사용하는 경우 권장 모델(기본적으로 선택됨)을 선택한 다음 적용을 클릭합니다. Tableau는 최적의 성능을 위해 이러한 모델을 권장합니다. Tableau가 권장 모델을 변경할 때마다 모델이 자동으로 업데이트됩니다.

Azure OpenAI 또는 사용자 지정 게이트웨이를 사용하는 경우 모델을 직접 선택해야 합니다. Azure OpenAI의 경우 선택한 모델을 먼저 배포하고 이름을 지정해야 합니다. 배포된 모델에 사용하는 이름은 모델 필드에 입력할 이름과 동일합니다. 그런 다음 해당 이름을 필드에 입력할 수 있습니다.

수동으로 선택한 모델은 사용자가 직접 유지 관리해야 하며, 모델이 더 이상 지원되지 않을 때 설정을 업데이트하지 않으면 사용자가 Tableau Agent에 액세스하지 못할 수 있습니다.

1. 모델 편집을 클릭합니다.

2. 모델 설정 대화 상자에서 LLM 호스트 또는 게이트웨이가 제공하는 특정 모델 ID를 선택하거나 입력합니다.

   • 사용자 요청 이해: 소형 모델 식별자를 선택하거나 입력합니다(예: gpt-4o-mini 이상).

   • 비주얼리제이션, 계산된 필드 만들기와 흐름 작성: 주 추론 모델 식별자를 선택하거나 입력합니다(예: gpt-4o 또는 clade Songnet 4.6).

   • 데이터 컨텍스트 처리: 임베딩 모델 식별자를 선택하거나 입력합니다(예: text-embedding-3-small).

     

3. 적용을 클릭합니다.

3단계: 사용자가 사용할 수 있도록 AI 기능 설정

참고: 대시보드의 Tableau Agent를 사용하려면 Tableau Server 버전 2026.3 이상과 Tableau Server+가 필요하며, OAuth 인증과 함께 사용자 지정 게이트웨이를 사용하는 경우에는 사용할 수 없습니다.

1. 기능별 AI 설정에서 이 사이트의 사용자에게 제공하려는 각 기능(웹 작성의 Tableau Agent, Tableau Prep의 Tableau Agent, 대시보드의 Tableau Agent(베타))에 대해 설정을 클릭합니다.

2. 설정 페이지 상단에서 저장을 클릭합니다.

   

최종 사용자 인증 환경(OAuth 게이트웨이)

OAuth를 사용하여 사용자 지정 게이트웨이를 구성한 경우, Tableau Agent에 액세스하는 최종 사용자에게는 LLM 게이트웨이에 로그인하고 Tableau Agent에 대한 액세스를 허용하라는 메시지가 표시됩니다.

1. 통합 문서 또는 작성 세션에서 Tableau Agent를 열고 질문을 입력하면 에이전트 패널에 LLM 게이트웨이에 로그인하라는 메시지가 표시됩니다.

2. 로그인을 클릭하면 별도의 브라우저 창에서 조직의 OAuth/ID 공급자 로그인 화면이 열립니다.

3. 인증이 완료되면 사용자가 Tableau로 리디렉션되고 Tableau Agent와 상호 작용할 수 있게 됩니다.

정방향 프록시 구성

Tableau Server가 정방향 프록시를 사용하여 인터넷에 연결하도록 구성된 경우 프록시 호스트 및 포트 설정을 사용하여 LLM에 접속하도록 Tableau Server를 구성할 수 있습니다.

변경 사항을 적용하려면 tsm configuration set(링크가 새 창에서 열림) 명령을 사용하십시오.

• HTTPS 프록시 호스트의 경우 다음 키-값 쌍을 사용합니다.

  -k tomcat.https.proxyHost -v host.domain

  -k tomcat.https.proxyPort -v port_number

  예를 들어 프록시 서버가 https://proxy.example.lan:8443에 있는 경우 다음 명령을 실행합니다.

  tsm configuration set -k tomcat.https.proxyHost -v proxy.example.lan

  tsm configuration set -k tomcat.https.proxyPort -v 8443

  tsm pending-changes apply

  그러면 Tableau Server가 다시 시작됩니다. 프로덕션 환경을 구성할 때 이 점을 유의하십시오.

• HTTP 프록시 호스트의 경우 다음 키-값 쌍을 사용합니다.

  -k tomcat.http.proxyHost -v host.domain

  -k tomcat.http.proxyPort -v port_number

  이러한 키를 설정한 후 다음 실행

  tsm pending-changes apply

  그러면 Tableau Server가 다시 시작됩니다. 프로덕션 환경을 구성할 때 이 점을 유의하십시오.