Saltar a contenido

BotCity Studio SDK

El BotCity Studio SDK es un paquete todo en uno que contiene todas las herramientas necesarias para construir, implementar y ejecutar tus automatizaciones de BotCity.

Incluye las herramientas BotCity Studio, BotCity Runner y BotCity CLI (interfaz de línea de comandos).

El procedimiento de instalación del BotCity Studio SDK es muy sencillo y consta de solo dos pasos:

  1. Descargar y descomprimir el BotCity Wizard
  2. Seguir las instrucciones en pantalla

Descargar

Para descargar el Wizard, simplemente inicia sesión en tu espacio de trabajo de Maestro y haz clic en Descargar Studio, en la sección Setup.

Descargar SDK

Tip

También puedes acceder a la página de descarga de BotCity Studio a través del menú superior izquierdo de Maestro, representado por el icono: Menú de Maestro

En la nueva página que se abre, descarga la versión compatible con tu sistema operativo.

Opciones de descarga del SDK

Herramienta de Diagnostico

La herramienta BotCity - Diagnostic acompaña al paquete Wizard y su objetivo principal es validar si su entorno cumple con los requisitos previos para usar el SDK de BotCity Studio.

De esta manera, la herramienta validará si es posible realizar la instalación en su entorno y también si las herramientas de BotCity podrán establecer una conexión exitosa con Orchestrator.

Para diagnosticar su entorno, simplemente ejecute diagnostic.jar, proporcione las credenciales solicitadas y presione Ejecutar. Con esto tendrás una devolución similar a la siguiente:

Dignostic report

Aviso

Si recibe un resultado FAIL en cualquier prueba de conexión, es posible que esté intentando instalar en un entorno de bloqueo.

En este caso, es necesario solicitar las liberaciones descritas en esta sección. al equipo responsable.

Además de la información de conexión, BotCity - Diagnostic también verifica las versiones de Python y Java de su entorno.

Si observa una falla en una de estas pruebas, verifique si su entorno cumple con los prerrequisitos para usar las herramientas de BotCity.

También puede exportar los resultados de las pruebas a un archivo CSV utilizando el botón Export.

Información

Esta es una herramienta completamente opcional, puede usarla si la encuentra necesaria, o si nota algún impedimento al instalar o usar las herramientas de BotCity.

Instalación

Una vez completada la descarga, extraiga el archivo descargado. Habrá un archivo llamado wizard-X.Y.Z donde X.Y.Z es la versión del Wizard.

Para proceder con la instalación, podemos elegir entre dos opciones:

  • Instalar a través de GUI (interfaz gráfica)
  • Instalar mediante línea de comando (instalación silenciosa)

Instalación mediante GUI (interfaz gráfica)

A través de la interfaz gráfica, el Wizard lo guiará en cada paso del proceso de instalación.

Elige dónde instalar

Instalar

Warning

Ten en cuenta que instalar en ubicaciones como C:\... podría causar problemas de permisos.

Trata de evitar esas ubicaciones o asegúrate de corregir los permisos correspondientemente.

Autenticación con BotCity Maestro

Configuración

Warning

Para Servidor, asegúrate siempre de usar la URL de BotCity Maestro.

Si tienes un subdominio personalizado, es muy probable que tu URL sea algo como https://tuempresa.botcity.dev.

Para la versión comunitaria, utiliza https://developers.botcity.dev.

Casi listo

Terminando

Espera mientras se completa la descarga y se configura el SDK.

¡Estás listo para empezar! 🚀

Finalizar

Tip

Ahora hay una copia del Wizard disponible en la carpeta donde se instaló el SDK. Siempre puedes iniciarlo desde allí y volver a esta pantalla.

Configuración de un BotCity Runner

Después de completar la instalación del SDK, puede configurar un Runner en su entorno de ejecución usando la opción Setup Runner.

Runner Setup

Puede elegir un Runner que ya exista en su espacio de trabajo de Orchestrator o crear uno nuevo.

Runner

Si es la primera vez que lo instalas, te recomendamos encarecidamente crear uno para poder ejecutar tus automatizaciones.

Tip

Ver más detalles en la sección Configurar un Runner.

