diff --git a/examples/Enhance_your_prompts_with_meta_prompting.ipynb b/examples/Enhance_your_prompts_with_meta_prompting.ipynb new file mode 100644 index 0000000000..660fd679f2 --- /dev/null +++ b/examples/Enhance_your_prompts_with_meta_prompting.ipynb @@ -0,0 +1,953 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Meta Prompting: A Guide to Automated Prompt Optimization\n", + "\n", + "Welcome to our cookbook on meta prompting! In this guide, we'll explore how to take a basic prompt and refine it to enhance the quality of outputs from a language model. We'll use the example of summarizing news reports to illustrate the process.\n", + "\n", + "\n", + "Meta-prompting is a technique where you use an LLM to generate or improve prompts. Typically this is done using a higher intelligent model that optimizes prompts for a model with less intelligence. It’s a process of using prompts to guide, structure, and optimize other prompts, helping ensure they’re more effective in guiding the LLM towards high-quality, relevant outputs. We'll be leveraging the capabilities of `o1-preview`, a more intelligent model with advanced reasoning skills, to improve a prompt for `gpt-4o`.\n", + "\n", + "We're committed to making your development journey with LLMs smoother and more accessible through this technique. Don't forget to check out our [Generate Anything](https://platform.openai.com/docs/guides/prompt-generation) feature in the playground — it's a fantastic starting point to dive into meta prompting.\n", + "\n", + "In this example, we'll begin with a simple prompt for summarizing news articles and then enhance it to see how the outputs improve. We'll use `o1-preview` to analyze and refine our prompt, adding more detail and clarity along the way. Finally, we'll evaluate the outputs systematically to understand the impact of our refinements." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/tqdm/auto.py:21: TqdmWarning: IProgress not found. Please update jupyter and ipywidgets. See https://ipywidgets.readthedocs.io/en/stable/user_install.html\n", + " from .autonotebook import tqdm as notebook_tqdm\n" + ] + } + ], + "source": [ + "import pandas as pd\n", + "import openai \n", + "from concurrent.futures import ThreadPoolExecutor, as_completed\n", + "from tqdm import tqdm\n", + "from pydantic import BaseModel\n", + "from datasets import load_dataset\n", + "\n", + "client = openai.Client()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Importing the Data\n", + "\n", + "Let's kick things off by importing the `bbc_news_alltime` dataset from [HuggingFace](https://huggingface.co/datasets/RealTimeData/bbc_news_alltime). This dataset contains all BBC News articles, capturing everything published monthly from 2017 up to the latest complete month. For our experiment, we'll focus exclusively on a sample from a recent month—August 2024—to keep things current and manageable.\n" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
\n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
titlepublished_dateauthorsdescriptionsectioncontentlinktop_image
2662Laura Whitmore: I was gaslighted after raising...2024-08-04https://www.facebook.com/bbcnewsThe former Love Island host said that things s...CultureTelevision presenter Laura Whitmore has said t...http://www.bbc.co.uk/news/articles/c9wvwvzm7x7ohttps://ichef.bbci.co.uk/ace/standard/2560/cps...
1865Errollyn Wallen appointed as Master of the Kin...2024-08-25https://www.facebook.com/bbcnewsShe is best known for her work on the 2012 Par...CultureCelebrated composer and singer-songwriter Erro...http://www.bbc.co.uk/news/articles/c4gl758g7zgohttps://ichef.bbci.co.uk/ace/standard/2560/cps...
2554SDLP: Matthew O'Toole endorses Claire Hanna fo...2024-08-30https://www.facebook.com/bbcnewsMatthew O'Toole had been named by some as a po...Northern Ireland PoliticsMatthew O'Toole leads his party's official opp...http://www.bbc.co.uk/news/articles/cvg41j7xrzdohttps://ichef.bbci.co.uk/ace/standard/3840/cps...
1338Rotherham rioters among those jailed - BBC News2024-08-20https://www.facebook.com/bbcnewsTwo men who were part of a mob targeting a Hol...South YorkshireRotherham pair among those jailed for UK rioti...http://www.bbc.co.uk/news/articles/cwywggd7qw6ohttps://ichef.bbci.co.uk/ace/standard/2560/cps...
1232BBC News - BBC iPlayer2024-08-02NoneNoneNoneJavaScript seems to be disabled. Please enable...http://www.bbc.co.uk/news/10318089
\n", + "
" + ], + "text/plain": [ + " title published_date \\\n", + "2662 Laura Whitmore: I was gaslighted after raising... 2024-08-04 \n", + "1865 Errollyn Wallen appointed as Master of the Kin... 2024-08-25 \n", + "2554 SDLP: Matthew O'Toole endorses Claire Hanna fo... 2024-08-30 \n", + "1338 Rotherham rioters among those jailed - BBC News 2024-08-20 \n", + "1232 BBC News - BBC iPlayer 2024-08-02 \n", + "\n", + " authors \\\n", + "2662 https://www.facebook.com/bbcnews \n", + "1865 https://www.facebook.com/bbcnews \n", + "2554 https://www.facebook.com/bbcnews \n", + "1338 https://www.facebook.com/bbcnews \n", + "1232 None \n", + "\n", + " description \\\n", + "2662 The former Love Island host said that things s... \n", + "1865 She is best known for her work on the 2012 Par... \n", + "2554 Matthew O'Toole had been named by some as a po... \n", + "1338 Two men who were part of a mob targeting a Hol... \n", + "1232 None \n", + "\n", + " section \\\n", + "2662 Culture \n", + "1865 Culture \n", + "2554 Northern Ireland Politics \n", + "1338 South Yorkshire \n", + "1232 None \n", + "\n", + " content \\\n", + "2662 Television presenter Laura Whitmore has said t... \n", + "1865 Celebrated composer and singer-songwriter Erro... \n", + "2554 Matthew O'Toole leads his party's official opp... \n", + "1338 Rotherham pair among those jailed for UK rioti... \n", + "1232 JavaScript seems to be disabled. Please enable... \n", + "\n", + " link \\\n", + "2662 http://www.bbc.co.uk/news/articles/c9wvwvzm7x7o \n", + "1865 http://www.bbc.co.uk/news/articles/c4gl758g7zgo \n", + "2554 http://www.bbc.co.uk/news/articles/cvg41j7xrzdo \n", + "1338 http://www.bbc.co.uk/news/articles/cwywggd7qw6o \n", + "1232 http://www.bbc.co.uk/news/10318089 \n", + "\n", + " top_image \n", + "2662 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "1865 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "2554 https://ichef.bbci.co.uk/ace/standard/3840/cps... \n", + "1338 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "1232 " + ] + }, + "execution_count": 3, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "ds = load_dataset(\"RealTimeData/bbc_news_alltime\", \"2024-08\")\n", + "df = pd.DataFrame(ds['train']).sample(n=100, random_state=1)\n", + "df.head()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterating on Prompts\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's start with a straightforward prompt and then use `o1-preview` to enhance it for better results. We want to summarize news articles, so this is what i'll ask the model to do. " + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [], + "source": [ + "simple_prompt = \"Summarize this news article: {article}\"\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To improve the prompt, we need to provide `o1-preview` with the context and goals we want to achieve. We can then ask it to generate a more detailed prompt that would produce richer and more comprehensive news summaries." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [], + "source": [ + "meta_prompt = \"\"\"\n", + "Improve the following prompt to generate a more detailed sumary. \n", + "Adhere to prompt engineering best practices. \n", + "Make sure the structure is clear and intuitive and contains the type of news, tags and sentiment analysis.\n", + "\n", + "{simple_prompt}\n", + "\n", + "Only return the prompt.\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'Please read the following news article and provide a comprehensive summary that includes:\\n\\n1. **Type of News**: Specify the category of the news article (e.g., Politics, Technology, Health, Sports, etc.).\\n2. **Summary**: Write a concise and clear summary of the main points, ensuring the structure is logical and intuitive.\\n3. **Tags**: List relevant keywords or tags associated with the article.\\n4. **Sentiment Analysis**: Analyze the overall sentiment of the article (positive, negative, or neutral) and briefly explain your reasoning.\\n\\n**Article:**\\n\\n{article}'" + ] + }, + "execution_count": 6, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "def get_model_response(messages, model=\"o1-preview\"):\n", + " response = client.chat.completions.create(\n", + " messages=messages,\n", + " model=model,\n", + " )\n", + " return response.choices[0].message.content\n", + "\n", + "\n", + "complex_prompt = get_model_response([{\"role\": \"user\", \"content\": meta_prompt.format(simple_prompt=simple_prompt)}])\n", + "complex_prompt" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Generating the Summaries\n", + "\n", + "Now that we have both prompts, let's generate the summaries! For each entry in our dataset, we'll use both the simple and the enhanced prompts to see how they compare. By doing this, we'll get a firsthand look at how our refinements with `o1-preview` can lead to richer and more detailed summaries. Let's dive in and see the difference for ourselves!" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [], + "source": [ + "def generate_resonse(prompt): \n", + " messages = [{\"role\": \"user\", \"content\": prompt}]\n", + " response = get_model_response(messages, model=\"gpt-4o-mini\")\n", + " return response\n", + "\n", + "def generate_summaries(row):\n", + " simple_itinerary = generate_resonse(simple_prompt.format(article=row[\"content\"]))\n", + " complex_itinerary = generate_resonse(complex_prompt + row[\"content\"])\n", + " return simple_itinerary, complex_itinerary" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's check if everything looks good and if we can generate a summary for the first news report. " + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "('Television presenter Laura Whitmore has shared that the issues she attempted to address during her time on *Strictly Come Dancing* eight years ago are now surfacing, stating that she experienced \"gaslighting\" that made her concerns seem normalized. In a recent interview, she expressed the difficulties she faced, including being portrayed negatively and feeling \"broken\" during the competition. Whitmore indicated that she raised concerns about inappropriate behavior and is currently providing evidence for a BBC investigation, although she has not made an official complaint herself. The BBC is facing allegations of mistreatment towards contestants, prompting them to announce new welfare measures, including the presence of a chaperone during rehearsals. Other celebrities participating in the show have also made allegations against professional dancers, leading to growing scrutiny around conditions on the show. The BBC emphasized that it takes complaints very seriously and is committed to updating its support processes.',\n", + " '1. **Type of News**: Entertainment\\n\\n2. **Summary**: Laura Whitmore, a television presenter, has spoken out about her experiences on Strictly Come Dancing, revealing that issues she attempted to address during her tenure on the show are now coming to light. In an interview with The Irish Times, she described feeling \"gaslit\" and suggested that her concerns, which she raised eight years ago, were not taken seriously at the time. Whitmore recalled that her participation left her feeling \"broken\" and criticized how she was portrayed during the show. She mentioned contributing evidence to an ongoing review involving incidents of alleged inappropriate behavior during her time on the show, although she did not make an official complaint. The BBC, which has been navigating its own controversy related to the treatment of contestants, stated it is taking these claims seriously and plans to enhance welfare measures on the show, including the introduction of a chaperone at rehearsals. Recent allegations from other contestants have further intensified the scrutiny of Strictly Come Dancing.\\n\\n3. **Tags**: Laura Whitmore, Strictly Come Dancing, BBC, allegations, inappropriate behavior, gaslighting, welfare measures, entertainment controversy\\n\\n4. **Sentiment Analysis**: The overall sentiment of the article is negative. It highlights serious allegations of mistreatment and inappropriate behavior associated with a popular television show, along with personal accounts from Whitmore that reflect emotional distress and professional struggles. The tone conveys a sense of urgency and seriousness regarding the issues raised, indicating a critical atmosphere within the entertainment industry related to contestant treatment.')" + ] + }, + "execution_count": 8, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "generate_summaries(df.iloc[0])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "By comparing the summaries generated from the simple and enhanced prompts, we can already see significant improvements. The initial summary gives us a general overview of the article, whereas the enhanced summary dives deeper — it not only provides a detailed summary but also categorizes the news type, lists relevant tags, and even includes a sentiment analysis.\n", + "\n", + "Let's test on the entire dataset now! " + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "Generating Itineraries: 100%|██████████| 100/100 [00:50<00:00, 1.98it/s]\n" + ] + }, + { + "data": { + "text/html": [ + "
\n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
titlepublished_dateauthorsdescriptionsectioncontentlinktop_imagesimple_summarycomplex_summary
2662Laura Whitmore: I was gaslighted after raising...2024-08-04https://www.facebook.com/bbcnewsThe former Love Island host said that things s...CultureTelevision presenter Laura Whitmore has said t...http://www.bbc.co.uk/news/articles/c9wvwvzm7x7ohttps://ichef.bbci.co.uk/ace/standard/2560/cps...Television presenter Laura Whitmore has spoken...1. **Type of News**: Entertainment/Television\\...
1865Errollyn Wallen appointed as Master of the Kin...2024-08-25https://www.facebook.com/bbcnewsShe is best known for her work on the 2012 Par...CultureCelebrated composer and singer-songwriter Erro...http://www.bbc.co.uk/news/articles/c4gl758g7zgohttps://ichef.bbci.co.uk/ace/standard/2560/cps...Errollyn Wallen has been appointed Master of t...1. **Type of News**: Arts/Music\\n\\n2. **Summar...
2554SDLP: Matthew O'Toole endorses Claire Hanna fo...2024-08-30https://www.facebook.com/bbcnewsMatthew O'Toole had been named by some as a po...Northern Ireland PoliticsMatthew O'Toole leads his party's official opp...http://www.bbc.co.uk/news/articles/cvg41j7xrzdohttps://ichef.bbci.co.uk/ace/standard/3840/cps...Matthew O'Toole, the leader of the official op...1. **Type of News**: Politics\\n\\n2. **Summary*...
1338Rotherham rioters among those jailed - BBC News2024-08-20https://www.facebook.com/bbcnewsTwo men who were part of a mob targeting a Hol...South YorkshireRotherham pair among those jailed for UK rioti...http://www.bbc.co.uk/news/articles/cwywggd7qw6ohttps://ichef.bbci.co.uk/ace/standard/2560/cps...Two men, Nathan Palmer (29) and Niven Matthewm...1. **Type of News**: Politics / Crime and Just...
1232BBC News - BBC iPlayer2024-08-02NoneNoneNoneJavaScript seems to be disabled. Please enable...http://www.bbc.co.uk/news/10318089The article discusses the need to enable JavaS...I cannot provide a summary of the article as t...
\n", + "
" + ], + "text/plain": [ + " title published_date \\\n", + "2662 Laura Whitmore: I was gaslighted after raising... 2024-08-04 \n", + "1865 Errollyn Wallen appointed as Master of the Kin... 2024-08-25 \n", + "2554 SDLP: Matthew O'Toole endorses Claire Hanna fo... 2024-08-30 \n", + "1338 Rotherham rioters among those jailed - BBC News 2024-08-20 \n", + "1232 BBC News - BBC iPlayer 2024-08-02 \n", + "\n", + " authors \\\n", + "2662 https://www.facebook.com/bbcnews \n", + "1865 https://www.facebook.com/bbcnews \n", + "2554 https://www.facebook.com/bbcnews \n", + "1338 https://www.facebook.com/bbcnews \n", + "1232 None \n", + "\n", + " description \\\n", + "2662 The former Love Island host said that things s... \n", + "1865 She is best known for her work on the 2012 Par... \n", + "2554 Matthew O'Toole had been named by some as a po... \n", + "1338 Two men who were part of a mob targeting a Hol... \n", + "1232 None \n", + "\n", + " section \\\n", + "2662 Culture \n", + "1865 Culture \n", + "2554 Northern Ireland Politics \n", + "1338 South Yorkshire \n", + "1232 None \n", + "\n", + " content \\\n", + "2662 Television presenter Laura Whitmore has said t... \n", + "1865 Celebrated composer and singer-songwriter Erro... \n", + "2554 Matthew O'Toole leads his party's official opp... \n", + "1338 Rotherham pair among those jailed for UK rioti... \n", + "1232 JavaScript seems to be disabled. Please enable... \n", + "\n", + " link \\\n", + "2662 http://www.bbc.co.uk/news/articles/c9wvwvzm7x7o \n", + "1865 http://www.bbc.co.uk/news/articles/c4gl758g7zgo \n", + "2554 http://www.bbc.co.uk/news/articles/cvg41j7xrzdo \n", + "1338 http://www.bbc.co.uk/news/articles/cwywggd7qw6o \n", + "1232 http://www.bbc.co.uk/news/10318089 \n", + "\n", + " top_image \\\n", + "2662 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "1865 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "2554 https://ichef.bbci.co.uk/ace/standard/3840/cps... \n", + "1338 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "1232 \n", + "\n", + " simple_summary \\\n", + "2662 Television presenter Laura Whitmore has spoken... \n", + "1865 Errollyn Wallen has been appointed Master of t... \n", + "2554 Matthew O'Toole, the leader of the official op... \n", + "1338 Two men, Nathan Palmer (29) and Niven Matthewm... \n", + "1232 The article discusses the need to enable JavaS... \n", + "\n", + " complex_summary \n", + "2662 1. **Type of News**: Entertainment/Television\\... \n", + "1865 1. **Type of News**: Arts/Music\\n\\n2. **Summar... \n", + "2554 1. **Type of News**: Politics\\n\\n2. **Summary*... \n", + "1338 1. **Type of News**: Politics / Crime and Just... \n", + "1232 I cannot provide a summary of the article as t... " + ] + }, + "execution_count": 9, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Add new columns to the dataframe for storing itineraries\n", + "df['simple_summary'] = None\n", + "df['complex_summary'] = None\n", + "\n", + "# Use ThreadPoolExecutor to generate itineraries concurrently\n", + "with ThreadPoolExecutor() as executor:\n", + " futures = {executor.submit(generate_summaries, row): index for index, row in df.iterrows()}\n", + " for future in tqdm(as_completed(futures), total=len(futures), desc=\"Generating Itineraries\"):\n", + " index = futures[future]\n", + " simple_itinerary, complex_itinerary = future.result()\n", + " df.at[index, 'simple_summary'] = simple_itinerary\n", + " df.at[index, 'complex_summary'] = complex_itinerary\n", + "\n", + "df.head()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Evaluating the Results\n", + "\n", + "To assess the difference in performance between the two prompts, we'll use a structured evaluation approach with the LLM acting as a judge. This means we'll leverage the language model itself to evaluate and compare the outputs based on specific criteria.\n", + "\n", + "**What Does \"LLM as a Judge\" Mean?**\n", + "\n", + "Using an LLM as a judge involves having the language model evaluate its own outputs or those of another model. It applies predefined criteria to assess aspects like accuracy, clarity, and relevance. This approach helps us obtain an objective and consistent evaluation without human bias, making it easier to identify improvements between different prompts. Our cookbook on [Getting Started with OpenAI Evals](https://cookbook.openai.com/examples/evaluation/getting_started_with_openai_evals) offers a glimps on how you can get started with this approach.\n", + "\n", + "\n", + "Here's the prompt we'll use for evaluation:" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [], + "source": [ + "evaluation_prompt = \"\"\"\n", + "You are an expert editor tasked with evaluating the quality of a news article summary. Below is the original article and the summary to be evaluated:\n", + "\n", + "**Original Article**: \n", + "{original_article}\n", + "\n", + "**Summary**: \n", + "{summary}\n", + "\n", + "Please evaluate the summary based on the following criteria, using a scale of 1 to 5 (1 being the lowest and 5 being the highest). Be critical in your evaluation and only give high scores for exceptional summaries:\n", + "\n", + "1. **Categorization and Context**: Does the summary clearly identify the type or category of news (e.g., Politics, Technology, Sports) and provide appropriate context? \n", + "2. **Keyword and Tag Extraction**: Does the summary include relevant keywords or tags that accurately capture the main topics and themes of the article? \n", + "3. **Sentiment Analysis**: Does the summary accurately identify the overall sentiment of the article and provide a clear, well-supported explanation for this sentiment? \n", + "4. **Clarity and Structure**: Is the summary clear, well-organized, and structured in a way that makes it easy to understand the main points? \n", + "5. **Detail and Completeness**: Does the summary provide a detailed account that includes all necessary components (type of news, tags, sentiment) comprehensively? \n", + "\n", + "\n", + "Provide your scores and justifications for each criterion, ensuring a rigorous and detailed evaluation.\n", + "\"\"\"\n", + "\n", + "class ScoreCard(BaseModel):\n", + " categorization: int\n", + " keyword_extraction: int\n", + " sentiment_analysis: int\n", + " clarity_structure: int\n", + " detail_completeness: int\n", + " justification: str" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here's a pro tip — you can actually use meta prompting to refine your evaluation prompt as well! By applying the same iterative enhancement to the prompt that instructs the LLM to act as a judge, you can make your evaluations even more precise and insightful. \n", + "\n", + "Let's use this prompt to evaluate our summaries!" + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "Evaluating Summaries: 100%|██████████| 100/100 [01:42<00:00, 1.02s/it]\n" + ] + }, + { + "data": { + "text/html": [ + "
\n", + "\n", + "\n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + " \n", + "
titlepublished_dateauthorsdescriptionsectioncontentlinktop_imagesimple_summarycomplex_summarysimple_evaluationcomplex_evaluation
2662Laura Whitmore: I was gaslighted after raising...2024-08-04https://www.facebook.com/bbcnewsThe former Love Island host said that things s...CultureTelevision presenter Laura Whitmore has said t...http://www.bbc.co.uk/news/articles/c9wvwvzm7x7ohttps://ichef.bbci.co.uk/ace/standard/2560/cps...Television presenter Laura Whitmore has spoken...1. **Type of News**: Entertainment/Television\\...categorization=4 keyword_extraction=3 sentimen...categorization=5 keyword_extraction=5 sentimen...
1865Errollyn Wallen appointed as Master of the Kin...2024-08-25https://www.facebook.com/bbcnewsShe is best known for her work on the 2012 Par...CultureCelebrated composer and singer-songwriter Erro...http://www.bbc.co.uk/news/articles/c4gl758g7zgohttps://ichef.bbci.co.uk/ace/standard/2560/cps...Errollyn Wallen has been appointed Master of t...1. **Type of News**: Arts/Music\\n\\n2. **Summar...categorization=4 keyword_extraction=4 sentimen...categorization=5 keyword_extraction=5 sentimen...
2554SDLP: Matthew O'Toole endorses Claire Hanna fo...2024-08-30https://www.facebook.com/bbcnewsMatthew O'Toole had been named by some as a po...Northern Ireland PoliticsMatthew O'Toole leads his party's official opp...http://www.bbc.co.uk/news/articles/cvg41j7xrzdohttps://ichef.bbci.co.uk/ace/standard/3840/cps...Matthew O'Toole, the leader of the official op...1. **Type of News**: Politics\\n\\n2. **Summary*...categorization=5 keyword_extraction=4 sentimen...categorization=5 keyword_extraction=5 sentimen...
1338Rotherham rioters among those jailed - BBC News2024-08-20https://www.facebook.com/bbcnewsTwo men who were part of a mob targeting a Hol...South YorkshireRotherham pair among those jailed for UK rioti...http://www.bbc.co.uk/news/articles/cwywggd7qw6ohttps://ichef.bbci.co.uk/ace/standard/2560/cps...Two men, Nathan Palmer (29) and Niven Matthewm...1. **Type of News**: Politics / Crime and Just...categorization=3 keyword_extraction=3 sentimen...categorization=5 keyword_extraction=4 sentimen...
1232BBC News - BBC iPlayer2024-08-02NoneNoneNoneJavaScript seems to be disabled. Please enable...http://www.bbc.co.uk/news/10318089The article discusses the need to enable JavaS...I cannot provide a summary of the article as t...categorization=2 keyword_extraction=3 sentimen...categorization=1 keyword_extraction=1 sentimen...
\n", + "
" + ], + "text/plain": [ + " title published_date \\\n", + "2662 Laura Whitmore: I was gaslighted after raising... 2024-08-04 \n", + "1865 Errollyn Wallen appointed as Master of the Kin... 2024-08-25 \n", + "2554 SDLP: Matthew O'Toole endorses Claire Hanna fo... 2024-08-30 \n", + "1338 Rotherham rioters among those jailed - BBC News 2024-08-20 \n", + "1232 BBC News - BBC iPlayer 2024-08-02 \n", + "\n", + " authors \\\n", + "2662 https://www.facebook.com/bbcnews \n", + "1865 https://www.facebook.com/bbcnews \n", + "2554 https://www.facebook.com/bbcnews \n", + "1338 https://www.facebook.com/bbcnews \n", + "1232 None \n", + "\n", + " description \\\n", + "2662 The former Love Island host said that things s... \n", + "1865 She is best known for her work on the 2012 Par... \n", + "2554 Matthew O'Toole had been named by some as a po... \n", + "1338 Two men who were part of a mob targeting a Hol... \n", + "1232 None \n", + "\n", + " section \\\n", + "2662 Culture \n", + "1865 Culture \n", + "2554 Northern Ireland Politics \n", + "1338 South Yorkshire \n", + "1232 None \n", + "\n", + " content \\\n", + "2662 Television presenter Laura Whitmore has said t... \n", + "1865 Celebrated composer and singer-songwriter Erro... \n", + "2554 Matthew O'Toole leads his party's official opp... \n", + "1338 Rotherham pair among those jailed for UK rioti... \n", + "1232 JavaScript seems to be disabled. Please enable... \n", + "\n", + " link \\\n", + "2662 http://www.bbc.co.uk/news/articles/c9wvwvzm7x7o \n", + "1865 http://www.bbc.co.uk/news/articles/c4gl758g7zgo \n", + "2554 http://www.bbc.co.uk/news/articles/cvg41j7xrzdo \n", + "1338 http://www.bbc.co.uk/news/articles/cwywggd7qw6o \n", + "1232 http://www.bbc.co.uk/news/10318089 \n", + "\n", + " top_image \\\n", + "2662 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "1865 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "2554 https://ichef.bbci.co.uk/ace/standard/3840/cps... \n", + "1338 https://ichef.bbci.co.uk/ace/standard/2560/cps... \n", + "1232 \n", + "\n", + " simple_summary \\\n", + "2662 Television presenter Laura Whitmore has spoken... \n", + "1865 Errollyn Wallen has been appointed Master of t... \n", + "2554 Matthew O'Toole, the leader of the official op... \n", + "1338 Two men, Nathan Palmer (29) and Niven Matthewm... \n", + "1232 The article discusses the need to enable JavaS... \n", + "\n", + " complex_summary \\\n", + "2662 1. **Type of News**: Entertainment/Television\\... \n", + "1865 1. **Type of News**: Arts/Music\\n\\n2. **Summar... \n", + "2554 1. **Type of News**: Politics\\n\\n2. **Summary*... \n", + "1338 1. **Type of News**: Politics / Crime and Just... \n", + "1232 I cannot provide a summary of the article as t... \n", + "\n", + " simple_evaluation \\\n", + "2662 categorization=4 keyword_extraction=3 sentimen... \n", + "1865 categorization=4 keyword_extraction=4 sentimen... \n", + "2554 categorization=5 keyword_extraction=4 sentimen... \n", + "1338 categorization=3 keyword_extraction=3 sentimen... \n", + "1232 categorization=2 keyword_extraction=3 sentimen... \n", + "\n", + " complex_evaluation \n", + "2662 categorization=5 keyword_extraction=5 sentimen... \n", + "1865 categorization=5 keyword_extraction=5 sentimen... \n", + "2554 categorization=5 keyword_extraction=5 sentimen... \n", + "1338 categorization=5 keyword_extraction=4 sentimen... \n", + "1232 categorization=1 keyword_extraction=1 sentimen... " + ] + }, + "execution_count": 11, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "def evaluate_summaries(row):\n", + " simple_messages = [{\"role\": \"user\", \"content\": evaluation_prompt.format(original_article=row[\"content\"], summary=row['simple_summary'])}]\n", + " complex_messages = [{\"role\": \"user\", \"content\": evaluation_prompt.format(original_article=row[\"content\"], summary=row['complex_summary'])}]\n", + " \n", + " simple_summary = client.beta.chat.completions.parse(\n", + " model=\"gpt-4o\",\n", + " messages=simple_messages,\n", + " response_format=ScoreCard)\n", + " simple_summary = simple_summary.choices[0].message.parsed\n", + " \n", + " complex_summary = client.beta.chat.completions.parse(\n", + " model=\"gpt-4o\",\n", + " messages=complex_messages,\n", + " response_format=ScoreCard)\n", + " complex_summary = complex_summary.choices[0].message.parsed\n", + " \n", + " return simple_summary, complex_summary\n", + "\n", + "# Add new columns to the dataframe for storing evaluations\n", + "df['simple_evaluation'] = None\n", + "df['complex_evaluation'] = None\n", + "\n", + "# Use ThreadPoolExecutor to evaluate itineraries concurrently\n", + "with ThreadPoolExecutor() as executor:\n", + " futures = {executor.submit(evaluate_summaries, row): index for index, row in df.iterrows()}\n", + " for future in tqdm(as_completed(futures), total=len(futures), desc=\"Evaluating Summaries\"):\n", + " index = futures[future]\n", + " simple_evaluation, complex_evaluation = future.result()\n", + " df.at[index, 'simple_evaluation'] = simple_evaluation\n", + " df.at[index, 'complex_evaluation'] = complex_evaluation\n", + "\n", + "df.head()" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "import matplotlib.pyplot as plt\n", + "\n", + "df[\"simple_scores\"] = df[\"simple_evaluation\"].apply(lambda x: [score for key, score in x.model_dump().items() if key != 'justification'])\n", + "df[\"complex_scores\"] = df[\"complex_evaluation\"].apply(lambda x: [score for key, score in x.model_dump().items() if key != 'justification'])\n", + "\n", + "\n", + "# Calculate average scores for each criterion\n", + "criteria = [\n", + " 'Categorisation',\n", + " 'Keywords and Tags',\n", + " 'Sentiment Analysis',\n", + " 'Clarity and Structure',\n", + " 'Detail and Completeness'\n", + "]\n", + "\n", + "# Calculate average scores for each criterion by model\n", + "simple_avg_scores = df['simple_scores'].apply(pd.Series).mean()\n", + "complex_avg_scores = df['complex_scores'].apply(pd.Series).mean()\n", + "\n", + "\n", + "# Prepare data for plotting\n", + "avg_scores_df = pd.DataFrame({\n", + " 'Criteria': criteria,\n", + " 'Original Prompt': simple_avg_scores,\n", + " 'Improved Prompt': complex_avg_scores\n", + "})\n", + "\n", + "# Plotting\n", + "ax = avg_scores_df.plot(x='Criteria', kind='bar', figsize=(6, 4))\n", + "plt.ylabel('Average Score')\n", + "plt.title('Comparison of Simple vs Complex Prompt Performance by Model')\n", + "plt.xticks(rotation=45, ha='right')\n", + "plt.tight_layout()\n", + "plt.legend(loc='upper left', bbox_to_anchor=(1, 1))\n", + "plt.show()\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After evaluating the results, we found that while the basic prompt performed well in clarity and structure, the enhanced prompt significantly improved outputs across several other key criteria: Categorization, Keywords and Tags, Sentiment Analysis, and Detail and Completeness. The complex prompt led to summaries that were more informative, better organized, and richer in content.\n", + "\n", + "This demonstrates how refining prompts can greatly enhance the quality of the generated summaries. Although this is a simplified example, the benefits of prompt optimization are expected to be even more pronounced in real-world, production-level applications, leading to outputs that are more aligned with specific goals and user needs." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conclusion\n", + "\n", + "Meta prompting is a powerful technique that can significantly enhance the quality of outputs from language models. Our exploration showed that starting with a simple prompt and refining it using `o1-preview` led to summaries that were more informative, better organized, and richer in content—improving across key criteria like categorization, keywords and tags, sentiment analysis, and completeness. This exercise underscores the value of prompt optimization, and even in this simplified example, the benefits are clear. In real-world applications, leveraging meta prompting and tools like `o1-preview` can elevate language model performance to better meet your specific goals and user needs." + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.12.1" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/registry.yaml b/registry.yaml index ad46334dbe..b221875a2b 100644 --- a/registry.yaml +++ b/registry.yaml @@ -1645,6 +1645,15 @@ - completions - audio +- title: Enhance your prompts with meta prompting + path: examples/Enhance_your_prompts_with_meta_prompting.ipynb + date: 2024-10-23 + authors: + - teomusatoiu + tags: + - completions + - reasoning + - title: GPT Actions library - GitHub path: examples/chatgpt/gpt_actions_library/gpt_action_github.md date: 2024-10-23