Gemini 起動

Gemini呼び出しポリシーを使って「Geminiオペレーションを呼び出す。

ゲートウェイのサポート

表 1. このポリシーをサポートするゲートウェイと、対応するポリシーのバージョンを示す表
ゲートウェイ	ポリシーのバージョン
DataPower® API Gateway	2.0.0

このトピックでは、アセンブリ・ユーザー・インターフェースでポリシーを設定する方法について説明します。 OpenAPI ソースでポリシーを設定する方法の詳細については、 gemini-invokeを参照してください。

製品情報

Gemini呼び出しポリシーは、6つの「Gemini操作へのアクセスを提供する：

POST models/[model]:generateContent
POST models/[model]:countTokens
POST models/[model]:embedContent
POST models/[model]:batchEmbedContents
GET models/[model]
GET models

Gemini呼び出しポリシーは、表2に示すプロパティをサポートしている。

プロパティ－

以下の表に、このポリシーのプロパティーをリストします。表には、プロパティーが必須かどうか、入力用の有効な値とデフォルト値、および値のデータ型が示されています。

表 2. Gemini invoke ポリシーのプロパティー
プロパティー・ラベル	必須	説明	データ・タイプ
タイトル	いいえ	Geminiチャットの完了を呼び出す	ストリング
説明	いいえ	ポリシーの説明。	ストリング
ジェミニ・オペレーション	はい	呼び出す'Gemini操作は、以下の操作のいずれかでなければならない： `POST models/[model]:generateContent` `generateContent` に対する HTTP POST操作。リクエストとレスポンスの例については、'GeminiAPI ドキュメントのGenerating Contentを参照のこと。 `POST models/[model]:countTokens` `/countTokens` に対する HTTP POST操作。リクエストとレスポンスのサンプル例については、'GeminiAPI ドキュメントの「トークンのカウント」を参照のこと。 `POST models/[model]:embedContent` `embedContent` に対する HTTP POST操作。リクエストとレスポンスのサンプル例については、'GeminiAPIドキュメントのEmbed Contentを参照してください。 `POST models/[model]:batchEmbedContents` `batchEmbedContents` に対する HTTP POST操作。リクエストとレスポンスの例については、'GeminiAPI ドキュメントのBatch Embed Contentを参照してください。 `GET models` `/models` に対する HTTP GET操作。レスポンスの例については、'GeminiAPI ドキュメントの List Modelsを参照のこと。 `GET models/[model]` `/models/[model]` に対する HTTP GET操作。レスポンスの例については、'GeminiAPI ドキュメントのRetrieve modelを参照ください。	ストリング
ジェミニAPIキー	はい	APIキー、またはAPIキーを含む変数への変数参照。 APIキーは'Geminiリクエストの認証に使用される。	ストリング
レスポンス・キャッシュを有効にする	いいえ	レスポンス・キャッシュは、APIのパフォーマンスを最適化するためにデフォルトで有効になっています。レスポンスキャッシュが有効になっている場合、リクエストが「Geminiサービスに送られると、リクエストペイロードに関連するキャッシュされたレスポンスがあるかどうかを判断するために、レスポンスキャッシュが検査される。その場合、キャッシュされたレスポンスとそれに関連する HTTP レスポンス・ヘッダは、 Output Message プロパティで指定された DataPower API Gateway コンテキスト・メッセージに配置される。キャッシュされた応答がない場合、リクエストは 'Geminiサービスに渡され、応答は、Response Cache Expirationプロパティで指定された有効期限を使用して、以降の操作のためにキャッシュされる。	ブール値
レスポンス・キャッシュの有効期限	いいえ	キャッシュの有効期間（time-to-live）。最小継続時間は60秒、最大継続時間は86400秒(1日)である。この範囲外の値は、たとえこのフィールドで値が受け入れられたとしても、API公開時にバリデーションに失敗する。	整数
キャッシュ・スコープ	いいえ	キャッシュされたレスポンスを保存するためのキーに一意性を持たせるための文字列。キャッシュスコープを追加することで、同じリクエストを複数のキャッシュエントリに保存することができる。	ストリング
ジェミニオペレーションパスのパラメータ	いいえ	操作の中で、パス・パラメータ名を角括弧で囲んで指定したパス・パラメータを持つ操作では、パラメータ名と値をコロンで区切って指定する。操作に複数のパスパラメータがある場合、各パスパラメータの指定はカンマで区切らなければならない。例えば、操作「`GET models/[model]`、パスパラメータプロパティは「`model:somename`」と指定される。注意：選択した操作にパス・パラメーターが必要であるにもかかわらず提供されなかった場合、呼び出し操作は失敗する。しかし、パス・パラメータを必要としない操作では、指定されたパス・パラメータは無視される。	ストリング
ジェミニ・オペレーション・クエリ・パラメータ	いいえ	クエリーパラメーターをサポートする操作の場合は、パラメーター名と値を等号で区切ったクエリーパラメーター文字列を指定する。複数のクエリーパラメーターがサポートされている場合、各クエリーパラメーターはアンパサンド文字で区切られる。現時点でサポートされているオペレーションはクエリーパラメーターをサポートしていないが、将来サポートされる可能性のあるオペレーションはクエリーパラメーターをサポートするだろう。	ストリング
出力メッセージ	いいえ	Geminiレスポンスを受け取るDataPower API Gatewayコンテキストメッセージの名前。デフォルトでは、このプロパティは値としてmessageを使用します。これにより、'`message.body`および'`message.headers`の後続のAPIポリシーによって、レスポンスにアクセスできるようになります。	ストリング