← Todos os projetosAll projects

Individual · Rodando toda semanaSolo · Runs weekly

Gupy Orchestrator

Automação que lê as vagas da Gupy toda semana e me manda no WhatsApp só o que é novo e faz sentido para mim.An automation that reads Gupy’s job listings every week and sends me, over WhatsApp, only what is new and actually makes sense for me.

O problemaThe problem

Eu abria a Gupy todo dia e lia descrição de vaga até o fim. O custo não era o número de vagas, era o que estava enterrado no último parágrafo. Várias vagas que pareciam certas pediam formação até 2027. Eu concluo em 2029.

Então o trabalho real era descartar. Eu lia a vaga inteira, achava o requisito que me eliminava e fechava a aba. Repetia isso de manhã, todo dia, antes de encontrar alguma coisa para a qual valia a pena me candidatar.

I opened Gupy every day and read job descriptions to the end. The cost wasn’t the number of postings, it was what sat buried in the last paragraph. Several jobs that looked right asked for a degree completed by 2027. I graduate in 2029.

So the real work was ruling things out. I’d read a whole posting, find the requirement that disqualified me, and close the tab. Same thing every morning, before finding anything actually worth applying to.

Como funcionaHow it works

Um prompt orquestrador roda no OpenBot e faz três buscas no conector de candidatos da Gupy, não uma. A primeira pede estágio remoto no país inteiro (jobTypes=vacancy_type_internship, workplaceTypes=remote, limit=100, ordenado por data de publicação) e filtra tech depois, no texto. A segunda pede todo estágio em Alagoas, de qualquer área, porque vaga de tech local às vezes está anunciada fora da categoria. A terceira abre mão do recorte de estágio e pede remoto ou híbrido em Alagoas, para alcançar vaga júnior efetiva. As três passam por search_jobs, com get_job_by_id e list_companies para completar o que a listagem não traz.

O que sobra vai para a leitura, com a descrição aberta, o PDF do meu currículo e a minha lista de lacunas declaradas (Power BI, scikit-learn, Excel avançado). O orquestrador procura cinco coisas que costumam estar no fim do texto: curso exigido, período mínimo, ano de conclusão, exigência de morar em outra cidade (existe vaga anunciada como remota que pede residência local) e critério afirmativo restrito, que ele sinaliza sem presumir que eu me enquadro. Com isso separa requisito excludente de requisito desejável e escreve um parágrafo com o encaixe e o gap.

Uma vez por semana sai um relatório pelo WhatsApp Orchestrator: número de vagas novas, tabela com vaga, empresa, modalidade, prazo e link, um parágrafo por vaga e os prazos urgentes no fim, tudo formatado para leitura no celular. Se o conector não responder, o orquestrador avisa em uma linha e busca na web em vez de parar.

An orchestrator prompt runs on OpenBot and makes three searches against Gupy’s candidate connector, not one. The first asks for remote internships nationwide (jobTypes=vacancy_type_internship, workplaceTypes=remote, limit=100, sorted by publication date) and filters for tech afterwards, in the text. The second asks for every internship in Alagoas, any field, because a local tech job is sometimes posted outside the category. The third drops the internship filter and asks for remote or hybrid roles in Alagoas, to reach junior positions. All three go through search_jobs, with get_job_by_id and list_companies filling in what the listing leaves out.

What survives goes to the reading step, with the full description, the PDF of my résumé and my own list of gaps (Power BI, scikit-learn, advanced Excel). The orchestrator looks for five things that tend to sit at the end of the text: required degree, minimum semester, graduation year, a requirement to live in another city (there are postings listed as remote that still ask for local residency), and restricted affirmative-action criteria, which it flags without assuming I qualify. From that it separates disqualifying requirements from nice-to-haves and writes a paragraph covering both the fit and the gap.

Once a week a report goes out over WhatsApp Orchestrator: how many new jobs there are, a table with role, company, work model, deadline and link, a paragraph per job, and the urgent deadlines at the end, all formatted to be read on a phone. If the connector doesn’t answer, the orchestrator says so in one line and searches the web instead of stopping.

A decisão de engenharia mais interessanteThe engineering decision worth talking about

