本稿はこちらの記事の翻訳です。最新の情報は元となる記事をご覧ください。
このトピックの一部は機械翻訳で処理されている場合があります。

 

naotokadowaki_33-1764883004212.png

 

Now Assist スキルキット (NASK) とは何ですか?

Now Assist スキルキット (NASK) Xanadu リリースでリリースされました。この機能を使用すると、生成 AI を活用するカスタムスキルをインスタンス内で直接構築して展開できます。これらのスキルは、タスクの要約やコード生成など、標準機能の (OOTB: Outo Of The Box) Now Assist スキルスイートでは実現できないユースケースを実現するのに役立ちます。

 

NASK はカスタムスキルを出力し、Now Assist アドミンコンソール内からアクティブ化できます。

naotokadowaki_34-1764883004216.png

 

NASK はいつ使用しますか?

NASK は、生成 AI 機能による柔軟性の向上を求めるユーザー向けに設計されています。NASK の使用を呼び出す可能性のある一般的なユースケースは次のとおりです。

  • 生成 AI 機能で拡張したい既存のワークフローがある場合。
  • 機能には、外部 LLM (ServiceNow 以外の管理対象モデルなど) を使用する必要がある場合。 
    • これには、LLM がドメイン固有の知識または特定のデータ処理を持っている要件と、ユーザーが NowLLM を使用できないようにするセキュリティ制限が含まれます。 
    • NASK を使用して外部 LLM を活用する方法の詳細については、こちらをご覧ください
  • OOTB スキルでは対応できない組織固有のユースケースがある場合。
  • **2025 1 月リリース時点でのみ利用可能** 対象となる OOTB スキルの LLM プロバイダーまたは基礎となるプロンプトを変更する場合。詳細については、「NASK を使用して OOTB スキルを変更するにはどうすればよいですか?」という質問を参照してください。

ServiceNow ではカスタムソリューションを監視または管理できないため、通常は、この機能を慎重に使用するアプローチをお勧めします。したがって、通常、ほとんどの管理者は OOTB 機能の範囲内に留まることをお勧めします。OOTB が目的に適していない場合は、Now Assist アドミンコンソール内で提供される構成オプションを試すことができます。それでも十分でない場合は、NASK が適している可能性があります。

この質問については、Now Assist を使用したカスタム生成 AI ソリューションの構築方法に関する記事でより広く説明されています。

 

Now Assist スキルキットにアクセスするにはどうすればよいですか?

NASK にアクセスするには、次の基準に従う必要があります。

  • Now Assist for [x] 製品のアクティブなライセンスがあること。
  • [x] 向け Now Assist プラグインを最新バージョンに更新していること。
  • Xanadu リリース以降のインスタンスであること。

なお、パーソナル開発インスタンス (PDI) では、Now Assist/生成 AI 機能 (ひいては NASK) にはアクセスできません。カスタムスキルの開発を検討しているパートナーの場合は、パートナーサクセスセンター内で NASK にアクセスするためのオプションを見つけることができます。

 

上記を確認したら、ユーザーにアクセス権を付与する必要があります。これを行うには、カスタムスキルを作成および管理するユーザーに sn_skill_builder.admin ロールを追加します。

naotokadowaki_35-1764883004218.png

NASK の使用を開始する前に知っておくべきことは何ですか?

NASK を使用してカスタムスキルを構築するプロセスには幅広い経験が含まれますが、使用する前にそれらすべてについて理解しておくことをお勧めします。要約として、以下にユーザージャーニーを記載します。

naotokadowaki_36-1764883004223.png

 

  1. プロバイダーの定義このプロセスでは、検討されている各 LLM の利点と潜在的な欠点を理解する必要があります。通常は、可能な場合は汎用の NowLLM サービスを使用することをお勧めしますが、ユースケースには特殊性があり、1 つの LLM が優先される場合があります。
  2. ビルドビルドプロセス中に、次のことを求められます。
    • プロンプトに必要な情報を補強するために、入力データの取得元を定義します。そのためには少なくともインスタンスのアーキテクチャを理解する必要がありますが、必要なものを抽出するためのスクリプトを作成するか、フローをビルドすることが必要になる場合もあります。
    • プロンプトの開発 – NASK 内には、希望のプロンプトを入力するテキストボックスが用意されています。プロンプト内で、求めている結果を提供するために LLM が知っておく必要のあるすべてのことを概説する必要があります。これには、形式、言語、アクション、および参照するデータへの参照が含まれます。
    • プロンプト設定を調整します。これらの設定では、スクリプトを作成するか (送信要求または受信要求を拡張するためにプリプロセッサーまたはポストプロセッサを含める場合など)、温度が LLM の「創造性」に関係していることの理解など、単に LLM の基礎を理解する必要があります。
  3. テスト: NASK には、エディター自体からプロンプトをテストするための領域が用意されています。スキルの結果の成功を定義するルーブリックを持つことが重要です。
  4. 展開現在、Now Assist パネル、Now Assist コンテキストメニュー、仮想エージェント、フローアクション、または UI アクションに直接展開できます。

