汎用大規模言語モデル (LLM) コネクタの構成

  • リリースバージョン: Australia
  • 更新日 2025年07月31日
  • 所要時間:7分
  • 汎用 LLM コネクタを使用して、外部 LLM を ServiceNow AI Platform に接続します。コネクタを使用すると、独自のプロンプトを作成して LLM に送信し、独自の生成 AI 機能を作成できます。

    始める前に

    コネクタを設定する前に、LLM の API 認証情報を構成する必要があります。詳細については、「 汎用 LLM の API 認証情報の構成」を参照してください。

    必要なロール:admin

    このタスクについて

    生成 AI コントローラー は、 Azure OpenAIGoogle Vertex などの一般的な AI サービスプロバイダーへのベースシステム接続を複数提供しています。ただし、業界の LLM、ケース固有の LLM をカスタムワークフローに組み込むか、組織のデータ処理ポリシーに準拠する LLM を組み込むことができます。
    注:
    生成 AI コントローラー テキスト生成のみをサポートします。

    手順

    1. ナビゲーションフィルターで、「 sys_generative_ai_model_config.list」と入力して生成 AI モデル構成 [sys_generative_ai_model_config] テーブルに移動します。
    2. [新規] を選択します。
    3. [ モデル ] フィールドに、モデルの名前を入力します。
      Azure OpenAI を使用している場合、モデル名はリソースのデプロイ名です。
    4. [ プロバイダー] フィールドで、[ カスタム LLM] を選択します。
    5. [ 接続および資格情報エイリアス ] フィールドで、認証情報の設定時に作成したエイリアスを選択します。
      API 認証情報をまだ構成していない場合は、「 汎用大規模言語モデルの API 認証情報の構成 」を参照してその方法を確認してください。[プロバイダー] フィールドが [カスタム LLM] に設定され、[接続と資格情報エイリアス] フィールドが [My_Model_Alias] に設定された生成 AI モデル構成レコード。
    6. [ 送信] を選択して、モデル構成を作成します。
      モデル構成は、外部モデルの API キーに関連付けられています。
    7. ナビゲーションフィルターで、「 sys_generative_ai_config.list」と入力して生成 AI 構成 [sys_generative_ai_config] テーブルに移動します。
    8. [新規] を選択します。
    9. [定義] フィールドの横にあるリストルックアップアイコン (虫眼鏡付きリストルックアップアイコン)を選択します。
    10. [ドキュメントを選択] モーダルで、カスタム LLM プロバイダーで構成する機能を選択します。
      たとえば、要約を作成機能を構成する場合は、[ 要約を作成 (カスタム LLM)] を選択します。
    11. [ OK ] を選択して選択内容を保存し、モーダルを閉じます。
    12. [ モデル ] フィールドで、ステップ 6 で作成したモデル構成を選択します。
      定義を選択すると、[モデル] フィールドがドロップダウンメニューに変わり、カスタム LLM プロバイダーを使用するオプションが表示されます。行ったモデル構成がこのリストに表示されます。設定されていない場合は、ステップ 1 に戻り、モデル構成の [プロバイダー] フィールドが [カスタム LLM] に設定されていることを確認します。
    13. [ プロンプトテンプレート] フィールドに、機能のプロンプトを入力します。
      プロンプトテンプレートは、機能を実行するために LLM に送信される指示です。プロンプトテンプレートに組み込むには、機能属性名を 2 つの括弧で囲みます。たとえば、要約作成機能を構成している場合、プロンプトテンプレートは、 わかりやすく親切な口調で次のものを要約する {{textToSummarize}} のようにすることができます。プロンプトに含めることができる属性を確認するには、OneExtend 機能 [sys_one_extend_capability] テーブルに移動し、構成している機能のレコードを見つけて、[OneExtend 機能属性] 関連リストを確認します。[定義]、[モデル]、および [プロンプトテンプレート] フィールドが入力された生成 AI 構成レコード。OneExtend の [機能属性] 関連リストが強調表示され、属性 (error、errorCode、provider、response、status、textToSummarize) が特定された状態で開く [要約を作成] 機能レコードユースケースに最適なものを決定するために、さまざまなプロンプトを試す必要がある場合があります。
    14. [ 送信] を選択して、新しい生成 AI 構成を作成します。
    15. ナビゲーションフィルターで、「 sys_generative_ai_custom_llm_transformer」と入力して生成 AI カスタム LLM トランスフォーマー [sys_generative_ai_custom_llm_transformer] テーブルに移動します。
    16. [新規] を選択します。
    17. トランスフォーマースクリプトを記述します。
      カスタム LLM の入力と出力の形式を 生成 AI コントローラー 理解するには、トランスフォーマースクリプトを作成する必要があります。トランスフォーマーレコードを作成すると、編集中にガイドとして使用できるコードとコメントが提供されます。これらのスクリプトは、モデルによって解釈される予想される要求オブジェクトと応答オブジェクトに依存します。

      たとえば、 Azure OpenAI 要求構造は次のスクリプトのようになります。

      {"messages": [{"role":"user", "content":"Summarize the following text: <<content>>"}], "max_tokens": 800, "temperature": 0.7}
      その要求構造の要求トランスフォーマースクリプトは、次のスクリプトです。
      (function(inputs) {
          /* write code here to construct the request body and any custom headers needed using the inputs object.
          inputs structure: {
              prompt_data: object,
              request_data: object
          } */
          var requestData = inputs.request_data;    
          var promptData = inputs.prompt_data;
          var prompt = promptData.prompt;
          var model = promptData.model;
      
          // construct body using the inputs
          var body = {
              messages: [{
              "role": "user",
              "content": prompt
              }],
              max_tokens: parseInt(promptData.max_tokens),
              temperature: parseInt(promptData.temperature)    
          };
      
          //construct headers using the inputs
          var headers = {};                        
          return {
              body: body,
              headers: headers
          };
      })(inputs);
      Azure OpenAIからの応答構造は、次のスクリプトのようになります。
      {
          "choices": [{
          "finish_reason": "stop",
          "index": 0,
          "message": {
              "content": "<<response>>",
              "role": "assistant"
              }
          }],
          "created": 1714994995,
          "id": "chatcmpl-9LqpXeLVXDAi6kciPfLeIDjmALeea",
          "model": "gpt-35-turbo-16k",
          "object": "chat.completion",
          "usage": {    
              "completion_tokens": 47,
              "prompt_tokens": 70,
              "total_tokens": 117
          }
      }
      この応答構造により、応答トランスフォーマースクリプトは次のスクリプトのようになります。
      (function(inputs) {
          /* write code here to transform the llm response into an array of text responses, using the inputs object
          inputs structure: {
              prompt_data: object,
              request_data: object,
              response_body: string,
              response_headers: string
          } */
          var requestData = inputs.request_data;
          var promptData = inputs.prompt_data;
          var responseBody = JSON.parse(inputs.response_body);
          gs.info("response : " + inputs.response_body);
          var responseTexts = [];
      
          // write code here to populate the responseTexts array.
          responseTexts.push(responseBody.choices[0].message.content);
      
          return responseTexts;
      
      })(inputs);
    18. [ 送信] を選択して、トランスフォーマースクリプトを作成します。

    タスクの結果

    外部 LLM が 生成 AI コントローラー に接続されています。ServiceNow AI Platform の生成 AI 機能には AI サービスプロバイダーを使用できます。

    次のタスク

    LLM に接続した後、 生成 AI コントローラー の生成 AI 機能のプロバイダーを設定できます。機能は、汎用プロンプト、コンテンツの生成、感情分析、要約です。プロバイダーの選択の詳細については、「 生成 AI 機能のプロバイダーを設定する」を参照してください。