API を追加

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

    • 選択したすべての機能が [API の追加 (Add APIs)] ページのタブとして一覧表示されます。機能ごとに少なくとも 1 つの API を追加します。

    始める前に

    注:
    • API は、コード生成とスクリプトの作成に Now Assist スキルを使用します。デフォルトでは、これらのスキルは Azure Open AI LLM (大規模言語モデル) を使用します。必要に応じて、Now Assist スキルキットアプリケーションにアクセスして LLM を変更できます。利用可能な LLM は、Azure Open AI、Now LLM です。
    • スポークジェネレーターの Now Assist は、Now LLM を使用するフローアクションを生成するために使用されます。

    必要なロール:sn_si_int_kit.integration_creator

    手順

    1. API を追加する機能を選択します。
    2. 新しい API を追加するには、 [ 新しい API の追加] を選択します。
    3. API タイプを選択します。
      オプション説明
      新しい API を選択
      1. API 名を選択します。

        選択した API の詳細 (API ドキュメント、API 応答構造、API サンプル応答) が表示されます。

      2. [ API エンドポイントの詳細を作成] を選択します。

        フローデザイナーアクションが生成されます。

      3. フローデザイナーアクションセクションで、 アイコンを選択して、Now Assist によって生成されたフローデザイナーアクションを確認します。必要に応じて、値を更新できます。
      4. いずれかの API 分類を選択します。
        • 前処理 API:最終結果を得るためにプライマリ API 呼び出しを行う前に、統合に必要な最初の API 呼び出しを指します。これらの予備呼び出しは、必要な識別子 (ホスト ID など) の取得、関連情報 (OS 名など) のフェッチ、接続の確立 (ホストとのセッションの開始など) などのタスクに不可欠です。これらの準備手順を完了することで、前処理 API によって統合がメイン API 呼び出しを正常に実行し、目的の結果を取得できるようになります。
        • 結果 API:最終データを提供し、前処理 API は必要な依存関係を提供します。
      5. [ 発動スクリプトを生成 ] を選択して、呼び出しスクリプトを生成します。
        必要に応じてスクリプトを変更できます。
        注:
        変更したスクリプトが検証されていることを確認します。
      6. [ 解析スクリプトを生成 ] を選択して、解析スクリプトを生成します。
        必要に応じてスクリプトを変更できます。
        注:
        • 変更したスクリプトが検証されていることを確認します。
        • 生成された解析スクリプトが正しくなく切り捨てられた場合は、Now Assist スキルキットからのコード生成スキルの出力トークン制限を増やします。
      7. 複数の API を追加するには、[+] アイコンを選択し、手順 2 から繰り返します。
      既存の API から選択
      1. [ API を選択] で、API を選択します。

        API の詳細 ( API ドキュメント、 API 応答構造、 API サンプル応答) が一覧表示されます。

      2. [API 分類] を選択します。
        • 前処理 API:最終結果を取得するためにプライマリ API コールを行う前に、統合に必要な最初の API コール。これらの予備呼び出しは、必要な識別子 (ホスト ID など) の取得、関連情報 (OS 名など) のフェッチ、接続の確立 (ホストとのセッションの開始など) などのタスクに不可欠です。これらの準備手順を完了することで、前処理 API によって統合がメイン API 呼び出しを正常に実行し、目的の結果を取得できるようになります。
        • 結果 API:最終データを提供し、前処理 API は必要な依存関係を提供します。
      3. [ 発動スクリプトを生成 ] を選択して、呼び出しスクリプトを生成します。
        必要に応じてスクリプトを変更できます。
        注:
        変更したスクリプトが検証されていることを確認します。
      4. [ 解析スクリプトを生成 ] を選択して、解析スクリプトを生成します。
        必要に応じてスクリプトを変更できます。
        • 変更したスクリプトが検証されていることを確認します。
        • 生成された解析スクリプトが正しくなく切り捨てられた場合は、Now Assist スキルキットからのコード生成スキルの出力トークン制限を増やします。
      5. 複数の API を追加するには、[+] アイコンを選択し、手順 2 から繰り返します。
    4. 複数の API を追加するには、[+] アイコンを選択し、手順 2 から繰り返します。
    5. [完了としてマーク] を選択します。

      少なくとも 1 つの API を機能ごとに結果 API として構成する必要があります。

      選択した機能のすべての API が一覧表示されます。
    6. [ 次へ ] を選択して、アプリケーションをレビューして公開します。