Now Assist スキルキット内でビルドできる内容に制限はありますか?

イノベーションを起こすことをお勧めしますが、ライセンスを取得した地域でのみの構築する事に関連する使用分野の制限に関するガイダンスがあります。

 

NASK の使用時に消費されるアシストの数はいくつですか?

アシストの使用の詳細については、概要を参照するか、アカウント担当者にお問い合わせください。LLM の呼び出し時にエラーメッセージが表示された場合、アシストは請求されません。

 

カスタムスキルは英語以外の言語をサポートしていますか?

はい、生成 AI コントローラーの動的翻訳コンポーネントを活用して、英語以外の言語で操作するユーザーがカスタムスキルを使用できるようにすることができます。特定の言語では、ネイティブ翻訳も利用できる場合があります。

詳細については、こちらまたは FAQ をご覧ください。

 

展開されたカスタムスキルにアクセスできるユーザーをどこで制限できますか?

これを行うには、展開ベクトル自体を設定します。たとえば、カスタムスキルを UI アクションとして展開する場合は、このガイドに従ってロールベースのアクセスを追加できます。

 

Now Assist スキルキットは GCC またはセルフホスト型環境でサポートされていますか?

はい。

 

Now Assist Guardian Now Assist スキルキットと連携しますか?

はい。

 

Now Assist スキルキットにはどのようなロールが付属しますか?

  • sn_skill_builder.admin:NASK 内のすべての機能へのアクセスを許可します。
  • sn_skill_builder.viewer:NASK への読み取り専用アクセスを付与します。

 

naotokadowaki_37-1764883004224.png

 

インスタンスの NASK はどこにありますか?

インスタンス内で、フィルターナビゲーターに「Now Assist スキルキット」と入力すると、リンクを表示できます。リンクが表示されない場合は、インスタンスが少なくとも Xanadu リリースであり、[x] 向け Now Assist 製品のアクティブなライセンスがあり、少なくとも 1 つの Now Assist プラグインがインストールされていることを確認してください。PDI では Now Assist 機能にアクセスできません。

 

naotokadowaki_38-1764883004230.png

 

NASK を使用してカスタムスキルを構築するにはどうすればよいですか?

カスタムスキルの構築に関するラボガイドとチュートリアルについては、Now Assist ユースケースライブラリを参照するか、製品ドキュメントを参照してください。

 

カスタムスキルで使用できる LLM はどれですか?
今日の選択肢は次のとおりです。

  • Now LLM サービス
  • 外部 LLM
    • Spokes(スポーク)
    • BYOLLM

通常、ほとんどのユースケースでは Now LLM サービスを利用することをお勧めします。Now LLM サービスの詳細については、Now LLM サービスに関する FAQ を参照するか、NASK 内で使用されているモデルに固有のモデルカードをこちらで確認してください。

 

要件により LLM を使用できない場合は、外部 LLM を活用することを選択できます。外部 LLM に接続には、スポーク経由または BYOLLM 2 つの方法があります。

 

当社が提供する構築済みスポークを使用すると、外部 LLM に簡単に接続できます。20258月時点のリストは以下の通りです。

  • Azure OpenAI
  • OpenAI
  • WatsonX
  • Amazon Bedrock
  • Google Vertex AI
  • Google Gemini AI Studio
  • Aleph Alpha [このモデルは廃止されているため、使用することはお勧めしません]

これらはスポークですが、Integration HubトランザクションではなくAssistを消費することに注意してください。このトピックの詳細については、アカウント担当者にお問い合わせください。  

 

