Agente de IA para Geração de Relatórios de Inclusão Escolar

Receber dados brutos (texto ou planilha) sobre práticas de inclusão escolar e produzir um dataset único, padronizado e validado em JSON para consumo analítico.

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 dados brutos via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Dados estruturados ou semiestruturados em texto ou planilha convertida em texto.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .csv, .txt.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON padronizado contendo metadados de coleta, registros por escola e período, indicadores derivados e benchmarks internos.
• Exemplo de Estrutura de Output:

   {
    "metadata_coleta": { "data": "2025-12-13" },
    "registros": [
      {
        "escola_id": "123",
        "escola_nome": "Escola Exemplo",
        "periodo_referencia": "2025-11",
        "alunos_paee_total": 50,
        "alunos_atendidos_aee": 45,
        "indicadores": {
          "cobertura_aee_percentual": 90.0
        }
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.000 caracteres, dependendo da quantidade de dados processados.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

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

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 Gerador de Relatório de Inclusão Escolar (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente Gerador de Relatório de Inclusão Escolar (RF 2).

Produzir um relatório claro e acionável, destacando áreas de sucesso e oportunidades de melhoria, com priorização e metas monitoráveis.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON padronizado e validado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown, estruturado em seções claras e concisas, com um plano de acompanhamento em JSON.
• Exemplo de Estrutura de Output:

   **Sumário Executivo:**
  - Área de sucesso: A escola Exemplo teve uma cobertura AEE de 90%.
  - Oportunidade de melhoria: A taxa de evasão está acima da média.
  
  **Prioridades e Roadmap:**
  - Implementar treinamentos adicionais para docentes.
  - Melhorar a infraestrutura de acessibilidade.
  
  **Plano de Acompanhamento:**
  - KPI: Cobertura AEE
  - Meta: Atingir 95% em 12 meses
  - Responsável: Coordenação Pedagógica 

• Número de caracteres esperado: O relatório em markdown deve ter um tamanho estimado em 8.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.
• Calculadora: Não utiliza.
• 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 é o entregável final e não é passada para outros agentes internos.

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

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