Instalação e Configuração¶
Pré-requisitos¶
- Python 3.7+
- Uma conta BotCity (necessária para integração com o Orchestrator)
Passos de Configuração¶
1. Clonar ou Baixar o Projeto¶
Baixe ou clone o template BeaPro para sua máquina local a partir da página pública do GitHub da BotCity:
2. Instalar Dependências¶
3. Configurar Variáveis de Ambiente¶
Edite o arquivo .env com suas credenciais do BotCity:
SERVER=<URL do servidor>
LOGIN=<seu login botcity>
KEY=<sua chave botcity>
TASK_ID=<ID da sua tarefa teste>
Note
O arquivo .env é usado apenas para execuções locais com autenticação. Não é necessário no modo de teste.
4. Configurar sua Fonte de Dados¶
Abra framework/datasources.py e escolha entre CSVSource, DatapoolSource, ou implemente a sua própria estendendo BaseSource.
Modos de Execução¶
O BeaPro suporta três modos de execução:
| Modo | Descrição |
|---|---|
| Modo de Teste | Executa localmente sem credenciais. Objetos mock substituem as funcionalidades do Orchestrator. |
| Local com Autenticação | Usa as credenciais do .env para integração completa com o Orchestrator. Ideal para desenvolvimento. |
| BotCity Runner | Implantado no BotCity Orchestrator. As credenciais são injetadas automaticamente. |
Para executar localmente no modo de teste:
Para fazer o build e implantar no BotCity Orchestrator:
Monitorando sua Execução¶
Após a execução, verifique:
- Saída do console para o fluxo de execução
- Pasta
output/para arquivos de log e resultados CSV - Pasta
temp/para screenshots capturadas em caso de erros - BotCity Orchestrator para logs de execução em tempo real e arquivos de resultado (ao executar com autenticação)