DEV Community: Morganna

Quem é o destaque da comunidade?

Morganna — Sat, 25 Apr 2026 11:40:19 +0000

Muitas pessoas podem pensar que quando somos Developer Advocate ou Developer Relations, nós nos tornamos o destaque do produto. Mas não é bem essa a verdade.

Claro que, ao começar a representar um produto, nós começamos a ter algum destaque, pois estamos lá, fazendo os conteúdos sobre ele, ensinando como utilizá-lo das melhores formas e como ele pode resolver diversos dos seus problemas. Podemos até acabar nos tornando referências. Mas eu acredito muito que ser Developer Advocate é também dar voz e destaque para a comunidade.

A partir da posição que tomamos em nosso papel, trazemos a comunidade para cima. Ela é quem fala, quem usa o produto, quem tem o que falar sobre ele, sobre suas experiências e dificuldades que precisam ser atendidas. E é extremamente importante levar essa voz da comunidade para o time de produto, de tecnologia, de marketing e todas as demais áreas envolvidas.

Costumo brincar que somos os olhos, ouvidos, boca e o corpo inteiro, se precisar, da comunidade. E seja uma comunidade interna ou externa, para ela, somos a ponte até a empresa, ou até as áreas de desenvolvimento daquele produto. Somos representantes dessa comunidade. E precisamos fazer com que ela seja ouvida e atendida.

Isso leva a valorização e reconhecimento para a comunidade. ✨

Você sabe o quanto você evolui quando ajuda outra pessoa?

Morganna — Sat, 25 Apr 2026 11:37:14 +0000

Independente da nossa senioridade na carreira, uma coisa é certa: é normal ter dúvidas e precisar de ajuda. Outra certeza é de que além de nós, outras pessoas também poderão contar com nosso apoio. A área de tecnologia, além de outras coisas, também é conhecida pela força que a comunidade tem e de como, na maioria das vezes, encontramos disponibilidade e gentileza para nos ajudarmos no cotidiano.

E essa semana me deparei com essa reflexão. Por que alguém negaria ajuda para outra pessoa? Não faz nem sentido. O mundo da tecnologia é bem pequeno e, com toda certeza, chegará a hora que essa pessoa também precisará de ajuda. E aposto que ela não quer encontrar um "não" como resposta.

Então, você sabe o quanto ganha quando ajuda outra pessoa? Você vê outra linha de pensamento, outra forma de enxergar um problema e uma, ou mais, possível solução. Você pode testar ideias diferentes para resolver a dúvida e esses testes vão te mostrar resultados diferentes que também se tornarão aprendizados. Você também reforça um conhecimento que você já tem, exercitando formas diferentes de explicar sobre aquilo, tendo que encontrar outros meios e analogias para garantir que a outra pessoa entendeu.

E são tantos outros aprendizados que poderíamos ficar por aqui enumerando-os, com toda certeza. Espero que possamos ser mais gentis e que possamos apoiar mais as pessoas ao redor. E assim, nós podemos crescer cada vez mais, sendo quem aprende ou sendo quem ensina.

Como ajudar as pessoas a contribuirem com seu projeto Open Source

Morganna — Wed, 29 Oct 2025 18:16:25 +0000

Essa é uma submissão para o Desafio de escrita do Hacktoberfest 2025: Reflexões sobre Open Source.

Tenha um `README.md` legal

Esse arquivo é basicamente a vitrine do seu projeto. Então faz sentido que você dedique um tempo nele, deixando-o completo, contando com descrição do projeto, como executá-lo (caso seja código), versionamento, como usá-lo etc.

Crie o `CONTRIBUTING.md`

Esse será um dos arquivos principais. É nele que você vai adicionar as orientações de como as pessoas podem contribuir com o seu projeto. E quanto mais completo, melhor será. Você pode incluir que a pessoa precisa, por exemplo, fazer um fork do projeto, criar uma branch para contribuição, colocar as regras de como nomear a branch, os commits, as pull requests, adicionar exemplos de contribuição, entre outras coisas que ajudam a padronizar e deixar o projeto mais organizado e recebendo contribuições relevantes.

Adicione issues

Se você já tem uma ideia de quais funcionalidades ou correções poderiam ser feitas no projeto, essa é uma boa forma de documentá-las. A comunidade pode escolher entre as issues disponíveis para desenvolvê-las. E, claro, as pessoas também podem criar novas issues para discussão da relevância da contribuição que a pessoa quer fazer. Assim, antes da pessoa ter todo o trabalho de fazer a alteração, vocês chegam num acordo se aquela alteração faz sentido ou não.

Disponibilize o `CODE_OF_CONDUCT.md` do projeto

Pode ser legal ter um arquivo com o código de conduta, assim as pessoas sabem como contribuir da melhor forma para aquele projeto, entendendo quais são as regras. Basicamente, adicionando as orientações de se manter o respeito nas contribuições e nas discussões dessas contribuições, entre outras.

