Now Assist のスポーク生成スキルを使用したスポークの作成とアクションのビルド
必要なサードパーティ API ドキュメントスニペットを入力として指定することで、統合を自動化し、再利用可能なアクションを生成します。
始める前に
重要:
この Now Assist スキルはデフォルトでオンになっています。このスキルは、アプリケーションの適切なロールユーザーが自動的に利用できるようになります。詳細については、「Now Assist skills, agents, and agentic workflows on by default」を参照してください。
- 必要なロール:admin
- アクションカテゴリ [sys_hub_category] テーブルで、統合に必要なアクションカテゴリを作成します。
- ServiceNow 統合ハブ Professional Pack Installer (com.glide.hub.integrations.professional) がインストールされ、ライセンスのエンタイトルメントが付与されていることを確認します。
手順
- 移動先 すべて > プロセス自動化 > ワークフロースタジオ.
- クリック 新規作成 > スポーク.
-
[スポーク情報 (Spoke Info)] 画面で、スポークを新しいスコープに作成するか既存のスコープに作成するかを指定します。
-
新しいスコープでスポークを作成する場合は、統合のロゴとして画像を選択し、フィールドに入力します。
ここでは、例として LearnOrbit との統合について説明します。
フィールド 説明 スポーク名 カスタムスポークを識別する名前 説明 カスタムスポークの説明。 図 : 1. スポークジェネレーターウィンドウ 注:[アプリスコープ名] の値は、x_<company-code>_<spoke-name>_<spoke> の形式です。デフォルトでは、<company-code> は snc です。システムプロパティ glide.appcreator.company.code の値を設定することで、会社コードを設定できます。
この構成値は、値 [アプリスコープ名] が生成されるときに使用されます。
-
既存のスコープでスポークを作成する場合は、統合のロゴとして画像を選択し、フィールドに入力します。
ここでは、例として LearnOrbit との統合について説明します。
フィールド 説明 アプリケーション名 既存のアプリケーション名またはスコープ。 アプリスコープ名 選択したアプリケーション名に基づいて自動入力されるスコープ名。 説明 カスタムスポークの説明。
-
新しいスコープでスポークを作成する場合は、統合のロゴとして画像を選択し、フィールドに入力します。
- [続行] をクリックします。
- [ビルド情報] 画面で、スポークのビルドに使用する方法を選択します。
-
[Now Assist] を選択して [続行] をクリックし、必要なサードパーティ API ドキュメントスニペットを指定して、再利用可能なアクションを生成します。
-
[アクションの生成] 画面で、必要なコンテンツを 360Learning API ドキュメントから [Now Assist コンテキスト] に貼り付けます。
この例では、enrollUser アクションに関連するドキュメントをコピーして、 Now Assist コンテキストに貼り付けます。注:一度に 1 つのアクションに関連するドキュメントのみを貼り付けるようにしてください。
図 : 2. [スポークアクションを作成] ウィンドウ -
[ 生成 preview] をクリックします。
アクションのプレビューが生成されます。アクションのプロパティ、入力、出力、およびステップの詳細が表示されます。
図 : 3. アクション生成結果のプレビュー - オプション:
生成されたアクションを変更する場合は、 [Now Assist コンテキスト] で指定したコンテンツを適宜変更し、[プレビューを再生成] をクリックします。
[Now Assist コンテキスト]で指定したコンテンツに足りないフィールドがある場合、エラーメッセージが表示されます。
図 : 4. アクション生成エラーの例 - [続行] をクリックします。
- [接続とカテゴリを選択] 画面の [接続および資格情報エイリアス] で、[新規作成] をクリックします。
-
[新しい接続および資格情報エイリアスを作成 (Create new connection and credential alias)] 画面で、フィールドに入力し、エイリアス情報を入力します。
フィールド 説明 接続および認証情報名 (Connection & Credential name) 接続および資格情報エイリアスレコードを識別するための名前です。 認証用の構成テンプレート (Configuration Template for authentication) この統合に必要な認証メカニズムです。認証メカニズムとサードパーティアプリケーションの間に互換性があることを確認します。 図 : 5. [接続および資格情報エイリアス] ウィンドウ - [エイリアス作成して続行 (Create alias and continue)] をクリックします。
-
[接続および資格情報エイリアスの構成] 画面で、フィールドに入力し、エイリアスを構成します。
フィールド 説明 接続情報 接続名 接続レコードを識別する名前です。 接続 URL サードパーティのインスタンスまたはサーバーに接続するためのベース URL。 認証情報 選択した構成テンプレートに基づいて、関連する認証情報フィールドが表示されます。認証情報レコードを設定するために必要な値を指定します。 エイリアスレコードを後で設定する場合は、[後で行う] をクリックします。
-
[Submit (送信)] をクリックします。
接続エイリアスレコードが作成されます。
- [接続とカテゴリを選択] で、必要なアクションのカテゴリを選択します。
-
[公開] をクリックします。
注:不足しているフィールドがある場合、アクションを公開できません。代わりに、[アクションをドラフトとして保存] をクリックして、アクションをドラフトとして保存できます。アクションが作成されます。別のスポークアクションを作成、または [スポーク] ページに移動できます。
アクションをドラフトとして保存した場合は、下のスポークの詳細ページでこれらのドラフトアクションにアクセスできます アクション > ドラフト.