コネクタ テンプレートを使用する

コネクタ テンプレートは、一般的な LLM プロバイダー用に事前定義された Integration Service コネクタの設定です。AI Trust Layer を使用してカスタム コネクタを作成する場合、テンプレートを選択すると、そのプロバイダーに必要な API リソース、認証設定、JavaScript フックがコネクタに事前に入力されるため、手動で構成する手間が減ります。

テンプレートからカスタム コネクタを作成する

1. Automation Suite で、[ AI Trust Layer ] > [LLM の設定] に移動します。
2. [設定を追加] を選択します。
3. 設定の [テナント]、[製品]、および [機能] の値を選択します。
4. [ モデルの設定] で、[ LLM 名 ] フィールドと [API の種類 ] フィールドを設定します。
5. [コネクタ] フィールドで、[カスタム コネクタを作成] を選択します。
6. [ カスタム コネクタを作成 ] ダイアログで、利用可能なテンプレートを 1 つ選択します。
7. [ コネクタを作成] を選択します。コネクタ ビルダーにリダイレクトされ、設定を編集、保存、 コネクタをパブリッシュできます。

結果

カスタム コネクタが作成され、選択したテンプレートに基づいて事前に構成されます。コネクタの JavaScript フックを編集して、LLM の要求と応答の動作をさらにカスタマイズできます。

利用可能なテンプレート

[カスタム コネクタを作成] ダイアログで利用可能なテンプレートは、モデル構成で選択した API の種類によって異なります。

AWS Bedrock

次の API の種類で利用可能: AWS Bedrock

使用すべきタイミング: このテンプレートは、独自の Amazon Bedrock LLM インスタンスに接続し、LLM の要求と応答の属性を制御または変更する必要がある場合に使用します。

認証： このテンプレートは、API キーに基づく標準の AWS Bedrock 認証に従います。

Azure OpenAI

次の API の種類で利用可能: OpenAI

使用すべきタイミング: このテンプレートは、独自の Azure OpenAI LLM インスタンスに接続し、LLM の要求と応答の属性を制御または変更する必要がある場合に使用します。

認証： このテンプレートは、標準の Azure OpenAI 認証に従います。

Google Vertex AI

使用すべきタイミング: このテンプレートは、独自の Google Vertex AI LLM インスタンスに接続し、LLM の要求と応答の属性を制御または変更する必要がある場合に使用します。

認証： このテンプレートは、API キーに基づく標準の Google Vertex AI 認証に従います。

OpenAI V1 対応

次の API の種類で利用可能: OpenAI

使用すべきタイミング: このテンプレートは、独自の OpenAI または OpenAI V1 互換インスタンス(Fireworks など)に接続し、LLM の要求属性と応答属性を制御または変更する必要がある場合に使用します。

認証： このテンプレートは、API キーに基づく標準の OpenAI V1 互換認証に従います。

カスタム AI ゲートウェイ

次の API の種類で利用可能: すべての

使用すべきタイミング: このテンプレートは、LLM が AI ゲートウェイの背後にある場合に使用します。

認証： 設定について詳しくは、 コネクタ ビルダーの認証に関するドキュメントをご覧ください。

このテンプレートには、 カスタム 認証の種類に必要な 2 つの API リソースが含まれています。

• /onProvision — Integration Service のコネクションが作成されたときに呼び出されます。ID プロバイダーから一時トークンを取得し、有効期限とともにコネクションに保存します。
• /onRefresh — トークンを更新するために使用します。ターゲット URL、要求前フック、要求後フックは、 /onProvision用に設定されたものと一致する必要があります。

カスタム以外の認証の種類を選択した場合は、コネクタから /onRefresh リソースと /onProvision API リソースを削除します。

JavaScript フックを編集する

テンプレートからコネクタを作成した後、要求前および要求後の JavaScript スクリプトを編集して、その動作をカスタマイズできます。詳しくは、 コネクタ ビルダーのドキュメントをご覧ください。

スクリプトを編集する前に、利用可能なコード スニペットと、予約済みの各キーワードのドキュメントを確認してください。