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