概要

アプリテンプレートは、ChatGPT アプリまたはコネクターのワークスペース専用バージョンが必要な管理対象ワークスペース向けの設定手段です。ワークスペース管理者とオーナーは、ワークスペース設定 > アプリ > ディレクトリでテンプレートを見つけ、組織固有の設定を追加して、レビュー用の下書きアプリを作成します。管理対象アプリテンプレートは、個人用ワークスペースには表示されません。

テンプレートは、OpenAI が共通のアプリ動作を提供できる一方で、各ワークスペースがプロバイダー固有の設定を用意する必要がある場合に役立ちます。テンプレートによっては、その設定にテナント名やホスト名、OAuth クライアント認証情報、コールバック URL、スコープ、Webhook の詳細、管理対象 MCP サーバー URL、その他のプロバイダー設定が含まれる場合があります。たとえば、GitHub Enterprise テンプレートでは、Codex がその組織の GitHub Enterprise ホストにアクセスするために使用する、ワークスペース専用コネクターを作成できます。

設定後、メンバーは元のテンプレートを使用しません。メンバーは、そのテンプレートから作成された公開済みワークスペースアプリを使用します。管理者はその後、ロールアクセス、アクション制御、アプリ権限、プロバイダー認可など、他の ChatGPT アプリと同じようにそのアプリを管理できます。


プラグインにも、アプリテンプレートやテンプレートから作成されたアプリを含めることができます。プラグインにアプリテンプレートが含まれている場合でも、メンバーが ChatGPT で接続したり、そのプラグインを通じて使用したりできるようにするには、ワークスペース管理者またはオーナーがワークスペース専用アプリを作成して公開する必要があります。プラグインの実行時には、メンバーに元のテンプレートを自分で設定させるのではなく、そのワークスペースで利用可能なアプリインスタンスが使用されます。必要なテンプレートがまだ設定されていない場合、メンバーはまず管理者に設定を完了してもらう必要があることがあります。プラグインは、アプリテンプレートだけでは使用できません。

一般的なテンプレートの流れについては、この記事を参照してください。プロバイダー固有の設定については、次を参照してください:

• GitHub Enterprise

• Snowflake

• Databricks

テンプレートは、同じアプリパターンを多くの組織で利用できる一方で、各組織が独自の設定を必要とする場合に役立ちます。

一般的な例:

• プロバイダー URL に会社のテナント、アカウント、組織、またはワークスペースのホスト名が含まれる場合

• 組織が独自の OAuth クライアントまたはプロバイダー認証情報を用意する必要がある場合

• プロバイダーが顧客固有のコールバック URL 設定を必要とする場合

• アプリは同じ実装パターンを使用しつつ、各ワークスペースがアクセス、アクション、セキュリティ設定を個別に管理する必要がある場合

テンプレートと通常のアプリの違い

通常のアプリは、たいてい直接有効にできます。一方、テンプレートではワークスペース管理者向けの設定フローが開始されます。

通常の流れは次のとおりです:

• 管理者がワークスペース設定 > アプリ > ディレクトリでテンプレートを見つける

• 管理者が必要なワークスペース固有の設定を入力する

• ChatGPT がワークスペース用の下書きアプリを作成する

• 管理者が下書きをレビューして公開する

• 管理者が公開済みアプリのアクセスとアクション設定を構成する

メンバーは元のテンプレートではなく、公開済みワークスペースアプリを使用する

アプリテンプレートの検索と設定

• ワークスペース設定 > アプリを開きます。

• ディレクトリを選択します。

• プロバイダー名またはアプリ名を検索します。

• テンプレートとしてマークされた項目を探します。

• 有効にするを選択して、設定フローを開始します。

設定フローでは、ワークスペース専用アプリを作成するために必要な詳細の入力を求められます。具体的なフィールドはテンプレートによって異なります。

たとえば、GitHub Enterprise テンプレートでは、次のような詳細の入力を求められることがあります:

• アプリ名と説明

• GitHub Enterprise ホスト名

• コールバック URL 設定

• OAuth クライアント ID とクライアントシークレット

• GitHub App 秘密鍵

• リクエストされるスコープ

• Webhook 設定の詳細

下書きを作成する前に、各フィールドを慎重に確認してください。組織で OAuth またはプロバイダー認証情報を一元管理している場合は、その認証情報を担当するチームと連携してください。

アプリ別の手順を参照してください:GitHub、Snowflake、Databricks。

OAuth クライアント設定

