在您使用适当的 MCP（模型上下文协议）服务器端点和有效的用户凭据配置 MCP 客户端后，您将解锁一套 MCP 工具。第三方坐席（如 Microsoft Copilot）可通过此工具直接与 Automation Anywhere 的自动化存储库和运行时进行交互。

这些工具使第三方 AI 坐席能够通过安全的坐席连接，发现、运行 Automation Anywhere 自动化，并从中检索结果。

工具 基础许可证 企业许可证（已启用 PRE）
发现自动化 不可用 可用
运行自动化 不可用 可用
获取自动化结果 可用 可用
注：

DiscoverAutomation 和 RunAutomation 工具需要已启用过程推理引擎（PRE）集成的企业版许可证。 PRE 集成目前仅支持美国地区和欧洲地区。

发现自动化

DiscoverAutomation 工具用于发现自动化存储库中，具有运行/调度权限之用户可访问的自动化。 该工具使 AI 坐席能够根据用户意图动态确定要运行的自动化。

运作方式：

  • 该工具会评估用户的请求。
  • 它会搜索自动化，并仅返回用户有权限访问的自动化。 在匹配的自动化列表中：
    • 如果可用的自动化数量不超过九个，则全部显示。
    • 如果可用的自动化超过九个，则只返回前九个自动化。
    • 这前九个自动化排名是根据内部相关性和排名标准确定的。 如果某个自动化未达到排名标准，则可能不会出现在默认结果中。
要检索默认列表中未显示的特定自动化，请使用工具的专用查询格式：
Discover automations to <specific task>
例如：
Discover automations to create invoice in SAP
Discover automations to extract data from Salesforce

使用基于特定任务的查询，不仅能提高匹配精度，还能让目标自动化程序更准确地出现在结果中。

最佳实践：

  • 为自动化提供描述性摘要。
  • 建议在单个坐席范围内，尽量限制不必要的自动化程序。

运行自动化

RunAutomation 工具用于执行通过 DiscoverAutomation 识别或由坐席明确指定的自动化。

它可以运行：
  • 机器人（自动化）
  • 流程
  • API 任务

执行任务由第三方 AI 坐席通过 MCP 服务器发起。

运作方式：

  1. 自动化已识别。
  2. 必需的输入参数已传递。
  3. MCP 服务器验证权限。
  4. Control Room 安排并运行自动化。
  5. 返回作业 ID 或执行引用。 需要此引用才能使用 GetAutomationResult 检索执行状态或结果。

自动化在已配置的运行时环境中运行，并强制执行基于角色的访问控制（RBAC）策略。 输入变量必须与自动化的预期参数相匹配。 所有执行事件都会记录在 Control Room 审核日志中。

最佳实践：

  • 输入参数不正确或缺失可能导致自动化失败。
  • 自动化必须作为坐席连接发布并启用。
  • 用户必须拥有运行自动化的权限。
  • 网络和凭据配置必须有效。

如果执行失败，请使用 GetAutomationResult 获取错误详情。

获取自动化结果

GetAutomationResult 工具用于检索使用 RunAutomation 启动的自动化的状态或输出结果。

该工具可与以下任一项配合使用：
  • 基础许可证
  • 启用 PRE 的企业许可证（美国和欧洲地区）

运作方式：

  • 该工具接受作业 ID 或执行引用。
  • 它向 Control Room 查询当前的执行状态，可能包括以下状态响应：
    • 运行中/进行中： 自动化当前正在执行。
      注： 如果状态为“运行中/进行中”，可以稍后再次调用该工具以获取更新的状态或最终结果。
    • 已完成： 自动化已成功完成。 当状态为“已完成”时，该工具会返回在自动化中定义的所有已配置输出变量。 输出可能包括：
      • 文本值
      • JSON 对象
      • 已处理的事务结果
      • 其他已定义的返回参数
    • 失败： 自动化执行失败。 如果状态为“失败”，响应将包含相关的错误详情和日志，以协助排查问题。

安全、治理与工具交互

所有 MCP 工具操作均：

  • 强制执行 Control Room 认证
  • 遵循 RBAC 权限
  • 维护审核日志记录
  • 遵守自动化级别的访问控制

只有授权用户才能发现、运行自动化，或从中获取结果。

典型的工具交互流程遵循以下顺序：

  1. 发现自动化
  2. 运行自动化
  3. 获取自动化结果
此流程允许 AI 坐席：
  • 识别正确的自动化
  • 安全执行该自动化
  • 获取最终结果

MCP 工具故障排除

自动化未显示在 DiscoverAutomation 中
  • 确认用户权限。
  • 确保自动化已发布。
  • 使用更具体的工具查询。
  • 检查自动化数量是否超过 9 个（上限为 9 个）。
自动化已运行，但未返回输出结果
  • 验证输出变量是否正确配置。
  • 确保输出变量已正确映射。
  • 确认已使用正确的作业 ID 调用 GetAutomationResult。
RunAutomation 失败
  • 验证输入参数的名称和类型。
  • 确认运行时环境的可用性。
  • 查看 Control Room 审核日志。
  • 检查 PRE 集成状态（仅限企业许可证）。