개요
앱 템플릿은 워크스페이스 전용 ChatGPT 앱이나 커넥터가 필요한 관리형 워크스페이스에서 사용할 수 있는 설정 방식입니다. 워크스페이스 관리자와 소유자는 제공되는 앱 또는 플러그인 관리 화면에서 템플릿을 찾고, 조직별 설정을 추가한 다음 검토할 앱 초안을 만들 수 있습니다. 관리형 앱 템플릿은 개인 워크스페이스에 표시되지 않습니다.
템플릿은 OpenAI가 공통 앱 기능을 제공할 수 있지만, 각 워크스페이스에서 제공업체별 설정을 입력해야 하는 경우에 유용합니다. 템플릿에 따라 테넌트 또는 호스트 이름, OAuth 클라이언트 자격 증명, 콜백 URL, 권한 범위, 웹훅 세부 정보, 관리형 MCP 서버 URL, 기타 제공업체 설정 등이 포함될 수 있습니다. 예를 들어 GitHub Enterprise 템플릿으로 Codex가 조직의 GitHub Enterprise 호스트에 연결하는 데 사용하는 워크스페이스 전용 커넥터를 만들 수 있습니다.
설정이 완료되면 멤버는 원본 템플릿을 사용하지 않습니다. 대신 템플릿으로 만든 후 게시한 워크스페이스 앱을 사용합니다. 관리자는 이후 해당 앱을 다른 ChatGPT 앱과 동일하게 관리할 수 있습니다. ChatGPT Business에서는 소유자와 관리자가 워크스페이스에서 앱을 활성화하거나 비활성화합니다. ChatGPT Enterprise/Edu에서는 지원되는 역할 기반 앱 액세스 기능을 소유자와 관리자가 사용할 수 있습니다. 관리자는 작업 제어, 앱 권한, 제공업체 권한 부여도 관리할 수 있습니다.
플러그인에는 앱 템플릿이나 템플릿으로 만든 앱이 포함될 수 있습니다. 플러그인에 앱 템플릿이 포함되어 있으면 워크스페이스 관리자나 소유자가 워크스페이스 전용 앱을 만들고 게시해야 멤버가 ChatGPT에서 해당 앱을 연결하거나 플러그인을 통해 사용할 수 있습니다. 플러그인은 해당 워크스페이스에서 사용할 수 있는 앱 인스턴스를 사용하며, 멤버가 원본 템플릿을 설정하지는 않습니다.
일반적인 템플릿 설정 절차는 이 문서를 참고하세요. 제공업체별 설정은 다음 문서를 참고하세요.
템플릿은 주로 다음과 같은 경우에 사용합니다.
제공업체 URL에 회사의 테넌트, 계정, 조직 또는 워크스페이스 호스트 이름이 포함된 경우
조직에서 자체 OAuth 클라이언트나 제공업체 자격 증명을 사용해야 하는 경우
제공업체가 고객별 콜백 URL 설정을 요구하는 경우
앱은 동일한 구현 방식을 사용하되, 각 워크스페이스에서 액세스, 작업, 보안 설정을 개별적으로 제어해야 하는 경우
템플릿과 일반 앱의 차이점
일반 앱은 대개 바로 활성화할 수 있습니다. 반면 템플릿은 워크스페이스 관리자가 설정 절차를 진행해야 합니다.
일반적인 절차는 다음과 같습니다.
관리자가 워크스페이스에 제공되는 인터페이스에 따라 앱 또는 플러그인 관리 화면에서 템플릿을 찾습니다.
관리자가 워크스페이스에 필요한 고유 설정을 입력합니다.
ChatGPT가 워크스페이스용 앱 초안을 만듭니다.
관리자가 초안을 검토하고 게시합니다.
관리자가 게시된 앱의 액세스 및 작업 설정을 구성합니다.
멤버는 원본 템플릿이 아닌, 게시된 워크스페이스 앱을 사용합니다.
앱 템플릿 찾기 및 설정
아래 절차는 앱 관리 인터페이스를 기준으로 설명합니다. 워크스페이스에서 관리자 > 플러그인을 사용하는 경우, 해당 플러그인이나 템플릿을 열고 안내되는 설정 절차를 따르세요. 워크스페이스 메뉴 탐색 및 요금제별 관리자 제어 기능은 플러그인과 앱의 관리자 제어, 보안 및 규정 준수를 참고하세요.
워크스페이스 설정 > 앱으로 이동하세요.
디렉터리를 선택하세요.
제공업체 또는 앱 이름을 검색하세요.
템플릿으로 표시된 항목을 찾으세요.
활성화를 선택해 설정 절차를 시작하세요.
설정 과정에서 워크스페이스 전용 앱을 만드는 데 필요한 정보를 입력하라는 안내가 표시됩니다. 구체적인 입력 항목은 템플릿에 따라 다릅니다.
예를 들어 GitHub Enterprise 템플릿에서는 다음과 같은 정보를 요청할 수 있습니다.
앱 이름 및 설명
GitHub Enterprise 호스트 이름
콜백 URL 설정
OAuth 클라이언트 ID 및 클라이언트 시크릿
GitHub App 개인 키
요청할 권한 범위
웹훅 설정 세부 정보
초안을 만들기 전에 각 항목을 꼼꼼히 검토하세요. 조직에서 OAuth 또는 제공업체 자격 증명을 중앙에서 관리하는 경우, 해당 자격 증명을 담당하는 팀과 협의하세요.
제공업체별 설정은 GitHub Enterprise, Snowflake, Databricks 문서를 참고하세요.
OAuth 클라이언트 설정
일부 템플릿에서는 조직의 자체 OAuth 클라이언트를 사용해야 합니다. 이 경우 외부 제공업체의 관리 콘솔에서 OAuth 앱을 만들거나 설정한 다음, ChatGPT의 콜백 URL을 복사해 제공업체의 리디렉션 또는 콜백 URL 설정에 붙여 넣으세요.
제공업체 설정이 템플릿 설정 지침과 일치하는지 확인한 후에만 ChatGPT에 OAuth 클라이언트 ID와 시크릿을 입력하세요.
템플릿에 기본 권한 범위가 포함되어 있다면, 조직에서 제공업체 권한을 검토하고 변경할 명확한 이유가 있는 경우가 아니라면 기본값을 유지하세요.
초안 만들기
필수 정보를 입력한 후 초안 만들기를 선택하세요.
초안을 만든다고 해서 멤버가 앱을 바로 사용할 수 있는 것은 아닙니다. 멤버에게 앱 사용을 안내하기 전에 초안을 검토하고 게시한 다음, 액세스 및 작업 설정을 구성하세요.
생성된 앱 게시 및 관리
게시한 후에는 워크스페이스 설정에서 제공되는 앱 또는 플러그인 메뉴를 통해 워크스페이스 전용 앱을 관리하세요.
게시 후 권장 확인 사항:
앱이 활성화된 앱에 표시되는지 확인하세요.
ChatGPT Business에서는 워크스페이스에서 앱을 활성화하거나 비활성화하세요. 역할 기반 앱 액세스를 지원하는 ChatGPT Enterprise/Edu에서는 앱을 사용할 역할에 대해 역할 액세스를 설정하세요.
작업에서 읽기 및 쓰기 작업을 검토하세요.
앱 권한을 검토하여 ChatGPT가 앱을 사용하기 전에 멤버에게 확인을 요청할 시점을 선택하세요.
권한이 있는 테스트 사용자에게 제공되는 앱 또는 플러그인 메뉴로 이동하여 게시된 앱이 표시되는지 확인하도록 요청하세요.
앱에 제공업체 인증이 필요한 경우, 테스트 사용자에게 제공업체 계정을 연결하도록 하세요.
위험 부담이 적은 테스트 프롬프트를 실행하여 앱이 예상대로 작동하는지 확인하세요.
이 권한은 ChatGPT 대화에 적용됩니다. 워크스페이스 에이전트에는 에이전트 제작자가 정의한 별도의 제어 설정이 적용됩니다. 자세한 내용은 Enterprise 및 Business용 ChatGPT 워크스페이스 에이전트를 참고하세요.
템플릿을 한 번만 사용할 수 있는 경우
일부 템플릿은 워크스페이스당 하나의 앱만 만들 수 있습니다. 이미 사용한 템플릿은 활성화 버튼을 사용할 수 없을 수 있습니다. 이 경우 같은 템플릿으로 다른 앱을 만들지 말고 기존 초안이나 게시된 앱을 관리하세요.
멤버에게 표시되는 내용
멤버에게는 템플릿으로 만든 후 게시한 앱이 표시됩니다. 멤버가 앱을 보거나 사용할 수 있는지는 워크스페이스 설정과 제공업체의 권한 부여 여부에 따라 달라집니다. 앱이 플러그인에 포함되어 있으면 멤버가 해당 플러그인을 통해 앱을 접할 수 있지만, 동일한 워크스페이스 액세스 및 제공업체 권한 부여 요건이 적용됩니다.
플러그인에 템플릿으로 만든 앱이 필요한 경우, 다음 절차가 모두 완료될 때까지 플러그인에 설정이 필요하다고 표시될 수 있습니다. 관리자가 워크스페이스 전용 앱을 만들고 게시한 다음, ChatGPT Business에서는 워크스페이스에서 앱을 활성화하고, 역할 기반 앱 액세스를 지원하는 ChatGPT Enterprise/Edu에서는 해당 역할에 대해 앱을 활성화해야 합니다. 또한 사용자나 관리자가 필요한 제공업체 권한 부여를 모두 완료해야 합니다.
다음 사항을 확인하세요.
앱이 게시되어 있는지 확인하세요.
워크스페이스에서 앱이 활성화되어 있는지 확인하세요.
역할 기반 앱 액세스를 지원하는 ChatGPT Enterprise/Edu에서는 멤버의 워크스페이스 역할에 액세스 권한이 있는지 확인하세요.
멤버가 올바른 워크스페이스에 있는지 확인하세요.
멤버에게 외부 제공업체에서 필요한 권한이 있는지 확인하세요.
게시된 앱은 워크스페이스 설정의 앱 또는 플러그인 메뉴에 표시됩니다. 표시되는 메뉴는 환경에 따라 다릅니다. 앱이 플러그인에 포함되어 있으면 플러그인 상세 페이지에 필수 또는 선택 앱으로 표시될 수도 있습니다.
앱 템플릿 문제 해결
설정에 실패하거나 앱이 표시되지 않으면 다음 사항을 확인하세요.
테넌트, 계정 또는 워크스페이스 호스트 이름이 올바른지 확인하세요.
콜백 URL을 제공업체 설정에 정확히 복사했는지 확인하세요.
OAuth 클라이언트 ID와 클라이언트 시크릿이 올바른지 확인하세요.
요청한 권한 범위가 제공업체의 OAuth 앱에서 허용하는 범위와 일치하는지 확인하세요.
초안이 생성되었는지 확인하세요.
초안이 게시되었는지 확인하세요.
ChatGPT Business에서는 워크스페이스에서 앱이 활성화되어 있는지 확인하세요. 역할 기반 앱 액세스를 지원하는 ChatGPT Enterprise/Edu에서는 역할 액세스 설정에 따라 테스트 사용자가 앱을 볼 수 있는지 확인하세요.
제공업체 측 권한이 테스트 중인 데이터에 대한 액세스나 작업을 허용하는지 확인하세요.
보안 요건 검토
OAuth 클라이언트 시크릿과 제공업체 자격 증명은 민감한 정보로 취급하세요.
초안을 만들기 전에 요청할 권한 범위를 검토하세요.
게시한 후에는 작업을 사용해 앱이 수행할 수 있는 작업을 제한하세요.
앱 권한을 사용해 ChatGPT가 앱을 사용하기 전에 멤버에게 확인을 요청할 시점을 정하세요.
ChatGPT에서 앱을 활성화한 후에도 제공업체 권한이 계속 적용된다는 점에 유의하세요.