Laboratório: Triagem Justa de Currículos com Claude Agent SDK e Avaliação Automatizada

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

11

Validações

4

Versões da documentação consultada

Python 3.9 ou superior · Claude Agent SDK Python a versão estável atual · pip a versão estável atual

Topologia

Uma máquina local (192.168.56.10) executa o agente Claude via SDK Python, processando currículos em arquivos. O agente recebe os critérios e os currículos, aplica as regras e gera um relatório de triagem. Não há conexão externa obrigatória além da API da Anthropic.

+---------------------+
| Máquina Local       |
| (192.168.56.10)     |
|  - Claude Agent SDK |
|  - Currículos .txt  |
|  - Relatório .json  |
+---------------------+
         |
         | HTTPS (API Anthropic)
         v
+----------------------+
| Claude API           |
| (api.anthropic.com)  |
+----------------------+

Equipamentos e software

Roteiro

1. Preparar ambiente Python isolado

   Isolar dependências evita conflitos e facilita a limpeza depois. Use venv.

   python3 -m venv venv
   source venv/bin/activateCopiar

   O que você deve ver: Prompt do terminal muda para indicar ambiente virtual ativo.

2. Instalar Claude Agent SDK

   O SDK oficial conecta seu código à API e implementa o laço de agente.

   pip install claude-agent-sdk-pythonCopiar

   O que você deve ver: Mensagem de sucesso do pip, pacote instalado.

3. Obter chave de API Anthropic

   A chave é obrigatória para autenticar o agente. Guarde em variável de ambiente.

   export ANTHROPIC_API_KEY='SUA_CHAVE_AQUI'Copiar

   O que você deve ver: Nenhuma saída (variável definida).

4. Criar diretório do projeto e arquivos de dados

   Organize os arquivos: currículos fictícios, critérios e saída.

   mkdir triagem_rh
   cd triagem_rh
   echo 'João Silva
   Formação: Engenharia
   Experiência: 3 anos
   Certificação: EXEMPLO
   ' > cv1.txt
   echo 'Maria Souza
   Formação: Administração
   Experiência: 5 anos
   ' > cv2.txtCopiar

   O que você deve ver: Dois arquivos cv1.txt e cv2.txt criados com dados de exemplo.

5. Definir critérios auditáveis de triagem

   Critérios claros garantem justiça e transparência. Use um arquivo YAML.

   echo 'criterios:
     - nome: Formação em Engenharia
       regra: O currículo deve citar formação em Engenharia
     - nome: Experiência mínima
       regra: O currículo deve citar pelo menos 3 anos de experiência
   ' > criterios.yamlCopiar

   O que você deve ver: Arquivo criterios.yaml criado com critérios de exemplo.

6. Criar prompt de sistema versionado para o agente

   O prompt define o comportamento do agente e deve ser versionado.

   echo 'Você é um agente de RH. Para cada currículo recebido, avalie se atende aos critérios abaixo. Para cada critério, responda "Atende" ou "Não atende" e justifique com base no texto do currículo. Nunca invente informações. Registre tudo em JSON. Critérios: [Formação em Engenharia, Experiência mínima de 3 anos].' > prompt_v1.txtCopiar

   O que você deve ver: Arquivo prompt_v1.txt criado com instruções claras.

7. Implementar script Python para rodar o agente

   O script lê currículos e critérios, monta a entrada e chama o Claude Agent SDK.

   cat > triagem.py <<'EOF'
   import os
   from claude_agent_sdk import ClaudeAgent, ClaudeAgentConfig
   import yaml
   import json
   
   def carregar_criterios(path):
       with open(path) as f:
           return yaml.safe_load(f)['criterios']
   
   def carregar_cv(path):
       with open(path) as f:
           return f.read()
   
   def main():
       criterios = carregar_criterios('criterios.yaml')
       cvs = ['cv1.txt', 'cv2.txt']
       resultados = []
       with open('prompt_v1.txt') as f:
           prompt = f.read()
       agent = ClaudeAgent(ClaudeAgentConfig(api_key=os.environ['ANTHROPIC_API_KEY'], system_prompt=prompt))
       for cv in cvs:
           entrada = f'Currículo:\n{carregar_cv(cv)}\nCritérios:\n{json.dumps(criterios, ensure_ascii=False)}'
           resposta = agent.run(entrada)
           resultados.append({'cv': cv, 'resposta': resposta})
       with open('relatorio.json', 'w') as f:
           json.dump(resultados, f, ensure_ascii=False, indent=2)
   if __name__ == '__main__':
       main()
   EOFCopiar

   O que você deve ver: Arquivo triagem.py criado com código funcional.

8. Executar o agente de triagem

   Rode o script e aguarde o processamento dos currículos.

   python triagem.pyCopiar

   O que você deve ver: Arquivo relatorio.json gerado com os resultados da triagem.

9. Inspecionar relatório de triagem

   Confira se as respostas do agente estão estruturadas e justificadas.

   cat relatorio.jsonCopiar

   O que você deve ver: JSON com cada currículo, critérios avaliados e justificativas.

10. Implementar avaliação automatizada dos resultados

    Garanta que o agente seguiu os critérios: crie um script de teste.

    cat > teste_avaliacao.py <<'EOF'
    import json
    with open('relatorio.json') as f:
        dados = json.load(f)
    for item in dados:
        print(f'CV: {item["cv"]}')
        if 'Formação em Engenharia' in item['resposta']:
            print('Critério Formação presente')
        else:
            print('FALHA: critério Formação ausente')
    EOFCopiar

    O que você deve ver: Arquivo teste_avaliacao.py criado para checagem básica.

11. Rodar avaliação automatizada

    Execute o script e veja se os critérios foram aplicados corretamente.

    python teste_avaliacao.pyCopiar

    O que você deve ver: Saída indicando se cada critério foi avaliado para cada currículo.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Nunca inclua dados pessoais reais nos arquivos de teste
• Guarde a chave de API apenas em variáveis de ambiente, nunca em arquivos de código
• Restrinja permissões dos arquivos de dados e relatórios
• Desative e remova a chave de API após o laboratório

Checklist final

• Ambiente virtual Python criado e ativado
• Claude Agent SDK instalado
• Chave de API definida em variável de ambiente
• Currículos e critérios criados
• Prompt versionado salvo
• Script de triagem executado com sucesso
• Relatório JSON gerado e validado
• Avaliação automatizada rodando