少なくとも Washington DC リリースのインスタンスでは、汎用 LLM コネクタを使用して、上記以外の外部 LLM (BYOLLM) に接続できます。このプロセスには、かなりの技術的洞察力が必要です。スポークでサポートされていない LLM と統合するには、次のものが必要です。

  • プロバイダーからの API キー
  • LLM のエンドポイント
  • 入力と応答を許容可能な形式に変換するための変換スクリプトの作成を支援する LLM API ドキュメントへのアクセス

このガイドには、汎用 LLM 接続を使用して外部 LLM に接続するデモがあります。

 

接続する外部 LLM に関係なく、ユースケースに適したライセンスとモデル構成を管理する責任はユーザーにあります。  

 

1 つのスキルで複数の LLM を使用できますか?
関連リソース: ツールと展開方法の概要

プラグインのバージョン 3.0.1 以降をお持ちの場合は、ツールエディター内で他のカスタムスキルを入力としてカスタムスキルに追加できます。これにより、使用している LLM に関係なく、スキルを連鎖させることができます。

naotokadowaki_39-1764883004234.png

 

スキル出力とは何ですか?

LLM からの応答は JSON 形式で保存され、LLM から取得した情報がさまざまなキー:値ペアで格納されます。NASK 内にあるスキル出力リストは、その LLM から返される予期されるキーを識別します。たとえば、プロバイダー (使用している LLM)、応答 (カスタムスキルの結果)、およびエラー (エラーが発生しなかった場合は空になる場合があります) があります。

 

スキル出力を使用して、出力のリストから目的のキーに OUTPUT KEY を置き換えることで、JSON 応答から取得する情報を解析できます。var output = sn_one_extend.OneExtendUtil.execute(request)['capabilities'][request.executionRequests[0].capabilityId]['OUTPUT KEY'];

 

現在、技術的にはツール内に出力を追加できますが、新しいスキル出力と値の間のマッピングを作成する製品内機能はありません。

 

プロンプトで使用するためにどのようなデータを取り込むことができますか?

関連リソースツールと展開方法の概要

レコード、RAG (レトリーバーツールを使用)、フロー、サブフロー、スクリプト、統合、イベント、Web 検索など、アクセスできる場所ならどこからでもデータを取り込むことができます。

ServiceNowのどこかに保存されていて、アクセス権がある限り、NASKを設定して取り込むことができます。ただし、データがレコードのフィールドよりも複雑な場合は、データを解析してプロンプト内で使用可能な文字列にする必要がある可能性があることに注意してください。ここで例を見ることができます。

ServiceNow の外部データを使用する場合は、次のツールを使用して使用できます。

  • リソースへの API 呼び出しを行うサブフロー
  • Web 検索
  • スクリプト

特定のレコードから情報を取り込むか、文字列やブール値などの静的変数を入力するには、スキル入力を追加する必要があります。これを行うには、[スキル入力] の横にあるプラスアイコンをクリックします。表示されるモジュールから、追加するデータのタイプを選択し、フォームへの入力の詳細の入力を完了します。その後、このスキル入力をフローやスクリプトへの入力として使用したり、プロンプト自体内で直接使用したりできます。

naotokadowaki_40-1764883004237.png

 

ツールを使用してデータを取得し、プロンプトにコンテキストデータを提供します。これを行うには、[ツール] セクションの右側にあるプラスアイコンをクリックします。開いたモジュール内で、追加するワークフローのタイプを選択します。フローに特定の入力が必要な場合は、スキル入力 (上記) または自分で指定した静的値のいずれかを入力できます。

naotokadowaki_41-1764883004240.png


バージョン 3.0.1 以降を使用している場合、ツールの追加と管理はツールエディターを介して行われます。このツールエディターを使用すると、次のアクティビティを実行できます。

  • 新しいツールの追加 (RAG リトリーバー、フロー、その他のカスタムスキルを含む)
  • あるツールからの出力を別のツールで使用する場合は、ツールを並列または連続で実行するように変更します。
  • 意思決定ノードの追加 (実行するツールを決定する際にロジックを使用する場合に使用)

ツールエディターの使用方法のデモは、AI アカデミーセッションでご覧いただけます。

naotokadowaki_0-1764884097964.png

 

NASK を使用して OOTB スキルを変更するにはどうすればよいですか?