E você, tem mais dicas de como deixar o projeto o mais amigável possível para as pessoas saberem como contribuir com ele? Deixe nos comentários a sua contribuição!

Educação, Developer Relations e Inteligência Artificial

Morganna — Thu, 22 May 2025 11:54:04 +0000

Eu acredito muito no poder da educação. Principalmente em situações como a que estamos vivenciando agora, com a explosão de novidades sobre Inteligência Artificial e os medos que surgem com tudo o que tem sido falado por aí.

Na minha opinião, as ferramentas de IA são muito poderosas para serem colocadas na mão das pessoas sem quaisquer orientações. O uso equivocado, as crenças ao redor disso, o fato de acreditar ou não nas informações geradas sem o senso crítico de quando há alienação e quando há, de fato, respostas válidas, o medo de perder o emprego por conta dessa tecnologia e muitos outros fatores, podem ser muito complicados sem educação.

A área de Developer Relations pode ser uma forte aliada nesse processo de educação nas empresas. Como Developer Advocate de uma plataforma de IA, vejo o impacto do meu trabalho acontecendo diariamente, levando o conhecimento de forma leve e prática, mostrando como as coisas funcionam de uma maneira mais profunda, dando na mão das pessoas de diversas áreas, e não apenas tecnologia, ferramentas que serão um apoio para seus desafios, tirando o peso do que as assusta e incluindo a leveza de resolver seus problemas diários.

Investir na área de Developer Relations pode ser fundamental por diversos motivos. E educação é uma das chaves que pode abrir várias portas de soluções dentro das empresas. Quem investe em educação, investe no capital intelectual. E quem investe no capital intelectual, investe em inovação.

Como maximizar o uso da Inteligência Artificial com a engenharia de prompt

Morganna — Fri, 16 May 2025 19:00:45 +0000

A inteligência artificial tem se tornado uma aliada valiosa em diversas áreas dentro das empresas. Um dos fatores que pode determinar a eficácia dessa tecnologia é a qualidade dos prompts utilizados para interagir com ela. Neste artigo, discutiremos a importância de construir prompts bem elaborados e forneceremos dicas práticas para garantir que você obtenha as melhores respostas das LLMs.

O que é Engenharia de Prompt

A engenharia de prompt surgiu como uma nova habilidade e ela é tão recente que ainda estamos aprendendo como usá-la. Essa habilidade nos permite criar inputs otimizados para os modelos de linguagem da inteligência artificial nos retornarem respostas que sejam relevantes. É importante ressaltar que a qualidade do prompt pode influenciar significativamente a acurácia da resposta recebida.

Como estruturar um prompt

Considere as seguintes etapas para criar seu prompt:
1. Ações
Comece o prompt com verbos de ações, como “escreva", “analise”, “crie”, entre outros. Deve ser uma pergunta ou solicitação bem definida, tomando o cuidado de evitar ambiguidades.

2. Dê contexto
Esse é um dos pontos mais importantes. Isso inclui informações sobre a situação atual, objetivos, informações sobre o projeto que está trabalhando ou quaisquer limitações que você possa ter para a sua solicitação.

3. Formatação
Forneça orientações sobre como você deseja que a resposta seja formatada. Você espera uma lista? Um e-mail? Um código? Um texto em formato markdown? Esse processo pode facilitar muito o entendimento do retorno da IA.

4. Exemplificação
Dependendo do tipo de solicitação que você está fazendo, pode fazer sentido dar exemplo para IA sobre o que está pedindo. Se está pedindo um e-mail, você pode dar outro e-mail como exemplo do que se espera de resultado. Se está desenvolvendo um código, você pode apontar os arquivos que já estão com o código pronto e que representam o que você espera como retorno.

5. Persona
Outro ponto que pode melhorar o seu prompt seria dizer qual é a persona. Se você está desenvolvendo um código, você pode dizer que a persona da IA é uma pessoa desenvolvedora. Se você está criando histórias a partir de um épico, você pode dizer que a persona da IA é uma pessoa product manager e assim por diante.

6. Entonação
Dependendo da sua solicitação, pode fazer sentido pedir uma entonação específica no seu prompt. Essa entonação pode ser, por exemplo: ou tom de voz casual, ou um tom de voz mais formal, ou entusiasmo, entre outros.

Vamos continuar construindo prompts

A criação de prompts eficazes é uma habilidade importante que pode maximizar o potencial da IA. Ao focar em clareza, contexto e especificidade, qualquer pessoa, independente da função ou área, pode aprimorar suas interações com a IA e, assim, alcançar melhores resultados. Invista tempo na elaboração de seus prompts e observe como isso pode transformar suas experiências com a tecnologia.

Trilha de estudos para ser uma pessoa desenvolvedora Python RPA

Morganna — Fri, 29 Mar 2024 21:23:00 +0000

Python tem ganhado cada vez mais força no mundo da automação RPA e é importante, como profissionais, estudarmos também essa tecnologia para atender as demandas da melhor maneira possível.