A parte difícil não foi código, foi escrever o critério de avaliação. A descrição de vaga não marca o que é excludente. "Formação até 2027" e "desejável conhecimento em Power BI" aparecem na mesma lista, com a mesma formatação, às vezes no mesmo parágrafo. Se o orquestrador tratar os dois do mesmo jeito, ele erra para os dois lados: ou me manda vaga que eu não posso pegar, ou corta vaga boa por causa de uma ferramenta que eu aprendo em uma semana. O que eu tive que definir foi o que torna um requisito inegociável, e isso é uma regra minha, não um campo que vem da API.

O segundo ponto é o estado. O orquestrador mantém um registro das vagas já enviadas, com ID e prazo, e a regra é nunca reenviar um ID que já saiu. Sem isso, um relatório semanal me mandaria de volta tudo que continua aberto, e eu pararia de abrir o relatório. A exceção é o prazo: numa semana sem vaga nova, ele repete só as que fecham em até sete dias, porque aí o que mudou não foi a vaga, foi quanto tempo me resta.

O ganho principal não foi tempo de leitura. Foi consistência: a automação não pula uma semana porque eu tinha prova.

The hard part wasn’t the code, it was writing the evaluation criteria. A job description doesn’t label which requirements are disqualifying. "Degree completed by 2027" and "Power BI experience a plus" show up in the same list, in the same formatting, sometimes in the same paragraph. If the orchestrator treats them alike, it fails in both directions: it either sends me a job I can’t take, or drops a good one over a tool I could learn in a week. What I had to define was what makes a requirement non-negotiable, and that’s a rule of mine, not a field the API hands me.

The second piece is state. The orchestrator keeps a record of the jobs it has already sent, with ID and deadline, and the rule is never to resend an ID that has gone out. Without that, a weekly report would hand me back everything still open, and I’d stop opening the report. The exception is the deadline: in a week with no new jobs, it repeats only the ones closing within seven days, because what changed there isn’t the posting, it’s how much time I have left.

The main gain wasn’t reading time. It was consistency: the automation doesn’t skip a week because I had an exam.

LimitaçõesLimitations

Não tem demo pública. O sistema depende do PDF do meu currículo e do meu WhatsApp, e os dois são meus.

A avaliação de fit é feita por LLM, então não é determinística. A mesma vaga pode receber análises com palavras diferentes em execuções diferentes, e a classificação de um requisito ambíguo pode variar. O prompt proíbe inventar vaga, link, prazo ou faixa salarial, e só autoriza o jobUrl que o conector devolveu, mas isso é uma restrição escrita, não uma garantia de execução.

Os conectores da Gupy são a única fonte do fluxo normal. Vaga que não está na Gupy só aparece quando o conector falha e o orquestrador cai na busca web, que é o caminho de exceção e não tem a mesma cobertura.

There’s no public demo. The system runs on the PDF of my résumé and my WhatsApp number, and both are mine.

Fit is assessed by an LLM, so it isn’t deterministic. The same job can come back worded differently on different runs, and an ambiguous requirement can be classified differently. The prompt forbids inventing a job, a link, a deadline or a salary range, and only allows the jobUrl the connector returned, but that’s a written constraint, not a guarantee at runtime.

Gupy’s connectors are the only source on the normal path. A job that isn’t on Gupy shows up only when the connector fails and the orchestrator falls back to a web search, which is the exception route and doesn’t have the same coverage.

Fale comigoGet in touch

Posso mostrar o critério de avaliação em detalhe, ou falar sobre uma vaga que você esteja abrindo. Mensagem no LinkedIn ou e-mail, os dois chegam em mim.

I can walk you through the evaluation criteria in detail, or talk about a role you’re hiring for. A LinkedIn message or an email, both reach me.

Próximo projetoNext project

Sistema-Gado →

Sistema de gestão para a fazenda da minha família, do peso de cada animal ao caixa do mês.A management system for my family’s farm, from each animal’s weight to the month’s cash flow.

Vamos conversarLet’s talk

Estou procurando estágio em desenvolvimento, remoto ou presencial em Maceió. Se quiser falar sobre este projeto ou sobre uma vaga, é só escrever.I’m looking for a development internship, remote or on-site in Maceió. If you want to talk about this project or about a role, just write.