プラグインのバージョン 3.0.1 では、NASK を使用して特定の OOTB スキルを編集できます。これを行うには、NASK に移動し、[ServiceNow スキル] という名前のタブをクリックします。編集するスキルを選択します。開いたら、OOTB スキルのクローンを作成する必要があります。このクローンバージョンを編集できるようになります。

 

注意:スキルのプロンプトと LLM プロバイダーのみを変更できます。入力、出力、または展開方法を編集する場合は、まったく新しいカスタムスキルを作成する必要があります。

 

この機能のデモはこちらからご覧いただけます。

 

変更された OOTB スキルを使用すると、変更されていないバージョンと同じ数のアシストが引き続き消費されます。各スキルが消費するアシスト数はこちらで確認できます。

 

OOTB スキルのプロバイダーを変更する場合、これはプロンプトレベルで行われることに注意してください。つまり、スキルのクローンを作成した後は、スキルに既に添付されているプロバイダーから選択するオプションのみが表示されることに注意してください。そのリスト外からプロバイダーを選択する場合は、[プロンプトをクローンして編集] をクリックするか、[+] アイコンをクリックして新しいプロンプトを追加する必要があります。表示されるダイアログボックスには、プロバイダーの幅広いリストが表示されます。

 

naotokadowaki_1-1764884097968.png

 

変更できる OOTB スキルを特定するにはどうすればよいですか?

sn_nowassist_skill_configテーブルに移動して、is_template = true のスキルを見つけることができます。この記事の表も参照できます。

 

適切なプロンプトを作成するにはどうすればよいですか?

「良い」プロンプトを定義するのは困難です。たとえば、要約のユースケースで使用されるプロンプトは、データ分析のユースケースには理想的ではない可能性があります。そうは言っても、目的に適したプロンプトが得られた方法に関するガイダンスをいくつか提供できます。

  • 反復、反復、反復:テストの結果をガイドとして使用して、時間をかけてプロンプトを微調整します。
  • プロンプト生成機能の使用:バージョン 2.0.1 のユーザーは、プロンプトジェネレーター機能を使用できます。これにより、カスタムスキルで実行する内容の説明を入力し、ベストプラクティスに従ったプロンプトを生成できます。
  • アプローチにおいてデータドリブンであること:プロンプトをテストするときに使用する大規模な開発データセットを作成します。このデータセットにはエッジケースが含まれていることを確認してください。空の入力が与えられた場合、プロンプトが満足のいく結果を返さなかったり、複数の外国語にまたがるテキストが含まれていたりする可能性があります。
  • プロンプトのクイックスタートガイドは便利ですが、規範的なものではありません:探している内容をある程度達成するプロンプトの例が表示される場合があります。これらは、プロンプトで何を達成できるかを理解するための優れた方法ですが、完全なソリューションではなく、その上で独自のプロンプトを開発するための基礎として見なす必要があります。
  • 注意 – LLM は人間ではありません: LLM は人間のコミュニケーションパターンを模倣することに優れていますが、人工的なままです。LLM が人間と同じようにプロンプトを理解すると想定して、プロンプトの言葉遣いをしないでください。たとえば、直接的ではなく「should」という用語を使用することが挙げられます。 

 

以下の例は、最初に LLM に次のことを依頼した反復の必要性を示しています。

あなたはテキストの根底にある感情を理解する専門家です。以下のアンケート回答を確認し、ユーザーの全体的な感情を判断し、一言で回答してください。

アンケートの質問と回答は以下のとおりです。:{{GetSurveyResults.survey_comments}}

 

これはかなり悪い結果となり、LLM はテキストの段落を返したため、このプロンプトに到達するまでプロンプトを反復処理しました。

 

あなたはテキストの根底にある感情を理解する専門家です。
以下のアンケート回答を確認し、ユーザーの全体的な感情を判断し、一言で回答してください。
次のカテゴリを使用して、全体的な感情を表します。
否定的:感情が否定的な性質である場合
肯定的:感情が肯定的な性質である場合
中立:感情が否定的でも肯定的でもない場合
応答には全体的な感情のみを含める必要があります。
アンケートの質問と回答は以下のとおりです。:{{RetrieveSurveyResults.survey_comments}}

 

2 番目のプロンプトでは、最初のプロンプトよりもはるかに高い頻度で成功したと分類した出力が提供されました。