Mas quais são os passos para aprender Python RPA?

Que tal seguir essas dicas de uma trilha para o seu desenvolvimento e ainda ter certificados para compartilhar suas novas skills técnicas?

🤖 Comece pela linguagem de programação Python

Este curso totalmente prático vai te guiar de forma clara e objetiva através das principais funcionalidades do Python.

Link: Python Basics - Introdução e Mão na Massa.

Para mais conteúdos para você aprender Python, siga as dicas do artigo "Como iniciar meus estudos em Python".

🤖 Desenvolva sua primeira automação Python

Este curso ministrado durante a Python Brasil de 2022 vai te ensinar a criar automações com visão computacional para qualquer sistema.

Link: Criando automações com visão computacional.

🤖 Segurança com Python RPA

Este curso vai te guiar de forma clara e objetiva através dos principais conceitos de segurança da informação e como aplicar esses conceitos em projetos Python com um foco especial em projetos de RPA.

Link: Segurança com Python RPA.

🤖 Aprenda como fazer orquestração da sua automação Python

Aprenda na prática de forma clara e objetiva as principais funcionalidades do orquestrador. Veja os benefícios e vantagens de usar cada recurso nos seus processos de automação.

Link: Orquestração de Python RPA.

🤖 Desenvolva uma automação com um importante sistema do mercado

Explore a automação SAP com Python e BotCity neste curso prático. Aprenda técnicas essenciais para agilizar os processos SAP de forma eficiente e eficaz.

Link: Automação de SAP com Python.

🤖 Pratique bastante e compartilhe sua evolução e seus aprendizados com a comunidade

Conheça o repositório de bots da comunidade, para aprender com o desenvolvimento de outras pessoas e compartilhar os seus projetos open source.

Link: Repositório de bots da comunidade.

O que achou dessas dicas? Bora começar esses estudos e sermos profissionais cada vez melhores!

E se tiver mais dicas, deixe nos comentários para complementar o conteúdo!

O papel da pessoa desenvolvedora muito além do código

Morganna — Fri, 29 Mar 2024 18:25:59 +0000

Estava acompanhando uma postagem no LinkedIn sobre como os times e as empresas precisam entender a importância do gerenciamento de projetos de automação. Você pode acompanhar a postagem neste link.

Entendo que é crucial que essa discussão ocorra entre as pessoas dos times de negócio e gestão. Mas essa preocupação deveria ser também considerada para pessoas desenvolvedoras e também outros papéis de pessoas tecnologistas.

Quando nos tornamos pessoas desenvolvedoras (independente do tipo de projeto que vamos desenvolver), colocamos na cabeça que somos pessoas que fazemos apenas código.

Mas na verdade, somos pessoas resolvedoras de problemas. Precisamos lembrar de exercitar esse papel, levando para os times que trabalhamos soluções que fazem mais sentido de acordo com os requisitos e projetos que temos que atender.

Além disso, resolver problemas não significa que vamos apenas desenvolver um código e acabou. Devemos encontrar soluções no mercado que nos ajudem, afinal de contas, nosso objetivo também é levar valor aos projetos que atuamos. Por isso é tão importante quando fazemos POCs (Proof of Concept, ou Prova de Conceito em português) das ferramentas que pesquisamos.

É nesse momento que testamos, avaliamos as funcionalidades e tentamos considerar quais serão os ganhos com aquela ferramenta. E isso vai muito além do que queremos. Por isso temos que entender o que as demais áreas precisam e o que de fato terá valor em nossa automação.

Um projeto de automação também é um projeto de software. E tal como um projeto de software, precisa de gerenciamento. Não basta entregar um executável para as pessoas usuárias. O que elas querem, no final do dia, é ter uma forma de orquestrar o que será executado.

Repare nas perguntas que as pessoas usuárias fazem:

Como eu sei se deu certo?
Como faço para agendar a execução?
E se der erro?
E se não executar?
Como eu levo uma comunicação eficaz para o time sobre o que está acontecendo com as automações?
Mas eu tenho uma planilha enorme de dados para consumir, e se falhar no meio do caminho?
Quem pode acessar as informações?
Onde eu coloco as senhas para autenticação nos sistemas?
Eu posso executar mais de uma automação por vez?

Entre tantas outras. E unir código com uma solução que te permita proporcionar todo esse gerenciamento é de extrema importância, principalmente porque a operação de automações pode ser facilmente escalada. E como vamos gerenciar isso?

Aproveitando a discussão, quero compartilhar com vocês uma trilha de estudos que pode te ajudar a entender melhor como seguir essas práticas e o nosso papel: trilha de estudos para Python RPA.

E o que você acha isso? Compartilhe suas experiências com a comunidade nos comentários e vamos trocar uma ideia.

As mulheres que mudaram o rumo da tecnologia

Morganna — Sun, 24 Mar 2024 14:45:38 +0000

