このページは Apigee と Apigee ハイブリッドに適用されます。
このトピックでは、API Hub に Vertex AI 拡張機能を作成する方法について説明します。
Vertex AI 拡張機能とは
Vertex AI 拡張機能を使用すると、API を介して大規模言語モデル（LLM）に現実世界のデータを取り込み、アクションを実行できます。拡張機能はユーザークエリを処理し、LLM と通信して、チャットアプリなどのアプリケーションに代わってオペレーションを実行します。
たとえば、レンタカー予約の API 用に Vertex AI 拡張機能を作成し、チャット アプリケーションにリンクしたとします。このアプリを使ってレンタカーについて質問すると、生成 AI が質問のコンテキストを理解し、拡張機能 API を呼び出してレンタカーを予約します。
Vertex AI 拡張機能の詳細については、Vertex AI の生成 AI の概要をご覧ください。
API Hub で Vertex AI 拡張機能を効率的に作成する
API Hub を利用すると、既存の API Hub メタデータを使用して Vertex AI 拡張機能を効率的に作成できます。API Hub が拡張機能の作成に使用するキーデータは、API 仕様とデプロイメントです。これらは API Hub ですでに検証されています。仕様は拡張機能に API のオペレーションを提供し、デプロイメントは API のサーバー エンドポイントを提供します。
Vertex AI 拡張機能を作成する
API Hub で Vertex AI 拡張機能を作成するには:
コンソール
拡張機能を作成するには:
Google Cloud コンソールで、Apigee API Hub の [APIs] ページに移動します。
[API Hub] に移動- 拡張機能を追加する API を探します。[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
- 目的の API をクリックして、詳細ページを表示します。
- [Vertex Extension を作成] をクリックします。
- [Vertex Extension を作成] フォームで、拡張機能の詳細を指定します。
- 拡張機能名: （必須）拡張機能名を指定します。
- 説明: （必須）拡張機能の説明を追加します。
- バージョン: （必須）API バージョンを選択します。
- 仕様ファイル: （必須）仕様が API バージョンにリンクされている場合、このフィールドは自動的に入力されます。API 仕様の管理をご覧ください。
- デプロイメント: （必須）デプロイメントが API バージョンにリンクされている場合、このフィールドは自動的に入力されます。デプロイメントを管理するをご覧ください。
- [拡張機能を作成] をクリックします。拡張機能をデフォルト バージョンに追加すると、API の詳細ページの [拡張機能] セクションに拡張機能が表示されます。別のバージョンに拡張機能を追加した場合は、そのバージョンの詳細ページに拡張機能が表示されます。
Vertex AI 拡張機能のリストを取得する
このセクションでは、Vertex 拡張機能のリストを取得する方法について説明します。
コンソール
コンソールで、登録済みの API に関連付けられているすべての拡張機能を表示するには:
Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動- [API] をクリックします。
- 検査する API を探します。[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
- API を選択します。
- デフォルト バージョンに追加された拡張機能は、API の詳細ページの [拡張機能] セクションに表示されます。拡張機能が別のバージョンに追加されている場合は、そのバージョンの詳細ページで拡張機能を確認する必要があります。
Vertex AI 拡張機能の詳細を取得する
このセクションでは、Vertex AI 拡張機能の詳細を取得する方法について説明します。
コンソール
コンソールで Vertex AI 拡張機能の詳細を表示するには:
Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動- [API] をクリックします。
- 検査する API を探します。[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
- API を選択します。
- デフォルト バージョンに追加された拡張機能は、API の詳細ページの [拡張機能] セクションに表示されます。拡張機能が別のバージョンに追加されている場合は、そのバージョンの詳細ページで拡張機能を確認する必要があります。 Vertex 拡張機能の表で、拡張機能をクリックして詳細ページを表示します。
Vertex AI 拡張機能を削除する
このセクションでは、Vertex 拡張機能を削除する方法について説明します。
コンソール
拡張機能を削除するには:
Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動- [API] をクリックします。
- 削除する拡張機能を含む API を見つけます。[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
- API を選択します。
- 削除する拡張機能を探します。デフォルト バージョンに追加された拡張機能は、API の詳細ページの [拡張機能] セクションに表示されます。拡張機能が別のバージョンに追加されている場合は、そのバージョンの詳細ページで拡張機能を確認する必要があります。
- 操作メニュー（API が表示された行の右側）にある [削除] をクリックします。