Agente de IA para Planejamento de Cardápio Escolar

Normalizar e consolidar restrições dietéticas, alergias e preferências dos alunos, gerando um perfil nutricional por faixa etária/turma e regras de exclusão/substituição por ingrediente.

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 JSON com a lista de alunos e políticas da escola 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: JSON com informações sobre restrições dietéticas, alergias e preferências alimentares dos alunos.
• 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 texto com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON normalizado contendo clusters de alunos, regras de ingredientes, padrões alimentares e preferências agrupadas.
• Exemplo de Estrutura de Output:

   {
    "clusters": [
      {
        "cluster_id": "C1",
        "criterios": {
          "faixa_etaria": "9-11",
          "serie": ["5º ano"]
        },
        "regras_ingredientes": {
          "proibidos": ["amendoim", "lactose", "suina"],
          "evitar": ["beterraba"]
        },
        "padroes": ["ovo-lacto-vegetariano"]
      }
    ],
    "mapa_aluno_cluster": {
      "A1": "C1"
    },
    "preferencias_agrupadas": {
      "positivas": {
        "frutas": ["maçã"]
      },
      "negativas": {
        "hortaliças": ["beterraba"]
      }
    },
    "matriz_substituicoes": [
      {
        "ingrediente": "leite",
        "substitutos": ["leite de aveia", "leite de soja"]
      }
    ],
    "sinalizadores": {
      "dados_faltantes": ["A2.sem_idade"],
      "conflitos": []
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e organizado, com um tamanho estimado em 10.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 Sugestão de Cardápio Balanceado (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Cardápio Balanceado (RF 2).

Gerar um cardápio semanal variado e balanceado por refeição e por cluster, com porções e substituições seguras, atendendo a diretrizes nutricionais escolares.

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: JSON contendo clusters de alunos, regras de ingredientes, padrões alimentares e preferências agrupadas, além de parâmetros opcionais de planejamento.
• 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 texto com até 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o plano semanal de cardápios por cluster.
• Exemplo de Estrutura de Output:

   {
    "semana": "2026-03-02",
    "cardapio": [
      {
        "dia": "segunda",
        "cluster_id": "C1",
        "refeicoes": [
          {
            "tipo": "almoco",
            "prato_principal": "arroz integral, feijao, frango grelhado",
            "acompanhamentos": ["salada de alface e tomate"],
            "fruta": "banana",
            "bebida": "agua",
            "porcoes": {
              "graos_g": 120,
              "proteina_g": 90,
              "hortalicas_g": 100,
              "fruta_g": 120
            },
            "alergenos": [],
            "substituicoes_seguras": [
              {
                "para": "frango grelhado",
                "opcoes": ["omelete", "grão-de-bico cozido"]
              }
            ],
            "custo_estimado": 6.5,
            "observacoes_preparo": ["usar pouco sal", "assado ao invés de frito"]
          }
        ]
      }
    ],
    "regras_nutricionais_avaliacao": {
      "C1": {
        "energia_kcal_dia": {
          "meta": 650,
          "estimado": 640,
          "status": "ok"
        },
        "sodio_mg": {
          "limite": 800,
          "estimado": 620,
          "status": "ok"
        }
      }
    },
    "diversidade_semana": {
      "proteinas": ["ave", "ovo", "leguminosa", "peixe", "bovina"],
      "status": "ok"
    },
    "pendencias": []
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e organizado, com um tamanho estimado em 15.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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Atualização de Sugestões de Cardápio (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Atualização de Sugestões de Cardápio (RF 3).

Incorporar feedback de aceitação e desperdício para ajustar o cardápio, preservando metas nutricionais e variedade.

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: JSON contendo feedback de aceitação, desperdício e ocorrências alérgicas relacionadas aos cardápios.
• 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 texto com até 30.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo ajustes propostos para o cardápio com base no feedback recebido.
• Exemplo de Estrutura de Output:

   {
    "semana": "2026-03-02",
    "ajustes": [
      {
        "dia": "terça",
        "cluster_id": "C1",
        "refeicao": "almoco",
        "acao": "substituir_prato_principal",
        "de": "frango grelhado",
        "para": "frango ensopado",
        "justificativa": "comentários de secura e desperdício > 15%",
        "impacto_nutricional": {
          "energia_kcal": "+20",
          "sodio_mg": "-50",
          "status": "ok"
        }
      }
    ],
    "regras_preservadas": ["variedade_semana", "sodio_limite", "ultraprocessados=0"],
    "preferencias_atualizadas": {
      "positivas": ["ensopados"],
      "negativas": ["grelhado seco"]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e organizado, com um tamanho estimado em 10.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: 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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. Os ajustes gerados devem ser disponibilizados para a administração escolar.