Quando eu comecei a fazer lives sobre tecnologia pelo time da Feministech na Twitch, eu pensei em falar sobre mulheres na tecnologia. O objetivo era falar de uma mulher a cada live. E como eu queria ter o registro disso de alguma forma, para que ninguém perdesse a história da mulher que falamos, caso a pessoa tivesse perdido a live, criei um projeto dentro do GitHub.

Isso foi bem importante para mim, a cada live que eu pensava em fazer, pesquisava sobre mulheres na tecnologia e acabava descobrindo histórias incríveis e que ninguém conta abertamente. E lá ia eu, ficar encantada com cada uma dessas histórias e já estava achando pouco falar sobre apenas uma mulher na tecnologia por live.

O projeto foi crescendo e tomando forma. Claro que já tive um milhão de ideias para ele, assim como já recebi também diversas sugestões. Já pensei até em transformar em um livro. (Quem sabe um dia, né?).

E quero aproveitar o #wecoded para mostrar também para mais pessoas sobre esse projeto. Ainda são pouquíssimas mulheres nele. Tem mulheres que já se foram, mulheres que ainda estão transformando a área de tecnologia com seus estudos, pesquisas e trabalho.

E além disso, quero aproveitar para falar mais uma coisa:

Você, que está aí em algum lugar, estudando sobre tecnologia, enfrentando diversos preconceitos, tentando lidar com mil coisas ao mesmo tempo: casa, trabalho, estudos, ou buscando sua primeira oportunidade, saúde, família, ou tendo que cuidar de tudo isso sozinha, entre tantas outras coisas... Eu quero dizer que você também está transformando o mundo da tecnologia. Seja você uma mulher que está pensando em dar seus primeiros passos na área, uma mulher que já está atuando como tecnologista, uma mulher com anos e anos de experiência, uma mulher em transição de carreira, não importa. A cada passo que você dá, é um passo que damos todas juntas para mudar o mundo. E você está transformando a área de tecnologia.

Vou pegar emprestada algumas palavras aqui do Emicida: "faz essa por nós, te vejo no pódio", onde estaremos juntas, combinado?

Se você quiser se inspirar em outras mulheres diversas ou quiser compartilhar a história de mulheres na tecnologia, aqui está o projeto. Espero que goste!

morgannadev / mulherestecnologia

A ideia deste repositório é compartilhar sobre mulheres na tecnologia, mostrando que há muitas delas que transformaram e ainda transformam a área.

Mulheres no mundo da tecnologia 💻

Olá, mundo Eu sou a Morganna, sou desenvolvedora backend, developer relations e tech writer e estou fazendo lives na twitch sobre programação e outras coisas. Faço parte da equipe Feministech Em cada uma das nossas lives, iremos conhecer uma mulher do mundo da tecnologia. E, também, vamos registrar um resumo de suas histórias aqui.

[0] Ada Lovelace

Nascida como Augusta Ada Byron King. Viveu entre 1815 e 1852. Foi a primeira pessoa (e não apenas a primeira mulher) a desenvolver um algoritmo que poderia ser implementado em um computador. Foi matemática, primeira pessoa programadora, poetisa, cientista da computação, inventora, tradutora, escritora e engenheira. Também é reconhecida pela comunidade de pessoas da área de qualidade como a primeira pessoa a identificar bugs em um algoritmo.

[1] Grace Hopper

Grace Murray Hopper, viveu entre 1906 e 1992. Foi a criadora da linguagem de programação de…

View on GitHub

Inclusive, nesse mesmo repositório, tem um arquivo com iniciativas e comunidades para mulheres no mundo todo. Conheça e compartilhe!

Dicas sobre desenvolvimento de automação com visão computacional

Morganna — Sun, 17 Mar 2024 19:50:16 +0000

Existem diversos casos de uso em que o desenvolvimento das automações RPA podem ter um melhor resultado utilizando o apoio da linguagem de programação Python e a tecnologia visão computacional.

O que é visão computacional

A visão computacional é uma tecnologia que utiliza-se da Inteligência Artificial, Aprendizado de Máquina (ou Machine Learning) e reconhecimento óptico de caracteres (também conhecido como OCR) para desenvolver sistemas que possam interpretar e classificar imagens.

Por trás dessa tecnologia, existem algoritmos capazes de entender padrões apenas visualizando imagens e vídeos. E isso pode ser um grande poder para nos ajudar a automatizar tarefas e processos que precisam acessar sistemas que nem sempre nos permitem acessar o backend da aplicação desktop ou ainda a DOM (Document Object Model de uma página HTML) de uma página Web e temos que partir para a visão computacional.

Como usar a visão computacional para desenvolver automações

Vou deixar aqui como sugestão, um conteúdo bem interessante em formato de curso rápido com o passo a passo de como desenvolver a sua automação com visão computacional: Criando automações com visão computacional.

E como dica extra, vou deixar aqui também disponível acesso para a documentação de maneira gratuita de uma extensão que está em pré-release que você pode utilizar no Visual Studio Code para desenvolver suas automações com o apoio dessa tecnologia, visão computacional.

