# Diagrama de despliegue de agentes Python gestionados por Sherpa Orchestrator

El diagrama completo está disponible en el siguiente enlace:

## Descripción de la arquitectura de la solución

Sherpa Orchestrator y Sherpa Python Coordinator / Sherpa Python SDK permiten la automatización de procesos de negocio mediante agentes Python que se ejecutan en servidores terminales o máquinas virtuales.

El Orquestador, basado en eventos o datos entrantes del entorno externo (a través de API), inicia scripts de Python que se ejecutan en las cuentas de los servidores terminales sin la intervención del Usuario:

* por orden del agente de IA,
* por orden del usuario de negocio,
* según un cronograma.

Los scripts de Python, mediante Sherpa Python SDK, intercambian con el Orquestador registros, tareas de colas, credenciales almacenadas de manera centralizada y datos compartidos.

Todos los componentes de la plataforma se instalan localmente en la red del Cliente, sin conexión a servidores externos o servicios SaaS. La posibilidad y necesidad de acceso de los componentes de la plataforma a sistemas internos y externos se determina por la tarea que se resuelve en el marco del proceso de negocio.

El despliegue de Sherpa Python SDK se realiza mediante un instalador exe en cuentas de usuario técnico. La instalación del Sherpa Coordinator Service se lleva a cabo en la cuenta de administrador del servidor terminal mediante un instalador exe.

Por defecto, el despliegue de Sherpa Orchestrator se realiza mediante un contenedor Docker.

Secuencia de pasos del proceso:

1. El desarrollador del script del agente de IA, utilizando cualquier IDE de Python adecuado, crea un script utilizando Sherpa Python SDK. Los scripts listos se transfieren a las cuentas técnicas de los agentes de IA mediante la función de publicación remota en Sherpa Orchestrator. La gestión de versiones de los scripts también se realiza mediante Sherpa Orchestrator.
2. El componente del servidor Sherpa Orchestrator mantiene la conexión con los agentes que se ejecutan en las máquinas cliente, así como almacena:
   1. configuraciones y versiones de scripts,
   2. variables globales compartidas y credenciales,
   3. registros y capturas de pantalla del funcionamiento de los agentes,
   4. registros de auditoría del Orquestador,
   5. Usuarios,
   6. Roles y tenencias del propio Orquestador,
   7. Licencias de todos los componentes de la plataforma,
   8. estadísticas de ejecución de scripts.
3. Los usuarios y administradores de Sherpa Orchestrator acceden a los recursos, configuraciones y estadísticas mediante la aplicación web del Orquestador, disponible a través de un navegador web. Sherpa Orchestrator incluye:
   1. servidor web Nginx,
   2. intérprete PHP,
   3. base de datos relacional (por defecto - MariaDB).
4. Según un cronograma, llamada a la API, orden del agente, o por otro desencadenante soportado, Sherpa Orchestrator da la tarea al Sherpa Python Coordinator Service del servidor terminal correspondiente para crear una conexión RDP a la cuenta local o remota, asignada al agente de IA.\
   \
   En este caso, en un mismo servidor terminal pueden estar alojadas y activas varias de estas cuentas simultáneamente. El acceso a la cuenta del agente se realiza con el nombre de usuario y la contraseña proporcionados por el Orquestador.\
   \
   Después de iniciar sesión, en la cuenta se ejecuta la instancia correspondiente de Sherpa Python SDK. Se conecta al Orquestador, recibe la tarea para ejecutar el script y el propio script, almacenado en el Orquestador.\
   \
   Durante la ejecución del script, Sherpa Python SDK puede enviar al Orquestador:

   1. estado actual,
   2. tareas,
   3. registros,
   4. valores de variables globales y credenciales.

   \
   También durante la ejecución del script, Sherpa Python SDK puede recibir del Orquestador:

   1. tareas,
   2. valores de variables globales y credenciales,
   3. órdenes para finalizar el script de manera "suave" o "dura".

   \
   Después de completar la ejecución del script, Sherpa Python SDK realiza el cierre de sesión de su cuenta.


---

# 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/es/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.
