Después de configurar el cliente del MCP (protocolo de contexto de modelo) con el endpoint adecuado del servidor MCP y credenciales de usuario válidas, desbloquea un conjunto de herramientas MCP que permiten que un agente de terceros (como Microsoft Copilot) interactúe directamente con el repositorio de automatización y el tiempo de ejecución de Automation Anywhere.

Estas herramientas permiten que agentes de IA de terceros descubran, ejecuten y obtengan resultados de automatizaciones de Automation Anywhere a través de conexiones seguras de agente.

Herramienta Licencia básica Licencia empresarial (PRE habilitado)
DiscoverAutomation No disponible Disponible
RunAutomation No disponible Disponible
GetAutomationResult Disponible Disponible
Nota:

Las herramientas DiscoverAutomation y RunAutomation requieren una licencia Enterprise con la integración del motor de razonamiento de procesos (PRE) habilitada. La integración PRE actualmente solo es compatible en las regiones de EE. UU. y Europa.

DiscoverAutomation

La herramienta DiscoverAutomation detecta las automatizaciones a las que ese usuario tiene acceso con el permiso Ejecutar/programar en el repositorio de automatizaciones. Esta herramienta permite a los agentes de IA determinar dinámicamente qué automatización ejecutar según la intención del usuario.

Cómo funciona:

  • La herramienta evalúa la solicitud del usuario.
  • Busca las automatizaciones y devuelve solo aquellas a las que el usuario está autorizado a acceder. De la lista de automatizaciones coincidentes:
    • Si hay nueve o menos automatizaciones disponibles, se muestran todas.
    • Si hay más de nueve automatizaciones disponibles, solo se devuelven las nueve automatizaciones principales.
    • Las nueve principales se determinan mediante criterios internos de relevancia y clasificación. Si una automatización no cumple con los criterios de clasificación, es posible que no aparezca en los resultados predeterminados.
Para recuperar automatizaciones específicas que no se muestran en la lista predeterminada, utilice un formato de consulta específico de la herramienta:
Discover automations to <specific task>
Por ejemplo:
Discover automations to create invoice in SAP
Discover automations to extract data from Salesforce

El uso de consultas específicas basadas en tareas mejora la precisión de coincidencia y aumenta la probabilidad de que la automatización deseada aparezca en los resultados.

Prácticas recomendadas:

  • Proporcionar resúmenes descriptivos para las automatizaciones.
  • Limitar las automatizaciones innecesarias dentro del alcance de un solo agente cuando sea posible.

RunAutomation

La herramienta RunAutomation ejecuta una automatización que ha sido identificada a través de DiscoverAutomation o especificada explícitamente por el agente.

Puede ejecutar lo siguiente:
  • Bots (automatizaciones)
  • Procesos
  • Tareas API

La ejecución se inicia desde un agente de IA de terceros a través del servidor MCP.

Cómo funciona:

  1. Se identifica la automatización.
  2. Se pasan los parámetros de entrada requeridos.
  3. El servidor MCP valida los permisos.
  4. La Control Room programa y ejecuta la automatización.
  5. Se devuelve un ID de trabajo o una referencia de ejecución. Esta referencia es necesaria para recuperar el estado de ejecución o los resultados mediante GetAutomationResult.

La automatización se ejecuta en el tiempo de ejecución configurado y se aplican las políticas de control de acceso basado en roles (RBAC). Las variables de entrada deben coincidir con los parámetros esperados por la automatización. Todos los eventos de ejecución se registran en los registros de auditoría de la Control Room.

Prácticas recomendadas:

  • Los parámetros de entrada incorrectos o faltantes pueden causar fallas en la automatización.
  • La automatización debe publicarse y habilitarse como una conexión de agente.
  • El usuario debe tener permiso para ejecutar la automatización.
  • La configuración de red y credenciales debe ser válida.

Si la ejecución falla, use GetAutomationResult para obtener los detalles del error.

GetAutomationResult

La herramienta GetAutomationResult recupera el estado o el resultado de una automatización que se inició mediante RunAutomation.

Esta herramienta se puede usar con cualquiera de las siguientes opciones:
  • Una licencia básica
  • Una licencia Enterprise con PRE habilitado (regiones de EE. UU. y Europa)

Cómo funciona:

  • La herramienta acepta un ID de trabajo o una referencia de ejecución.
  • Consulta a la Control Room el estado actual de ejecución, que incluye las siguientes posibles respuestas de estado:
    • En ejecución/en progreso: La automatización se está ejecutando actualmente.
      Nota: Si el estado es En ejecución/en progreso, la herramienta se puede volver a llamar más tarde para obtener el estado actualizado o el resultado final.
    • Completado: La automatización finalizó con éxito. Cuando el estado es Completado, la herramienta devuelve cualquier variable de salida configurada que esté definida en la automatización. La salida puede incluir lo siguiente:
      • Valores de texto.
      • Objetos JSON.
      • Resultados de transacciones procesadas.
      • Otros parámetros de retorno definidos.
    • Error: Error en la ejecución de la automatización. Si el estado es Error, la respuesta incluye detalles de error relevantes y registros para ayudar con la solución de problemas.

Seguridad, gobernanza e interacciones con herramientas.

Todas las operaciones de la herramienta MCP:

  • Aplicar autenticación de la Control Room
  • Seguir los permisos RBAC
  • Mantener el registro de auditoría
  • Respetar los controles de acceso a nivel de automatización

Solo los usuarios autorizados pueden descubrir, ejecutar o recuperar resultados de automatización.

Un flujo típico de interacción con la herramienta sigue esta secuencia:

  1. DiscoverAutomation
  2. RunAutomation
  3. GetAutomationResult
Este flujo permite que el agente de IA haga lo siguiente:
  • Identifique el autómata correcto
  • Lo ejecute de forma segura
  • Recupere el resultado final

Solución de problemas de las herramientas MCP

Las automatizaciones no aparecen en DiscoverAutomation
  • Confirme los permisos de usuario.
  • Asegúrese de que la automatización esté publicada.
  • Use una consulta de herramienta más específica.
  • Verifique si existen más de nueve automatizaciones (límite de las nueve principales).
La automatización se ejecuta, pero no se devuelve ningún resultado
  • Verifique que las variables de salida estén configuradas correctamente.
  • Asegúrese de que las variables de salida estén asignadas correctamente.
  • Confirme que GetAutomationResult se llame con el ID de trabajo correcto.
RunAutomation falla
  • Valide los nombres y tipos de los parámetros de entrada.
  • Confirme la disponibilidad del tiempo de ejecución.
  • Revise los registros de auditoría de la Control Room.
  • Verifique el estado de integración de PRE (solo con licencia Enterprise).