ただし、この例はユースケースに固有のものであるため、展開前に時間をかけてプロンプトをテストして反復することをお勧めします。

 

スキルの出力に希望する形式を指示するにはどうすればよいですか?

これは、プロンプト自体の内から、次のようなステートメントを追加することで実行できます。

  • 箇条書きでリストを入力する。
  • 一言で答える。
  • 応答のすべての頭字語を展開する。
  • プロフェッショナルな口調で返信する。

ただし、技術的な意味では、LLM からの出力は JSON であり、さまざまなキーと値のペアを利用できます。詳細については、「スキル出力とは何ですか?」という質問をご覧ください。

 

プリプロセッサーおよび/またはポストプロセッサーとはどういう意味ですか?

スキルを構築するときに、プリプロセッサーまたはポストプロセッサーを追加するオプションがあります。これらは基本的に、プロンプトがインスタンスを離れる前 (プリプロセッサー) または応答が返された後 (ポストプロセッサ) で実行されるスクリプトです。

 

これらは、インスタンスから送信できるデータを制限する特定のデータ処理制限がある場合に使用するのに適しています。これにより、OOTB 機密データハンドラーまたはデータプライバシーソリューションがニーズに合わない場合に、特定の情報をマスク/マスク解除する方法を構成できます。プロセッサーの使用が必要になる追加のユースケースとして、組織に固有の頭字語のマッピングが開発されます。応答を LLM に配信する前に、プリプロセッサに頭字語を展開させ、LLM が何を表しているかを認識させることができます。

 

naotokadowaki_2-1764884097973.png

 

1 つのスキルで複数のプロンプトを使用できますか?

はい:このシナリオは使用条件機能によって処理されます。使用条件を使用すると、各プロンプトをいつ実行するかを指定できます。 

 

不要になったカスタムスキルを削除するにはどうすればよいですか?

現在、この機能はありません。カスタムスキルを NASK に表示しないようにする場合は、sn_nowassist_skill_configテーブルに移動して手動で削除します。ただし、これにより多くのメタデータレコードが残ります。 

 

この機能が必要でないようにするには、更新セット内にカスタムスキルを作成することをお勧めします。これにより、スキルの一部として作成されたすべてのレコードを識別できます。

 

トークンの制限は何ですか?

トークン制限は、スキル内で使用している LLM によって異なります。汎用 Now LLM サービスの場合、制限は 16,000 です。つまり、要求と応答の両方が 16,000 以下である必要があります。

 

テストで負のトークンが表示されている場合は、トークン制限を超えていることを意味します。

 

スキルの最大要求トークン数を定義することは可能ですか?

最大トークン制限 (つまり、コンテキストウィンドウ) LLM の固定プロパティであり、変更できません。

naotokadowaki_3-1764884097975.png

 

最大要求トークン数は、最大トークン制限 - 最大応答トークン数として計算されます。

最大応答トークン数は、デザイン時にプロンプトエディターの右側のパネル内で各プロンプトに対して制御できます。これは、プロンプトに構成されているすべての LLM に対して実行できます (現在の NowLLM を除く)

naotokadowaki_4-1764884097978.png

 

naotokadowaki_5-1764884097980.png

 

入力内でトークン制限に達している場合は、再帰的な要約の使用を試すことができます。大規模言語モデル (LLM) への要求が細かく分割されるため、生成 AI 機能のコンテキストを維持できます。

 

プロンプトに渡すトークンの数を (渡す前に) 評価して、スキルがエラーに違反し、何かが機能しない場合に適切なエラー応答を提供することを確認するためのベストプラクティスはありますか?

プロンプト変数は、skill_inputまたはtool_outputのいずれかです。

Skill_inputs、最大許容トークン数に基づいてトークン数を自動的に管理する「切り捨て」オプションがあります。

naotokadowaki_6-1764884097983.png

 

naotokadowaki_7-1764884097984.png

 

Tool_outputs現在、切り捨て機能が組み込まれていません。今のところ、ツールを使用している場合は、サブフロー/フローアクション/script_includes自体のツールロジックに応答制限を組み込んで、ツールからの出力長を制御できます。

 

構成オプション「temperature」はどういう意味ですか?

