# Instalação inicial e configuração dos componentes da plataforma (exemplo Sherpa Orchestrator)

### Passo 1

Na tela Robots (Robôs) no Orchestrator, crie um novo registro de Robô e defina o Papel como "Coordenador".

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-7cab54a799467b1daee4634245e4cace9bc54df3%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(53).png?alt=media" alt=""><figcaption></figcaption></figure>

Depois disso, entre na edição do registro e copie o GUID deste robô-coordenador.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-20eff63556ae2575f29c7b481f9804342357e04b%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(54).png?alt=media" alt=""><figcaption></figcaption></figure>

### Passo 2

A partir da conta de administrador do servidor terminal, instale o SherpaRPACoordinator.exe.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-a6ab3c1a29b19efd43a683be7ce327bc7504739f%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(55).png?alt=media" alt=""><figcaption></figcaption></figure>

Durante a instalação do Coordenador, é necessário inserir o domínio do servidor Orchestrator e o identificador (GUID) do Coordenador.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-4ade3072f5f004d5086f5123307e86e513915077%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(56).png?alt=media" alt=""><figcaption></figcaption></figure>

ID do Coordenador na janela "Robô":

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-af62b10e23f0027f8c3490de3e830b96a96e1f6f%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(57).png?alt=media" alt=""><figcaption></figcaption></figure>

Em seguida, é necessário verificar a conexão, clicando no botão "Verificar conexão". Também, se necessário, você pode configurar as opções de conexão através de um servidor proxy clicando no botão "Configurações de proxy". Com a conexão bem-sucedida, a instalação é iniciada clicando no botão "Avançar". Após a conclusão da instalação do Coordenador, o serviço Sherpa RPA Service é iniciado.

Ao verificar a presença do serviço Sherpa RPA Service no registro de serviços, é possível ver que ele está instalado e em estado "Em execução":

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-61ec5002fb45c1e52653649e0138524be28f00d5%2F2025-07-29_19-35-51.png?alt=media" alt=""><figcaption></figcaption></figure>

### Passo 3

Para cada conta no servidor terminal que deve executar robôs Python, é necessário criar um robô Unattended correspondente no Orchestrator. Para isso, na tela Robots (Robôs) no Orchestrator, crie um novo registro de Robô e defina o papel como "Unattended":

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-3045b3400945ff3465c107c0dca13864d550929a%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(58).png?alt=media" alt=""><figcaption></figcaption></figure>

É necessário selecionar o robô-coordenador previamente criado, inserir o IP ou nome de domínio da máquina com os robôs Unattended, o login (com o domínio, se houver) e a senha da conta do Usuário sob a qual o Robô deve entrar. Se o Active Directory estiver sendo utilizado, o login da conta deve ser informado através do nome de domínio no campo "Login da conta".

No menu suspenso, é necessário selecionar o Coordenador através do qual o robô Unattended será iniciado:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-ab4065fda80818337a38da11336016a097f3a5e2%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(60).png?alt=media" alt=""><figcaption></figcaption></figure>

Também é necessário inserir as chaves de licença no campo "Chave de licença", que foram previamente adicionadas na tela Licenças. É necessário escolher a licença Unattended. A licença deve ser previamente criada no Orchestrator e ativada (a data de expiração da Licença deve ser maior que o dia atual).

Após salvar o registro criado, é necessário entrar novamente na edição dele e copiar o GUID deste robô Unattended.

### Passo 4

Em seguida, entre na conta do Usuário do servidor terminal, sob a qual este robô Python deve ser executado, e cole o valor do GUID copiado no passo anterior no valor da variável correspondente RobotGUID no script local do framework Python.

Depois, entre no agendador local do Windows e crie um novo registro para o Usuário atual.

Como Gatilho, indique: "Ao conectar-se remotamente à sessão do usuário".

Nas configurações do Gatilho, indique:

* "Qualquer usuário" e "Conexão de um computador remoto" (para máquinas virtuais separadas para cada Robô)
* "Conexão do computador local" (para robôs hospedados no mesmo servidor terminal que o Orchestrator).

Como Ação, indique: "Iniciar programa". No caminho para iniciar, escreva o caminho para o interpretador Python, e nos parâmetros de inicialização, escreva o caminho para o script específico do framework Python nesta conta.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-e6236758b76b536edb537fdb8aba44c1dc268cdd%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(61).png?alt=media" alt=""><figcaption></figcaption></figure>

### Passo 5

Saia da conta do Usuário atual usando Log off (não através do fechamento da janela RDP).

Repita o passo 3 e o passo 4 para cada um dos robôs Python neste servidor terminal.

## Mecanismos de autenticação

A autenticação do Sherpa Coordinator e do script Python do framework no Orchestrator é realizada por meio de um Bearer Token, transmitido no cabeçalho das requisições HTTP RESTful. O Bearer Token é associado ao GUID único de cada instância do robô Python e do Sherpa Coordinator.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-orchestrator/python-sherpa-framework/pervonachalnaya-ustanovka-i-nastroika-komponentov-platformy-na-primere-sherpa-orchestrator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