Dicas sobre como resolver problemas ao desenvolver com visão computacional

Elemento não encontrado

Algo que pode ajudar na investigação de elementos não encontrados pela visão computacional, é utilizar o seguinte comando logo após chamar a função find() e antes de executar operações como o click():

bot.save_screenshot("debug_find.png")

Isso pode te ajudar a analisar como estava a tela e talvez te dar um direcionamento de qual é o motivo do elemento não estar sendo encontrado.

Resolução da tela

Outra questão muito importante dentro do desenvolvimento com visão computacional é a resolução da tela. Caso esteja desenvolvendo uma automação que utiliza máquina virtual acessando via RDP, você pode seguir algumas dicas do artigo linkado.

Sugestões para avaliar problemas

Você pode analisar os pontos a seguir para descobrir o que pode estar acontecendo nas falhas do seu robô:

Talvez o período configurado no parâmetro waiting_time da função find() esteja muito curto e isso pode acontecer caso ainda não tenha dado tempo de carregar a tela, então você poderia ajustar esse item;
Talvez o sistema sendo automatizado possua algum bloqueio contra captura de telas (esse tipo de problema pode ser bastante comum em telas que envolvam Bancos, por exemplo);
Talvez algum outro elemento esteja na frente do elemento buscado, então a sugestão de tirar um print da tela citada acima, pode ajudar a entender se isso está acontecendo;
Pode ser que o recorte foi feito com outra resolução que não a do sistema atual. Lembre-se de tentar desenvolver num ambiente igual ou ao menos o mais parecido possível, principalmente ao que se refere às configurações de resolução;
Verifique se você está fazendo os recortes necessários em um ambiente com tema dark, por exemplo, porque isso pode fazer diferença se em outro momento, o ambiente estiver com o tema light;
E outra dica seria verificar a acurácia do algoritmo de visão computacional. Na função find(), ajuste, se necessário, o parâmetro matching. Ele costuma estar com o valor máximo 0.97. Esse valor poderia ser ajustado a, no mínimo, 0.90. Isso pode ajudar nas questões levantadas neste tópico. Mas cuidado para não diminuir muito mais que isso, a ponto do algoritmo perder a sua eficiência para encontrar o elemento que precisa ser identificado.

Já fez alguma automação com visão computacional?

Compartilhe suas experiências com essa forma de desenvolvimento e, caso tenha passado por algum problema ou erro, compartilhe também como solucionou ocorrido. Sempre bom aprender com experiências diferentes.

E não deixe de participar da comunidade para mais trocas e conteúdos.

Como identificar problemas de ambiente ao tentar instalar BotCity Studio SDK

Morganna — Tue, 12 Mar 2024 17:14:57 +0000

Para utilizar qualquer tecnologia e/ou linguagem de programação, você deve preparar o ambiente para que seu código funcione adequadamente conforme você o desenvolve. E as orientações sobre como fazer isso, normalmente constam nas primeiras etapas da documentação dessa tecnologia.

No caso do desenvolvimento de automações RPA com as ferramentas da BotCity também funciona dessa maneira. As orientações estão na documentação com os pré-requisitos. Mas dependendo do computador que estamos utilizando, pode ser que tenhamos algumas dificuldades para instalar algo.

Isso pode acontecer por alguns motivos:

algumas tecnologias podem ter pré-requisitos para funcionar;
alguns computadores podem ter bloqueios para instalar algo, caso você não seja a pessoa administradora da máquina.

Essas questões ressaltam quando estamos lidando com computadores que são da empresa na qual trabalhamos que, por segurança, adiciona bloqueios nesses equipamentos.

Caso você esteja tentando preparar o ambiente para desenvolvimento de suas automações utilizando as ferramentas da BotCity e enfrente alguma dificuldade, é importante que você conheça também a ferramenta Diagnostic.

Essa ferramenta acompanha o mesmo pacote que você realiza o download do Wizard para instalação do BotCity Studio SDK. Seu objetivo é validar se o ambiente atende os pré-requisitos para que você utilize esse SDK sem problemas e se é possível a instalação das ferramentas em seu computador, além de confirmar se será possível estabelecer uma conexão de sucesso com o BotCity Orquestrador.

Como executar o diagnóstico

Ao fazer o dowload do BotCity Studio SDK, você terá uma pasta compactada chamada Wizard. Ao descompactá-la, um dos arquivos disponíveis será o diagnostic.jar.

⚠️ Para executar o Diagnostic no Linux ou no MacOS, é necessário ter o Java instalado. Se você for executar no ambiente Windows, pode executar sem essa preocupação.

A janela do Diagnostic se abrirá e você deverá adicionar o seu login da conta criada para utilizar o SDK e o Orquestrador. No campo "Email" preencha o seu e-mail cadastrado e no campo "Password" adicione a sua senha. Após isso clique no botão localizado do lado direito da janela, chamado “Run”.

