> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automation Anywhere ツールキット

> ワークフロー内からAutomation Anywhereのボットをデプロイおよび管理します。

**Automation Anywhere ツールキット**により、ワークフローからAutomation AnywhereのAPA Control Roomと連携できます。ボットのデプロイ、ステータスの監視、出力の取得、利用可能なボットの一覧取得、および実行中のボットのキャンセルが可能です。

## 認証

すべてのAutomation Anywhereツールには、Control Roomへの接続が必要です。各ツールには**接続**セレクターがあります。接続が設定されていない場合は、**接続を追加**をクリックして作成してください。

接続を作成する際は、以下の情報を提供してください：

| フィールド                | 必須 | 説明                                                                                           |
| -------------------- | -- | -------------------------------------------------------------------------------------------- |
| **接続名**              | はい | この接続を識別するラベルです（例：`control-room-connection`）。                                                 |
| **Control Room URL** | はい | Automation Anywhere Control RoomのURLです（例：`https://your-company.automationanywhere.digital`）。 |
| **ユーザー名**            | はい | Automation Anywhereのユーザー名です。                                                                 |
| **認証バージョン**          | はい | APIキーを使用する場合は`V2認証`、パスワードを使用する場合は`V1認証`を選択してください。                                            |
| **資格情報**             | はい | APIキー（V2用）またはパスワード（V1用）です。`@`と入力してvaultシークレットを参照できます。                                        |

## ツール

### ボットのデプロイ

接続されたControl RoomからAutomation Anywhereボットをデプロイします。

| フィールド           | 必須  | 説明                                                                                                                                                                                                                      |
| --------------- | --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **接続**          | はい  | 設定済みのControl Room接続を選択してください。                                                                                                                                                                                           |
| **ボットID**       | はい  | デプロイするボットのIDです。`@`と入力して変数を選択できます。                                                                                                                                                                                       |
| **オートメーション名**   | いいえ | オートメーションの名前です。デフォルトは`null`です。                                                                                                                                                                                           |
| **オートメーションの説明** | いいえ | デプロイされるオートメーションの説明です。デフォルトは`null`です。                                                                                                                                                                                    |
| **ボット入力**       | いいえ | ボットへの入力の配列です。**アイテムを追加**をクリックしてエントリを追加するか、**JSONモード**を有効にしてデータを貼り付けるか`@`変数を使用してください。デフォルトは`null`です。                                                                                                                     |
| **デプロイタイプ**     | いいえ | デプロイリクエストのタイプです。オプション：`Attended Request`、`Unattended Request`、`Headless Request`。デフォルトは`Unattended Request`です。                                                                                                          |
| **実行ユーザーID**    | いいえ | ボットを実行するユーザーのIDの配列です。ボットは提供されたリストの1つのデバイスでデプロイされます。各アイテムで`@`と入力して変数を参照できます。デフォルトは`null`です。                                                                                                                              |
| **プールID**       | いいえ | 使用する実行ユーザー数を指定するプールIDの配列です。各アイテムで`@`と入力して変数を参照できます。デフォルトは`null`です。                                                                                                                                                      |
| **実行ユーザー数**     | いいえ | `実行ユーザーID`リストから使用する実行ユーザーの数です。指定しない場合、リストの利用可能なすべてのデバイスでデプロイされます。デフォルトは`0`です。                                                                                                                                           |
| **子ウィンドウで起動**   | いいえ | デプロイデバイスの選択方法を指定します。オプション：`RUN_ONLY_ON_DEFAULT_DEVICE`（デフォルトデバイスのみを使用）、`PREFER_DEFAULT_DEVICE`（デフォルトデバイスを優先し、利用不可の場合プール内の別のデバイスを使用）、`RUN_ON_POOL_DEVICES`（プール内の利用可能な任意のデバイスでデプロイ）。デフォルトは`RUN_ONLY_ON_DEFAULT_DEVICE`です。 |
| **失敗時に続行**      | いいえ | `true`に設定すると、失敗した場合にこのステップをスキップし、ワークフローを通常通り続行します。デフォルトは`false`です。                                                                                                                                                      |
| **失敗時にリトライ**    | いいえ | `true`に設定すると、ステップが失敗した場合に最大4回まで自動的にリトライします。デフォルトは`false`です。                                                                                                                                                             |

### ボットステータスの取得

デプロイされたボットの現在の実行ステータスを取得します。

| フィールド         | 必須  | 説明                                                 |
| ------------- | --- | -------------------------------------------------- |
| **接続**        | はい  | 設定済みのControl Room接続を選択してください。                      |
| **デプロイID**    | はい  | ステータスを確認するデプロイIDです。`@`と入力して変数を選択できます。              |
| **完了までポーリング** | いいえ | 有効にすると、すぐに返信する代わりに、ボットが完了または失敗するまでステータスを継続的に確認します。 |

### ボット出力の取得

完了したボットデプロイから返された出力を取得します。

| フィールド      | 必須 | 説明                                 |
| ---------- | -- | ---------------------------------- |
| **接続**     | はい | 設定済みのControl Room接続を選択してください。      |
| **デプロイID** | はい | 出力を取得するデプロイIDです。`@`と入力して変数を選択できます。 |

### ボット一覧の取得

接続されたControl Roomで利用可能なボットのリストを取得します。

| フィールド      | 必須  | 説明                              |
| ---------- | --- | ------------------------------- |
| **接続**     | はい  | 設定済みのControl Room接続を選択してください。   |
| **フィルター名** | いいえ | 名前でボットをフィルターします。デフォルトは`null`です。 |
| **制限数**    | いいえ | 返すボットの最大数です。デフォルトは`50`です。       |

### ボット実行のキャンセル

接続されたControl Roomで実行中のボットデプロイをキャンセルします。

| フィールド      | 必須 | 説明                                       |
| ---------- | -- | ---------------------------------------- |
| **接続**     | はい | 設定済みのControl Room接続を選択してください。            |
| **デプロイID** | はい | キャンセルするボット実行のデプロイIDです。`@`と入力して変数を選択できます。 |
