preparar_pesquisa
Prepara uma pesquisa de fan-out ISOLADO por persona (mede sem convergência). A PERGUNTA do usuário NÃO é enviada ao servidor (privacidade): você a classifica localmente pela 'fronteira' e a injeta você mesmo em cada pacote. Sorteia N personas e devolve UM pacote por persona (ficha + formato de resposta) + o protocolo para o HOST disparar UMA tarefa/subagente isolado por pacote — cada um responde só a SUA persona, sem ver as outras. A agregação é feita LOCALMENTE; o servidor não recebe nem armazena nenhuma resposta. Formatos: 'escolha' (opção única → distribuição), 'pontuar' (nota 0-10 por atributo → média+desvio por opção, recomendado para 'o que importa mais' e mais robusto a colapso), 'escala' e 'aberta'. Pode filtrar o segmento (classe, idade, região, etc.) pela DSL.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | Quantas personas sortear (teto 30, para proteger a base e o custo de tokens do host). | |
| seed | No | Opcional. Por padrão o sorteio é ALEATÓRIO e o seed usado é devolvido no resultado — salve-o para reproduzir a MESMA amostra depois. Passe um número só se quiser repetir uma amostra específica. | |
| filtro | No | Filtro DSL do segmento — recorta por classe, idade, região, banco, dívida, etc. Ex.: "classe_social in ['Classe A'; 'Classe B'] & idade > 30 & se_investe == 'Sim'". Vazio = população toda. | |
| opcoes | No | Opções fechadas quando formato='escolha' ou 'pontuar'. Ex.: ['Versão A', 'Versão B'] | |
| formato | No | escolha=opção única fechada (gera distribuição, mas pode colapsar em amostra enviesada); pontuar=cada persona dá nota 0-10 a CADA opção (gera média+desvio por opção, preserva a preferência secundária — recomendado para 'o que importa mais'); escala=uma nota numérica; aberta=sem número, só temas/verbatim. | escolha |
| escala_max | No | Máximo da escala quando formato='escala' (ex.: 5). | |
| escala_min | No | Mínimo da escala quando formato='escala' (ex.: 1). |