Caso você não preencha e-mail e senha, o Diagnostic não fará os testes de login com o Orquestrador, deixando essa informação como resultado do teste: "E-mail ou senha não informados. Essa etapa foi pulada".

Após clicar em "Run", o Diagnostic começará os testes do ambiente. Se terminar com tudo funcionando corretamente, uma janela de confirmação aparecerá em cima informando que o diagnóstico finalizou e que o sistema está pronto para o desenvolvimento.

Status dos resultados do diagnóstico

Pode ser que você perceba três diferentes status após a execução. São eles:

PASS: significa que o teste passou;
FAIL: significa que o teste falhou e será necessário averiguar o problema;
SKIP: significa que o teste anterior com o SSL (certificado) habilitado, funcionou, então o Diagnostic não precisou executar um novo teste com o SSL desabilitado.

Caso receba o resultado FAIL em algum teste de conexão, possivelmente há algum bloqueio no ambiente que você está utilizando. E, neste caso, é necessário solicitar ao time responsável da empresa onde você trabalha, as liberações descritas na documentação de problemas com bloqueios de ambiente.

Como exportar o resultado dos testes

Se for necessário, você pode exportar o resultado dos testes em formato .csv. Para fazer isso, clique no botão "Export" localizado na parte debaixo da janela, do lado direito. Feito isso, uma nova janela se abrirá para você ter acesso ao arquivo.

Ficou alguma dúvida?

Você pode acessar o nosso FAQ para dúvidas frequentes, ou ainda entrar em contato com a comunidade global no Slack. Caso prefira, também temos o fórum disponível para dúvidas.

Para quem é a sua homenagem para mulheres na tecnologia?

Morganna — Fri, 08 Mar 2024 18:21:57 +0000

Vamos refletir um pouco sobre essa questão. Quando você pensa em mulher na tecnologia, o que vem a sua mente? E essa pergunta é importante para todes.

O seu pensamento de diversidade está incluindo quais mulheres? As brancas? As negras? As indígenas? As pardas? As amarelas? As mulheres dos mais diversos tipos de corpos?

Você só considera as mulheres cis? E as mulheres trans? Você lembra das mulheres com deficiência? Tem considerado as mulheres mais velhas e não apenas as mais jovens? E as mulheres que são mães? Ou que querem ser mães? Ou que não querem ser?

E aquelas que querem começar uma nova carreira na área, que tipo de suporte e oportunidade elas tem recebido da sociedade, das comunidades e do mercado?

Já parou para pensar se a sua homenagem ao dia das mulheres e às mulheres da tecnologia inclui aquelas que são do norte ou nordeste do país? Ou de quaisquer outras regiões do Brasil e do mundo?

Você homenageia também, com as suas palavras e emoções, as mulheres que creem em religiões diferentes das suas? Culturas e verdades diferentes das suas? Você se lembra de todas as raças? Todas as cores? Todas as histórias e experiências diferentes das suas?

E as mulheres LGBTQIAP+? Também fazem parte de toda a compaixão que você demonstra todo dia 8 de março ou elas estão apenas nas suas piadas sexistas com aquele seu grupinho racista, machista e misógino?

Quando foi que você se lembrou, de verdade, das mulheres de baixa renda? As que sofrem com a miséria das mais diversas formas? As que sofrem constantes violências? E as mulheres que você chama de loucas só porque elas lutam para conquistarem algo que já deveria ser delas?

Muitas pessoas por aí perguntam o que fazer para solucionar "o problema da falta de diversidade nas empresas" e em tantos outros lugares na sociedade. Como mudar a diversidade se raramente conseguimos encontrar lugares nos quais realmente nos sentimos pertencentes? Como mudar a diversidade se nem mesmo a nossa vida é respeitada? Como mudar a diversidade se não fazemos o exercício de perceber quem está ao nosso lado?

Ainda temos raízes muito profundas para quebrar. E apenas um "feliz dia da mulher" não alimenta a diversidade. Apenas uma "vaga para mulheres na empresa" não é uma oportunidade saudável. Precisamos ir muito além como sociedade para que deixemos de ser vistas como nos veem hoje: ou somos um nada, ou somos alguém para servir de token para o seu falso papo de diversidade, ou somos alvo de todo tipo de violência.

Como já disse, ainda temos raízes muito profundas para quebrar. Que continuemos sendo todas loucas o suficiente para quebrarmos cada uma dessas raízes.

Como identificar se a automação está executando localmente ou no BotCity Orquestrador?

Morganna — Wed, 06 Mar 2024 20:31:41 +0000

A dúvida surgiu

Enquanto estávamos em nossa live coding desenvolvendo uma automação com Python e fazendo integração com e-mail e Google Sheets, surgiu uma dúvida:

Como identificar se a automação está executando localmente ou no BotCity Orquestrador?

