サポート (英語のみ)

利用事例: Nexthink ワークフローを用いたMoveworksサービスの自動化

このユースケースでは、ワークフローAPIを使用して、NexthinkワークフローをMoveworksチャットボットサービスと統合し、リアルタイムでの問題診断と解決の自動化を行う手順を説明します。

この文書では、問題解決に必要な一般的なチャットボットタスクのための NQL 例を提供します。

  • 従業員にデバイスの問題に関連する基本的なトラブルシューティングを提供する。

  • 従業員デバイスに関するNexthinkデータを活用して基本的なデバイス情報を取得する。

  • ディスクの問題を修正するための修復を起動する。

開始前に

以下の要件を確認してください。

  • ワークフロー実行エンドポイントへのアクセス:

    • POST /v1/workflows/execute

    • POST /v1/workflows/execution/{executionUuid}/injec

  • Moveworks の HTTP 呼び出しで使用する Nexthink API 資格情報 (OAuth2 クライアントIDとシークレット)。

  • この場合、Moveworks Studio への管理者アクセス。

ステップ1 - ワークフローAPIを用いてワークフロー-チャットボットアーキテクチャを設計する

チャットボット-ワークフローのインタラクションの標準化されたステップをデザインし、各ステップのワークフロー機能を定義する。

NexthinkワークフローAPIフローを使用したチャットボットの流れを理解するには、Nexthink ワークフローとのチャットボットの統合 のドキュメントを参照してください。

以下の表は、このユースケースのために設計されたインタラクションステップを示しています。 このシーケンスは、ユーザーをコントロール下に置きながら、Nexthinkがシームレスにバックグラウンドで実行されるようにします。

インタラクションステージ
ワークフローAPI＆機能

1. 通信を認証する

ワークフローAPI資格情報: Nexthink プラットフォームを通じたトークン収集。

2. Moveworks がワークフロー実行をトリガーする

Moveworksのチャットボット内の会話がワークフローAPI（/executionsエンドポイント）を呼び出す。

3. 入力に基づいたワークフローの一時停止/再開ロジック

Moveworks は /inject API エンドポイントを使用して、ユーザー/デバイスのコンテキストを Nexthink に入力変数として提供します。

ワークフローは、会話の途中でチャットボット/ユーザー入力を待つようにAPI リスナーを使用します。

5. ワークフローが問題修復を指揮する

ワークフローは、ブランチング、コネクタ、サービスAPIシンクレットを処理し、ユーザーの選択に基づいてリモートアクション、キャンペーン、通知、さらなるロジックをトリガーします。

6. ワークフローがチャットボットに結果を返す

ワークフローは サービスAPI シンクレットを使用して修復結果/ステータスを出力します。

Moveworksチャットボットが確認を従業員に返します。

ステップ2 - Moveworks のチャットボットを設定してワークフローAPIを実行させる

Moveworks Studio 内で:

  1. ユーザーの質問をトリガーにしたボットフローを作成します。 例えば: ノートパソコンについてのヘルプが必要です。

  2. HTTPアクションを追加します:

    • メソッド: POST

    • URL: https://api.<your-tenant>.nexthink.cloud/platform/v1/workflows/execute

    • ヘッダー: Content-Type: application/json、 plus OAuth2クレデンシャルを使用してNexthinkからの認証

  3. APIレスポンスを保存します。これには次のものが含まれます。

    • workflowUuid

    • executionUuid

  4. workflowUuid および executionUuid のための2つのスロットを作成する:

    • 以前のAPIレスポンスを解析し、それらのスロットに値を割り当てます。

    • これらの値は後で同じワークフローインスタンスを再開するために使用されます。

ステップ3 - MoveworksチャットボットをサポートするためのNexthinkワークフローを作成する

Nexthink ワークフローデザイナーで:

  1. 新しいワークフローを作成します。

  2. サービス/API シンクレットを追加して、ユーザーのデバイスをクエリします。

  3. 待機 フローコントロールを挿入し、その タイプ を API リスナー に設定します。

    • 待機 フローコントロールが正しく設定されていることを確認してください。入力構造がチャットボットの送信内容に一致する必要があります。 Moveworks からの期待されるペイロードの例:

      jsonCopyEdit{
  "input": {
    "selectedDevice": "Laptop-2345"
  }
}

この呼び出しを受信すると、ワークフローは再開され、入力はパラメータとして利用可能になります。

204 No Contentレスポンスは成功を示します。

  1. タイムアウト（例: 60 分）と selectedDevice のような出力パラメータを定義します。

  2. ワークフロー内で selectedDevice パラメータを評価するための条件 フロー制御を追加します。

  3. 入力に基づいて、次のような自動化アクションを定義します:

    • 問題を修正するための リモートアクション シンクレットを使用します。

    • 問題解決を確認するために メッセージ や キャンペーン を送信します。

    • 関数 シンクレットを使用して、入力を解析、検証、または変換します。

    これらはユーザーの選択に基づいた機能的かつ実行可能なステップです。

ステップ4 - Moveworks-ワークフロー統合を確認する

Nexthink のターゲットワークフロー概要ダッシュボードから、タイムライン実行履歴を開いて以下を確認します。

  • ワークフローがトリガーされ、一時停止されました。

  • 入力後に待機ブロックが再開されました。

  • パラメータが正しく埋め込まれました。

Moveworks で:

  • HTTPコールログを確認します:

    • /inject が正常に呼び出されましたか?

    • 認証トークンは有効ですか？

    • workflowUuid および executionUuid がスロットに埋め込まれましたか？

トラブルシューティングワークフロー を参照して、タイムライン実行履歴を確認および解釈してください。

関連リソース

Last updated

Was this helpful?