アクションを使って GPT を外部 API に接続する方法（設定、認証、スキーマ構成を含む）。

概要

この記事では、外部 API への接続、GPT が実行できることの定義、認証、スキーマ、ワークスペース制限の管理など、GPT でアクションを構成する方法を説明します。

アクションを構成するには、接続したいサービスの API 詳細（認証情報と OpenAPI スキーマを含む）が必要です。GPT はアプリまたはアクションのいずれかを使用できますが、同時に両方は使用できません。

各アクションは、GPT が API で認証する方法と、API で実行できることを定義するスキーマという 2 つの主要コンポーネントで定義されます。

制限事項

ワークスペースで許可されているアクションドメインが 0 件の場合、許可リストチェックを通過できるアクションドメインがないため、GPT カスタムアクションは実行できません。これは、必ずしも GPT のすべての表示設定やアクセスがブロックされていることを意味するわけではありません。

アクションは Pro モードでは利用できません。カスタムアクションを含む GPT を作成または編集する場合、モデルセレクターにはアクションをサポートする非 Pro モデルのみが表示されます。

アクションの作成

GPT エディターで アクション セクションに移動し、新しいアクションを作成 を選択します。

次に、GPT が外部 API に接続して使用する方法を構成します。

アクションを構成したら、プレビュー でテストして、想定どおりに動作することを確認します。

認証

認証は、GPT が外部 API に接続する方法を制御します。

利用可能なオプション:

なし: 認証は不要
API キー: シークレットキーを使用してリクエストを認可
OAuth: ユーザーサインインを使用してアカウントベースのアクセスを提供

API キー

サーバー間アクセスには、API キー認証を使用します。次のように構成できます。

Basic
Bearer
カスタムヘッダー

OAuth

アクションでユーザーアカウントが必要な場合は、OAuth を使用します。OAuth には以下が必要です。

クライアント ID と クライアントシークレット
認可 URL と トークン URL
スコープ とトークン交換方法

エディターは、OAuth フローを完了するためのコールバック URL を提供します。

スキーマ

スキーマは、API で実行できることを定義します。スキーマは ChatGPT に以下を伝えます。

呼び出すサーバー
利用可能なエンドポイント
受け付けるパラメーター
各アクションの識別方法（operation ID）

スキーマは、JSON または YAML の OpenAPI 仕様として提供する必要があります。

スキーマの追加

スキーマは 3 つの方法で追加できます。

エディターに直接貼り付ける
URL からインポートする
組み込み例から始める:
- 天気（JSON）
- Pet Store（YAML）
- 空のテンプレート

スキーマが有効な場合、エディターに検出されたアクションが表示されます。無効な場合は、検証エラーが表示されます。

ワークスペース制限（Enterprise および Edu）

次のメッセージが表示される場合:

「ワークスペースの設定により、許可されているドメインはありません。」

これは、ワークスペース設定によってアクションが制限されていることを意味します。

管理者は、すべてのドメインを許可するか、承認済みドメインにアクションを制限できます。
許可されているドメインがない場合、アクションは使用できません。

アクションとドメイン制限に関するワークスペースレベルの制御については、こちらをご覧ください: Enterprise および Edu ワークスペースでの GPT アクセスの管理。

プライバシーとユーザー制御

各アクションには、プライバシーポリシー URL を含めることができます。
アクションを含む公開 GPT（リンクまたは GPT Store）には、有効なプライバシーポリシー URL が必要です。
ユーザーは、アクションの実行前に承認を求められる場合があります。
OAuth アクションでは、ユーザーが接続済みアカウントを確認および管理できます。

追加ヘルプ

アクションの作成やデバッグについては、公式の ActionsGPT を使用してください。

GPT のアクションを設定する

概要