Configuração de um Agente do Robôs local

A configuração padrão do Agente do Robôs é definida durante a instalação. Antes de usar o Agente do Robôs, revise as definições de configuração e certifique-se de que sejam adequadas para sua organização. Em particular, certifique-se de que os Carregamentos de arquivos permitidos estão definidos de forma adequada.

Observação

As informações neste tópico se aplicam apenas a organizações que usam um Agente do Robôs local para executar scripts ACL em robôs ACL.

Indivíduos e organizações com o ACL Robotics Professional Edition não têm um Agente do Robôs local. Os scripts Python/HCL executados em robôs HighBond e de fluxo de trabalho não usam o Agente do Robôs.

Onde especificar as definições de configuração

Você especifica as definições de configuração do Agente do Robôs em dois locais:

  • na tela Gerenciamento de agente no Robôs
  • no arquivo Agent.exe.config no diretório de instalação do Agente do Robôs no servidor do Windows

Observação

As definições de configuração na tela Gerenciamento de agente têm precedência sobre as configurações no arquivo Agent.exe.config.

Definir configurações na tela Gerenciamento de agente

Observação

As definições de configuração na tela de Gerenciamento de agente se aplicam a todos os agentes em um cluster de vários agentes.

  1. Na página inicial do Launchpad (www.highbond.com), selecione o aplicativo Robôs para abri-lo.

    Se já tiver entrado na Diligent One, você pode usar o menu de navegação à esquerda para mudar para o aplicativo Robôs.

  2. Clique em Configurações no canto superior direito do painel.
  3. No painel esquerdo, certifique-se de que Gerenciamento de agente está selecionado.
  4. Em Configuração, selecione a opção apropriada para Carregamentos de arquivos permitidos.

    A opção Carregamentos de arquivos permitidos controla quais resultados de saída são enviados do Agente do Robôs para o aplicativo Robôs na nuvem:

    • Somente arquivos de resultados e logs

      Se especificado em um cabeçalho de análise, os arquivos de resultados (como o Excel) e os logs são carregados. Você também pode carregar manualmente os arquivos relacionados para a guia Entrada/Saída do Robôs.

    • Tabelas, arquivos e logs de resultados

      Se especificado em um cabeçalho de análise, as tabelas de resultados do Analytics, os arquivos de resultados (como Excel) e os logs são carregados. Você também pode carregar manualmente os arquivos relacionados para a guia Entrada/Saída do Robôs.

    • Carregamentos de arquivos não permitidos

      Nenhum arquivo de nenhum tipo pode ser carregado por scripts ou manualmente pelos usuários. Scripts de análise com tags //RESULT FILE ou //RESULT LOG não serão executados.

  5. Em Configuração, especifique os diretórios apropriados para a Configuração de caminhos e clique em Salvar.
    • Armazenamento de dados

      O servidor do Windows ou diretório de rede para armazenamento permanente de saída de tabelas de dados do Analytics por scripts de análise com uma tag //DATA.

      Um diretório separado para tabelas de dados permite que você especifique um local de armazenamento de pouco acesso, mais econômico para arquivos grandes que são acessados apenas periodicamente.

    • Caminho de Resultados

      O diretório do servidor do Windows ou da rede para criação das tabelas de resultados do Analytics geradas por scripts de análise com uma tag //RESULT TABLE.

    Importante

    O diretório ou diretórios especificados em Configuração devem estar acessíveis para o Agente do Robôs ou, em um cluster de vários agentes, para todos os agentes. Para cada diretório especificado, a conta de serviço que executa o agente deve ter permissões de leitura/gravação/listagem. Para obter mais informações, consulte Segurança do Agente do Robôs local.

Definir configurações no arquivo Agent.exe.config

Para atualizar definições de configuração, edite o arquivo Agent.exe.config no diretório de instalação do Agente do Robôs e reinicie o serviço do Agente do Robôs para Windows.

A localização padrão do arquivo de configuração é:

C:\Arquivos de Programas (x86)\ACL Software\Robots Agent\agent\Agent.exe.config.