一部のテンプレートでは、組織が独自の OAuth クライアントを用意する必要があります。これが必要な場合は、外部プロバイダーの管理コンソールで OAuth アプリを作成または構成し、その後 ChatGPT からコールバック URL をコピーして、プロバイダーのリダイレクトまたはコールバック URL 設定に貼り付けます。

プロバイダー設定がテンプレートの設定手順と一致していることを確認してから、ChatGPT に OAuth クライアント ID とシークレットを入力してください。

テンプレートにデフォルトのスコープが含まれている場合、組織がプロバイダー権限を確認し、それらを変更する明確な理由がある場合を除き、デフォルトのままにしてください。

下書きの作成

必要な情報を入力したら、下書きを作成を選択します。

下書きを作成しても、アプリが自動的にメンバーに利用可能になるわけではありません。メンバーに使用を依頼する前に、下書きをレビューして公開し、アクセスとアクションの設定を構成してください。

作成されたアプリの公開と管理

公開後は、ワークスペース設定 > アプリ > 有効からワークスペース専用アプリを管理します。

公開後に推奨される確認事項:

• アプリが 有効なアプリに表示されることを確認する

• アプリを使用するロールに ユーザーアクセスを設定する

• 読み取りアクションと書き込みアクションの アクション制御を確認する

• アプリ使用前に ChatGPT がメンバーへ確認するタイミングを選ぶために、アプリ権限を確認する

• 許可されたテストユーザーに、ChatGPT でアプリを開き、アプリが表示されることを確認してもらう

• アプリでプロバイダー認証が必要な場合は、テストユーザーにプロバイダーアカウントを接続してもらう

• リスクの低いテストプロンプトを実行し、アプリが想定どおりに動作することを確認する

これらのアプリ権限は ChatGPT の会話に適用されます。ワークスペースエージェントでは、利用可能なアプリアクションとエンドユーザーに承認を求めるタイミングを決定するために、エージェントのビルダーが設定したエージェントごとの制御が使用されます。エージェントの動作については、次を参照してください:Enterprise および Business 向け ChatGPT ワークスペースエージェント。

テンプレートを一度しか使用できない場合

一部のテンプレートでは、ワークスペースごとに 1 つのアプリしか作成できない場合があります。テンプレートがすでに使用されている場合、有効にするボタンを使用できないことがあります。その場合は、同じテンプレートから別のアプリを作成するのではなく、既存の下書きまたは公開済みアプリを管理してください。

メンバーに表示される内容

メンバーには、テンプレートから作成された公開済みアプリが表示されます。メンバーがそのアプリを表示または使用できるかどうかは、ワークスペース設定とプロバイダー認可によって決まります。アプリがプラグインに含まれている場合、メンバーはそのプラグインを通じてアプリに出会うことがありますが、同じワークスペースアクセス要件とプロバイダー認可要件が引き続き適用されます。

プラグインでテンプレートから作成されたアプリが必要な場合、管理者がそのワークスペース専用アプリを作成して公開し、関連するロールで有効化し、必要なユーザーまたは管理者のプロバイダー認可が完了するまで、プラグインに設定が必要であると表示されることがあります。

次を確認してください:

• アプリが公開されていること

• ワークスペースでアプリが有効になっていること

• メンバーのワークスペースロールにアクセス権があること

• メンバーが正しいワークスペースに所属していること

• メンバーが外部プロバイダーで必要な権限を持っていること

公開済みアプリは、ワークスペース設定 > アプリ > 有効に表示されます。アプリがプラグインの一部である場合、プラグイン詳細ページで必須または任意のアプリとして表示されることもあります。

トラブルシューティング

設定に失敗する場合やアプリが表示されない場合は、次を確認してください:

• テナント、アカウント、またはワークスペースのホスト名が正しいこと

• コールバック URL がプロバイダー設定に正確にコピーされていること

• OAuth クライアント ID とクライアントシークレットが正しいこと

• リクエストされたスコープが、プロバイダーの OAuth アプリで許可されている内容と一致していること

• 下書きが作成されていること

• 下書きが公開されていること

• ロールアクセスにより、テストユーザーがアプリを表示できること

• プロバイダー側の権限により、テスト対象のデータまたはアクションが許可されていること

セキュリティに関する注意

• OAuth クライアントシークレットとプロバイダー認証情報は機密情報として扱ってください。

• 下書きを作成する前に、リクエストされるスコープを確認してください。

• 公開後は、アプリで実行できる内容を制限するために アクション制御を使用してください。

• アプリ使用前に ChatGPT がメンバーへ確認するタイミングを決めるには、アプリ権限を使用してください。

• ChatGPT でアプリを有効にした後も、プロバイダー権限は引き続き適用されます。