Create media_graph_critic.py

tools/media_graph_critic.py

@@ -0,0 +1,55 @@
+from smolagents.tools import tool
+from typing import Dict, Any, List, Optional
+
+@tool
+def critique_media_graph(graph_properties: Dict[str, Any]) -> Dict[str, List[str]]:
+    """
+    Analisa as propriedades de um gráfico e identifica elementos que podem induzir a erros
+    de leitura, como escalas inapropriadas ou falta de informações essenciais (EF09MA21).
+    Args:
+        graph_properties: Um dicionário descrevendo as propriedades do gráfico.
+                          Exemplo: {
+                              "tem_titulo": True,
+                              "tem_legenda_clara": False,
+                              "tem_fonte_dos_dados": True,
+                              "eixo_y_inicia_em_zero": False,
+                              "tipo_grafico": "barras",
+                              "contexto": "Vendas anuais da empresa X"
+                          }
+    Returns:
+        Um dicionário com uma lista de pontos positivos e uma lista de possíveis problemas (críticas).
+    """
+    critiques = []
+    positives = []
+
+    # Verifica título
+    if graph_properties.get("tem_titulo"):
+        positives.append("O gráfico possui um título, o que ajuda na compreensão do seu tema.")
+    else:
+        critiques.append("AUSÊNCIA DE TÍTULO: A falta de um título claro dificulta a compreensão imediata do assunto do gráfico.")
+
+    # Verifica legenda
+    if graph_properties.get("tem_legenda_clara"):
+        positives.append("As legendas estão claras e bem explicitadas.")
+    else:
+        critiques.append("LEGENDA CONFUSA OU AUSENTE: A ausência de uma legenda clara pode levar a interpretações erradas das categorias ou dados apresentados.")
+
+    # Verifica fonte
+    if graph_properties.get("tem_fonte_dos_dados"):
+        positives.append("A fonte dos dados foi citada, o que confere mais credibilidade à informação.")
+    else:
+        critiques.append("FALTA DE FONTE: A omissão da fonte dos dados impede a verificação da sua veracidade e confiabilidade.")
+
+    # Verifica escala do eixo Y (crítica comum)
+    if not graph_properties.get("eixo_y_inicia_em_zero", True) and graph_properties.get("tipo_grafico") in ["barras", "linhas"]:
+        critiques.append("ESCALA INAPROPRIADA: O eixo Y não começa em zero. Isso pode distorcer a proporção visual entre os dados, exagerando as diferenças.")
+    else:
+        positives.append("A escala do eixo Y parece apropriada para o conjunto de dados.")
+
+    if not critiques:
+        critiques.append("Nenhum problema óbvio de manipulação ou erro de leitura foi identificado com base nas informações fornecidas.")
+
+    return {
+        "pontos_positivos": positives,
+        "pontos_de_atencao_criticas": critiques
+    }