温度はLLMの「創造性」を制御します。より決定論的または反復可能なアプローチをお探しのお客様には、温度を低い設定に設定することをお勧めします。温度が低いほど、より保守的で反復的で集中的な反応が得られます。温度が高いほど、より多様で創造的で予測不可能な出力が得られます。この通常の例はコンテンツ作成であり、より柔軟性が歓迎される場合があります。

 

機密情報が LLM に送信されないようにするにはどうすればよいですか?

データプライバシーソリューションを使用して、カスタムスキルを含むすべての生成 AI アプリケーションで個人識別可能情報 (PII) を作成できます。

詳細については、こちらをご覧ください

 

 

naotokadowaki_8-1764884097985.png

 

カスタムスキルをテストするにはどうすればよいですか?

製品内のテスト方法を提供しています。これを行うには、プロンプト エディターの下にある [テストを実行] をクリックします。[応答] タブに LLM からの出力が表示されます。スキル入力/ツールからプロンプトに追加されたデータを確認する場合は、[接地プロンプト] タブをクリックします。

naotokadowaki_9-1764884097988.png

 

また、カスタムスキルの評価を実行することもできます。[評価] というラベルの付いたタブで利用できるこの機能を使用すると、データセットまたは任意のサイズを選択してカスタムスキルをテストできます。必要に応じて、AI に次の応答を判断させることもできます。

  • 忠実度: 出力はソース素材に忠実ですか?
  • 正確性: 出力は各入力命令に正しく応答しますか?

 

注意:この評価機能は、ServiceNow OEM Azure OpenAI (GPT-4o) モデルを活用しています。このモデルは、20251月現在、APACリージョンでは利用できません。最新情報については、こちらのページをご参照ください。

naotokadowaki_0-1764884200269.png

 

スキルのテストにはアシストが消費されることに注意してください。詳細については、アカウント担当者にお問い合わせください。

 

 

naotokadowaki_1-1764884200270.png

 

カスタムスキルはどこに展開できますか?

関連リソース:ツールと展開方法の概要

Now Assist スキルキットプラグインの 3.0.0 バージョン (2025 3 ) の時点で、UI アクション、Now Assist パネル、仮想エージェント、フローアクション、またはスクリプト内から展開できます。

 

カスタムスキルの構築が完了しました。は何ですか。

プロンプトが完了し、テストが完了したら、プロンプトの公開と展開を検討します。

 

公開するには、画面右上の [公開] をクリックします。これによりプロンプトがロックされ、それ以上の調整はできなくなります。後で絞り込みたい場合は、プロンプトのコピーを作成してコピーを作成する必要があります。

naotokadowaki_2-1764884200273.png

 

公開したら、[スキル設定] タブをクリックし、左側のナビゲーションバーの [展開設定] をクリックします。これにより、次の 2 つの設定を行うオプションが表示されます。

  1. Now Assist アドミンコンソールのどこにスキルがあるか。
  2. ユーザーがスキルをトリガーする方法と場所。

展開オプションの例として、UI アクションへの展開について順を追って説明します。これを行うには、[UI アクション] ボックスを選択し、UI アクションを表示するレコードタイプ (通常はスキル入力として選択したもの) を決定して、[保存] をクリックします。これにより、トリガーされるとスキルを呼び出し、情報メッセージで応答を返す UI アクションが自動的に生成されます。UI アクションのスクリプト内から直接、出力の使用方法を編集できます。

 

naotokadowaki_3-1764884200275.png

 

フローまたは仮想エージェントトピック内からカスタムスキルを呼び出すことはできますか?

バージョン 3.0.0 以上の Now Assist スキルキットプラグインを使用しているユーザーは、フローアクションに直接展開することも、仮想エージェントトピック内のモジュールとして展開することもできます。

フローアクションにカスタムスキルを展開するデモについては、以下のビデオをご覧ください。

 

スクリプト内からカスタムスキルを呼び出すことはできますか?

有料。以下のスクリプト例を参照し、変数をカスタムスキルの値に置き換えます。Sys ID を見つけるには、テーブルに移動してカスタムスキルレコードの Sys ID を取得するか、NASK でカスタムスキルを編集するときに URL の内容を確認するだけです。 

変数

URL パラメーター

skillConfigId

sn_nowassist_skill_config

config-id

capabilityId

sys_one_extend_capability

skill

 

var inputsPayload = {};

// create the payload to deliver input data to the skill

