# ユースケース: Nexthinkワークフローを利用したMoveworksサービス自動化

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

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

* 従業員にデバイスの問題に関連する基本的なトラブルシューティングを提供する。
* 従業員デバイスに関するNexthinkデータを活用して基本的なデバイス情報を取得する。
* ディスクの問題を修正するための修復を起動する。

## 開始前に

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

* ワークフロー実行エンドポイントへのアクセス:
  * `POST /v1/workflows/execute`
  * `POST /v1/workflows/execution/{executionUuid}/injec`
* Moveworks の HTTP 呼び出しで使用する [Nexthink API 資格情報](/platform/ja/solutions/chatbots/integrating-chatbots-with-nexthink-workflows.md#configuring-nexthink-workflows-to-support-chatbot-integrations) (OAuth2 クライアントIDとシークレット)。
* この場合、Moveworks Studio への管理者アクセス。

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

チャットボットワークフローのインタラクションのための標準化された手順を設計し、各ステップのワークフロー機能を定義します。

NexthinkワークフローAPIフローを使用したチャットボットの流れを理解するには、[Nexthinkワークフローとチャットボットの統合](/platform/ja/solutions/chatbots/integrating-chatbots-with-nexthink-workflows.md) のドキュメントを参照してください。

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

<figure><img src="/files/LntFuxm14qPd8iJTzHtp" alt=""><figcaption></figcaption></figure>

| インタラクションステージ                  | ワークフローAPI＆機能                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1. 通信を認証する                    | ワークフローAPI資格情報: Nexthink プラットフォームを通じたトークン収集。                                                                                                                               |
| 2. Moveworks がワークフロー実行をトリガーする | Moveworksのチャットボット内の会話がワークフローAPI（`/executions`エンドポイント）を呼び出す。                                                                                                               |
| 3. 入力に基づいたワークフローの一時停止/再開ロジック  | <p>Moveworks は <code>/inject</code> API エンドポイントを使用して、ユーザー/デバイスのコンテキストを Nexthink に入力変数として提供します。</p><p>ワークフローは<strong>API リスナー</strong>を使用して、会話中のチャットボット/ユーザーの入力を待機します。</p> |
| 5. ワークフローが問題修復を指揮する           | ワークフローは、ブランチング、コネクタ、サービスAPIシンクレットを処理し、ユーザーの選択に基づいてリモートアクション、キャンペーン、通知、さらなるロジックをトリガーします。                                                                                   |
| 6. ワークフローがチャットボットに結果を返す       | <p>ワークフローは<strong>サービス API</strong> チンクレットを使用して是正結果/ステータスを出力します。</p><p>Moveworks チャットボットが従業員に確認を送信します。</p>                                                                |

***

## ステップ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. \u002F \u003C p \u003E`workflowUuid` と `executionUuid` のために2つのスロットを作成します: \u003C \u002Fp \u003E
   * 以前のAPIレスポンスを解析し、それらのスロットに値を割り当てます。
   * これらの値は後で同じワークフローインスタンスを再開するために使用されます。

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

Nexthink ワークフロー[デザイナー](/platform/ja/user-guide/workflows/creating-workflows.md)で:

1. 新しいワークフローを作成します。
2. **サービス/API** シンクレットを追加して、ユーザーのデバイスをクエリします。
3. **待機** フローコントロールを挿入し、その **タイプ** を **API リスナー** に設定します。
   * **待機** フローコントロールが正しく設定されていることを確認してください。入力構造がチャットボットの送信内容に一致する必要があります。 Moveworks からの期待されるペイロードの例:

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

{% hint style="info" %}
このコールが受信されると、ワークフローは再開し、入力はパラメータとして利用可能になります。

`204 No Content`レスポンスは成功を示します。
{% endhint %}

4. タイムアウト（例: 60 分）と `selectedDevice` のような出力パラメータを定義します。
5. ワークフローで `selectedDevice` パラメータを評価するために **条件** フロー制御を追加します。
6. 入力に基づいて、次のような自動化アクションを定義します:

   * 問題を修正するための **リモートアクション** シンクレットを使用します。
   * 問題解決を確認するために **メッセージ** や **キャンペーン** を送信します。
   * **関数** シンクレットを使用して、入力を解析、検証、または変換します。

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

***

## ステップ4 – Moveworks-ワークフローのインテグレーションを検証

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

* ワークフローがトリガーされ、一時停止されました。
* 入力後に**待機**ブロックが再開されました。
* パラメータが正しく埋め込まれました。

Moveworks で:

* HTTPコールログを確認します:
  * `/inject` が正常に呼び出されましたか?
  * 認証トークンは有効ですか？
  * `workflowUuid` および `executionUuid` がスロットに埋め込まれましたか？

{% hint style="info" %}
[トラブルシューティングワークフロー](/platform/ja/user-guide/workflows/monitoring-workflows-dashboard/troubleshooting-workflows.md#troubleshootingworkflows-usingtheworkflowtimeline) を参照して、タイムライン実行履歴を確認および解釈してください。
{% endhint %}

***

### 関連リソース

* [Nexthinkワークフローとチャットボットの統合](/platform/ja/solutions/chatbots/integrating-chatbots-with-nexthink-workflows.md)
* [ワークフローの作成](/platform/ja/user-guide/workflows/creating-workflows.md#optionally-make-the-workflow-available-in-nexthink-spark)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/ja/solutions/chatbots/integrating-chatbots-with-nexthink-workflows/use-case-moveworks-service-automation-with-nexthink-workflows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.