####################################################################################################################### # # geval.py # # Description: This file contains the code to evaluate the generated text using G-Eval metric. # # Scripts taken from https://github.com/microsoft/promptflow/tree/main/examples/flows/evaluation/eval-summarization and modified. # import configparser import inspect import json import logging import re from typing import Dict, Callable, List, Any import gradio as gr from tenacity import ( RetryError, Retrying, after_log, before_sleep_log, stop_after_attempt, wait_random_exponential, ) from App_Function_Libraries.Chat import chat_api_call # ####################################################################################################################### # # Start of G-Eval.py logger = logging.getLogger(__name__) config = configparser.ConfigParser() config.read('config.txt') def aggregate( fluency_list: List[float], consistency_list: List[float], relevance_list: List[float], coherence_list: List[float], ) -> Dict[str, float]: """ Takes list of scores for 4 dims and outputs average for them. Args: fluency_list (List(float)): list of fluency scores consistency_list (List(float)): list of consistency scores relevance_list (List(float)): list of relevance scores coherence_list (List(float)): list of coherence scores Returns: Dict[str, float]: Returns average scores """ average_fluency = sum(fluency_list) / len(fluency_list) average_consistency = sum(consistency_list) / len(consistency_list) average_relevance = sum(relevance_list) / len(relevance_list) average_coherence = sum(coherence_list) / len(coherence_list) log_metric("average_fluency", average_fluency) log_metric("average_consistency", average_consistency) log_metric("average_relevance", average_relevance) log_metric("average_coherence", average_coherence) return { "average_fluency": average_fluency, "average_consistency": average_consistency, "average_relevance": average_relevance, "average_coherence": average_coherence, } def run_geval(document, summary, api_key, api_name=None, save=False): prompts = { "coherence": """You will be given one summary written for a source document. Your task is to rate the summary on one metric. Please make sure you read and understand these instructions carefully. Please keep this document open while reviewing, and refer to it as needed. Evaluation Criteria: Coherence (1-5) - the collective quality of all sentences. We align this dimension with the DUC quality question of structure and coherence whereby "the summary should be well-structured and well-organized. The summary should not just be a heap of related information, but should build from sentence to a coherent body of information about a topic." Evaluation Steps: 1. Read the source document carefully and identify the main topic and key points. 2. Read the summary and compare it to the source document. Check if the summary covers the main topic and key points of the source document, and if it presents them in a clear and logical order. 3. Assign a score for coherence on a scale of 1 to 5, where 1 is the lowest and 5 is the highest based on the Evaluation Criteria. Example: Source Document: {{Document}} Summary: {{Summary}} Evaluation Form (scores ONLY): - Coherence:""", "consistency": """You will be given a source document. You will then be given one summary written for this source document. Your task is to rate the summary on one metric. Please make sure you read and understand these instructions carefully. Please keep this document open while reviewing, and refer to it as needed. Evaluation Criteria: Consistency (1-5) - the factual alignment between the summary and the summarized source. A factually consistent summary contains only statements that are entailed by the source document. Annotators were also asked to penalize summaries that contained hallucinated facts. Evaluation Steps: 1. Read the source document carefully and identify the main facts and details it presents. 2. Read the summary and compare it to the source document. Check if the summary contains any factual errors that are not supported by the source document. 3. Assign a score for consistency based on the Evaluation Criteria. Example: Source Document: {{Document}} Summary: {{Summary}} Evaluation Form (scores ONLY): - Consistency:""", "fluency": """You will be given one summary written for a source document. Your task is to rate the summary on one metric. Please make sure you read and understand these instructions carefully. Please keep this document open while reviewing, and refer to it as needed. Evaluation Criteria: Fluency (1-3): the quality of the summary in terms of grammar, spelling, punctuation, word choice, and sentence structure. - 1: Poor. The summary has many errors that make it hard to understand or sound unnatural. - 2: Fair. The summary has some errors that affect the clarity or smoothness of the text, but the main points are still comprehensible. - 3: Good. The summary has few or no errors and is easy to read and follow. Example: Summary: {{Summary}} Evaluation Form (scores ONLY): - Fluency (1-3):""", "relevance": """You will be given one summary written for a source document. Your task is to rate the summary on one metric. Please make sure you read and understand these instructions carefully. Please keep this document open while reviewing, and refer to it as needed. Evaluation Criteria: Relevance (1-5) - selection of important content from the source. The summary should include only important information from the source document. Annotators were instructed to penalize summaries which contained redundancies and excess information. Evaluation Steps: 1. Read the summary and the source document carefully. 2. Compare the summary to the source document and identify the main points of the source document. 3. Assess how well the summary covers the main points of the source document, and how much irrelevant or redundant information it contains. 4. Assign a relevance score from 1 to 5. Example: Source Document: {{Document}} Summary: {{Summary}} Evaluation Form (scores ONLY): - Relevance:""" } scores = {} for metric, prompt in prompts.items(): full_prompt = prompt.replace("{{Document}}", document).replace("{{Summary}}", summary) try: score = geval_summarization(full_prompt, 5 if metric != "fluency" else 3, api_name, api_key) scores[metric] = score except Exception as e: error_message = detailed_api_error(api_name, e) return error_message avg_scores = aggregate([scores['fluency']], [scores['consistency']], [scores['relevance']], [scores['coherence']]) results = { "scores": scores, "average_scores": avg_scores } logging.debug("Results: %s", results) if save: logging.debug("Saving results to geval_results.json") save_eval_results(results) logging.debug("Results saved to geval_results.json") return (f"Coherence: {scores['coherence']:.2f}\n" f"Consistency: {scores['consistency']:.2f}\n" f"Fluency: {scores['fluency']:.2f}\n" f"Relevance: {scores['relevance']:.2f}\n" f"Average Scores:\n" f" Fluency: {avg_scores['average_fluency']:.2f}\n" f" Consistency: {avg_scores['average_consistency']:.2f}\n" f" Relevance: {avg_scores['average_relevance']:.2f}\n" f" Coherence: {avg_scores['average_coherence']:.2f}\n" f"Results saved to geval_results.json") def create_geval_tab(): with gr.Tab("G-Eval"): gr.Markdown("# G-Eval Summarization Evaluation") with gr.Row(): with gr.Column(): document_input = gr.Textbox(label="Source Document", lines=10) summary_input = gr.Textbox(label="Summary", lines=5) api_name_input = gr.Dropdown( choices=["OpenAI", "Anthropic", "Cohere", "Groq", "OpenRouter", "DeepSeek", "HuggingFace", "Mistral", "Llama.cpp", "Kobold", "Ooba", "Tabbyapi", "VLLM", "Local-LLM", "Ollama"], label="Select API" ) api_key_input = gr.Textbox(label="API Key (if required)", type="password") save_value = gr.Checkbox(label="Save Results to a JSON file(geval_results.json)") evaluate_button = gr.Button("Evaluate Summary") with gr.Column(): output = gr.Textbox(label="Evaluation Results", lines=10) evaluate_button.click( fn=run_geval, inputs=[document_input, summary_input, api_name_input, api_key_input, save_value], outputs=output ) return document_input, summary_input, api_name_input, api_key_input, evaluate_button, output def parse_output(output: str, max: float) -> float: """ Function that extracts numerical score from the beginning of string Args: output (str): String to search max (float): Maximum score allowed Returns: float: The extracted score """ matched: List[str] = re.findall(r"(? max: raise ValueError(f"Parsed number: {score} was larger than max score: {max}") else: raise ValueError(f"More than one number detected in input. Input to parser was: {output}") else: raise ValueError(f'No number detected in input. Input to parser was "{output}". ') return score def geval_summarization( prompt_with_src_and_gen: str, max_score: float, api_endpoint: str, api_key: str, ) -> float: model = get_model_from_config(api_endpoint) try: for attempt in Retrying( reraise=True, before_sleep=before_sleep_log(logger, logging.INFO), after=after_log(logger, logging.INFO), wait=wait_random_exponential(multiplier=1, min=1, max=120), stop=stop_after_attempt(10), ): with attempt: system_message="You are a helpful AI assistant" # TEMP setting for Confabulation check temp = 0.7 logging.info(f"Debug - geval_summarization Function - API Endpoint: {api_endpoint}") try: response = chat_api_call(api_endpoint, api_key, prompt_with_src_and_gen, "", temp, system_message) except Exception as e: raise ValueError(f"Unsupported API endpoint: {api_endpoint}") except RetryError: logger.exception(f"geval {api_endpoint} call failed\nInput prompt was: {prompt_with_src_and_gen}") raise try: score = parse_output(response, max_score) except ValueError as e: logger.warning(f"Error parsing output: {e}") score = 0 return score def get_model_from_config(api_name: str) -> str: model = config.get('models', api_name) if isinstance(model, dict): # If the model is a dictionary, return a specific key or a default value return model.get('name', str(model)) # Adjust 'name' to the appropriate key if needed return str(model) if model is not None else "" def aggregate_llm_scores(llm_responses: List[str], max_score: float) -> float: """Parse and average valid scores from the generated responses of the G-Eval LLM call. Args: llm_responses (List[str]): List of scores from multiple LLMs max_score (float): The maximum score allowed. Returns: float: The average of all the valid scores """ all_scores = [] error_count = 0 for generated in llm_responses: try: parsed = parse_output(generated, max_score) all_scores.append(parsed) except ValueError as e: logger.warning(e) error_count += 1 if error_count: logger.warning(f"{error_count} out of 20 scores were discarded due to corrupt g-eval generation") score = sum(all_scores) / len(all_scores) return score def validate_inputs(document: str, summary: str, api_name: str, api_key: str) -> None: """ Validate inputs for the G-Eval function. Args: document (str): The source document summary (str): The summary to evaluate api_name (str): The name of the API to use api_key (str): The API key Raises: ValueError: If any of the inputs are invalid """ if not document.strip(): raise ValueError("Source document cannot be empty") if not summary.strip(): raise ValueError("Summary cannot be empty") if api_name.lower() not in ["openai", "anthropic", "cohere", "groq", "openrouter", "deepseek", "huggingface", "mistral", "llama.cpp", "kobold", "ooba", "tabbyapi", "vllm", "local-llm", "ollama"]: raise ValueError(f"Unsupported API: {api_name}") def detailed_api_error(api_name: str, error: Exception) -> str: """ Generate a detailed error message for API failures. Args: api_name (str): The name of the API that failed error (Exception): The exception that was raised Returns: str: A detailed error message """ error_type = type(error).__name__ error_message = str(error) return f"API Failure: {api_name}\nError Type: {error_type}\nError Message: {error_message}\nPlease check your API key and network connection, and try again." def save_eval_results(results: Dict[str, Any], filename: str = "geval_results.json") -> None: """ Save evaluation results to a JSON file. Args: results (Dict[str, Any]): The evaluation results filename (str): The name of the file to save results to """ with open(filename, 'w') as f: json.dump(results, f, indent=2) print(f"Results saved to {filename}") # # ####################################################################################################################### # # Taken from: https://github.com/microsoft/promptflow/blob/b5a68f45e4c3818a29e2f79a76f2e73b8ea6be44/src/promptflow-core/promptflow/_core/metric_logger.py class MetricLoggerManager: _instance = None def __init__(self): self._metric_loggers = [] @staticmethod def get_instance() -> "MetricLoggerManager": if MetricLoggerManager._instance is None: MetricLoggerManager._instance = MetricLoggerManager() return MetricLoggerManager._instance def log_metric(self, key, value, variant_id=None): for logger in self._metric_loggers: if len(inspect.signature(logger).parameters) == 2: logger(key, value) # If the logger only accepts two parameters, we don't pass variant_id else: logger(key, value, variant_id) def add_metric_logger(self, logger_func: Callable): existing_logger = next((logger for logger in self._metric_loggers if logger is logger_func), None) if existing_logger: return if not callable(logger_func): return sign = inspect.signature(logger_func) # We accept two kinds of metric loggers: # def log_metric(k, v) # def log_metric(k, v, variant_id) if len(sign.parameters) not in [2, 3]: return self._metric_loggers.append(logger_func) def remove_metric_logger(self, logger_func: Callable): self._metric_loggers.remove(logger_func) def log_metric(key, value, variant_id=None): """Log a metric for current promptflow run. :param key: Metric name. :type key: str :param value: Metric value. :type value: float :param variant_id: Variant id for the metric. :type variant_id: str """ MetricLoggerManager.get_instance().log_metric(key, value, variant_id) def add_metric_logger(logger_func: Callable): MetricLoggerManager.get_instance().add_metric_logger(logger_func) def remove_metric_logger(logger_func: Callable): MetricLoggerManager.get_instance().remove_metric_logger(logger_func) # # End of G-Eval.py #######################################################################################################################