Agente de IA para Análise de Resultados de Experimentos

Ler arquivos CSV de experimentos, inferir a estrutura do conjunto de dados e mapear o delineamento experimental para orientar as etapas seguintes.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de um ou mais arquivos CSV de dados experimentais via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload dos arquivos na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um ou mais arquivos CSV contendo dados brutos de experimentos laboratoriais.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a lista de variáveis, tipo inferido por variável, possíveis papéis, unidades se detectáveis, tokens de ausentes detectados, delimitador, separador decimal, chaves de repetição e delineamento sugerido.
• Exemplo de Estrutura de Output:

   {
    "variaveis": ["tempo", "grupo", "sujeito_id", "medida"],
    "tipos": {"tempo": "data/hora", "grupo": "categórica", "sujeito_id": "identificador", "medida": "numérica"},
    "papeis": {"tempo": "tempo", "grupo": "independente", "sujeito_id": "identificador", "medida": "dependente"},
    "unidades": {"medida": "mg"},
    "tokens_ausentes": ["", "NA", "null"],
    "delimitador": ",",
    "separador_decimal": ".",
    "chaves_repeticao": ["sujeito_id", "tempo"],
    "delineamento": "intra-sujeitos"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho em torno de 2.500 caracteres, dependendo da complexidade dos dados experimentais.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Validação e Padronização dos Dados (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Validação e Padronização dos Dados (RF 2).

Validar consistência, padronizar formatos e preparar um dataset analítico sem alterar o significado dos dados.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber o JSON de esquema e delineamento, além dos dados brutos em CSV.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json e .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 100.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote contendo o dataset padronizado em texto/markdown, relatório de qualidade com porcentagem de ausentes, categorias raras, duplicatas potenciais, checagens de faixa plausível, unidades harmonizadas e lista de transformações aplicadas.
• Exemplo de Estrutura de Output:

   {
    "dataset_padronizado": "...",
    "relatorio_qualidade": {
      "ausentes_porcentagem": {"tempo": 0, "grupo": 0, "sujeito_id": 0, "medida": 5},
      "categorias_raras": {"grupo": ["controle"]},
      "duplicatas": {"sujeito_id+tempo": 0},
      "outliers": {"medida": 3}
    },
    "transformacoes": ["Datas padronizadas para ISO", "Unidade de medida padronizada para mg"]
  } 

• Número de caracteres esperado: O pacote gerado deve ter um tamanho em torno de 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculos de verificação de qualidade dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Estatística Descritiva e Sumários Visuais (RF 3).

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Estatística Descritiva e Sumários Visuais (RF 3).

Produzir estatísticas descritivas e um plano de visualizações para sustentar análise de tendências.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber o dataset padronizado e o esquema/delineamento dos dados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json e .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 100.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um markdown contendo tabelas de descritivos por variável dependente, matriz de correlação para variáveis numéricas, tabelas de frequência para categóricas e lista de gráficos recomendados.
• Exemplo de Estrutura de Output:

   {
    "estatisticas_descritivas": "...",
    "matriz_correlacao": "...",
    "tabelas_frequencia": "...",
    "graficos_recomendados": ["linha: x=tempo, y=média de resposta, cor=grupo, erro=IC95%"]
  } 

• Número de caracteres esperado: O markdown gerado deve ter um tamanho em torno de 5.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculos estatísticos.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Detecção de Padrões e Tendências (RF 4).

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Padrões e Tendências (RF 4).

Identificar tendências temporais, diferenças entre grupos e relações dose–resposta, quantificando intensidade e robustez.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber descritivos, plano visual e dataset padronizado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json e .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 100.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com candidatos a padrões e uma seção textual resumida com bullets sobre tendências temporais, diferenças entre grupos e associações.
• Exemplo de Estrutura de Output:

   {
    "padroes": ["tendencia_temporal", "diferenca_grupos"],
    "resumo": "..."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho em torno de 3.500 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculos estatísticos.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Insights para Discussão em Sala (RF 5).

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights para Discussão em Sala (RF 5).

Converter padrões identificados em insights pedagógicos claros e acionáveis para discussão em sala.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber o JSON de padrões e tendências, contexto do experimento e descritivos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um markdown estruturado com resumo executivo, principais achados, perguntas norteadoras, limitações e suposições, próximos passos e glossário.
• Exemplo de Estrutura de Output:

   {
    "resumo_executivo": "...",
    "principais_achados": ["Tendência temporal identificada..."],
    "perguntas_norteadoras": ["O que poderia explicar a diferença observada entre os grupos?"],
    "limitacoes": ["Dados ausentes em proporção significativa..."],
    "proximos_passos": ["Aumentar o tamanho da amostra..."],
    "glossario": {"rho": "Coeficiente de correlação de Spearman..."}
  } 

• Número de caracteres esperado: O markdown gerado deve ter um tamanho em torno de 4.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Empacotamento e Entrega do Resultado (RF 6).

5.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Empacotamento e Entrega do Resultado (RF 6).

Consolidar todos os outputs em um artefato único em Markdown, garantindo rastreabilidade entre achados e evidências.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber descritivos, padrões e insights.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um documento final em Markdown contendo sumário, contexto, metodologia, descritivos, padrões, insights e anexo técnico.
• Exemplo de Estrutura de Output:

   {
    "sumario": "...",
    "contexto": "...",
    "metodologia": "...",
    "descritivos": "...",
    "padroes": "...",
    "insights": "...",
    "anexo_tecnico": "..."
  } 

• Número de caracteres esperado: O documento gerado deve ter um tamanho em torno de 8.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

6.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

6.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. O documento gerado é o resultado que deve ser disponibilizado ao usuário.