inputsPayload[‘input name’] = {

  tableName: 'table name',

  sysId: 'sys_id',

  queryString: ''

};


//create the request by combining the capability sys ID and the skill config sys ID

var request = {

    executionRequests: [{

        payload: inputsPayload,

        capabilityId: ‘capability sys id’,

        meta: {

            skillConfigId: ‘skill config sys id’

        }

    }],

    mode: 'sync'

};


//run the custom skill and get the output in a string format
try {
var output = sn_one_extend.OneExtendUtil.execute(request)['capabilities'][request.executionRequests[0].capabilityId]['response'];
var LLMOutput = JSON.parse(output).model_output;
} catch(e) {
 gs.error(e);
 gs.addErrorMessage('Something went wrong while executing the skill.');
}
action.setRedirectURL(current);

 

NASKを使ってデモを見ることはできますか?

ここで見つけることができます。

 

 

naotokadowaki_4-1764884200276.png

 

NASK に移動すると、「このページにアクセスする権限がありません」というエラーが表示されます。

NASK にアクセスするには、sn_skill_builder.admin ロールが必要です。ユーザーがそのロールを持っていることを確認してから、ログインして再度ログインし、アクセス権が付与されているかどうかを確認してください。

 

スクリプト関数で構成されるスキル入力を追加しようとしていますが、スクリプトインクルードを選択しても関数が表示されません。

すべてのアプリケーションスコープからスクリプトインクルードにアクセスできることを確認します。

naotokadowaki_5-1764884200277.png

 

カスタムスキルが Now Assist アドミンコンソールに表示されないのはなぜですか?

スキルが公開されており、展開方法が選択されていることを確認します。

展開設定で [その他] を選択した場合は、[利用可能] という名前のタブに自分のスキルが表示されます。

naotokadowaki_6-1764884200280.png

 

インスタンスに NASK が見つからないのはなぜですか?

  1. 次の点を確認してください。
    a) インスタンスは Xanadu リリースです。
    b) 関連する Now Assist プラグインのライセンスが最新である
    c) 関連するすべての Now Assist プラグイン (ITSM/HRSD/CSM/ITOM 向け Now Assist など) が最新である。Now Assist スキルキットには、以下のスクリーンショットに示すように、最新バージョンのプラグインがバンドルされています。                                       naotokadowaki_7-1764884200283.png
  2. Now Assist スキルキットを表示してアクセスするには、それを使用するユーザーに「sn_skillビルダーアドミン」ロールを付与する必要があります。このロールがアサインされていない場合、Now Assist スキルキットに移動しようとするとエラーメッセージが表示されます。
    naotokadowaki_8-1764884200285.png
  3. 「sn_skillビルダーアドミン」ロールをアサインしたら、ログアウトしてから再度ログインして変更を有効にします。

ステップ 1 から 3 を完了しても NASK にアクセスできない場合は、ケースをログに記録してください。調査します。

 

ページが読み込まれないのはなぜですか?

ページをリフレッシュしてみてください。

 

選択したレコードにカスタムスキルが表示されないのはなぜですか?

これは、スキルが次の条件を満たしていないことが原因である可能性があります。

  1. 公開 (Published)
  2. UI アクションとして展開
  3. Now Assist アドミンコンソール内からアクティブ化

テストを実行しても応答がないのはなぜですか?

LLM への接続で問題が発生している可能性があります。汎用の Now LLM サービスを使用されている場合は、ケースを提出していただければ調査します。外部 LLM を使用している場合は、まずサービスが実行されていることを確認してから、接続と認証情報を確認してください。

 

ツールを追加できないのはなぜですか?

以下の既知の問題のいずれかが発生している可能性があります (これらはすべて Xanadu パッチ 2 で修正されています)

  • ツール名にスペースを含めることはできません (たとえば、「retrievePolicies」という名前を付けることはできますが、「ポリシーを取得」という名前にすることはできません。)
  • フローアクション/サブフローの名前は、インスタンス内のスキルと同じにすることはできません。
  • スクリプトツール内から関数を呼び出す場合、関数の入力パラメーターをキャメルケースにすることはできません。以下の例を参照してください。

さらに、フロー/サブフローを追加する場合は、それらが公開されており、正しいアクセス権があることを確認してください。

 

プロンプトにスキル入力を追加できないのはなぜですか?

