composiohq/selecionador-de-vencedores-de-sorteio

O que selecionador-de-vencedores-de-sorteio faz?

Seleciona vencedores aleatórios de listas, planilhas ou Google Sheets para brindes, sorteios e concursos. Garante seleção justa e imparcial com transparência.

Visão Geral

Esta skill permite que você escolha vencedores de forma aleatória a partir de uma lista de participantes, seja ela fornecida como texto, arquivo CSV, ou diretamente de uma planilha do Google Sheets. O processo é totalmente auditável e garante que cada participante tenha chances iguais.

Funcionalidades

• Múltiplas fontes de entrada: aceita listas em texto simples, arquivos CSV ou conexão direta com Google Sheets.
• Número configurável de vencedores: defina quantos vencedores deseja selecionar.
• Seleção sem reposição: cada participante só pode ser sorteado uma vez.
• Semente aleatória determinística: opção para usar uma semente fixa, permitindo reproduzir resultados para auditoria.
• Exclusão de duplicatas: remove automaticamente entradas repetidas da lista.
• Logs de transparência: registra o processo e a semente utilizada para verificação posterior.

Como Usar

1. Configurar a skill no ambiente Composio (Claude Code ou outros agentes compatíveis).
2. Fornecer os dados dos participantes, seja como:
   • Uma lista de texto delimitada por quebras de linha.
   • Um arquivo CSV ou Excel.
   • Uma planilha do Google Sheets (autenticação necessária).
3. Definir parâmetros:
   • num_winners: número de vencedores (padrão: 1).
   • seed (opcional): semente para o gerador aleatório.
   • remove_duplicates: booleano para remover entradas repetidas.
4. Executar a ação. A skill retornará os nomes ou identificadores dos vencedores.

Exemplo de comando:

composio run composiohq/raffle-winner-picker \
  --input "data/participantes.csv" \
  --params '{"num_winners": 3, "seed": 42, "remove_duplicates": true}'

Integração com Google Sheets

Para usar o Google Sheets como fonte de dados:

1. Conecte sua conta do Google via Composio (necessita permissão de leitura).
2. Especifique o sheet_id e o intervalo (ex.: A2:A100).
3. A skill lê os valores da coluna e aplica o sorteio.

Exemplo:

source:
  type: google_sheets
  sheet_id: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  range: "Sheet1!A2:A100"

Transparência e Fairness

• O algoritmo usa o gerador aleatório criptograficamente seguro do sistema operacional quando nenhuma semente é fornecida.
• Se uma semente for fornecida, o gerador Mersenne Twister é utilizado, e a semente é registrada nos logs para auditoria.
• A ordem de sorteio é embaralhada usando o algoritmo Fisher-Yates.

Limitações

• A lista de participantes deve conter menos de 100.000 entradas para garantir performance.
• Para Google Sheets, a planilha deve estar compartilhada com o e-mail da conta de serviço do Composio.

Suporte

Para dúvidas ou problemas, consulte a documentação oficial do Composio ou abra uma issue no repositório.