# Diagrama de implantação de agentes Python sob a gestão do Sherpa Orchestrator

Um diagrama completo está disponível no link:

## Descrição da arquitetura da solução

Sherpa Orchestrator e Sherpa Python Coordinator / Sherpa Python SDK fornecem automação de processos de negócios com agentes Python, executados em servidores terminais ou máquinas virtuais.

O Orchestrator, com base em eventos ou dados de entrada do ambiente externo (via API), inicia scripts Python, executados nas contas dos servidores terminais sem a participação do Usuário:

* por comando do agente de IA,
* por comando do usuário de negócios,
* por agendamento.

Os scripts Python, com a ajuda do Sherpa Python SDK, trocam logs, tarefas de filas, credenciais armazenadas centralmente e dados compartilhados com o Orchestrator.

Todos os componentes da plataforma são instalados localmente na rede do Cliente, sem conexão com servidores externos ou serviços SaaS. A possibilidade e a necessidade de acesso dos componentes da plataforma a sistemas internos e externos são determinadas pela tarefa a ser resolvida no âmbito do processo de negócios.

A implantação do Sherpa Python SDK é realizada com um instalador exe nas contas de usuário técnico. A instalação do Sherpa Coordinator Service é feita na conta de administrador do servidor terminal usando um instalador exe.

Por padrão, a implantação do Sherpa Orchestrator é realizada com um contêiner Docker.

Sequência de passos do processo:

1. O desenvolvedor do script do agente de IA, utilizando qualquer IDE Python apropriada, cria um script usando o Sherpa Python SDK. Scripts prontos são transferidos para as contas técnicas dos agentes de IA por meio da função de publicação remota no Sherpa Orchestrator. O controle de versões dos scripts também é realizado com o Sherpa Orchestrator.
2. O componente servidor do Sherpa Orchestrator mantém a comunicação com os agentes executados nas máquinas clientes, além de armazenar:
   1. configurações e versões dos scripts,
   2. variáveis globais compartilhadas e credenciais,
   3. logs e capturas de tela do funcionamento dos agentes,
   4. registros de auditoria do Orchestrator,
   5. Usuários,
   6. Funções e inquilinos do próprio Orchestrator,
   7. Licenças de todos os componentes da plataforma,
   8. estatísticas de execução dos scripts.
3. Usuários e administradores do Sherpa Orchestrator acessam recursos, configurações e estatísticas por meio do aplicativo web do Orchestrator, disponível através de um navegador web. O Sherpa Orchestrator inclui:
   1. servidor web Nginx,
   2. interpretador PHP,
   3. banco de dados relacional (por padrão - MariaDB).
4. Por agendamento, chamada de API, comando do agente ou outro gatilho suportado, o Sherpa Orchestrator dá a tarefa ao Sherpa Python Coordinator Service do respectivo servidor terminal para criar uma conexão RDP com a conta local ou remota, designada para o agente de IA.\
   \
   Nesse caso, em um servidor terminal, podem ser hospedadas e ativas simultaneamente várias dessas contas. O login na conta do agente é feito com o nome de usuário e senha fornecidos pelo Orchestrator.\
   \
   Após o login, na conta é iniciado o respectivo exemplo do Sherpa Python SDK. Ele se conecta ao Orchestrator, recebe a tarefa para executar o script e o próprio script, armazenado no Orchestrator.\
   \
   Durante a execução do script, o Sherpa Python SDK pode enviar ao Orchestrator:

   1. status atual,
   2. tarefas,
   3. logs,
   4. valores de variáveis globais e credenciais.

   \
   Também durante a execução do script, o Sherpa Python SDK pode receber do Orchestrator:

   1. tarefas,
   2. valores de variáveis globais e credenciais,
   3. comandos para "finalização suave" ou "finalização forçada" do script.

   \
   Após a conclusão da execução do script, o Sherpa Python SDK realiza o logoff de sua conta.


---

# 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/diagramma-razvertyvaniya-python-agentov-pod-upravleniem-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.