Depois de configurar seu cliente MCP (Protocolo de Contexto de Modelo) com o endpoint apropriado do servidor MCP e credenciais de usuário válidas, você desbloqueia um conjunto de ferramentas MCP que permite que um agente de terceiros (como o Microsoft Copilot) interaja diretamente com o repositório de automação e o tempo de execução da Automation Anywhere.

Essas ferramentas permitem que agentes de IA de terceiros descubram, executem e recuperem resultados de automações da Automation Anywhere por meio de conexões seguras de agente.

Ferramenta Licença base Licença Enterprise (PRE ativado)
DiscoverAutomation Não disponível Disponível
RunAutomation Não disponível Disponível
GetAutomationResult Disponível Disponível
Nota:

As ferramentas DiscoverAutomation e RunAutomation requerem uma licença Enterprise com integração do Mecanismo de Raciocínio de Processos (PRE) ativada. A integração de PRE é atualmente compatível apenas com as regiões dos EUA e Europa.

DiscoverAutomation

A ferramenta DiscoverAutomation descobre automações que estão acessíveis para esse usuário com a permissão Executar/Agendar no repositório de automação. Essa ferramenta permite que agentes de IA determinem dinamicamente qual automação executar com base na intenção do usuário.

Como funciona:

  • a ferramenta avalia a solicitação do usuário.
  • Ela pesquisa as automações e retorna apenas aquelas às quais o usuário está autorizado a acessar. Da lista de automações correspondentes:
    • se nove ou menos automações estiverem disponíveis, todas serão exibidas.
    • Se mais de nove automações estiverem disponíveis, apenas as nove principais automações serão retornadas.
    • As nove principais são determinadas usando critérios internos de relevância e classificação. Se uma automação não atender aos critérios de classificação, é possível que ela não apareça nos resultados padrão.
Para recuperar automações específicas que não aparecem na lista padrão, utilize um formato de consulta específico da ferramenta:
Discover automations to <specific task>
Por exemplo:
Discover automations to create invoice in SAP
Discover automations to extract data from Salesforce

o uso de consultas específicas baseadas em tarefas melhora a precisão da correspondência e aumenta a probabilidade de que a automação desejada apareça nos resultados.

Práticas recomendadas:

  • forneça resumos descritivos para as automações.
  • Limite automações desnecessárias no escopo de um único agente sempre que possível.

RunAutomation

A ferramenta RunAutomation executa uma automação que foi identificada por meio do DiscoverAutomation ou explicitamente especificada pelo agente.

Ela pode executar:
  • Bots (automações)
  • Processos
  • Tarefas de API

A execução é iniciada a partir de um agente de IA de terceiros por meio do servidor MCP.

Como funciona:

  1. a automação é identificada.
  2. Os parâmetros de entrada obrigatórios são enviados.
  3. O servidor MCP valida permissões.
  4. A Control Room agenda e executa a automação.
  5. Um ID de trabalho ou referência de execução é retornado. Essa referência é necessária para recuperar o status de execução ou os resultados usando GetAutomationResult.

A automação é executada no ambiente de tempo de execução configurado e as políticas de controle de acesso baseado em função (RBAC) são aplicadas. As variáveis de entrada devem corresponder aos parâmetros esperados pela automação. Todos os eventos de execução são registrados nos logs de auditoria da Control Room.

Práticas recomendadas:

  • parâmetros de entrada incorretos ou ausentes podem causar falha na automação.
  • A automação deve ser publicada e habilitada como uma conexão de agente.
  • O usuário deve ter permissão para executar a automação.
  • A configuração de rede e credenciais deve ser válida.

Se a execução falhar, use GetAutomationResult para obter detalhes do erro.

GetAutomationResult

A ferramenta GetAutomationResult recupera o status ou o resultado de uma automação que foi iniciada usando RunAutomation.

Essa ferramenta pode ser usada com:
  • uma licença base
  • Uma licença Enterprise com PRE ativado (regiões dos EUA e Europa)

Como funciona:

  • a ferramenta aceita um ID de trabalho ou referência de execução.
  • Ela consulta a Control Room para obter o status atual de execução, que inclui as seguintes possíveis respostas de status:
    • Em execução/Em andamento: a automação está sendo executada no momento.
      Nota: Se o status for Em execução/Em andamento, a ferramenta pode ser chamada novamente mais tarde para recuperar o status atualizado ou o resultado final.
    • Concluído: a automação foi concluída com êxito. Quando o status for Concluído, a ferramenta retorna quaisquer variáveis de saída configuradas definidas na automação. A saída pode incluir:
      • Valores de texto
      • Objetos JSON
      • Resultados das transações processadas
      • Outros parâmetros de retorno definidos
    • Falha: A execução da automação falhou. Se o status for Falha, a resposta incluirá detalhes relevantes do erro e logs para auxiliar na solução de problemas.

Segurança, governança e interações com ferramentas

Todas as operações da ferramenta MCP:

  • Aplicar autenticação da Control Room
  • Seguir as permissões RBAC
  • Manter o registro de auditoria
  • Respeitar os controles de acesso em nível de automação

Apenas usuários autorizados podem descobrir, executar ou recuperar resultados de automação.

Um fluxo típico de interação com a ferramenta segue esta sequência:

  1. DiscoverAutomation
  2. RunAutomation
  3. GetAutomationResult
Esse fluxo permite que o agente de IA:
  • identifique a automação correta
  • Execute-a com segurança
  • Recupere o resultado final

Solução de problemas das ferramentas MCP

As automações não aparecem no DiscoverAutomation
  • Confirme as permissões do usuário.
  • Garanta que a automação seja publicada.
  • Use uma consulta de ferramenta mais específica.
  • Verifique se existem mais de nove automações (limite de nove principais).
A automação é executada, mas nenhum resultado é retornado
  • Verifique se as variáveis de saída estão configuradas corretamente.
  • Garanta que as variáveis de saída estejam mapeadas corretamente.
  • Confirme que GetAutomationResult é chamado com o ID de trabalho correto.
Falha no RunAutomation
  • Valide nomes e tipos de parâmetros de entrada.
  • Confirme a disponibilidade do ambiente de execução.
  • Revise os logs de auditoria da Control Room.
  • Verifique o status da integração de PRE (somente para licença Enterprise).