Observação

Você precisa reiniciar o serviço do Agente do Robôs para que a alteração entre em vigor.

Para instalações de vários agentes, você deve atualizar o arquivo Agent.exe.config e reiniciar o serviço do Agente do Robôs em cada servidor do Windows. As definições de configuração para cada agente podem ser idênticas ou diferentes, dependendo das suas necessidades.

Propriedades de configuração em Agent.exe.config

Chave Valor
RuntimeBasePath

Pasta base para:

  • pastas temporárias de tarefas de análise

  • saída de arquivos de resultados não Analytics gerada por scripts de análise com uma tag //RESULT FILE.

  • Saída de arquivos de log do Analytics gerada por scripts de análise com uma tag //RESULT LOG.

  • Saída de arquivos de log do Analytics gerada por scripts de análise com falha

A pasta base padrão é C:\acl\robots\data\

Uma pasta base de tempo de execução separada permite localizar o processamento da tarefa de análise em um dispositivo mais rápido e de alto desempenho, como uma unidade de estado sólido (SSD).

Exemplo de caminho completo para uma pasta de tarefa de análise com uma pasta base configurada pelo usuário: E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp
DataBasePath

A pasta base para armazenamento permanente da saída das tabelas de dados do Analytics por scripts analíticos com uma tag // DATA.

A pasta base padrão é C:\acl\robots\data\

Uma pasta base separada para tabelas de dados do Analytics permite que você especifique um local de armazenamento de pouco acesso, mais econômico para arquivos grandes que são acessados apenas periodicamente.

Exemplo de caminho completo para uma pasta de arquivos de dados com uma pasta base configurada pelo usuário: D:\acl\robots\data\Production\Robot12\Data

Observação

O valor de DataBasePath não é usado se um valor diferente aparecer na definição de configuração do Armazenamento de dados na tela de Gerenciamento de agente no Robôs.

Para obter mais informações, consulte Definir configurações na tela Gerenciamento de agente.
ResultsBasePath

A pasta base para as tabelas de resultados do Analytics geradas por scripts de análise com uma tag //RESULT TABLE.

A pasta base padrão é C:\acl\robots\data\

Exemplo de caminho completo para uma pasta de resultados com uma pasta base configurada pelo usuário: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions

Observação

O valor de ResultsBasePath não é usado se um valor diferente aparecer na definição de configuração do Caminho de Resultados na tela de Gerenciamento de agente no Robôs.

Para obter mais informações, consulte Definir configurações na tela Gerenciamento de agente.
AclSEProfileBase

A pasta base para trabalhar com tabelas ao se conectar do Analytics ao Agente do Robôs usando o Serviço de Dados do Robôs.

A pasta base padrão é C:\acl\robots\aclse\
LogFile

O caminho e o nome do arquivo de log do Agente do Robôs.

O caminho e o nome padrão são C:\acl\robots\logs\application.log
EnginePath

Caminho do arquivo executável que executa as tarefas.

A localização padrão é C:\Arquivos de Programas (x86)\ACL Software\Robots Agent\AclScript.exe
KeepJobFolder

Especifica se a pasta temporária de tarefa de análise é mantida em caso de falha em uma tarefa do robô.

  • true a pasta temporária de tarefa de análise é mantida após a falha da tarefa

  • false a pasta temporária de tarefa de análise é excluída após a falha da tarefa

    O valor padrão é false.

Observação

A configuração KeepJobFolder não tem efeito quando uma tarefa do robô é concluída com sucesso. Após a execução bem-sucedida de uma tarefa, a pasta temporária Tarefa de análise é excluída automaticamente.

Cuidado

Você pode definir o valor como true para manter arquivos para fins de solução de problemas. Deixar o valor definido como true permanentemente pode fazer com que o disco rígido do servidor, ou uma unidade de estado sólido, fique sem espaço.
AllowExecuteCommand