Acciones del BotCity Wizard

Wizard Home

A continuación se muestran algunas acciones que puede realizar desde la pantalla de inicio del Wizard:

  • Cambiar la versión a una más nueva o anterior, así como a una versión development
  • Configurar un BotCity Runner
  • Iniciar BotCity Studio
  • Iniciar BotCity Runner como un proceso en segundo plano o como una aplicación visual (GUI)
  • Abrir la carpeta en la que se instaló el SDK

Instalación mediante línea de comando (instalación silenciosa)

Otra forma de instalar el SDK es mediante la línea de comando, ingresando los parámetros necesarios para la instalación.

Comandos de instalación

Podemos instalarlo usando el comando wizard install e ingresando algunos parámetros.

El comando más simple posible es aquel en el que solo ingresamos los parámetros obligatorios email y password, que se utilizan para la autenticación en BotCity Maestro Orchestrator.

wizard install 
  --email "user@server.com"
  --password "bot32r$3usr74"

Consejo

  • Puede ser necesario informar la versión del Wizard en el comando, si no se encuentra. wizard-X.Y.Z install ...
  • Para sistemas Linux y macOS, agregue el comando java -jar antes del comando del Wizard. java -jar wizard-X.Y.Z.jar install ...

Para realizar la instalación completa, con todos los parámetros, podemos utilizar el siguiente comando:

wizard install 
  --dir "C:\BotCity"
  --server "https://developers.botcity.dev"
  --email "user@server.com"
  --password "bot32r$3usr74"
  --organization "superbots"
  --runner "vm-01"

Tabla de parámetros para el comando de instalación:

Opción Obligatorio Definición Valor predeterminado
dir No Carpeta donde se instalará el SDK Depende del sistema operativo
server No URL del orquestador de BotCity Maestro https://developers.botcity.dev
email Correo electrónico de cuenta de usuario
password Contraseña de cuenta de usuario
organization No Organización a utilizar (label) Primera organización en la lista
runner No Corredor a configurar (machineId) Vacío

Actualizar comandos

Para actualizar la configuración del SDK, podemos usar el comando wizard update, informando siempre el parámetro password, los demás parámetros son opcionales. Además de los parámetros de instalación, podemos ingresar el parámetro version para actualizar la versión del SDK.

Advertencia

Cuando no se proporciona el parámetro "version", siempre se actualizará a la última versión del SDK.

Solo podemos ingresar un parámetro opcional como en el siguiente ejemplo (incluye actualización de versión):

wizard update
  --password "bot32r$3usr74"
  --runner "vm-01"

O haga una actualización completa, con todos los parámetros como en el siguiente ejemplo:

wizard update 
  --server "https://developers.botcity.dev"
  --email "user@server.com"
  --password "bot32r$3usr74"
  --organization "superbots"
  --runner "vm-01"
  --version "v2.16.5"

consejo

La versión del SDK se puede verificar en el archivo setup.json en la carpeta donde se instaló el SDK.

Con este comando no podemos cambiar la ubicación de instalación del SDK, por lo que debemos rehacer la instalación.

Tabla de parámetros para el comando de actualización:

Opción Obligatorio Definición Valor predeterminado
server No URL del orquestador de BotCity Maestro Se mantiene instalado
email No Correo electrónico de cuenta de usuario Se mantiene instalado
password Contraseña de cuenta de usuario
organization No Organización a utilizar (etiqueta) Se mantiene instalado
runner No Corredor a configurar (machineId) Se mantiene instalado
version No Versión a instalar Última versión

Explorando el contenido

Después de extraer el archivo descargado, encontrarás la siguiente estructura de carpetas:

.
├── bin
├── conf
│   ├── conf.bcf
│   └── properties.json
├── lib
│   └── tesseract
├── run
├── scripts
│   └── console_session.bat
├── startup
│   └── startup.bat
├── venvs
├── win32
│  └── java
├── BotCLI.bat
├── BotRunner.bat
├── BotRunner-gui.bat
├── BotStudio.exe
├── diagnostic-X.Y.Z.jar
├── install.log
├── setup.json
└── wizard-X.Y.Z.exe
.
├── bin
├── conf
│   ├── conf.bcf
│   └── properties.json
├── lib
│   └── tesseract
├── run
├── scripts
├── startup
├── venvs
├── wizard-X.Y.Z.jar
├── diagnostic-X.Y.Z.jar
├── setup.json
├── install.log
├── BotCLI.sh
├── BotRunner-gui.sh
├── BotRunner.sh
└── BotStudio.sh

