概要
アプリテンプレートは、ChatGPT のアプリまたはコネクターについてワークスペース専用版を必要とする管理対象ワークスペース向けのセットアップ方法です。ワークスペースの管理者と所有者は、利用可能な管理画面の アプリ または プラグイン からテンプレートを見つけ、組織固有の設定を追加して、レビュー用の下書きアプリを作成できます。管理対象のアプリテンプレートは、個人用ワークスペースには表示されません。
テンプレートは、OpenAI が共通のアプリ動作を提供できる一方で、各ワークスペースにプロバイダー固有の設定が必要な場合に便利です。テンプレートによっては、テナント名やホスト名、OAuth クライアント認証情報、コールバック URL、スコープ、Webhook の詳細、管理対象 MCP サーバーの URL、その他のプロバイダー設定が必要です。たとえば、GitHub Enterprise テンプレートでは、Codex がその組織の GitHub Enterprise ホストに接続するために使用するワークスペース専用コネクターを作成できます。
セットアップ後、メンバーは元のテンプレートを使用しません。代わりに、そのテンプレートから作成された公開済みのワークスペースアプリを使用します。管理者は、ロールアクセス、アクション制御、アプリの権限、プロバイダー認可などを含め、他の ChatGPT アプリと同様にそのアプリを管理できます。
プラグインには、アプリテンプレートまたはテンプレートから作成されたアプリを含めることができます。プラグインにアプリテンプレートが含まれている場合、メンバーが ChatGPT で接続したり、プラグイン経由で使用したりするには、まずワークスペースの管理者または所有者がワークスペース専用アプリを作成して公開する必要があります。プラグインは、そのワークスペースで利用可能なアプリインスタンスを使用します。メンバーが元のテンプレートを設定することはありません。
テンプレートの一般的な手順については、この記事を参照してください。プロバイダー固有のセットアップについては、以下を参照してください。
テンプレートを使用する一般的な理由は次のとおりです。
プロバイダー URL に、会社のテナント、アカウント、組織、またはワークスペースのホスト名が含まれている
組織独自の OAuth クライアントまたはプロバイダー認証情報を用意する必要がある
プロバイダーで顧客固有のコールバック URL を設定する必要がある
アプリには同じ実装方式を使用しつつ、各ワークスペースでアクセス、アクション、セキュリティ設定を個別に管理する必要がある
テンプレートと通常のアプリの違い
通常のアプリは、一般にそのまま有効にできます。一方、テンプレートではワークスペース管理者向けのセットアップフローが開始されます。
一般的な手順は次のとおりです。
管理者が、利用可能なインターフェースに応じて、ワークスペースの管理画面にある アプリ または プラグイン でテンプレートを見つけます。
管理者が、必要なワークスペース固有の設定を入力します。
ChatGPT がワークスペース用の下書きアプリを作成します。
管理者が下書きを確認して公開します。
管理者が、公開済みアプリのアクセス設定とアクション設定を構成します。
メンバーは元のテンプレートではなく、公開済みのワークスペースアプリを使用します。
アプリテンプレートの検索とセットアップ
以下では、アプリ の管理者インターフェースを使用する手順を説明します。ワークスペースで 管理者 > プラグイン を使用している場合は、該当するプラグインまたはテンプレートを開き、そのセットアップ手順に従ってください。ワークスペース内の移動方法については、プラグインとアプリの管理者コントロール、セキュリティ、コンプライアンスを参照してください。
ワークスペース設定 > アプリ に移動します。
ディレクトリ を選択します。
プロバイダー名またはアプリ名を検索します。
テンプレートと表示されている項目を探します。
有効にする を選択して、セットアップを開始します。
セットアップでは、ワークスペース専用アプリの作成に必要な情報の入力を求められます。具体的なフィールドはテンプレートによって異なります。
たとえば、GitHub Enterprise テンプレートでは、次のような情報の入力を求められることがあります。
アプリ名と説明
GitHub Enterprise のホスト名
コールバック URL の設定
OAuth クライアント ID とクライアントシークレット
GitHub App の秘密鍵
要求するスコープ
Webhook のセットアップ情報
下書きを作成する前に、各フィールドを慎重に確認してください。組織で OAuth またはプロバイダーの認証情報を一元管理している場合は、その認証情報を管理するチームと連携してください。
プロバイダー固有のセットアップについては、GitHub Enterprise、Snowflake、Databricks を参照してください。
OAuth クライアントのセットアップ
テンプレートによっては、組織独自の OAuth クライアントを用意する必要があります。必要な場合は、外部プロバイダーの管理コンソールで OAuth アプリを作成または設定してから、ChatGPT に表示されるコールバック URL を、プロバイダーのリダイレクト URL またはコールバック URL の設定にコピーします。
プロバイダーの設定がテンプレートのセットアップ手順と一致していることを確認してから、OAuth クライアント ID とシークレットを ChatGPT に入力してください。
テンプレートに既定のスコープが含まれている場合は、組織がプロバイダーの権限を確認し、変更する明確な理由がない限り、既定値を使用してください。
下書きの作成
必要な情報を入力したら、下書きを作成 を選択します。
下書きを作成しただけでは、アプリはメンバーに公開されません。メンバーに使用を案内する前に、下書きを確認して公開し、アクセス設定とアクション設定を構成してください。
作成されたアプリの公開と管理
公開後は、利用可能なワークスペース設定の アプリ または プラグイン から、ワークスペース専用アプリを管理します。
公開後に推奨される確認事項は次のとおりです。
アプリが 有効なアプリ に表示されることを確認する
アプリを使用するロールに ロールアクセス を設定する
読み取りおよび書き込みアクションの アクション 設定を確認する
ChatGPT がアプリを使用する前にメンバーへ確認するタイミングを、アプリの権限 で設定する
認可済みのテストユーザーに、利用可能な アプリ または プラグイン を開いてもらい、公開済みアプリが表示されることを確認する
アプリでプロバイダー認証が必要な場合は、テストユーザーにプロバイダーアカウントを接続してもらう
リスクの低いテストプロンプトを実行し、アプリが想定どおりに動作することを確認する
これらの権限は ChatGPT の会話に適用されます。ワークスペースエージェントには、エージェントのビルダーが定義した別の制御が適用されます。詳しくは、Enterprise および Business 向け ChatGPT ワークスペースエージェントを参照してください。
テンプレートを一度しか使用できない場合
テンプレートによっては、ワークスペースごとに 1 つのアプリしか作成できない場合があります。テンプレートがすでに使用されている場合、［有効にする］ボタンを使用できないことがあります。その場合は、同じテンプレートから別のアプリを作成せず、既存の下書きまたは公開済みアプリを管理してください。
メンバーに表示される内容
メンバーには、テンプレートから作成された公開済みアプリが表示されます。メンバーがアプリを表示または使用できるかどうかは、ワークスペース設定とプロバイダーの認可によって決まります。アプリがプラグインに含まれている場合、メンバーはそのプラグインを通じてアプリを利用することがありますが、同じワークスペースアクセス権とプロバイダー認可の要件が引き続き適用されます。
プラグインにテンプレートから作成するアプリが必要な場合、管理者がワークスペース専用アプリを作成して公開し、該当するロールに対して有効にしたうえで、必要なユーザーまたは管理者によるプロバイダー認可が完了するまで、プラグインにセットアップが必要と表示されることがあります。
以下を確認してください。
アプリが公開されている
ワークスペースでアプリが有効になっている
メンバーのワークスペースロールにアクセス権がある
メンバーが正しいワークスペースに参加している
メンバーが外部プロバイダーで必要な権限を持っている
公開済みアプリは、利用可能なワークスペース設定の アプリ または プラグイン に表示されます。アプリがプラグインの一部である場合、プラグインの詳細ページに必須または任意のアプリとして表示されることもあります。
アプリテンプレートのトラブルシューティング
セットアップに失敗する場合やアプリが表示されない場合は、以下を確認してください。
テナント、アカウント、またはワークスペースのホスト名が正しい
コールバック URL がプロバイダー設定に正確にコピーされている
OAuth クライアント ID とクライアントシークレットが正しい
要求したスコープが、プロバイダーの OAuth アプリで許可されている内容と一致している
下書きが作成されている
下書きが公開されている
ロールアクセスで、テストユーザーによるアプリの表示が許可されている
プロバイダー側の権限で、テスト対象のデータまたはアクションが許可されている
セキュリティ要件の確認
OAuth クライアントシークレットとプロバイダーの認証情報は、機密情報として扱ってください。
下書きを作成する前に、要求するスコープを確認してください。
公開後は アクション を使用して、アプリが実行できる操作を制限してください。
ChatGPT がアプリを使用する前にメンバーへ確認するタイミングは、アプリの権限 で設定します。
ChatGPT でアプリを有効にした後も、プロバイダーの権限が引き続き適用されることに注意してください。