「Now Assist スキルを呼び出す」ステップ
公開済みの Now Assist スキルをアクションから実行します。ステップ入力とステップ出力から、 Now Assist スキル入力とスキル出力を構成します。
ロールと可用性
ワークフロースタジオ アクションステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。
- Now Assist スキルキット の要件
- このステップには Now Assist スキルキットが必要です。詳細については、「」を参照してください。
- ロール要件
- このステップには、委託開発によって付与されたロール、またはユーザーにアサインされたロールが必要です。詳細については、「ワークフロースタジオ フローへのユーザーアクセス」を参照してください。
入力
アクションに必要な各入力の値を指定します。動的な値を追加するには、[データ] パネルからピルをドラッグアンドドロップすることも、ピルピッカーから選択することもできます。
- スキル構成
- データタイプ：Reference
Now Assist スキル構成 [sn_nowassist_skill_config] レコードへの参照。ペイロードは、選択したスキル構成に基づいて生成されます。
- ペイロード
- データタイプ：String
処理のために Now Assist スキルと OneExtend フレームワークに送信するペイロードを含む JSON 形式の文字列。
- このステップが失敗した場合
- データタイプ：Choice
次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「アクションエラー評価」を参照してください。
出力
これらの出力は [データ] パネルに表示されます。アクションの任意の場所で入力として使用できます。
- エラー
- データタイプ：String
スキルによって生成されたエラーメッセージ。スキルが Now Assist スキル要求を正常に実行した場合、この出力は空です。
- プロバイダー
- Now Assistスキル要求を履行した LLM プロバイダーの名前。
- 応答
- 会話のサマリーや返信など、LLM によって生成されたテキスト応答。
- 結果
- LLM によって生成された結果を入力ペイロードに含む JSON 形式の文字列。
- ステータス
- プロバイダーへのコールのステータス。
- ステップステータス
- データタイプ：Object
ステップに関するランタイムの詳細を含むオブジェクトデータピル。アクションの各ステップはステップステータスを返します。
- ステップステータスコード (Step Status Code)
- データタイプ：Integer ステップでエラーが発生したかどうかを示す整数データピルです。何らかの理由でエラーが生成された場合、ステップは値 1 を返します。たとえば、必須の入力データが欠落しているか、間違ったデータタイプで出力を返す場合、ステップはエラーを生成する可能性があります。ステップは、正常に実行されると値 0 を返します。これらのコードはカスタマイズできません。
- 成功 [0]：ステップは成功しました。
- エラー [1]：ステップによってエラーが発生しました。
- ステップステータスメッセージ (Step Status Message)
- データタイプ：String
ステップまたはシステム操作によって生成されたエラーメッセージを含む文字列データピル。このステップステータスメッセージはカスタマイズできません。
フロー要約スキルを呼び出す
- sys_id。この入力には、要約されるコンポーネントの Sys ID が含まれています。
- type。この入力には、要約するコンポーネントのタイプが含まれています。
- Flow to summarize。この入力には、要約されるコンポーネントの Sys ID が含まれています。
- Type。この入力には、フロー、サブフロー、アクションなどの要約するコンポーネントのタイプが含まれています。
これらのサンプル入力値を指定することで、このアクションをテストできます。
- スキル構成
- この例では、フロー要約 Now Assist スキル構成レコードを使用します。
- ペイロード
- この例では、JSON オブジェクトを使用してアクションの入力値をスキル値にマッピングします。この例では、[変更 - 通常 - 許可] フローの Sys ID とフローのタイプを指定します。
フロー要約スキルによって生成される出力値の例を次に示します。
- エラー出力
- この例では、エラー出力は生成されません。
- プロバイダー出力
- この例では、Now LLM プロバイダーを使用します。
- 応答出力
-
この例では、フロー要約スキルを使用して、変更 - 通常 - 承認フローのサマリーを生成します。通常は、この応答出力を別のアクションまたはフローロジックの入力として使用します。
このフローは「変更 - 通常 - 承認」という名前で、通常の変更モデルを使用し、[承認] ステータスになっている変更要求を保留中でないことを確認しながら処理するように設計されています。
フローは、アサイン先グループマネージャーが既に変更要求を承認しているかどうかを確認することから始まります。そうでない場合は、特にリスク承認に対して変更承認ポリシーが適用されます。
次に、承認プロセスがスキップされたか、却下されたか、承認されたかが評価されます。スキップすると、何も実行されません。却下された場合は、関係者にメール通知が送信されます。承認されると、変更要求レコードを更新して承認済みとしてマークします。
並行して、フローは変更要求が保留または非アクティブになるまで待機し、変更要求の承認を無視します。また、変更モデルを再度評価します。
これらのタスクが完了すると、フローは終了します。
- 結果出力
- この例では、応答と、応答の生成に使用されるフロー要素の両方を含む JSON オブジェクトを返します。
- ステータスの出力
- この例では、成功の出力値を返します。