
Agente de Contratação com IA: Usando Notion como uma Torre de Controle de IA
Todo recrutador com quem conversei diz a mesma coisa: "Estamos afogados em aplicações." Centenas de currículos chegam para uma única vaga. A maioria é analisada em 6 segundos. Ótimos candidatos escorregam pelas fendas. O processo é lento, tendencioso e fundamentalmente quebrado.
Então, eu construí um agente de IA que resolve isso — e eu lhe dei um cérebro alimentado por Groq e um centro de comando alimentado por Notion.
O Que Eu Construí
Agente de Contratação de IA é um sistema de recrutamento autônomo que transforma um banco de dados do Notion em uma torre de controle de IA ao vivo para contratações. Sem painéis para construir. Sem novas ferramentas para aprender. Sua equipe já vive no Notion — agora sua IA também vive lá.
A ideia central é a seguinte: você insere um candidato em uma tabela do Notion com seu nome, habilidades, experiência e a vaga para a qual se candidatou. É isso. O agente o pega automaticamente, envia seu perfil para um grande modelo de linguagem (LLaMA 3.3 70B via Groq) e, em segundos, escreve de volta uma pontuação de adequação (0–100), cinco perguntas de entrevista personalizadas e uma recomendação de contratação/rejeição com justificativa — tudo diretamente na mesma linha do Notion. O status do candidato muda de Pendente para Avaliado sem um único clique humano.
Isso não é um chatbot. Não é um processador de formulários. É um agente persistente de monitoramento que observa seu pipeline de contratações 24/7 e age no momento em que novos candidatos aparecem. Pense nisso como um recrutador sênior que nunca dorme, nunca tem um dia de folga e avalia cada candidato com os mesmos critérios rigorosos.
O Problema Que Resolve
A contratação tradicional está quebrada de três maneiras específicas:
1. O volume mata a qualidade. Uma única vaga publicada no LinkedIn pode gerar de 200 a 500 aplicações. Os recrutadores fisicamente não conseguem dar a cada uma a atenção que merece. O resultado? Correspondência de padrões em nomes de marcas e escaneamento de palavras-chave — não uma avaliação real.
2. A inconsistência é a norma. O primeiro currículo revisado na segunda-feira de manhã recebe um nível diferente de escrutínio do que o 80º revisado na sexta-feira à tarde. A fadiga humana introduz um viés invisível que nenhuma sessão de treinamento pode eliminar completamente.
3. A velocidade importa e as equipes são lentas. Os melhores candidatos têm um prazo de validade de cerca de 10 dias antes de aceitarem outra oferta. A maioria das empresas leva de 3 a 6 semanas para passar da aplicação à primeira entrevista. As melhores pessoas já se foram antes mesmo de você abrir seu currículo.
O Agente de Contratação de IA ataca todos os três problemas simultaneamente. Cada candidato recebe a mesma profundidade de análise. As avaliações acontecem em segundos, não em dias. E como o agente opera continuamente, não há atraso entre a aparição de um candidato e sua avaliação.
Demonstração
Assista ao walkthrough completo — desde a inserção do candidato até a avaliação impulsionada por IA, tudo acontecendo ao vivo dentro do Notion.
Como o Notion MCP É o Núcleo
Esta é a parte que quero enfatizar: O Notion não é apenas o banco de dados aqui. É todo o plano de controle.
Na maioria dos projetos de IA, você construiria um frontend separado, conectaria uma API REST, projetaria um painel e adicionaria um banco de dados. Isso leva semanas de trabalho antes mesmo de você chegar à lógica da IA. Com o Notion como a camada do Modelo Contextual de Protocolo (MCP), eu colapsei tudo isso em uma única superfície.
O Notion serve como:
- A camada de entrada — recrutadores adicionam candidatos diretamente onde já trabalham
-
O gatilho de processamento — o status
Pendenteatua como uma fila de trabalho - A camada de saída — pontuações, perguntas e recomendações aparecem na mesma linha
- O registro de auditoria — cada avaliação é carimbada com data e visível para toda a equipe
- A sobreposição humana — gerentes podem revisar decisões da IA e alterar status manualmente
O agente não possui os dados. O Notion possui. O agente não possui o fluxo de trabalho. Sua equipe possui. A IA é um participante em um sistema controlado por humanos, não uma caixa preta tomando decisões em isolamento. Esse é o poder de usar o Notion como uma torre de controle — total transparência, zero troca de contexto.
Arquitetura
┌─────────────────┐ poll every 60s ┌───────────────────┐
│ Notion DB │ ◄─────────────────── │ Agente de Contratação de IA │
│ (Candidatos) │ ──────────────────► │ (Python) │
└─────────────────┘ read Pending / └─────────┬─────────┘
write Score, │
Questions, │ analyze
Recommendation, │ candidate
Status ▼
┌─────────────────┐
│ Groq API │
│ (LLaMA 3.3 70B) │
└─────────────────┘
Sem filas. Sem middleware. Sem infraestrutura para manter. Apenas um script Python, duas APIs e um banco de dados Notion fazendo o trabalho pesado.
Como Funciona — Passo a Passo
Passo 1: Entrada do Candidato
Um recrutador (ou o script incluído sample_candidates.py) adiciona uma nova linha ao banco de dados do Notion com o nome do candidato, habilidades, anos de experiência e função alvo. O status é definido como Pendente.
Passo 2: O Agente Faz Polling
O agente consulta a API do Notion a cada 60 segundos, filtrando todas as linhas onde Status = Pendente. Se nenhuma for encontrada, ele dorme e verifica novamente.
Passo 3: Análise LLM
O perfil de cada candidato pendente é empacotado em um prompt estruturado e enviado para a API da Groq executando LLaMA 3.3 70B. O modelo é instruído a retornar JSON estrito com uma pontuação, justificativa, cinco perguntas de entrevista e uma recomendação de contratação/rejeição.
Passo 4: Resultados Escritos de Volta
O agente analisa a resposta do LLM e escreve a pontuação, perguntas de entrevista e recomendação diretamente na linha do candidato no Notion via API do Notion.
Passo 5: Atualização de Status
O status do candidato é alterado de Pendente para Avaliado. O agente passa para o próximo candidato. O recrutador vê os resultados na próxima vez que olhar para a tabela.
Pilha Tecnológica
| Tecnologia | Papel |
|---|---|
| Python 3.12 | Tempo de execução do agente principal |
| API do Notion | Operações de banco de dados — ler candidatos, escrever avaliações |
| API do Groq | Inferência LLM (LLaMA 3.3 70B Versátil) |
| python-dotenv | Gerenciamento seguro de variáveis de ambiente |
| requests | Cliente HTTP para comunicação com a API do Notion |
Principais Recursos
- Polling autônomo — funciona 24/7, capta novos candidatos automaticamente
- Avaliação de IA estruturada — pontuação, justificativa, perguntas de entrevista e recomendação em JSON estrito
- Integração direta com o Notion — sem painéis externos, sem troca de contexto
- Pontuação transparente — cada decisão inclui justificativa escrita
- Análise ciente do papel — o LLM avalia candidatos em relação à função específica para a qual se candidataram
- Processamento em lote —
O uso de um agente de IA para recrutamento pode revolucionar o processo de seleção de candidatos no Brasil, permitindo que empresas lidem com grandes volumes de aplicações de forma eficiente. Isso pode resultar em contratações mais rápidas e justas, melhorando a qualidade das equipes.

