Python "Hola Bot"¶

Este tutorial te guiará a través del proceso de crear una automatización simple en Python.

Prerrequisitos¶

Cuenta de BotCity
BotCity Studio SDK
Python 3.7 o superior

Creando tu primer proyecto¶

BotCity ofrece un proyecto de plantilla que se puede personalizar mediante una herramienta llamada cookiecutter.

Instalando Cookiecutter¶

Para poder usarlo, primero necesitamos instalar el paquete de Python cookiecutter ejecutando el siguiente comando en tu terminal de línea de comandos:

python -m pip install --upgrade cookiecutter

Después de hacer esto, estará listo para crear su primera automatización de Python utilizando el framework de BotCity.

De la plantilla al proyecto¶

Con cookiecutter instalado correctamente, es hora de utilizarlo y crear un nuevo proyecto.

Para crear un nuevo proyecto usando nuestra plantilla invocaremos el cookiecutter y proporcionaremos como argumento la URL en la que se encuentran las plantillas de BotCity:

python -m cookiecutter https://github.com/botcity-dev/bot-python-template/archive/v2.zip

El sistema le solicitará un par de respuestas para poder crear correctamente su proyecto.

Una vez que se le solicite project_type, responda con 1 para Desktop y presione Intro;
Para bot_id escriba HelloBot y presione enter;

Después de realizar el proceso anterior, ahora tendrá una nueva carpeta llamada HelloBot.

Success

Felicitaciones, ahora tiene un proyecto con el framework Python de BotCity. 🏆

Echemos un vistazo más profundo a ello.

Explorando el proyecto¶

Debajo de la carpeta de su proyecto HelloBot tendrá la siguiente estructura:

HelloBot
├── bot.py       <- Aquí es donde desarrollarás el código de tu bot.
├── resources    <- Carpeta que contiene recursos útiles para el bot.
├── build.bat        <- Script por lotes para generar el paquete.
├── build.ps1        <- Script de PowerShell para generar el paquete.
├── build.sh         <- Script de shell para generar el paquete.
├── requirements.txt <- Archivo que describe las dependencias de Python para tu bot.
└── HelloBot.botproj <- Archivo utilizado para cargar el proyecto en BotStudio.

Note

Puede que parezcan muchos archivos y carpetas, pero estos son los más importantes:

bot.py: Cambia este archivo y agrega aquí el código de tu bot.
resources: agregue a esta carpeta los archivos que se usarán con su bot, como imágenes, hojas de cálculo, etc.
requirements.txt: cambie este archivo y agregue todas las dependencias externas que se utilizan en el código.

Excelente!

Toda esta información es excelente, pero es hora de ver algo de acción.

Probemos este nuevo y brillante Bot localmente. 🦾🤖

Probar su proyecto localmente¶

Para probar su proyecto localmente, primero instalemos las dependencias de Python que se utilizan en el proyecto.

Usando la herramienta de línea de comandos, acceda a la carpeta HelloBot que describimos anteriormente.

Instalación del proyecto¶

Desde esta carpeta, ejecute el siguiente comando para instalar las dependencias definidas en el archivo requirements.txt:

pip install --upgrade -r requirements.txt

Este comando producirá una gran cantidad de resultados, lo que significa que se están instalando todas las dependencias como botcity-framework-core y otras.

Una vez que se completa este proceso, su proyecto estará listo para ejecutarse.

Ejecutando el robot¶

Nuestro proyecto de plantilla ejecuta una automatización muy simple. Abre su navegador web predeterminado y carga el sitio web de BotCity.

Usando la terminal abierta dentro de la carpeta del proyecto, puede ejecutar su automatización HelloBot con el siguiente comando:

python bot.py

Tip

También puedes usar tu IDE favorito para ejecutar tu proyecto localmente.

Aquí tienes una captura de pantalla del resultado esperado:

🌟 Excelente 🌟

Ahora estás listo para comenzar a crear automatizaciones utilizando el framework Desktop de Python de BotCity.

Conclusión¶

En este tutorial aprendiste:

Las dependencias necesarias para desarrollar automatizaciones utilizando el framework Desktop de Python de BotCity y cómo instalarlas.
Cómo crear nuevos proyectos de bot utilizando cookiecutter y la plantilla de BotCity.
Cómo instalar y ejecutar tu nuevo proyecto de bot localmente.

Diviértete automatizando 🤖

Siguientes pasos¶

Ahora es el momento de cargar tu proyecto en BotCity Studio y comenzar a crear tus automatizaciones con Visión por Computadora y toda la productividad que ofrece nuestra herramienta.