これは、Xanadu パッチ 1 で動作するインスタンスで Firefox Now Assist スキルキットを使用する場合の既知の問題です。解決するには、別のブラウザを試すか、インスタンスのバージョンを更新してください。

 

ツールを追加したときに「スキルツールをフェッチできませんでした」というエラーメッセージが表示されるのはなぜですか?

  • メタデータに関連する問題が発生しています。KB1702519 に従って解決策を行ってください

 

Now Assist スキルキットを初めて開いたときに、「スキルのリストのロード中にエラーが発生しました」というエラーメッセージが表示されるのはなぜですか?

これは、Xanadu パッチ 1 インスタンスの既知の問題です。最初のスキルを作成すると、このメッセージは消えます。

 

JSON アレイスキル入力が機能しないのはなぜですか?

このスキル入力タイプは現在サポートされていません。当面の間、文字列スキル入力タイプを使用してください。

 

サブフローが実行されないのはなぜですか?

次を試してください。

  • 最初にフローデザイナーでテストして、サブフローが正しい応答を返すことを検証します。
  • サブフローが公開されていることを確認します。
  • サブフローを入力として追加した後にサブフローを編集した場合は、ツールを削除して再度追加してみてください。製品の現在のバージョンは、サブフローの入力または出力が変更されていることを検出できません。

 

[スキルを作成] ボタンをクリックしても何も起こらないのはなぜですか?

Now Assist アドミンコンソールプラグインがバージョン 4.0.5 以降であることを確認してください。

 

[テストを実行] をクリックしても応答が返されないのはなぜですか?

これは、Now Assist Guardian のプロンプトインジェクションがオンになっている場合の既知の問題です。まもなくリリースされる修正を予定していますが、当面の間、カスタムスキルの開発中にこの機能をオフにしてください。

 

ドロップダウンオプションで探しているテーブルが見つからないのはなぜですか?

これに対する修正は、Now Assist スキルキットプラグインのバージョン 1.0.3 で展開されました。インストールするには、

  1. [システム定義] > [プラグイン] に移動します。
  2. 生成 AI コントローラーを検索します。[更新] という名前のタブをクリックします。
  3. 生成 AI コントローラープラグインをクリックします。
  4. [続行] をクリックして更新します。ダイアログボックスで、バージョン 7.0.3 以降にアップグレードしていることを確認します。
  5. プラグインを更新します。

このバージョンの生成 AI コントローラーでは、Now Assist スキルキットプラグインをこの問題を解決するために必要なバージョンに更新する必要があります。

 

OOTB スキルをクローンするときに LLM プロバイダーのリスト全体が表示されないのはなぜですか?

スキルをクローンする場合、少人数の LLM グループのオプションのみが提供される可能性があります。これは、このリストが、スキルに添付されている既存のプロンプトで現在使用されている LLM プロバイダーから派生するためです。

 

naotokadowaki_0-1764884279690.png

 

 

そのリストに指定されていない LLM を使用して OOTB スキルの LLM を変更する場合は、次の操作を行う必要があります。

  1. NASK 内の OOTB スキル画面で [クローン] ボタンをクリックします
  2. 表示されるダイアログボックスで (上図を参照)、プロバイダーはそのままにしておきます
  3. [クローン] をクリックします
  4. 新しくクローンされたスキルで、[プロンプトをコピーして編集] または [+] アイコンをクリックして、新しいプロンプトを追加します。
  5. 表示されるダイアログボックスに、LLM プロバイダーの拡張リストが表示されます。

naotokadowaki_1-1764884279694.png

 

 

その他のリソース

 

免責事項

一部の日本語は、翻訳ソフトウェアを使用してお客様の便宜のために翻訳されています。正確な翻訳をご提供できるよう相当な努力を払っておりますが、いかなる自動翻訳も人間の翻訳者に代わることはなく、そのようなことは意図されておりません。翻訳は「現状のまま」提供されています。他言語への翻訳の的確性、信頼性または正確性については、明示または黙示を問わず、いかなる保証も行われません。翻訳ソフトには限界があるため、一部のコンテンツが正確に翻訳されていない場合があります。これらの資料の公用言語は英語です。翻訳の際に生じる相違または不一致は、コンプライアンスまたは履行の目的に関しては拘束力を有さず、法的効力はないものとします。

バージョン履歴
最終更新日:
日曜日
更新者: