Instalar o Agente
O agente é o programa que roda na máquina onde seus bots serão executados. Ele se conecta ao orquestrador do Sinfonia por HTTPS, recebe as execuções da fila e envia de volta os logs e o status. Sem pelo menos um agente online, nenhum bot é executado.
Um binário, qualquer máquina
O agente é distribuído como um único binário estático. Não há instalador, runtime ou biblioteca extra para configurar: basta copiar o arquivo para a máquina e executá-lo.
- Sem instalação: um só executável, que já traz tudo o que o agente precisa para rodar.
- Multiplataforma: há um binário para Windows (10, 11 e Server) e outro para distribuições Linux. Você escolhe o sistema no momento do download.
- Diferentes arquiteturas: funciona em processadores x86_64 e ARM64.
Nota
O agente não precisa de instalação, mas os seus bots continuam precisando das próprias dependências na máquina, como o Python 3.12+ para bots Python ou o Node 22+ para bots JavaScript. Confira os pré-requisitos e os requisitos de hardware, principalmente a liberação de rede para o orquestrador.
Baixe o agente
Acesse https://sinfonia.live/agents e clique no ícone de download no canto superior esquerdo. Preencha os campos:
Nome do Agente
- Descrição: Nome usado para identificar o agente na plataforma. Use algo que indique a máquina, por exemplo
WIN-FINANCEIRO-01.
OS
- Descrição: Sistema operacional da máquina onde o agente será executado.
- Opções disponíveis:
Linux,Windows.
Token
- Descrição: Token que autentica o agente no orquestrador.
- Como obter: Por padrão a plataforma gera um token
masterao configurar sua conta. Você também pode criar tokens na seção de tokens.
Atualização Automática
- Descrição: Define se o agente se atualiza sozinho quando houver uma nova versão.
- Opções disponíveis:
Habilitado,Desabilitado.
Copie os arquivos para a máquina
Envie os arquivos baixados para a máquina onde o agente vai rodar e mantenha todos na mesma pasta. O agente precisa de permissão de leitura e escrita nessa pasta.
Inicie o agente
agent.exe na pasta onde os arquivos foram copiados.Importante
Windows: se seus bots precisam de interface gráfica, faça também a configuração descrita em Sessão RDP para interface gráfica.
Confirme a conexão
Volte para https://sinfonia.live/agents. O agente deve aparecer com o nome escolhido e o status ONLINE. A partir daí ele já pode ser selecionado ao publicar bots e configurar gatilhos.
Sessão RDP para interface gráfica
No Windows, o agente pode criar uma sessão RDP própria ao executar as automações. Isso garante que exista uma interface gráfica disponível para bots que interagem com a tela, mesmo que ninguém esteja logado no servidor. Para habilitar, ative o modo multiusuário no agente e informe qual variável do orquestrador guarda a senha do usuário Windows usado na sessão.
Cadastre a senha no orquestrador
Em Administração → Variáveis de Ambiente, crie uma variável com a senha do usuário Windows que o agente usará para abrir a sessão RDP e anote a chave usada, por exemplo WIN_USER_PSWD. Por ser um dado sensível, restrinja a visualização e a edição a Admins.
Configure o .env do agente
No servidor, abra o arquivo .env que está na pasta do agente e adicione:
MULTI_USER_ENABLED=true
USER_PSWD=WIN_USER_PSWDMULTI_USER_ENABLED: permite que o agente crie a sessão RDP para executar as automações. Usetrue.USER_PSWD: recebe a chave da variável cadastrada no passo anterior, e não a senha em si.
Reinicie o agente
Feche o agent.exe e execute-o novamente para que ele carregue a nova configuração.
Dica
Para acompanhar CPU, memória, logs em tempo real e o histórico do agente, veja Agentes.