Especifica como o Agente do Robôs lida com o comando EXECUTE quando encontrado em um script de análise:

  • true o comando EXECUTE é processado

  • false o comando EXECUTE não é processado e o script que o contém falha

    O valor padrão é false.

    Uma mensagem é gravada no log, explicando o motivo da falha.
MaxLogSizeKB

O tamanho máximo do arquivo de log do Agente do Robôs antes que o arquivo seja arquivado e um novo arquivo de log seja criado.

O valor padrão é 102400 (100 MB).

O arquivo de log atual é application.log. Os arquivos de log arquivados são salvos na mesma pasta que o arquivo de log atual e recebem um sufixo numérico de incremento: application.0.log, application.1.log e assim por diante e assim por diante.
SkipPathAccessCheck

Controla quais pastas o Agente do Robôs pode acessar ao ler ou gravar tabelas ou arquivos.

  • true o acesso à pasta não é verificado. Os scripts executados pelo Agente do Robôs podem ler ou gravar tabelas ou arquivos em qualquer robô ACL.

  • false o acesso à pasta é verificado. Os scripts executados pelo Agente do Robôs só podem ler ou gravar tabelas ou arquivos no mesmo robô que o script.

    O valor padrão é false.

Se você definir o valor como true e pular a verificação de acesso à pasta, o desempenho do Agente do Robôs poderá melhorar quando executar scripts em alguns ambientes. Você também tem a capacidade de realizar operações de leitura ou gravação em robôs.

Cuidado

Restringir quais pastas um script pode acessar é um recurso de segurança do Robôs que evita violações acidentais ou intencionais de acesso a dados. Defina o valor como true somente se tiver certeza de que permitir que scripts ACL leiam ou gravem tabelas ou arquivos em qualquer robô ACL não representa um risco de segurança.

Observação

A configuração SkipPathAccessCheck não tem efeito na capacidade de compartilhar e vincular tabelas de dados específicas do Analytics entre robôs. Para obter mais informações, consulte Compartilhando e vinculando tabelas de dados em robôs ACL.

Configurar o Agente do Robôs para trabalhar com um servidor proxy específico

Você pode configurar manualmente o Agente do Robôs para se conectar ao aplicativo Robôs usando um servidor proxy designado. Para fazer a configuração manual, você precisa fazer o seguinte:

  • Adicionar uma seção adicional ao arquivo Agent.exe.config

  • Atualizar dois arquivos de configuração adicionais, AgentService.exe.config e Worker.exe.config

Etapas

  1. No servidor onde o Agente do Robôs está instalado, acesse o diretório de instalação do Agente do Robôs.

    A localização padrão do diretório de instalação é:

    C:\Arquivos de programas (x86)\ACL Software\Robots Agent\agent\

  2. Consulte a tabela abaixo para atualizar os arquivos de configuração na subpasta \agent.

  3. Depois de salvar todos os arquivos, reinicie o serviço do Windows Agente do Robôs para iniciar a comunicação entre o Agente do Robôs e o aplicativo Robôs usando seu servidor proxy designado.

Observação

Várias configurações de servidor proxy são possíveis. Os exemplos de configuração abaixo podem não corresponder exatamente aos seus requisitos. Para obter mais informações, consulte a documentação técnica da Microsoft:

Nome do arquivo Informações de configuração
Agent.exe.config

Atualize este arquivo adicionando a seção <system.net> no local mostrado no exemplo.

  • Atualize o endereço de servidor proxy e a porta da sua organização.

  • useDefaultCredentials="true" especifica que as credenciais da conta que executa o serviço do Windows Agente do Robôs são usadas para acessar o servidor proxy.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="ENDEREÇO DO SEU SERVIDOR PROXY:SUA PORTA" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

Nesses dois arquivos, atualize a seção <defaultProxy> de acordo com o exemplo mostrado abaixo.

  • Atualize o endereço de servidor proxy e a porta da sua organização.

  • useDefaultCredentials="true" especifica que as credenciais da conta que executa o serviço do Windows Agente do Robôs são usadas para acessar o servidor proxy.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="ENDEREÇO DO SEU SERVIDOR PROXY:SUA PORTA" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>