Agente de IA para Acompanhamento de Desempenho de Estagiários

Definir o esquema de dados unificado e o plano de coleta por fonte, períodos e filtros, produzindo parâmetros prontos para execução de coleta.

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 uma lista de fontes de dados e metadados 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: O input inicial para o fluxo é uma lista de fontes de dados e seus metadados.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo: schema_unificado, mapeamentos_por_fonte, parametros_de_coleta_por_fonte, regras_de_normalizacao, chaves_de_deduplicacao, regras_de_privacidade, e flags.
• Exemplo de Estrutura de Output:

   {
    "schema_unificado": {
      "estagiario_id": "int",
      "estagiario_nome": "string",
      "supervisor_id": "int",
      "supervisor_nome": "string",
      "data_referencia": "date",
      "periodo": "string",
      "atividade_id": "int",
      "atividade_tipo": "string",
      "horas_registradas": "float",
      "tarefas_concluidas": "int",
      "prazos_cumpridos": "boolean",
      "qualidade_nota": "float",
      "engajamento_interacoes": "int",
      "feedbacks_recebidos": "int",
      "assiduidade_percentual": "float",
      "pontualidade_percentual": "float",
      "comentarios_texto": "string",
      "area": "string",
      "localidade": "string"
    },
    "mapeamentos_por_fonte": {},
    "parametros_de_coleta_por_fonte": {},
    "regras_de_normalizacao": {},
    "chaves_de_deduplicacao": {},
    "regras_de_privacidade": {},
    "flags": {}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em 2.500 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.
• 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 (JSON) gerada por este agente deve ser visível para o Agente de Execução de Chamada à API (RF 2), Agente de Execução de Consulta a Documento (RF 3), e Agente de Execução de Consultas em Banco de Dados (RF 4).

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 (RF 2).

Realizar chamadas às APIs das fontes definidas para obter dados de desempenho conforme parâmetros prontos.

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 uma lista de parâmetros para chamadas API.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos retornados por cada API, organizados por source_id, incluindo metadados de paginação e status.
• Exemplo de Estrutura de Output:

   {
    "source_id": "api_1",
    "data": [
      {
        "estagiario_id": 123,
        "atividade_id": 456,
        "horas_registradas": 8.5
      }
    ],
    "metadata": {
      "pagination": {
        "current_page": 1,
        "total_pages": 10
      },
      "status": "success"
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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: Realiza chamadas às APIs das fontes definidas.

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 (JSON) gerada por este agente deve ser visível para o Agente de Normalização, Limpeza e Consolidação (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consulta a Documento (RF 3).

Realizar consulta a documentos (planilhas, arquivos texto, relatórios) para obter dados de desempenho conforme parâmetros prontos.

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: Este agente deve ser apto a receber uma lista de parâmetros para consulta a documentos.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos extraídos dos documentos por source_id, preservando cabeçalhos e linhas, com indicação de linhas ignoradas/sem dados.
• Exemplo de Estrutura de Output:

   {
    "source_id": "doc_1",
    "data": [
      {
        "estagiario_id": 789,
        "atividade_id": 012,
        "horas_registradas": 7.5
      }
    ],
    "metadata": {
      "headers": ["estagiario_id", "atividade_id", "horas_registradas"],
      "lines_ignored": 2
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Realiza consultas a documentos para coleta de dados.
• Calculadora: Não utiliza.
• 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 (JSON) gerada por este agente deve ser visível para o Agente de Normalização, Limpeza e Consolidação (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados (RF 4).

Realizar conexão e execução de consultas em bancos de dados externos para obter dados de desempenho conforme parâmetros prontos.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber uma lista de parâmetros para consultas em banco de dados.
• 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é 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado das consultas por source_id, incluindo esquemas de colunas e amostras de linhas.
• Exemplo de Estrutura de Output:

   {
    "source_id": "db_1",
    "data": [
      {
        "estagiario_id": 456,
        "atividade_id": 789,
        "horas_registradas": 6.0
      }
    ],
    "metadata": {
      "columns": ["estagiario_id", "atividade_id", "horas_registradas"],
      "sample_lines": 10
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Realiza consultas em bancos de dados externos.

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 (JSON) gerada por este agente deve ser visível para o Agente de Normalização, Limpeza e Consolidação (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização, Limpeza e Consolidação (RF 5).

Unificar, normalizar e consolidar os dados brutos no schema definido, avaliando qualidade e completude.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber dados brutos coletados de múltiplas fontes.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset consolidado no schema_unificado com registros_normalizados, indicadores_de_qualidade, registros_descartados, dicionario_de_dados e amostra_de_registros.
• Exemplo de Estrutura de Output:

   {
    "registros_normalizados": [
      {
        "estagiario_id": 123,
        "atividade_id": 456,
        "horas_registradas": 8.5
      }
    ],
    "indicadores_de_qualidade": {
      "completude_por_campo": 98,
      "taxa_duplicidade": 0.5,
      "taxa_descartes": 0.2,
      "campos_sem_mapeamento": ["supervisor_nome"]
    },
    "registros_descartados": [],
    "dicionario_de_dados": {},
    "amostra_de_registros": {}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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.
• Calculadora: Utiliza lógica interna para normalização e avaliação dos dados.
• 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 (JSON) gerada por este agente deve ser visível para o Agente de Análise de Padrões de Desempenho (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Padrões de Desempenho (RF 6).

Identificar padrões, tendências e alertas de desempenho em nível individual, de time e coortes, calculando KPIs e escores.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber um dataset consolidado e indicadores de qualidade.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com kpis_por_estagiario, tendências, escores_de_desempenho, alertas_priorizados, achados_por_coorte.
• Exemplo de Estrutura de Output:

   {
    "kpis_por_estagiario": {},
    "tendências": {},
    "escores_de_desempenho": {},
    "alertas_priorizados": {},
    "achados_por_coorte": {}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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.
• Calculadora: Utiliza lógica interna para calcular KPIs e escores.
• 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 (JSON) gerada por este agente deve ser visível para o Agente de Insights e Ajustes do Programa (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Insights e Ajustes do Programa (RF 7).

Traduzir os padrões identificados em ações práticas de melhoria do programa de estágio com KPIs-alvo.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber a saída do agente de análise.
• 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é 5.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um plano_de_acoes estruturado com itens contendo problema_diagnosticado, hipótese_de_causa, ação_recomendada, responsável_sugerido, prazo_sugerido, esforço_estimado, impacto_esperado, kpi_alvo e valor_meta.
• Exemplo de Estrutura de Output:

   {
    "plano_de_acoes": [
      {
        "problema_diagnosticado": "Baixa qualidade de nota",
        "hipótese_de_causa": "Falta de mentoria",
        "ação_recomendada": "Implementar sessões de mentoria semanal",
        "responsável_sugerido": "RH",
        "prazo_sugerido": "4 semanas",
        "esforço_estimado": "médio",
        "impacto_esperado": "alto",
        "kpi_alvo": "qualidade_nota",
        "valor_meta": ">=8.0"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

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

7.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 (JSON) gerada por este agente deve ser visível para o Agente de Feedback Personalizado (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Feedback Personalizado (RF 8).

Gerar feedbacks personalizados para estagiários e supervisores, com reforços, oportunidades e metas SMART de curto prazo.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber análises de desempenho por indivíduo e plano_de_acoes aplicável.
• 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é 5.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com feedbacks em JSON: por_estagiario e por_supervisor, incluindo campos de controle requer_revisao_humana e motivos.
• Exemplo de Estrutura de Output:

   {
    "por_estagiario": [
      {
        "estagiario_id": 123,
        "resumo_desempenho": "Bom desempenho geral",
        "pontos_fortes": ["Proatividade"],
        "oportunidades": ["Melhorar a comunicação"],
        "metas_smart_quinzena": "Aumentar a qualidade da nota para >=8.0",
        "recomendacoes_de_recursos": "Curso de comunicação",
        "tom_respeitoso": true
      }
    ],
    "por_supervisor": [
      {
        "supervisor_id": 456,
        "destaques_da_equipe": "Alta produtividade",
        "riscos_e_alertas": "Quedas na qualidade",
        "orientacoes_de_coaching": "Focar em feedbacks semanais",
        "acoes_prioritarias_semana": ["Revisar metas de equipe"]
      }
    ],
    "campos_de_controle": {
      "requer_revisao_humana": false,
      "motivos": ""
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

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

8.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 (JSON) gerada por este agente é o entregável final e não é passada para outros agentes internos.

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

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