조직용 Databricks 앱 템플릿을 설정하는 ChatGPT 워크스페이스 관리자인 경우 이 가이드를 사용하세요. 템플릿은 구성원이 사용하는 최종 앱이 아닙니다. 필수 Databricks 구성을 제공하면 워크스페이스별 초안 앱을 만드는 설정 흐름입니다.
Databricks의 경우 대부분의 설정은 Databricks Account Console에서 진행됩니다. 사용자 지정 OAuth 앱 연결을 만들고, ChatGPT 콜백 URL을 등록하고, 생성된 클라이언트 자격 증명을 복사한 다음, 해당 값을 ChatGPT 템플릿 설정 흐름에 붙여넣습니다. ChatGPT가 초안 앱을 만들면 다른 워크스페이스 앱처럼 게시하고 관리할 수 있습니다.
설정할 항목
ChatGPT에서 워크스페이스별 Databricks 앱을 만들고 있습니다. 이 앱은 다음을 사용합니다.
Databricks Account Console에서 만든 Databricks OAuth 앱 연결.
Databricks OAuth 클라이언트 ID 및 클라이언트 비밀.
ChatGPT에서 복사한 정확한 콜백 URL.
사용하려는 커넥터 기능과 일치하는 Databricks 범위.
워크스페이스 호스트, 계정 호스트, 계정 ID, 웨어하우스 등 ChatGPT 설정 흐름에서 요청하는 Databricks 제공자 세부 정보.
시작하기 전에
필요한 사항:
ChatGPT 워크스페이스 관리자 또는 소유자 액세스 권한.
Databricks 계정 관리자 액세스 권한. 일부 작업은 워크스페이스 관리자 액세스 권한으로 충분할 수 있지만, 사용자 지정 앱 연결은 Databricks Account Console에서 구성합니다.
별도 탭에 열려 있는 Databricks Account Console.
정확한 콜백 URL을 복사할 수 있도록 ChatGPT에 열려 있는 Databricks 앱 템플릿 설정 화면.
앱에 일반 Databricks API 액세스가 필요한지, 아니면 Databricks SQL 액세스만 필요한지에 대한 결정.
Databricks 클라이언트 비밀을 안전하게 처리할 장소.
콜백 URL을 임의로 만들지 마세요. ChatGPT에 표시된 정확한 콜백 URL을 복사하세요.
준비할 값
콜백 URL: ChatGPT 템플릿 설정 흐름에서 복사합니다.
Databricks OAuth 클라이언트 ID.
Databricks OAuth 클라이언트 비밀.
ALL APIs 또는 SQL과 같은 Databricks 액세스 범위.
ChatGPT 설정 흐름에서 요청하는 Databricks 워크스페이스 또는 계정 필드.
ChatGPT에서 앱 게시 및 관리
초안 앱을 만든다고 해서 구성원이 자동으로 사용할 수 있게 되는 것은 아닙니다. 초안을 검토한 후:
초안 앱을 게시합니다.
앱이 워크스페이스 설정 > 앱 > 사용 설정됨에 표시되는지 확인합니다.
이 앱을 사용해야 하는 역할에 대해 사용자 액세스를 구성합니다.
앱에서 노출하는 Databricks 작업에 대해 작업 제어를 검토합니다.
ChatGPT가 앱 사용 전 구성원에게 확인을 요청할 시점을 선택하려면 앱 권한을 검토합니다.
허용된 테스트 사용자에게 ChatGPT에서 앱을 열어 앱이 표시되는지 확인하도록 요청합니다.
이 앱 권한은 ChatGPT 대화에 적용됩니다. 워크스페이스 에이전트는 에이전트 빌더가 설정한 에이전트별 제어를 사용하여 어떤 앱 작업을 사용할 수 있는지와 최종 사용자에게 승인 요청을 할 시점을 결정합니다. 에이전트 동작에 대해서는 다음을 참조하세요. Enterprise 및 Business용 ChatGPT 워크스페이스 에이전트.
ChatGPT에서 템플릿 설정 시작
ChatGPT에서 앱을 사용할 워크스페이스로 전환합니다.
워크스페이스 설정 > 앱을 엽니다.
디렉터리를 선택합니다.
Databricks를 검색합니다.
Databricks 앱 템플릿을 선택하고 설정을 시작합니다.
Databricks 또는 Databricks - Data Platform처럼 명확한 앱 이름과 설명을 입력합니다.
OAuth 클라이언트 섹션에서 ChatGPT의 콜백 URL을 복사합니다. 이 탭을 열어 둡니다.
콜백 URL 예시: https://chatgpt.com/connector/oauth/<callback_id>
콜백 ID를 제거하거나, 끝에 슬래시를 추가하거나, 일반 ChatGPT URL로 바꾸지 마세요.
Databricks에서 OAuth 앱 연결 만들기
Databricks 계정의 Databricks Account Console을 엽니다.
왼쪽 사이드바에서 설정을 엽니다.
앱 연결 탭을 엽니다.
연결 추가를 선택합니다.
ChatGPT Databricks Connector와 같은 애플리케이션 이름을 입력합니다.
리디렉션 URL에 ChatGPT에서 복사한 정확한 콜백 URL을 붙여넣습니다.
액세스 범위에서 앱에 필요한 범위를 선택합니다.
SQL 이외의 Databricks API가 필요한 일반 Databricks 앱에는 ALL APIs를 사용합니다.
Databricks SQL API로 제한된 앱에는 SQL만 사용합니다.
조직에 특정 정책이 없다면 토큰 TTL은 Databricks 기본값으로 둡니다.
클라이언트 비밀 생성을 사용 설정합니다. ChatGPT에는 이 흐름을 위한 기밀 OAuth 클라이언트가 필요합니다.
연결을 만듭니다.
Databricks에서 자격 증명 복사
연결이 생성됨 대화 상자에서 클라이언트 ID를 복사합니다.
클라이언트 비밀을 즉시 복사하여 안전하게 보관합니다.
비밀을 복사하기 전에 대화 상자를 닫았다면 OAuth 앱 자격 증명을 만들거나 순환하고 새 비밀을 사용합니다.
Databricks는 비밀을 한 번만 표시합니다. 이를 자격 증명처럼 취급하고 스크린샷, 티켓, 댓글 또는 채팅에 포함하지 마세요.
ChatGPT에서 설정 완료
ChatGPT 템플릿 설정 탭으로 돌아갑니다.
Databricks 클라이언트 ID를 OAuth 클라이언트 ID에 붙여넣습니다.
Databricks 클라이언트 비밀을 OAuth 클라이언트 비밀에 붙여넣습니다.
템플릿 기본값을 의도적으로 재정의해야 하는 경우가 아니라면 범위는 변경하지 마세요.
워크스페이스 호스트, 계정 호스트, 계정 ID, 웨어하우스 또는 기타 Databricks별 값 등 설정 흐름에서 요구하는 Databricks 제공자 필드를 입력합니다.
초안 앱을 만듭니다.
사용자로 앱 테스트
허용된 테스트 사용자로 ChatGPT에서 연결 흐름을 시작합니다.
브라우저가 예상한 Databricks 계정 또는 워크스페이스를 여는지 확인합니다.
요청된 범위를 승인합니다.
브라우저가 ChatGPT로 돌아오고 앱이 연결된 것으로 표시되는지 확인합니다.
현재 사용자 정보 가져오기 또는 승인된 Databricks SQL 리소스 쿼리와 같이 위험이 낮은 읽기 작업을 먼저 실행합니다.
쓰기 작업이 사용 설정된 경우 더 넓게 배포하기 전에 명확히 위험이 낮은 Databricks 워크플로로 테스트합니다.
액세스 관리
Databricks와 ChatGPT가 모두 액세스 제어에 관여합니다.
ChatGPT에서 워크스페이스 관리자는 게시된 앱의 사용 가능 여부, 사용할 수 있는 워크스페이스 역할, 사용 설정된 작업, 앱 사용 전 ChatGPT가 사용자에게 확인을 요청할 시점을 관리합니다.
Databricks에서 관리자는 어떤 사용자가 OAuth 앱을 승인할 수 있는지와 해당 사용자가 어떤 Databricks 리소스에 액세스할 수 있는지 관리합니다. ChatGPT에서 앱을 사용 설정한 후에도 제공자 권한은 계속 적용됩니다.
문제 해결
리디렉션 URI 불일치: Databricks 리디렉션 URL이 경로와 콜백 ID를 포함해 ChatGPT에 표시된 콜백 URL과 정확히 일치하는지 확인합니다.
비밀 누락: Databricks 비밀은 한 번만 표시됩니다. 복사하지 못했다면 새 클라이언트 비밀을 생성합니다.
OAuth 앱을 즉시 사용할 수 없음: Databricks에 따르면 OAuth 애플리케이션 업데이트 처리에는 최대 30분이 걸릴 수 있습니다.
범위 부족: ChatGPT는 인증할 수 있지만 Databricks API 호출이 실패하는 경우, 앱에 비SQL API가 필요할 때 Databricks 앱에 ALL APIs가 있는지 확인합니다.
SQL 작업 실패: SQL 범위, 웨어하우스 구성 및 Databricks 권한을 확인합니다.
잘못된 워크스페이스: 사용자가 연결할 ChatGPT 워크스페이스와 동일한 워크스페이스에서 앱을 만들고 게시합니다.
사용자가 연결할 수 없음: 사용자에게 Databricks 액세스 권한이 있고 OAuth 앱을 승인할 수 있는지 확인합니다.