適切な MCP（Model Context Protocol）サーバーエンドポイントと有効なユーザー認証情報で MCP クライアントを構成すると、サードパーティのエージェント（Microsoft Copilotなど）が Automation Anywhere のオートメーションリポジトリおよびランタイムと直接連携できる一連の MCP ツールが利用可能になります。

これらのツールにより、サードパーティのAIエージェントは、安全なエージェント接続を通じてAutomation Anywhereの自動化を検出、実行、および結果の取得が可能になります。

ツール ベースライセンス エンタープライズライセンス（PRE 有効）
DiscoverAutomation 提供なし 利用可能
RunAutomation 提供なし 利用可能
GetAutomationResult 利用可能 利用可能
注:

DiscoverAutomation および RunAutomation ツールを使用するには、Process Reasoning Engine（PRE）統合が有効になっているエンタープライズライセンスが必要です。 PRE 統合は現在、米国およびヨーロッパ地域でのみサポートされています。

DiscoverAutomation

DiscoverAutomation ツールは、オートメーションリポジトリ内でそのユーザーが 実行/スケジュール 権限を持つオートメーションを検出します。 このツールは、AI エージェントがユーザーの意図に基づいて実行する自動化を動的に判断できるようにします。

仕組み：

  • ツールはユーザーのリクエストを評価します。
  • 自動化を検索し、ユーザーがアクセス権を持つ自動化のみを返します。 一致するオートメーションのリストから：
    • 利用可能な自動化が9件以下の場合、すべてが表示されます。
    • 利用可能な自動化が9件を超える場合、上位9件の自動化のみが返されます。
    • 上位9件は、内部の関連性およびランキング基準に基づいて決定されます。 オートメーションがランキング基準を満たしていない場合、デフォルトの結果に表示されないことがあります。
デフォルトリストに表示されていない特定のオートメーションを取得するには、ツール固有のクエリ形式を使用してください。
Discover automations to <specific task>
次に例を示します。
Discover automations to create invoice in SAP
Discover automations to extract data from Salesforce

特定のタスクに基づいたクエリを使用することで、マッチングの精度が向上し、目的の自動化が結果に表示される可能性が高まります。

ベスト プラクティス：

  • 自動化のための説明的な要約を提供してください。
  • 可能な限り、単一エージェントのスコープ内で不要な自動化を制限してください。

RunAutomation

RunAutomation ツールは、DiscoverAutomation を通じて特定された、またはエージェントによって明示的に指定された自動化を実行します。

以下を実行できます：
  • Bot（オートメーション）
  • プロセス
  • API タスク

実行は、サードパーティの AI エージェントから MCP サーバーを介して開始されます。

仕組み：

  1. オートメーションが識別されます。
  2. 必要な入力パラメータが渡されます。
  3. MCP サーバーは権限を検証します。
  4. Control Room はオートメーションをスケジュールし、実行します。
  5. ジョブ ID または実行リファレンスが返されます。 この参照は、GetAutomationResult を使用して実行状況や結果を取得するために必要です。

自動化は設定されたランタイム環境で実行され、ロールベースのアクセス制御（RBAC）ポリシーが適用されます。 入力変数はオートメーションの想定されるパラメーターと一致している必要があります。 すべての実行イベントは、Control Room の監査ログに記録されます。

ベスト プラクティス：

  • 不正確または不足している入力パラメータがあると、自動化が失敗する可能性があります。
  • オートメーションは、エージェント接続として公開および有効化されている必要があります。
  • ユーザーにはオートメーションを実行する権限が必要です。
  • ネットワークおよび認証情報の設定が有効である必要があります。

実行に失敗した場合は、GetAutomationResult を使用してエラーの詳細を取得してください。

GetAutomationResult

GetAutomationResult ツールは、RunAutomation を使用して開始されたオートメーションのステータスまたは出力を取得します。

このツールは、次のいずれかで使用できます：
  • ベースライセンス
  • PRE が有効化されたエンタープライズライセンス（米国および欧州）

仕組み：

  • このツールはジョブ ID または実行リファレンスを受け付けます。
  • 現在の実行状況を確認するために Control Room に問い合わせを行い、以下のようなステータス応答が含まれます。
    • 実行中/進行中： オートメーションは現在実行中です。
      注: ステータスが「実行中」または「進行中」の場合、後で再度ツールを呼び出して、更新されたステータスや最終結果を取得できます。
    • 完了: オートメーションが正常に完了しました。 ステータスが「完了」になると、ツールはオートメーションで定義されたすべての設定済み出力変数を返します。 出力には以下が含まれる場合があります：
      • テキスト値
      • JSON オブジェクト
      • 処理済みトランザクション結果
      • その他の定義済み返却パラメータ
    • 失敗： オートメーションの実行に失敗しました。 ステータスが「失敗」の場合、レスポンスにはトラブルシューティングのための関連するエラー詳細およびログが含まれます。

セキュリティ、ガバナンス、ツールの連携

すべての MCP ツール操作：

  • Control Room 認証を強制する
  • RBAC 権限に従う
  • 監査ログを維持する
  • オートメーションレベルのアクセス制御を遵守する

認可されたユーザーのみが、オートメーションの結果を検出、実行、または取得できます。

一般的なツールのインタラクションフローは、次の順序で進行します。

  1. DiscoverAutomation
  2. RunAutomation
  3. GetAutomationResult
このフローにより、AI エージェントは次のことが可能になります。
  • 正しいオートマトンを特定する
  • 安全に実行してください
  • 最終結果を取得

MCP ツールのトラブルシューティング

オートメーションは DiscoverAutomation に表示されません
  • ユーザーの権限を確認します。
  • オートメーションが公開されていることを確認してください。
  • より具体的なツールクエリを使用してください。
  • 9個を超える自動化が存在するかどうかを確認します（上位9件の制限）。
自動化は実行されますが、出力は返されません
  • 出力変数が正しく構成されていることを確認してください。
  • 出力変数が正しくマッピングされていることを確認してください。
  • GetAutomationResult が正しいジョブ ID で呼び出されていることを確認してください。
RunAutomation に失敗しました
  • 入力パラメーターの名前と型を検証します。
  • ランタイム環境の利用可能性を確認してください。
  • Control Room の監査ログを確認します。
  • PRE 統合ステータスを確認します（エンタープライズライセンスのみ）。