En la carpeta raíz del SDK, encontrarás los siguientes archivos:

  • BotCLI.bat/BotCLI.sh: Envoltorio para la herramienta BotCity CLI (interfaz de línea de comandos).
  • BotRunner-gui.bat/BotRunner-gui.sh: Lanzador para la herramienta BotCity Runner en modo gráfico.
  • BotRunner.bat/BotRunner.sh: Lanzador para la herramienta BotCity Runner en modo sin cabeza.
  • BotStudio.exe/BotStudio.sh: Lanzador para la herramienta BotCity Studio.
  • bin: Carpeta que contiene los archivos jar binarios del SDK de BotCity.
  • conf: Carpeta que contiene los archivos de configuración.
    • conf.bcf: Archivo de configuración de BotCity Studio.
    • properties.json: Archivo de propiedades de BotCity Studio (utiliza el menú de Preferencias para editar los valores, no directamente en el archivo).
  • lib: Bibliotecas de soporte para BotCity Studio.
  • run: Carpeta de tiempo de ejecución para BotCity Runner.
  • venvs: Carpeta de tiempo de ejecución para los ambientes virtuales de Python de BotCity Runner.
  • scripts: Carpeta para almacenar scripts que BotCity Runner puede ejecutar. Más detalles aquí.
  • startup: Carpeta que contiene un script que BotCity Runner puede ejecutar al iniciar. Más detalles aquí.
  • setup.json: Archivo que contiene información de instalación, como la versión del SDK instalada y las credenciales de acceso utilizadas.
  • install.log: Archivo producido por el Wizard que contiene información del registro de instalación.
  • diagnostic-X.Y.Z.jar: Copia del BotCity Diagnostic creada dentro de la carpeta de instalación.
  • wizard-X.Y.Z.exe/wizard-X.Y.Z.jar: Copia del BotCity Wizard creada dentro de la carpeta de instalación.

Configuración

La configuración del SDK de BotCity Studio se realiza a través del archivo conf.bcf ubicado en el directorio "conf".

Usando el Wizard, este archivo se genera automáticamente para ti, pero aún puedes personalizarlo según tus necesidades.

Echemos un vistazo al contenido del archivo conf.bcf:

server=https://developers.botcity.dev
workspace=
key=
login=
machineId=<Your Machine ID Here>
logScreen=true
logApplication=true
  • server: URL del servidor de BotCity Maestro.
  • workspace: Espacio de trabajo de BotCity Maestro.
  • key: Clave de API de BotCity Maestro ubicada en la página Ambiente de desarrollo.
  • login: Usuario de API de BotCity Maestro ubicado en la página Ambiente de desarrollo.
  • machineId: ID de máquina de la máquina actual. Consulta Máquinas.
  • logScreen: Opción booleana que define si se envían capturas de pantalla periódicamente a BotCity Studio.
  • logApplication: Opción booleana que define si los registros de BotCity Runner se envían periódicamente a BotCity Studio.

Prueba de tu SDK de BotCity Studio

La forma más sencilla de probar tu SDK de BotCity Studio es utilizar la herramienta BotCity CLI.

Para ello, abre una terminal en la carpeta que contiene el SDK de BotCity Studio y ejecuta el siguiente comando:

./BotCLI.bat bot list
./BotCLI.sh bot list

Si tu SDK de BotCity Studio está configurado correctamente, deberías ver la siguiente salida:

SUCCESS:
...

Note

Si ves un mensaje de ÉXITO seguido de un mensaje de ERROR, significa que tu SDK de BotCity Studio está configurado correctamente pero probablemente aún no has implementado ningún bot.

Siguientes pasos

Ahora estás listo para comenzar a desarrollar tus automatizaciones de BotCity.

Pasemos al siguiente paso y comencemos a desarrollar tu primer bot.