Essa dúvida surgiu por causa da seguinte situação: quando estamos executando nossa automação localmente, ou seja, em nosso computador ou máquina virtual, e queremos conectá-la com o BotCity Orquestrador, precisamos utilizar o BotCity Maestro SDK para fazer login na plataforma. Mas quando fazemos deploy no Orquestrador, esse trecho de código para o login não precisa existir.

Exemplo prático

Criei um robô seguindo a documentação do framework web para exemplo. Abaixo temos o código principal:

# Import for the Web Bot
from botcity.web import WebBot, Browser, By

# Import for integration with BotCity Maestro SDK
from botcity.maestro import *

# Disable errors if we are not connected to Maestro
BotMaestroSDK.RAISE_NOT_CONNECTED = False


def main():
    # Runner passes the server url, the id of the task being executed,
    # the access token and the parameters that this task receives (when applicable).
    maestro = BotMaestroSDK.from_sys_args()
    ## Fetch the BotExecution with details from the task, including parameters
    execution = maestro.get_execution()

    print(f"Task ID is: {execution.task_id}")
    print(f"Task Parameters are: {execution.parameters}")

    bot = WebBot()

    # Configure whether or not to run on headless mode
    bot.headless = False

    # Uncomment to change the default Browser to Firefox
    # bot.browser = Browser.FIREFOX

    # Uncomment to set the WebDriver path
    # bot.driver_path = "<path to your WebDriver binary>"

    # Opens the BotCity website.
    bot.browse("https://www.botcity.dev")

    # Implement here your logic...
    ...

    # Wait 3 seconds before closing
    bot.wait(3000)

    # Finish and clean up the Web Browser
    # You MUST invoke the stop_browser to avoid
    # leaving instances of the webdriver open
    bot.stop_browser()

    # Uncomment to mark this task as finished on BotMaestro
    # maestro.finish_task(
    #     task_id=execution.task_id,
    #     status=AutomationTaskFinishStatus.SUCCESS,
    #     message="Task Finished OK."
    # )


def not_found(label):
    print(f"Element not found: {label}")


if __name__ == '__main__':
    main()

E assim fica o código do requirements.txt:

botcity-framework-web>=0.8.0,<1.0
botcity-maestro-sdk>=0.3.3,<1.0

O que eu fiz para poder executar esse código, foi descomentar a linha:

bot.browser = Browser.FIREFOX

E adicionar o geckodriver na configuração do WebDriver, deixando-o na pasta resources:

bot.driver_path = r"resources\geckodriver.exe"

Esse bot é apenas um exemplo e o que ele faz ao ser executado é abrir o navegador Firefox (poderia ter sido o Chrome, Edge, entre outros) com o site da BotCity e, depois de três segundos, fecha o navegador.

Conexão com BotCity Orquestrador

Se você precisar se conectar com a plataforma para orquestração, você precisará adicionar o seguinte código para fazer login no BotCity Orquestrador:

maestro.login(
    server='MAESTRO_SERVER', 
    login='MAESTRO_LOGIN', 
    key='MAESTRO_KEY'
)

Por serem dados sensíveis, uma saída para ocultar os dados é utilizando dotenv do Python e o OS. Para isso, basta importar da seguinte forma:

from dotenv import load_dotenv
import os

...

def main():
    load_dotenv()
    ...

E no arquivo requirements.txt precisa adicionar a biblioteca dotenv:

botcity-framework-web>=0.8.0,<1.0
botcity-maestro-sdk>=0.3.3,<1.0

python-dotenv

Além disso também é necessário termos um arquivo chamado .env, pois é de lá que o código buscará as informações. E esse arquivo ficará da seguinte forma:

MAESTRO_SERVER = "coloque o server aqui"
MAESTRO_LOGIN = "coloque o login aqui"
MAESTRO_KEY = "coloque a key aqui"

Essas informações ficam disponíveis em Dev. Environment, no BotCity Orquestrador.

OBS: É importante lembrar de não disponibilizar o .env ao versionar em plataformas como o GitHub, Gitlab, entre outras. Para facilitar, adicione .env ao arquivo .gitignore.

Qual a diferença entre o ambiente local e o orquestrador

Quando executamos nossa automação dentro do Orquestrador, uma tarefa é criada, atrelada a automação que fizemos o deploy, então por ele nós temos o ID da tarefa (ou task_id). Já no ambiente local, não temos essa informação.

Como validar em qual ambiente está sendo executado

Então podemos, por exemplo, fazer a seguinte validação: se task_id for igual a 0, estamos executando localmente e precisamos fazer o processo de login com o Orquestrador. Caso contrário, o task_id existe e, então, não precisamos fazer o login.

...
    maestro = BotMaestroSDK.from_sys_args()

    ## Fetch the BotExecution with details from the task, including parameters
    execution = maestro.get_execution()

    if(execution.task_id == 0):
        print("Running locally so we need to login to BotCity Orchestrator.")
        maestro.login(
            server=os.getenv('MAESTRO_SERVER'), 
            login=os.getenv('MAESTRO_LOGIN'), 
            key=os.getenv('MAESTRO_KEY')
        )
    else:
        print("Running with BotCity Orchestrator.")
