生成 AI スキルを使用して API コネクタを作成する

  • リリースバージョン: Australia
  • 更新日 2026年03月31日
  • 所要時間：4分

    • SPC セットアップコネクタスキルを使用すると、 セキュリティポスチャコントロール ワークスペースのコネクタビルダーで構成ステップ 3 から 5 を自動的に完了できます。

    始める前に

    注:
    ライセンスに応じて、特定のアプリケーション機能、生成 AI スキル、エージェント型ワークフロー、AI エージェントにアクセスできます。詳細については、「ServiceNow product tiers」を参照してください。

    SPC セットアップコネクタスキルは 脆弱性対応向け Now Assist に含まれており、スキルはデフォルトでアクティブ化されています。このスキルの構成の詳細については、「 脆弱性対応向け Now Assistのスキルの構成」を参照してください。

    重要:
    この Now Assist スキルはデフォルトでオンになっています。このスキルは、アプリケーションの適切なロールユーザーが自動的に利用できるようになります。詳細については、「Now Assist skills, agents, and agentic workflows on by default」を参照してください。

    SCP セットアップコネクタ Now Assist スキルを呼び出す前に、ワークスペースでステップ 1 と 2 を完了する必要があります。詳細については、「メタデータを入力」と「コネクタエイリアスと接続認証情報の作成」を参照してください。

    必要なロール：admin

    手順

    1. 移動先 すべて > セキュリティポスチャコントロール > コネクタビルダー ステップ 1 と 2 を完了します (まだ完了していない場合)。
    2. ステップ 3 で、[ Now Assist を使用] を選択します。
    3. フィールドに入力します。
      注:
      API ドキュメント URL がサポートされていない場合、または資産リストデータに関連していない場合は、エラーが表示されます。
      フィールド 説明
      API ドキュメントリンク

      使用する API 情報を持つベンダーの URL ( https://developer.yourvendor.com/documentation/api/assets など) を入力します。
      API エンドポイント (オプション)

      API ページの詳細が多すぎる場合、PDF の場合、または HTML 形式ではなく JASON である場合は、このフィールドを使用することをお勧めします。ベース URL にエンドポイントを追加できます。

      たとえば、 https://developer.yourvendor.com があるとします。API ドキュメント (documentation/api/assets) で必要なエンドポイントを見つけて、このフィールドに入力します。
    4. [ Set up for me] を選択します。

      Now Assistスキルは、テンプレートを自動的に選択し、入力パラメーターを提供し、API 接続をテストし、パラメーターをマッピングします。

      このプロセスには少し時間がかかり、進捗状況がモーダルに表示されます。

      Now Assist は、前のステップでアップロードした API ドキュメントに基づいて、応答サンプルとスキーマを生成します。コネクタを検証して公開する前に、サンプル応答とスキーマの正確性、およびマッピングの正確性を確認する必要があります。

      注:

      Now Assistスキルによって生成されたすべての情報が正しいことを確認して確認するように求める警告メッセージが表示されます。

      Now Assistスキルが入力できない場合、たとえば入力した情報に基づいてテンプレートを選択できない場合は、エラーメッセージが表示されます。エラーメッセージが表示された場合は、[ 構成を適用] を選択して次の手順に進むことはできません。

    5. [ 構成を適用] を選択します。
      コネクタビルダーの [テンプレートの選択] ステップが表示され、テンプレートが自動的に選択されました。
    6. [保存して続行] を選択します。
      [入力の提供] ステップが表示されます。次の情報は、入力したベンダードキュメントに基づいてフォームに自動的に入力されます。
      注:
      [ サンプル応答を取得] を選択する必要はありません。
      • API サンプル応答
      • API エンドポイントパス
      • クエリパラメーター
      • ヘッダーパラメーター
      • ページネーションパラメーター
    7. 情報を確認し、必要に応じてフィールドを編集します。
    8. 値を確認したら、[ 保存して続行] を選択します。

      API サンプルが表示されない場合、またはエラーが表示された場合は、メッセージのプロンプトに従って、不足している値を入力します。

      インポートが成功すると、[マップ応答] ステップが表示されます。入力パラメーターは、コネクタによって生成されたサンプルデータの セキュリティポスチャコントロール (SPC) 属性とポリシーに自動的にマッピングされています。

      [参照] ウィンドウで SPC 属性の API 応答サンプルと API 属性の API 応答スキーマサンプルを確認して、値を確認します。

      このサンプルデータが集計され、マッピングが編集可能です。さらに、必要に応じて SPC ポリシーのカスタム属性を作成できます。

      値を組み合わせて単一のフィールドに入力することを含むマッピングの詳細については、セキュリティポスチャコントロール 製品ドキュメントの「応答のマッピング」を参照してください。

    9. 検証手順、コネクタの公開、およびプロセスの完了の詳細については、セキュリティポスチャコントロール製品ドキュメントの「コネクタの検証」を参照してください。