Agente de IA para Relatórios de Progresso Pedagógico

Preparar o payload padronizado para buscar dados de engajamento e aprendizagem no sistema LMS.

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 objeto JSON 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Objeto JSON com as chaves necessárias para configurar uma chamada à API do LMS.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o payload padronizado para a chamada à API do LMS.
• Exemplo de Estrutura de Output:

   {"route": "/lms/analytics/batch", "method": "POST", "headers": {"Authorization": "Bearer {{auth_token}}"}, "query": {}, "body": {"institution": "nome_ou_id", "course_ids": ["id_curso_1", "id_curso_2"], "class_ids": ["id_turma_1"], "student_ids": ["id_aluno_1", "id_aluno_2"], "date_range": {"start": "AAAA-MM-DD", "end": "AAAA-MM-DD"}, "metrics": ["logins", "submissions", "forum_posts", "grades"]}} 

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

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 Execução de Chamada à API - LMS (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - LMS (RF 2).

Realizar chamada à API do Sistema LMS para obter dados de engajamento e aprendizagem conforme payload preparado.

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: Payload JSON já pronto no formato para execução da chamada à API do LMS.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: Dados brutos JSON retornados pelo LMS contendo séries temporais e registros por aluno/atividade.
• Exemplo de Estrutura de Output:

   {"data": [{"aluno_id": "...", "atividade": "...", "logins": 5, "submissions": 3, "forum_posts": 2, "grades": 85}]} 

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

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API do LMS e retornar os dados recebidos como resposta.

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 Tratamento de Dados do LMS (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Tratamento de Dados do LMS (RF 3).

Padronizar e limpar o retorno bruto do LMS, gerando um JSON estruturado por aluno, turma e período, pronto para consolidação com outras fontes.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
• Tipo do input: JSON bruto retornado do LMS com registros de engajamento e aprendizagem por aluno e atividade.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: JSON estruturado por aluno, turma e período, pronto para consolidação com outras fontes.
• Exemplo de Estrutura de Output:

   {"fonte": "LMS", "periodo": {"inicio": "AAAA-MM-DD", "fim": "AAAA-MM-DD"}, "itens": [{"id_aluno": "...", "id_turma": "...", "kpis": {"acessos_total": 0, "dias_ativos": 0, "tarefas_entregues": 0, "tarefas_atraso": 0, "posts_forum": 0, "media_notas": 0.0}, "series": {"acessos_diario": [{"data": "AAAA-MM-DD", "qtd": 0}], "submissoes": [{"atividade": "id", "data": "AAAA-MM-DD", "status": "on_time|late", "nota": 0.0, "peso": 1.0}]}}]} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.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.
• Calculadora: Utiliza lógica interna para calcular dias_ativos e media_notas.
• 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 Preparador de Chamada à API - Sistema Acadêmico (SIS) (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Preparador de Chamada à API - Sistema Acadêmico (SIS) (RF 4).