...

Execução local

Ao testar a execução do robô localmente, percebemos que retorna a mensagem correta no terminal:

Execução no Orquestrador

Ao testar a execução do robô no Orquestrador, percebemos que retorna a mensagem correta no terminal:

Código completo

Caso queira validar como ficou o código principal completo, segue abaixo:

# Import for the Web Bot
from botcity.web import WebBot, Browser, By

# Import for integration with BotCity Maestro SDK
from botcity.maestro import *

from dotenv import load_dotenv
import os

# Disable errors if we are not connected to Maestro
BotMaestroSDK.RAISE_NOT_CONNECTED = False


def main():
    load_dotenv()

    # Runner passes the server url, the id of the task being executed,
    # the access token and the parameters that this task receives (when applicable).
    maestro = BotMaestroSDK.from_sys_args()

    ## Fetch the BotExecution with details from the task, including parameters
    execution = maestro.get_execution()

    if(execution.task_id == 0):
        print("Running locally so we need to login to BotCity Orchestrator.")
        maestro.login(
            server=os.getenv('MAESTRO_SERVER'), 
            login=os.getenv('MAESTRO_LOGIN'), 
            key=os.getenv('MAESTRO_KEY')
        )
    else:
        print("Running with BotCity Orchestrator.")

    bot = WebBot()

    # Configure whether or not to run on headless mode
    bot.headless = False

    # Uncomment to change the default Browser to Firefox
    bot.browser = Browser.FIREFOX

    # Uncomment to set the WebDriver path
    bot.driver_path = r"resources\geckodriver.exe"

    # Opens the BotCity website.
    bot.browse("https://www.botcity.dev")

    # Implement here your logic...
    ...

    # Wait 3 seconds before closing
    bot.wait(3000)

    # Finish and clean up the Web Browser
    # You MUST invoke the stop_browser to avoid
    # leaving instances of the webdriver open
    bot.stop_browser()

    # Uncomment to mark this task as finished on BotMaestro
    maestro.finish_task(
        task_id=execution.task_id,
        status=AutomationTaskFinishStatus.SUCCESS,
        message="Task Finished OK."
    )


def not_found(label):
    print(f"Element not found: {label}")


if __name__ == '__main__':
    main()

O que achou?

Espero que tenha curtido a dica e possa adaptá-la de acordo com a necessidade da sua execução. Qualquer dúvida, basta entrar em contato pela nossa comunidade.

DEV Community: Morganna

Quem é o destaque da comunidade?

Você sabe o quanto você evolui quando ajuda outra pessoa?

Como ajudar as pessoas a contribuirem com seu projeto Open Source

Tenha um README.md legal

Crie o CONTRIBUTING.md

Adicione issues

Disponibilize o CODE_OF_CONDUCT.md do projeto

Educação, Developer Relations e Inteligência Artificial

Como maximizar o uso da Inteligência Artificial com a engenharia de prompt

O que é Engenharia de Prompt

Como estruturar um prompt

Vamos continuar construindo prompts

Trilha de estudos para ser uma pessoa desenvolvedora Python RPA

🤖 Comece pela linguagem de programação Python

🤖 Desenvolva sua primeira automação Python

🤖 Segurança com Python RPA

🤖 Aprenda como fazer orquestração da sua automação Python

🤖 Desenvolva uma automação com um importante sistema do mercado

🤖 Pratique bastante e compartilhe sua evolução e seus aprendizados com a comunidade

O papel da pessoa desenvolvedora muito além do código

As mulheres que mudaram o rumo da tecnologia

morgannadev / mulherestecnologia

A ideia deste repositório é compartilhar sobre mulheres na tecnologia, mostrando que há muitas delas que transformaram e ainda transformam a área.

Mulheres no mundo da tecnologia 💻

[0] Ada Lovelace

[1] Grace Hopper

Dicas sobre desenvolvimento de automação com visão computacional

O que é visão computacional

Como usar a visão computacional para desenvolver automações

Dicas sobre como resolver problemas ao desenvolver com visão computacional

Elemento não encontrado

Resolução da tela

Sugestões para avaliar problemas

Já fez alguma automação com visão computacional?

Como identificar problemas de ambiente ao tentar instalar BotCity Studio SDK

Como executar o diagnóstico

Status dos resultados do diagnóstico

Como exportar o resultado dos testes

Ficou alguma dúvida?

Para quem é a sua homenagem para mulheres na tecnologia?

Como identificar se a automação está executando localmente ou no BotCity Orquestrador?

A dúvida surgiu

Exemplo prático

Conexão com BotCity Orquestrador

Qual a diferença entre o ambiente local e o orquestrador

Como validar em qual ambiente está sendo executado

Execução local

Execução no Orquestrador

Código completo

O que achou?

Tenha um `README.md` legal

Crie o `CONTRIBUTING.md`

Disponibilize o `CODE_OF_CONDUCT.md` do projeto