Agente de IA para Análise de Feedback de Avaliações de Curso

Definir o escopo de coleta, padronizar o schema alvo e preparar os parâmetros/payloads para captura de feedbacks em múltiplas fontes (APIs e documentos).

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 parâmetros via API. Na fase de testes, os dados serão enviados pelo 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 parâmetros necessários para a coleta de feedbacks.
• 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 com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o schema_target padronizado e os critérios de coleta definidos.
• Exemplo de Estrutura de Output:

   {
    "schema_target": {
      "feedback_id_externo": "string",
      "source": "string",
      "course_id": "string",
      "course_name": "string",
      "instructor_name": "string",
      "turma_id": "string",
      "created_at_utc": "string",
      "rating_valor": "number",
      "rating_escala": "string",
      "nps_score": "number",
      "comment_text": "string",
      "language_detected": "string",
      "user_role": "string",
      "platform_channel": "string",
      "module/topic": "string",
      "origem_arquivo": "string",
      "source_reference": "string"
    },
    "criteria": {
      "period_filter": {"start_date": "string", "end_date": "string"},
      "quality_filters": {"min_length": 5, "exclude_empty": true}
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.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 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 (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 (RF 2).

Realizar chamadas às APIs das fontes definidas para obter os feedbacks conforme payloads preparados.

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 payloads de API preparados para a coleta de feedbacks.
• 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 com até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo as respostas das chamadas às APIs, incluindo metadados de chamada.
• Exemplo de Estrutura de Output:

   {
    "responses": [
      {
        "source": "LMS",
        "endpoint": "/api/feedbacks",
        "data": [{...}],
        "metadata": {
          "interval": "2025-01-01/2025-12-31",
          "pagination": "page=1"
        }
      }
    ]
  } 

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

2.3.3 Parâmetros de Geração

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

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar chamadas às APIs externas utilizando os payloads recebidos.

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 Consolidação e Normalização de Feedbacks (RF 4).

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

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

Realizar consulta a documentos/arquivos fornecidos para extrair os registros de feedback.

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 1).
• Tipo do input: Este agente deve ser apto a receber parâmetros para consulta a documentos/arquivos contendo registros de feedbacks.
• 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 com até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os registros de feedback extraídos dos documentos, incluindo metadados de extração.
• Exemplo de Estrutura de Output:

   {
    "document_responses": [
      {
        "file_name": "feedbacks_2025.csv",
        "data": [{...}],
        "metadata": {
          "extracted_on": "2025-12-02",
          "source_reference": "uri"
        }
      }
    ]
  } 

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

3.3.3 Parâmetros de Geração

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

3.3.4 Ferramentas do Agente

• Documentos: O agente deverá realizar consultas a documentos/arquivos fornecidos utilizando os parâmetros recebidos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Consolidação e Normalização de Feedbacks (RF 4).

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

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

Consolidar dados provenientes de APIs e documentos em um dataset único, padronizado e deduplicado, pronto para análise.

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 2 ou RF 3).
• Tipo do input: Este agente deve ser apto a receber dados de feedbacks provenientes de APIs e documentos, além do schema_target para consolidação.
• 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 com até 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o dataset consolidado e normalizado, pronto para análise.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": [
      {
        "feedback_id_externo": "12345",
        "course_id": "ABC123",
        "comment_text": "Ótimo curso!",
        "rating_normalizado_0_1": 0.8,
        "language_detected": "pt",
        "comment_text_pt_br": "Ótimo curso!"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas 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 gerada por este agente deve ser visível para o Agente de Análise de Feedbacks (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Feedbacks (RF 5).

Identificar padrões, pontos fortes e áreas de melhoria a partir do dataset normalizado de feedbacks de curso.

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 um dataset normalizado de feedbacks de curso, pronto para 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 com até 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo a análise dos feedbacks, incluindo padrões, pontos fortes e áreas de melhoria.
• Exemplo de Estrutura de Output:

   {
    "analise_feedbacks": {
      "pontos_fortes": [
        {"tema": "Didática do Instrutor", "menções": 10, "saldo": 30, "citações": ["Ótima didática!", "Instrutor claro e objetivo."]}
      ],
      "areas_melhoria": [
        {"tema": "Plataforma", "menções": 8, "saldo": -20, "citações": ["Dificuldade de navegação.", "Interface confusa."]}
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 é o entregável final e não é passada para outros agentes internos.

5.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.