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