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