notebooks/llmu/RAG_with_Quickstart_Connectors.ipynb

{
  "cells": [
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "1lq03xVdfzMX"
      },
      "source": [
        "<a target=\"_blank\" href=\"https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/llmu/RAG_with_Quickstart_Connectors.ipynb\">\n",
        "  <img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/>\n",
        "</a>"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "RHv_VYcmkRFI"
      },
      "source": [
        "# RAG with Quickstart Connectors"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "yZzk64vUhC8T"
      },
      "source": [
        "*Note: To run the notebook, you must first deploy your own Google Drive connector as a web-based REST API (the steps are outlined [here](https://txt.cohere.com/rag-quickstart-connectors/#build-and-deploy-the-connector)).*\n",
        "\n",
        "*The connector implementation code is [available here](examples/rag_quickstart_connectors/gdrive).*"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "LgnnKlvWgfi8"
      },
      "source": [
        "This notebook shows how to build a RAG-powered chatbot with Cohere's Chat endpoint using one of 80+ pre-built quickstart connectors. We’ll use it to connect a chatbot to a Google Drive, enabling the chatbot to use the Google Drive API to find answers to a user’s question by searching documents in the Google Drive.\n",
        "\n",
        "Read the accompanying [article here](https://txt.cohere.com/rag-quickstart-connectors/)."
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "FBb1kNk5gl9S"
      },
      "source": [
        "With quickstart connectors, developers can use pre-built implementations of over 80 connectors immediately without having to build them themselves. They can either use these quickstart connectors directly or adapt them to their organization’s needs.\n",
        "\n",
        "Cohere’s quickstart connectors are open-sourced and available in [our connectors repository](https://github.com/cohere-ai/quick-start-connectors/tree/main?ref=txt.cohere.com).\n",
        "\n",
        "The diagram below provides an overview of what we’ll build.\n"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "Hb1Q0wjFuhtn"
      },
      "source": [
        "![rag-workflow-4.png](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAB8gAAAL4CAYAAAAXhq2ZAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAJx2SURBVHgB7P0PmF11fS/6fzKZMJMAyUCAAElM6IFgtSWIRcF7BcE/rX+RKrZWidDy67nPuUXgHs/to5UfcuFoe+RewHg95zyXKwXso1VaRNtqtYJAryLeAlHxaPQ0GQkKQSRBCOFfcuez6UpXdvae2Xtmz56993q9fPYzk5m91157zTj7w+e9Pt81b/eEAAAAAAAAAIABNxQAAAAAAAAAUAECcgAAAAAAAAAqQUAOAAAAAAAAQCUIyAEAAAAAAACoBAE5AAAAAAAAAJUgIAcAAAAAAACgEgTkAAAAAAAAAFSCgBwAAAAAAACAShCQAwAAAAAAAFAJAnIAAAAAAAAAKkFADgAAAAAAAEAlCMgBAAAAAAAAqAQBOQAAAAAAAACVICAHAAAAAAAAoBIE5AAAAAAAAABUgoAcAAAAAAAAgEoQkAMAAAAAAABQCQJyAAAAAAAAACpBQA4AAAAAAABAJQjIAQAAAAAAAKgEATkAAAAAAAAAlSAgBwAAAAAAAKASBOQAAAAAAAAAVIKAHAAAAAAAAIBKEJADAAAAAAAAUAkCcgAAAAAAAAAqQUAOAAAAAAAAQCUIyAEAAAAAAACoBAE5AAAAAAAAAJUgIAcAAAAAAACgEgTkAAAAAAAAAFSCgBwAAAAAAACAShCQAwAAAAAAAFAJAnIAAAAAAAAAKkFADgAAAAAAAEAlCMgBAAAAAAAAqAQBOQAAAAAAAACVICAHAAAAAAAAoBIE5AAAAAAAAABUgoAcAAAAAAAAgEoQkAMAAAAAAABQCQJyAAAAAAAAACpBQA4AAAAAAABAJQjIAQAAAAAAAKgEATkAAAAAAAAAlSAgBwAAAAAAAKASBOQAAAAAAAAAVIKAHAAAAAAAAIBKEJADAAAAAAAAUAkCcgAAAAAAAAAqQUAOAAAAAAAAQCUIyAEAAAAAAACoBAE5AAAAAAAAAJUgIAcAAAAAAACgEgTkAAAAAAAAAFSCgBwAAAAAAACAShCQAwAAAAAAAFAJAnIAAAAAAAAAKkFADgAAAAAAAEAlCMgBAAAAAAAAqAQBOQAAAAAAAACVICAHAAAAAAAAoBIE5AAAAAAAAABUgoAcAAAAAAAAgEoQkAMAAAAAAABQCQJyAAAAAAAAACpBQA4AAAAAAABAJQjIAQAAAAAAAKgEATkAAAAAAAAAlSAgBwAAAAAAAKASBOQAAAAAAAAAVIKAHAAAAAAAAIBKEJADAAAAAAAAUAkCcgAAAAAAAAAqQUAOAAAAAAAAQCUIyAEAAAAAAACoBAE5AAAAAAAAAJUgIAcAAAAAAACgEgTkAAAAAAAAAFSCgBwAAAAAAACAShCQAwAAAAAAAFAJAnIAAAAAAAAAKkFADgAAAAAAAEAlCMgBAAAAAAAAqAQBOQAAAAAAAACVICAHAAAAAAAAoBIE5AAAAAAAAABUgoAcAAAAAAAAgEoQkAMAAAAAAABQCQJyAAAAAAAAACpBQA4AAAAAAABAJQjIAQAAAAAAAKgEATkAAAAAAAAAlSAgBwAAAAAAAKASBOQAAAAAAAAAVIKAHAAAAAAAAIBKEJADAAAAAAAAUAkCcgAAAAAAAAAqQUAOAAAAAAAAQCUIyAEAAAAAAACoBAE5AAAAAAAAAJUgIAcAAAAAAACgEgTkAAAAAAAAAFSCgBwAAAAAAACAShCQAwAAAAAAAFAJAnIAAAAAAAAAKkFADgAAAAAAAEAlCMgBAAAAAAAAqAQBOQAAAAAAAACVICAHAAAAAAAAoBIE5AAAAAAAAABUgoAcAAAAAAAAgEoQkAMAAAAAAABQCQJyAAAAAAAAACpBQA4AAAAAAABAJQjIAQAAAAAAAKgEATkAAAAAAAAAlSAgBwAAAAAAAKASBOQAAAAAAAAAVIKAHAAAAAAAAIBKEJADAAAAAAAAUAkCcgAAAAAAAAAqQUAOAAAAAAAAQCUIyAEAAAAAAACoBAE5AAAAAAAAAJUgIAcAAAAAAACgEgTkAAAAAAAAAFSCgBwAAAAAAACAShCQAwAAAAAAAFAJAnIAAAAAAAAAKkFADgAAAAAAAEAlCMgBAAAAAAAAqAQBOQAAAAAAAACVICAHAAAAAAAAoBIE5AAAAAAAAABUgoAcAAAAAAAAgEoQkAMAAAAAAABQCQJyAAAAAAAAACpBQA4AAAAAAABAJQjIAQAAAAAAAKgEATkAAAAAAAAAlSAgBwAAAAAAAKASBOQAAAAAAAAAVIKAHAAAAAAAAIBKEJADAAAAAAAAUAkCcgAAAAAAAAAqQUAOAAAAAAAAQCUI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AAAAekFADgAAAAAAAEAvCMgBAAAAAAAA6AUBOQAAAAAAAAC9ICAHAAAAAAAAoBcE5AAAAAAAAAD0goAcAAAAAAAAgF4QkAMAAAAAAADQCwJyAAAAAAAAAHpBQA4AAAAAAABALwjIAQAAAAAAAOgFATkAAAAAAAAAvSAgBwAAAAAAAKAXBOQAAAAAAAAA9IKAHAAAAAAAAIBeEJADAAAAAAAA0AsCcgAAAAAAAAB6QUAOAAAAAAAAQC8IyAEAAAAAAADoBQE5AAAAAAAAAL0gIAcAAAAAAACgFwTkAAAAAAAAAPSCgBwAAAAAAACAXhCQAwAAAAAAANALAnIAAAAAAAAAekFADgAAAAAAAEAvCMgBAAAAAAAA6AUBOQAAAAAAAAC9ICAHAAAAAAAAoBcE5AAAAAAAAAD0goAcAAAAAAAAgF4QkAMAAAAAAADQCwJyAAAAAAAAAHpBQA4AAAAAAABALwjIAQAAAAAAAOgFATkAAAAAAAAAvSAgBwAAAAAAAKAXBOQAAAAAAAAA9IKAHAAAAAAAAIBeEJADAAAAAAAA0AsCcgAAAAAAAAB6QUAOAAAAAAAAQC8IyAEAAAAAAADoBQE5AAAAAAAAAL0gIAcAAAAAAACgFwTkAAAAAAAAAPSCgBwAAAAAAACAXhCQAwAAAAAAANALAnIAAAAAAAAAekFADgAAAAAAAEAvCMgBAAAAAAAA6AUBOQAAAAAAAAC9ICAHAAAAAAAAoBcE5AAAAAAAAAD0goAcAAAAAAAAgF4QkAMAAAAAAADQCwJyAAAAAAAAAHpBQA4AAAAAAABALwjIAQAAAAAAAOgFATkAAAAAAAAAvSAgBwAAAAAAAKAXBOQAAAAAAAAA9IKAHAAAAAAAAIBeEJADAAAAAAAA0AsCcgAAAAAAAAB6QUAOAAAAAAAAQC8IyAEAAAAAAADoBQE5AAAAAAAAAL0gIAcAAAAAAACgFwTkAAAAAAAAAPSCgBwAAAAAAACAXhCQAwAAAAAAANALAnIAAAAAAAAAekFADgAAAAAAAEAvCMgBAAAAAAAA6AUBOQAAAAAAAAC9ICAHAAAAAAAAoBcE5AAAAAAAAAD0goAcAAAAAAAAgF4QkAMAAAAAAADQCwJyAAAAAAAAAHpBQA4AAAAAAABALwjIAQAAAAAAAOgFATkAAAAAAAAAvSAgBwAAAAAAAKAXBOQAAAAAAAAA9IKAHAAAAAAAAIBeEJADAAAAAAAA0AsCcgAAAAAAAAB6QUAOAAAAAAAAQC8IyAEAAAAAAADoBQE5AAAAAAAAAL0gIAcAAAAAAACgFwTkAAAAAAAAAPSCgBwAAAAAAACAXhCQAwAAAAAAANALAnIAAAAAAAAAekFADgAAAAAAAEAvCMgBAAAAAAAA6AUBOQAAAAAAAAC9ICAHAAAAAAAAoBcE5AAAAAAAAAD0goAcAAAAAAAAgF4QkAMAAAAAAADQCwJyAAAAAAAAAHpBQA4AAAAAAABALwjIAQAAAAAAAOgFATkAAAAAAAAAvSAgBwAAAAAAAKAXBOQAAAAAAAAA9IKAHAAAAAAAAIBeEJADAAAAAAAA0AsCcgAAAAAAAAB6QUAOAAAAAAAAQC8IyAEAAAAAAADoBQE5AAAAAAAAAL0gIAcAAAAAAACgFwTkAAAAAAAAAPSCgBwAAAAAAACAXhCQAwAAAAAAANALAnIAAAAAAAAAekFADgAAAAAAAEAvCMgBAAAAAAAA6AUBOQAAAAAAAAC9ICAHAAAAAAAAoBcE5AAAAAAAAAD0goAcAAAAAAAAgF4QkAMAAAAAAADQCwJyAAAAAAAAAHpBQA4AAAAAAABALwjIAQAAAAAAAOgFATkAAAAAAAAAvSAgBwAAAAAAAKAXBOQAAAAAAAAA9IKAHAAAAAAAAIBeEJADAAAAAAAA0Av/H5PvzC/FdluLAAAAAElFTkSuQmCC)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "7ov6QwswXmfJ"
      },
      "source": [
        "# Setup"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "ofFN7iLvXn43",
        "outputId": "45f5bd8e-a76e-410e-f62f-4f96fb86c0fa"
      },
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m117.2/117.2 kB\u001b[0m \u001b[31m1.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
            "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m75.6/75.6 kB\u001b[0m \u001b[31m3.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
            "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m77.8/77.8 kB\u001b[0m \u001b[31m5.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
            "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m58.3/58.3 kB\u001b[0m \u001b[31m5.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
            "\u001b[?25h"
          ]
        }
      ],
      "source": [
        "! pip install cohere -q"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 1,
      "metadata": {
        "id": "P1wBvi56Rnmv"
      },
      "outputs": [],
      "source": [
        "import cohere\n",
        "from cohere import ChatConnector\n",
        "import uuid\n",
        "from typing import List\n",
        "\n",
        "co = cohere.Client(\"COHERE_API_KEY\") # Get your API key here: https://dashboard.cohere.com/api-keys"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 3,
      "metadata": {},
      "outputs": [],
      "source": [
        "#@title Enable text wrapping in Google Colab\n",
        "\n",
        "from IPython.display import HTML, display\n",
        "\n",
        "def set_css():\n",
        "  display(HTML('''\n",
        "  <style>\n",
        "    pre {\n",
        "        white-space: pre-wrap;\n",
        "    }\n",
        "  </style>\n",
        "  '''))\n",
        "get_ipython().events.register('pre_run_cell', set_css)"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "IvtgPNskj5LY"
      },
      "source": [
        "# Test the Connector"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "wFCfGIZsk58k"
      },
      "source": [
        "We can test if the connector is working by making a curl request to its search endpoint.\n",
        "\n",
        "Note: The steps to build and deploy the connector are outlined in [this article](https://txt.cohere.com/rag-chatbot-quickstart/). The implementation code is available [here](https://github.com/cohere-ai/notebooks/tree/main/examples/chat_rag_quickstart_connector)."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "t8am2kZpcYpf",
        "outputId": "f316fbcc-6b77-4adf-b058-b198e0ba3039"
      },
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "{\n",
            "  \"results\": [\n",
            "    {\n",
            "      \"editedBy\": \"Meor Amer\",\n",
            "      \"id\": \"1LGsOhBL02jwy5UUIS8tuv9G80FSn7vxeQYiiglsN9oY\",\n",
            "      \"mimeType\": \"application/vnd.google-apps.document\",\n",
            "      \"modifiedTime\": \"2023-12-01T07:51:43.489Z\",\n",
            "      \"text\": \"\\ufeffConstructing Prompts\\r\\nIn this chapter, you'll learn about the different techniques for constructing prompts for the Command model.\\r\\nSuggest Edits\\r\\n!https://files.readme.io/76e9a4b-constructing-prompts-for-the-command-model.png\\r\\nIntroduction\\r\\nWhen working with large language models (LLMs), the prompt is the key to getting the desired response. A well-designed prompt will result in useful and accurate responses from a model and considerably improve your experience interacting with it.\\r\\nPrompts can be as simple as a one-liner, or they can be as complex as multiple layers of specific information. The more specific your command is, the more likely you will get exactly what you need from the model. We\\u2019ll look at some tips and ideas for constructing the commands in your prompt to help you get to your intended outcome. We\\u2019ll focus on the broad patterns without going into the long-tail list of techniques and tricks.\\r\\nWe\\u2019ll be using the Command model , Cohere\\u2019s instruction-following model that enables generative AI use cases in business productivity, marketing, creative writing, and more. This chapter comes with a Google Colaboratory notebook that lets you get hands-on with the code.\\r\\nSetting Up\\r\\nFirst, let\\u2019s install the Cohere Python SDK, get the Cohere API key, and set up the client.\\r\\nPython\\r\\n! pip install \"cohere<5\" import cohere co = cohere.Client(\\\"COHERE_API_KEY\\\") # Your Cohere API key\\r\\nLet\\u2019s also define a function to take a prompt and a temperature value and then call the Generate endpoint , which is how we can access the Command model. Here, we select the model type to be command.\\r\\nWe set a default temperature value of 0, which nudges the response to be more predictable and less random. Throughout this chapter, you\\u2019ll see different temperature values being used in different situations. Increasing the temperature value tells the model to generate less predictable responses and instead be more \\u201ccreative.\\u201d\\r\\nThis function returns the text response generated by the model.\\r\\nPython\\r\\ndef generate_text(prompt, temp=0): response = co.generate( model='command', prompt=prompt, max_tokens=200, temperature=temp) return response.generations[0].text\\r\\nInstruction\\r\\n!https://txt.cohere.com/content/images/2023/07/Instruction.png\\r\\nAdding basic instructions to a prompt\\r\\nWhile prompts can morph into something very lengthy and complex, it doesn\\u2019t have to be that way all the time. At its core, prompting a Command model is about sending an instruction to a text generation model and getting a response back. Hence, the smallest unit of a perfectly complete prompt is a short line of instruction to the model.\\r\\nLet\\u2019s say we want to generate a product description for a wireless headphone. Here\\u2019s an example prompt, where we create a variable for the user to input some text and merge that into the main prompt.\\r\\nPython\\r\\n`user_input = \\\"a wireless headphone product named the CO-1T\\\" prompt = f\\\"\\\"\\\"Write a creative product description for {user_input}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nThe model returns the following sample response, which does the job we asked for.\\r\\nThe CO-1T is a sleek and stylish wireless headphone product that offers a comfortable and secure fit for all-day wear. These headphones feature a noise-cancelling microphone and easy-to-use controls, making them perfect for use during your daily commute or while you're at the gym. The CO-1T comes with a charging cable and a carrying case, so you can take them with you on the go.\\r\\n\\r\\n\\r\\nThe CO-1T features a powerful and clear sound quality, making it easy to hear your favorite music and podcasts. The noise-cancelling microphone ensures that you can take calls without any distractions, while the easy-to-use controls allow you to adjust the volume and playback of your music.\\r\\n\\r\\n\\r\\nSpecifics\\r\\n!https://txt.cohere.com/content/images/2023/07/Specifics.png\\r\\nAdding specific details to a prompt\\r\\nA simple and short prompt can get you started, but in most cases, you\\u2019ll need to add specificity to your instructions. A generic prompt will return a generic response, and in most cases, that\\u2019s not what we want. In the same way that specific instructions will help humans do our job well, a model needs to be supplied with specific details to guide its response.\\r\\nGoing back to the previous prompt, the generated product description was great, but what if we wanted it to include specific things, such as its features, who it is designed for, and so on? We can adjust the prompt to take more inputs from the user, like so:\\r\\nPython\\r\\n`user_input_product = \\\"a wireless headphone product named the CO-1T\\\" user_input_keywords = '\\\"bluetooth\\\", \\\"wireless\\\", \\\"fast charging\\\"' user_input_customer = \\\"a software developer who works in noisy offices\\\" user_input_describe = \\\"benefits of this product\\\"\\r\\nprompt = f\\\"\\\"\\\"Write a creative product description for {user_input_product}, \\\\ with the keywords {user_input_keywords} for {user_input_customer}, and describe {user_input_describe}.\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nIn the example above, we pack the additional details of the prompt in a single paragraph. Alternatively, we can also compose it to be more structured, like so:\\r\\nPython\\r\\n`user_input_product = \\\"a wireless headphone product named the CO-1T\\\" user_input_keywords = '\\\"bluetooth\\\", \\\"wireless\\\", \\\"fast charging\\\"' user_input_customer = \\\"a software developer who works in noisy offices\\\" user_input_describe = \\\"benefits of this product\\\"\\r\\nprompt = f\\\"\\\"\\\"Write a creative product description for {user_input_product}. Keywords: {user_input_keywords} Audience: {user_input_customer} Describe: {user_input_describe}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nAnd here\\u2019s an example response. This time, the product description is tailored more specifically to our desired target customer, includes the key features that we specified, and sprinkles benefit statements throughout \\u2014 all coming from the instruction we added to the prompt.\\r\\nDo you hate noisy work environments? Well, we got a great solution for you! The CO-1T is the perfect wireless headphone for software developers who work in loud and disruptive offices. With its Bluetooth connectivity and noise-canceling features, you can stay focused on your work without any distractions.  Our product also has fast charging, so you won't have to worry about battery life. Instead, you can quickly get back to work in no time. So what are you waiting for? Become the most productive person in your office with the help of the CO-1T.\\r\\n\\r\\n\\r\\nThere are many other angles to add specificity to a prompt. Here are some examples:\\r\\n* Style : Telling the model to provide a response that follows a certain style or framework. For example, instead of asking the model to \\u201cGenerate an ad copy for a wireless headphone product\\u201d in the generic sense, we ask it to follow a certain style, such as \\u201cGenerate an ad copy for a wireless headphone product, following the AIDA Framework \\u2013 Attention, Interest, Desire, Action.\\u201d\\r\\n* Tone : Adding a line mentioning how the tone of a piece of text should be, such as professional, inspirational, fun, serious, and so on. For example, \\u201cTone: casual\\u201d\\r\\n* Persona : Telling the model to act like a certain persona helps to add originality and quality to the response. For example, \\u201cYou are a world-class content marketer. Write a product description for\\u2026\\u201d\\r\\n* Length : Telling the model to generate text with a specific length, be it in words, paragraphs, and others. This helps guide the model to be verbose, concise, or somewhere in between. For example, \\u201cWrite in three paragraphs the benefits of \\u2026\\u201d\\r\\nContext\\r\\n!https://txt.cohere.com/content/images/2023/07/Context.png\\r\\nAdding contextual information to a prompt\\r\\nWhile LLMs excel in text generation tasks, they struggle in context-aware scenarios. Here\\u2019s an example. If you were to ask the model for the top qualities to look for in wireless headphones, it will duly generate a solid list of points. But if you were to ask it for the top qualities of the CO-1T headphone, it will not be able to provide an accurate response because it doesn\\u2019t know about it (CO-1T is a hypothetical product we just made up for illustration purposes).\\r\\nIn real applications, being able to add context to a prompt is key because this is what enables personalized generative AI for a team or company. It makes many use cases possible, such as intelligent assistants, customer support, and productivity tools, that retrieve the right information from a wide range of sources and add it to the prompt.\\r\\nThis is a whole topic on its own, but to provide some idea, this demo shows an example of text generation with information retrieval in action. Here though, we\\u2019ll assume that the right information is already retrieved and added to the prompt.\\r\\nHere\\u2019s an example where we ask the model to list the features of the CO-1T wireless headphone without any additional context:\\r\\nPython\\r\\n`user_input =\\\"What are the key features of the CO-1T wireless headphone\\\" prompt = user_input\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nThis generates a response that the model makes up since it doesn\\u2019t have any information to refer to.\\r\\nThe CO-1T wireless headphone is a high-quality, comfortable, and durable headphone that is designed for use with a variety of devices. It features a sleek and modern design, a comfortable and secure fit, and a high-quality sound. The CO-1T is also equipped with a variety of features, including a built-in microphone, a multi-function button, and a rechargeable battery.\\r\\n\\r\\n\\r\\nAnd here\\u2019s the same request to the model, this time with the product description of the product added as context.\\r\\nPython\\r\\n`context = \\\"\\\"\\\"Think back to the last time you were working without any distractions in the office. That's right...I bet it's been a while. \\\\ With the newly improved CO-1T noise-cancelling Bluetooth headphones, you can work in peace all day. Designed in partnership with \\\\ software developers who work around the mayhem of tech startups, these headphones are finally the break you've been waiting for. With \\\\ fast charging capacity and wireless Bluetooth connectivity, the CO-1T is the easy breezy way to get through your day without being \\\\ overwhelmed by the chaos of the world.\\\"\\\"\\\"\\r\\nuser_input = \\\"What are the key features of the CO-1T wireless headphone\\\"\\r\\nprompt = f\\\"\\\"\\\"{context} Given the information above, answer this question: {user_input}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nNow, the model accurately lists the features of the model.\\r\\nThe answer is:\\r\\nThe CO-1T wireless headphones are designed to be noise-canceling and Bluetooth-enabled. They are also designed to be fast charging and have wireless Bluetooth connectivity.\\r\\n\\r\\n\\r\\nFormat\\r\\n!https://txt.cohere.com/content/images/2023/07/Format.png\\r\\nAdding output format requirements to a prompt\\r\\nSo far, we have seen how to get the model to generate responses that follow certain styles or include specific information. But we can also get the model to generate responses in a certain format. Let\\u2019s look at a couple of them: markdown tables and JSON strings.\\r\\nHere, the task is to extract information from a list of invoices. Instead of providing the information in plain text, we can prompt the model to generate a table containing all the required information.\\r\\nPython\\r\\n`prompt=\\\"\\\"\\\"Turn the following information into a table with columns Invoice Number, Merchant Name, and Account Number. Bank Invoice: INVOICE #0521 MERCHANT ALLBIRDS ACC XXX3846 Bank Invoice: INVOICE #6781 MERCHANT SHOPPERS ACC XXX9877 Bank Invoice: INVOICE #0777 MERCHANT CN TOWER ACC XXX3846 \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nThe response will come in the form of a markdown table.\\r\\n| Invoice Number | Merchant Name | Account Number |\\r\\n|-----------|------------|-----------|\\r\\n| 0521 | Allbirds | XXX3846 |\\r\\n| 6781 | Shoppers | XXX9877 |\\r\\n| 0777 | CN Tower | XXX3846 |\\r\\n\\r\\n\\r\\nAnother useful format is JSON, which we can modify the prompt as follows.\\r\\nPython\\r\\n`prompt=\\\"\\\"\\\"Turn the following information into a JSON string with the following keys: Invoice Number, Merchant Name, and Account Number. Bank Invoice: INVOICE #0521 MERCHANT ALLBIRDS ACC XXX3846 Bank Invoice: INVOICE #6781 MERCHANT SHOPPERS ACC XXX9877 Bank Invoice: INVOICE #0777 MERCHANT CN TOWER ACC XXX3846 \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nThis returns the following response.\\r\\nJSON\\r\\n[ { \\\"Invoice Number\\\": \\\"0521\\\", \\\"Merchant Name\\\": \\\"Allbirds\\\", \\\"Account Number\\\": \\\"XXXX3846\\\" }, { \\\"Invoice Number\\\": \\\"6781\\\", \\\"Merchant Name\\\": \\\"Shoppers\\\", \\\"Account Number\\\": \\\"XXXX9877\\\" }, { \\\"Invoice Number\\\": \\\"0777\\\", \\\"Merchant Name\\\": \\\"CN Tower\\\", \\\"Account Number\\\": \\\"XXXX3846\\\" } ]\\r\\nExamples\\r\\n!https://txt.cohere.com/content/images/2023/07/Examples.png\\r\\nAdding examples to a prompt\\r\\nAll our prompts so far use what is called zero-shot prompting , which means that we are providing instruction without any example. But in many cases, it is extremely helpful to provide examples to the model to guide its response. This is called few-shot prompting .\\r\\nFew-shot prompting is especially useful when we want the model response to follow a certain style or format. Also, sometimes it is hard to explain what you want in an instruction, and easier to show examples.\\r\\nLet\\u2019s use an example task, where a model should take a request coming from a human and rephrase it into the most accurate utterance that an AI virtual assistant should use. The example data is taken from this paper (Einolghozati et al., 2020).\\r\\nWe\\u2019ll use this example request: \\u201cSend a message to Alison to ask if she can pick me up tonight to go to the concert together\\u201d. Given that request, we should expect the rephrased utterance to be something like: \\u201cCan you pick me up tonight to go to the concert together?\\u201d\\r\\nFirst, let\\u2019s generate a response without giving the model an example. Here\\u2019s the prompt:\\r\\nPython\\r\\n`prompt=\\\"\\\"\\\"Turn the following message to a virtual assistant into the correct action: Send a message to Alison to ask if she can pick me up tonight to go to the concert together\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nThe response we get is not wrong, but it doesn\\u2019t follow the style that we need, which is a simple one-line rephrasing of the original request. Instead, it generates an email!\\r\\nHere is the message to Alison:\\r\\n\\r\\n\\r\\nHey Alison, I hope you're doing well! I was wondering if you could pick me up tonight to go to the concert together. I would really appreciate it, and I think it would be a lot of fun. Let me know if you're able to do this, and I'll make sure to be ready on time.\\r\\n\\r\\n\\r\\nThanks,\\r\\n[Your Name]\\r\\n\\r\\n\\r\\nNow, let\\u2019s modify the prompt by adding a few examples of how we expect the output to be.\\r\\nPython\\r\\n`user_input = \\\"Send a message to Alison to ask if she can pick me up tonight to go to the concert together\\\"\\r\\nprompt=f\\\"\\\"\\\"Turn the following message to a virtual assistant into the correct action:\\r\\nMessage: Ask my aunt if she can go to the JDRF Walk with me October 6th Action: can you go to the jdrf walk with me october 6th\\r\\nMessage: Ask Eliza what should I bring to the wedding tomorrow Action: what should I bring to the wedding tomorrow\\r\\nMessage: Send message to supervisor that I am sick and will not be in today Action: I am sick and will not be in today\\r\\nMessage: {user_input}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nThis time, the style of the response is exactly how we want it.\\r\\nCan you pick me up tonight to go to the concert together?\\r\\n\\r\\n\\r\\nChain of Thought\\r\\nOne specific way to provide examples in a prompt is to show responses that include a reasoning step. This way, we are asking the model to \\u201cthink\\u201d first rather than going straight to the response. In tasks involving mathematical questions, for example, there is a huge difference between directly giving the answer and adding a reasoning step in between.\\r\\nThis concept is called chain of thought prompting, introduced by Wei et al. Let\\u2019s look at an example from the paper which illustrates this idea.\\r\\nFirst let\\u2019s look at a prompt without a chain of thought. It contains one example of a question followed by the answer, without any intermediate calculation step. It also contains the new question we want to answer.\\r\\nPython\\r\\n`prompt=f\\\"\\\"\\\" Q: Roger has 5 tennis balls. He buys 2 more cans of tennis balls. Each can has 3 tennis balls. \\\\ How many tennis balls does he have now? A: The answer is 11. Q: The cafeteria had 23 apples. If they used 20 to make lunch and bought 6 more, how many apples do they have? A:\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nWe get the following response, which is an incorrect answer. And notice that the response is direct, in the same style as the example given.\\r\\nThe answer is 29.\\r\\n\\r\\n\\r\\nNow, let\\u2019s repeat that, this time with a chain of thought. Now, the example answer contains a reasoning step, describing the calculation logic to get to the final answer, before giving the final answer.\\r\\nPython\\r\\n`prompt=f\\\"\\\"\\\" Q: Roger has 5 tennis balls. He buys 2 more cans of tennis balls. Each can has 3 tennis balls. \\\\ How many tennis balls does he have now? A: Roger started with 5 balls. 2 cans of 3 tennis balls each is 6 tennis balls. 5 + 6 = 11. \\\\ The answer is 11. Q: The cafeteria had 23 apples. If they used 20 to make lunch and bought 6 more, how many apples do they have? A:\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nAnd we get the correct answer this time, with the response following the style of the example given.\\r\\nThe cafeteria started with 23 apples. They used 20 to make lunch, so they have 23 - 20 = 3 apples. They bought 6 more apples, so they have 3 + 6 = 9 apples. The answer is 9.\\r\\n\\r\\n\\r\\nSteps\\r\\n!https://txt.cohere.com/content/images/2023/07/Steps.png\\r\\nAdding generation steps to a prompt\\r\\nTo steer the model toward generating higher-quality responses, it can be helpful to add instructions for the model to generate intermediate steps before generating the final output. The information generated during these steps helps enrich the model\\u2019s context before it generates the final response.\\r\\nThere could be another scenario where we specifically need the response to be detailed and verbose. In this case, asking the model to generate responses in steps will become handy.\\r\\nLet\\u2019s use an example of generating startup ideas. We can get the model to directly generate an idea for a given industry, like so:\\r\\nPython\\r\\n`user_input = \\\"education\\\"\\r\\nprompt = f\\\"\\\"\\\"Generate a startup idea for this industry: {user_input}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nThis generates the following response, which is reasonable, but perhaps not rich enough in information.\\r\\nA mobile app that connects students with tutors for on-demand homework help.\\r\\n\\r\\n\\r\\nAlternatively, we can ask the model to generate information in steps, such as describing the problem to be solved and the target audience experiencing this problem.\\r\\nPython\\r\\n`user_input = \\\"education\\\"\\r\\nprompt = f\\\"\\\"\\\"Generate a startup idea for this industry: {user_input} First, describe the problem to be solved. Next, describe the target audience of this startup idea. Next, describe the startup idea and how it solves the problem for the target audience. Next, provide a name for the given startup.\\r\\nUse the following format: Industry: <the given industry> The Problem: <the given problem> Audience: <the given target audience> Startup Idea: <the given idea> Startup Name: <the given name>\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.9) print(response)`\\r\\nThis provides a richer description of the startup idea.\\r\\nIndustry: Education\\r\\nThe Problem: Students often need to learn at their own pace and require individual attention to succeed in their studies.\\r\\nAudience: Students who need a more personalized learning experience.\\r\\nStartup Idea: An online platform that connects students with tutors for personalized one-on-one learning.\\r\\nStartup Name: tutormate\\r\\n\\r\\n\\r\\nPrefix\\r\\n!https://txt.cohere.com/content/images/2023/07/Prefix.png\\r\\nAdding a prefix to a prompt\\r\\nTo ensure that the response follows a consistent format or style, sometimes we need to add a prefix or leading words to help guide the response. This is especially handy when the temperature value is high. In this scenario, we want the response to be creative but, at the same time, follow a certain format.\\r\\nLet\\u2019s say we are generating the characteristics of football players for a given position, with one separate paragraph per characteristic. A prompt without any guiding prefix would look something like this:\\r\\nPython\\r\\n`user_input_position = \\\"modern centre forward\\\"\\r\\nprompt = f\\\"\\\"\\\"Describe the ideal {user_input_position}. In particular, describe the following characteristics: \\\\ pace, skill, and awareness.\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.9) print(response)`\\r\\nAnd the response is a paragraph combining all the characteristics \\u2014 not what we wanted.\\r\\nAn ideal modern centre forward would have a combination of pace, skill, and awareness. They would be fast and agile, with the ability to run and move with the ball at speed. They would also be skilled with their feet, with the ability to dribble and pass the ball with ease. Finally, they would be aware of their surroundings and the position of their teammates and opponents, with the ability to make quick and intelligent decisions on the fly.\\r\\n\\r\\n\\r\\nBut if we just added a prefix of the first characteristic (\\u201cPace\\u201d) at the end of the prompt, it will give a signal to the model as to how the output should look like.\\r\\nPython\\r\\n`user_input_position = \\\"modern centre forward\\\"\\r\\nprompt = f\\\"\\\"\\\"Describe the ideal {user_input_position}. In particular, describe the following characteristics: \\\\ pace, skill, and awareness.\\r\\nPace:\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.9) print(response)`\\r\\nHere\\u2019s an example response, which is much closer to what we are looking for:\\r\\nThe ideal modern centre forward will have excellent pace, both in terms of speed and acceleration. This will allow them to take advantage of gaps in the opposition defence and create chances for their team.\\r\\nSkill:\\r\\n\\r\\n\\r\\nThe ideal modern centre forward will also have a high level of skill, including dribbling, passing, and shooting. This will allow them to create chances for themselves and their team, as well as to score goals.\\r\\n\\r\\n\\r\\nAwareness:\\r\\n\\r\\n\\r\\nThe ideal modern centre forward will also have a high level of awareness, including an understanding of the game and their position within it. This will allow them to make intelligent decisions on the pitch, both in terms of their own play and in terms of the overall strategy of their team.\\r\\n\\r\\n\\r\\nZero-Shot Chain of Thought\\r\\nOne specific way of adding prefixes to a prompt is such that it encourages the model to perform a reasoning step before generating the final answer.\\r\\nEarlier, we saw that chain-of-thought prompting helps guide the model to perform reasoning by way of showing examples. But Kojima et al. show that there\\u2019s a way to apply chain-of-thought prompting without providing examples. This technique is called zero-shot chain of thought In contrast, the technique with examples discussed earlier is known as \\u201cfew-shot chain of thought\\u201d.\\r\\nThe paper proposes adding a prefix that nudges the model to perform a reasoning step, specifically the phrase \\u201cLet\\u2019s think step by step\\u201d.\\r\\nHere\\u2019s an example taken from the paper. First, we look at a prompt without the \\u201cLet\\u2019s think step by step\\u201d prefix.\\r\\nPython\\r\\n`prompt=f\\\"\\\"\\\"Q: A juggler can juggle 16 balls. Half of the balls are golf balls, and half of the golf balls are blue. How many blue golf balls are there? A: The answer (arabic numerals) is\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nIt gives an incorrect answer.\\r\\n8\\r\\n\\r\\n\\r\\nNow, let\\u2019s add the \\u201cLet\\u2019s think step by step\\u201d prefix to the prompt.\\r\\nPython\\r\\n`prompt=f\\\"\\\"\\\"Q: A juggler can juggle 16 balls. Half of the balls are golf balls, and half of the golf balls are blue. How many blue golf balls are there? A: Let\\u2019s think step by step.\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nAnd this time, the response contains a reasoning step before giving the final answer, which is the correct answer.\\r\\nThere are 16 balls in total. Half of the balls are golf balls, so there are 8 golf balls. Half of the golf balls are blue, so there are 4 blue golf balls.\\r\\nSo, the answer is 4.\\r\\n\\r\\n\\r\\nConclusion\\r\\nIn this chapter, we looked at some techniques for constructing prompts for the Command model. A prompt can be as simple as a single line of instruction, though the more specific the prompt is, the higher the quality and accuracy you can expect from the response. Each building block added to a prompt provides a different type of lever to enhance the quality of the response.\",\n",
            "      \"title\": \"Constructing Prompts\",\n",
            "      \"url\": \"https://docs.google.com/document/d/1LGsOhBL02jwy5UUIS8tuv9G80FSn7vxeQYiiglsN9oY/edit?usp=drivesdk\"\n",
            "    },\n",
            "    {\n",
            "      \"editedBy\": \"Meor Amer\",\n",
            "      \"id\": \"1oF20QD0lHNdYQp6F7sSyEC1grGErout4GIQn1JBUACo\",\n",
            "      \"mimeType\": \"application/vnd.google-apps.document\",\n",
            "      \"modifiedTime\": \"2023-12-01T07:50:28.605Z\",\n",
            "      \"text\": \"\\ufeffChaining Prompts\\r\\nIn this chapter, you'll learn about several prompt-chaining patterns and their example applications.\\r\\nSuggest Edits\\r\\n!https://files.readme.io/17ec857-Chaining_Prompts.png\\r\\nIntroduction\\r\\nIn the previous two chapters, we looked at various ways to prompt the Command model. One thing similar about all of those examples is that they utilize a single prompt to fulfill a particular task. However, there may be other tasks where this is insufficient, and we instead have to chain a few prompts together to complete a task successfully.\\r\\nWe can think of the previous two chapters as looking at prompts as a single unit, and this chapter will look at prompts as a combination of these units. The diagram below summarizes these three chapters.\\r\\n!https://files.readme.io/4f17dcc-chapters_1-3_comparison.png\\r\\nA comparison of this chapter and the two previous ones\\r\\nCombining multiple prompts to accomplish a single goal will be the focus of this chapter. We\\u2019ll look at some ideas and patterns for chaining prompts, which could come in handy when building a generative AI application.\\r\\nSequential\\r\\nLet\\u2019s begin with probably the most common approach for chaining prompts \\u2013 in a sequence.\\r\\n!https://txt.cohere.com/content/images/2023/08/Sequential.png\\r\\nChaining prompts in a sequence\\r\\nThe key idea is that if the task provided in a single prompt becomes too lengthy or complex and contains many different instructions, the response may not capture the details and granularity required. In this case, it would make sense to break this task into smaller subtasks that can be run one after the other. The response of one subtask becomes the prompt to the other subtask, and this chain continues until the overall task is complete.\\r\\nLet's use story generation as an example. Suppose we have a task to generate a long story containing a dialog guided by a set of information \\u2013 characters, story beats, and locations. Now, we could stuff all this information into a single prompt, but that might dilute the key details we want the dialog to contain.\\r\\nBesides, we don\\u2019t want to write all these additional details in the first place because we\\u2019d like the model to generate them for us. What we want is to provide a short summary of what we want the story to be about, which becomes our sole prompt.\\r\\nThe diagram below summarizes the chains involved in generating the eventual dialog. First, a human enters a story summary, which becomes the prompt to generate a list of characters, which then becomes the prompt to generate the story beats, and so on, until we get to the dialog generation.\\r\\n!https://txt.cohere.com/content/images/2023/08/sequential-example.png\\r\\nA summary of the different steps in the story generation task, running in a sequence\\r\\nAnother added benefit of chaining prompts in sequences instead of using one single prompt is that we can implement human checks at each point in the sequence, and if a response does not fulfill a certain standard, we can trigger a re-run. This makes it easy to do evaluation and quality control over a complex generative AI task \\u2013 by doing them in stages.\\r\\nParallel\\r\\nA sequential chain of prompts is needed when the subtasks depend on each other. But when they are independent, we can run them in parallel instead.\\r\\n!https://txt.cohere.com/content/images/2023/08/Parallel.png\\r\\nRunning prompts in parallel before combining them into a single output\\r\\nLet\\u2019s say we are building an application that generates recipe ideas for a whole week and then generates a shopping list of ingredients for the user to buy. In this case, given a user input of, say, the number of meals or days, we can run the recipe generation step in parallel. The prompt might look something like the following:\\r\\nPython\\r\\nprompt = f'Suggest a simple and quick recipe for {meal}. Write in JSON containing these keys \\\"Ingredients\\\" and \\\"Instructions\\\"'\\r\\nNext, we\\u2019ll repeat the recipe generation across all meals. Once complete, we can consolidate the ingredients from each meal into a single shopping list that the user can use immediately.\\r\\nPython\\r\\nprompt = f\\\"\\\"\\\"Consolidate the following ingredients into a single shopping list, without repetition: {ingredients}\\\"\\\"\\\"\\r\\nSampling\\r\\nIf a task involves logical reasoning, for example, in mathematical question answering, there may be more than one way to solve a given problem. In this case, we want to encourage the model to be more creative when exploring different solutions. But dialing up the creativity knob (i.e., \\u201ctemperature\\u201d) also means that there\\u2019s a higher chance that the model will get the final answer wrong.\\r\\nThe solution is, instead of prompting the same question to the model once, we can repeat that multiple times and choose the response with the highest majority.\\r\\n!https://txt.cohere.com/content/images/2023/08/Sampling.png\\r\\nSampling prompt responses followed by a majority vote\\r\\nLet\\u2019s look at an example taken from a paper by Wang et al., 2023 that introduces the concept of self -consistency .\\r\\nFirst, revisiting the previous chapter , we looked at the concept of chain-of-thought prompting introduced by Wei et. al, 2023 , where a model is prompted in such a way that it is encouraged to do a reasoning step before giving the final response. In those settings, however, the model is typically encouraged to do \\u201cgreedy decoding,\\u201d which means biasing towards the correct and safe path. This can be done by adjusting settings like the temperature value.\\r\\nWith self-consistency, we can build on the chain-of-thought approach by sampling from several paths instead of one. We also make the paths much more diverse by adjusting the settings towards being more \\u201ccreative,\\u201d again using settings like temperature. We then do a majority vote out of all answers.\\r\\nThe diagram below illustrates the self-consistency concept. It shows an example of comparing the result of a single solution, using the greedy decoding approach, and a solution that samples from multiple generations, using a more diverse decoding approach. The former didn\\u2019t get the answer correct, and the latter did.\\r\\nhttps://lh6.googleusercontent.com/c4nCCvs8OfEJl-z3eOQ6-C7ypOwYc-84f0Hfk3aMdJjbxVLuVU9AK0ZmTp4nAfj-E_woIlTBu1kJMvbE8JrKuSAYEcgwgxAhvbWttrHmLB0xNer5ug7k-wlnUC_KYIVpDg5yVTmHWvZcmRy4O36F9-E\\r\\nAn example from Wei et al., 2023 illustrating the self-consistency concept\\r\\nExploration\\r\\nBuilding on the previous chain pattern, when a question is much more complex and requires more granular reasoning steps, it is helpful to break down the steps into pieces. At each step, we encourage the model to explore different solutions, vote for the best solution and only then continue to the next step.\\r\\nThis is also useful in creative applications like story writing. Making the model explore different story ideas is more interesting than constraining it to a single path, elevating the final output's quality.\\r\\n!https://txt.cohere.com/content/images/2023/08/Exploration.png\\r\\nExploring different solutions, one step at a time\\r\\nLet\\u2019s use one concrete example from Yao et al., 2023 , which introduces the concept of tree of thoughts . The diagram below illustrates how this concept differs from direct input-output prompting, chain-of-thought, and self-consistency with chain-of-thought. At each step, the model generates several diverse solutions. A separate prompt is then used to evaluate these solutions and vote for the best solution. The process repeats until the final step is completed.\\r\\nhttps://lh6.googleusercontent.com/nI7-VerhzDlQiqtzdy-JujxQULEktPFrqlek_VrwaHnZVlEUEtFpo7yTHRYi5Ai0vubp0yi6tFT1e_PX9DajfRPh_0O0p-oKLn0cs9Jtbg166rM4Z-ZmzGDXgf0Uy1j9NBw7ha2lYdB8mydqNfWg13w\\r\\nAn illustration from Yao et al., 2023 of the Tree of Thoughts approach compared to three others\\r\\nHere\\u2019s one of the examples shown in the paper with a creative writing task. The diagram below shows the initial input containing a list of four seemingly unrelated sentences \\u2013 each talking about handstands, the smell of space, sign language, and people\\u2019s perceptions. The task is to weave them into one coherent passage. It must contain four short paragraphs, each ending with the given sentence.\\r\\nhttps://lh4.googleusercontent.com/oW9iUE6aWqaxb4p26wmji6MO9yAmDH_-4renhnIiJTJbe9QXg6CZl_detvcMG-5Rf7kepegWvjplZi5PzrRuEz7GMrENToB3IVr17VMPnRSCCR0GDwyS7AkmF56n56uWyob-yTD8WjkZmI_sSIpCp8g\\r\\nA creative writing example from Yao et al., 2023 using Tree of Thoughts\\r\\nSince the task is quite challenging, it makes sense to break down the task into two: writing the plan and writing the actual passage based on the winning plan. At each step, the model generates a few solutions, and then another prompt is used to evaluate and vote for the best solution, guiding the direction of the next step.\\r\\nA couple of writing plan options are shown in the screenshot, and the winning option is the one that suggests using self-help as the theme to weave the sentences into a coherent passage.\\r\\nLoop\\r\\nIn some applications, we may need to re-run a generation step, given what happens in a subsequent step. One example is when that subsequent step is used to check if the response generated meets specific criteria, such as quality and format. This is where the loop pattern becomes useful.\\r\\n!https://txt.cohere.com/content/images/2023/08/Loop.png\\r\\nLooping a task back to an earlier step\\r\\nLet\\u2019s take a rephrasing task as an example. Say we have an application that takes a rude user comment and suggests a rephrasing that makes it more polite. Here, we want the LLM response to be polite and, at the same time, retain the original meaning of the comment.\\r\\nThe prompt, taking in the user input to be rephrased, might look something like the following:\\r\\nPython\\r\\n`user_input = \\\"I really don't have time for this nonsense.\\\"\\r\\nprompt_rephrase = f\\\"\\\"\\\"Rephrase this user comment into something more polite: User comment: You don't know what you're talking about. Rephrased comment: I think there might be some inaccuracies in your statement. User comment: {user_input} Rephrased comment:\\\"\\\"\\\"`\\r\\nHere is an example response which rephrases the original user input:\\r\\nI think we might need to set aside some time to discuss this properly.\\r\\n\\r\\n\\r\\nNext, we create another prompt to check if the rephrased comment is similar enough to the original comment.\\r\\nPython\\r\\n`prompt_check = f\\\"\\\"\\\"Below is a rude comment that has been rephrased into a polite version. The rephrased comment must maintain a similar meaning to the original comment. Check if this is true. Answer with YES or NO.\\r\\nOriginal comment: Shut up, you're always wrong. Rephrased comment: Please be quiet, check your facts again. Similar meaning: YES Original comment: I can't stand you. Rephrased comment: Let's discuss this. Similar meaning: NO Original comment: {user_input} Rephrased comment: {user_input_rephrased} Similar meaning:\\\"\\\"\\\"`\\r\\nAnd if the response is \\u201cNO,\\u201d we route the task back to the rephrasing prompt and repeat until we get a \\u201cYES\\u201d response.\\r\\nPerformance Considerations\\r\\nPrompt chaining is a powerful concept that makes complex use cases possible when a single prompt setup is insufficient. Having said that, prompt chaining should only be considered when it\\u2019s truly necessary. The overall performance considerations need to be taken into account.\\r\\nOne such consideration is latency. The longer the chain, the longer it takes to complete a task from start to finish. If an application is latency-sensitive, it makes sense to minimize the number of chains. The cost factor is another consideration when designing applications that rely on prompt chaining.\\r\\nFinal Thoughts\\r\\nIn this chapter, we looked at several prompt-chaining patterns and examples of how they can be applied to the Command model.\\r\\nThis is a fascinating area of prompt engineering because it opens up so much room for creativity when solving problems with LLMs. Although it comes with some performance trade-offs, balancing these considerations presents an exciting challenge for building production-ready LLM-powered applications.\",\n",
            "      \"title\": \"Chaining Prompts\",\n",
            "      \"url\": \"https://docs.google.com/document/d/1oF20QD0lHNdYQp6F7sSyEC1grGErout4GIQn1JBUACo/edit?usp=drivesdk\"\n",
            "    },\n",
            "    {\n",
            "      \"editedBy\": \"Meor Amer\",\n",
            "      \"id\": \"1X9XM5nLjjF_8b6ulj35FK8ioWCJTg6n0KtYtXLkr9Dw\",\n",
            "      \"mimeType\": \"application/vnd.google-apps.document\",\n",
            "      \"modifiedTime\": \"2023-12-01T07:51:15.475Z\",\n",
            "      \"text\": \"\\ufeffUse Case Patterns\\r\\nIn this chapter, you'll learn about the common use case patterns in text generation, including prompt examples.\\r\\nSuggest Edits\\r\\n!https://files.readme.io/c798ac6-command-usecase-patterns.png\\r\\nIn the previous chapter, we took the vertical direction and learned different ways to construct a prompt. In this chapter, we'll take a horizontal approach by looking at different use case patterns for applying these prompts.\\r\\nIn this chapter, we'll go through several use case patterns for the Command model. Though they won\\u2019t cover all the possible ways you can use the model, they are good starting points for understanding the patterns of tasks where the model works well.\\r\\nSetting Up\\r\\nThe examples in this post will be shown in Python. For each use case, we\\u2019ll look at ideas on how a prompt can be constructed and the associated model settings. This chapter comes with a Google Colaboratory notebook that lets you get hands-on with the code.\\r\\nFirst, install the Cohere package, get the Cohere API key , and set up the client.\\r\\n! pip install cohere\\r\\n\\r\\n\\r\\nimport cohere\\r\\nco = cohere.Client(\\\"COHERE_API_KEY\\\") # Your Cohere API key\\r\\n\\r\\n\\r\\nLet\\u2019s also define a function to take a prompt and a temperature value and then call the Generate endpoint , which is how we can access the Command model. Here, we select the model to be command . We set a default temperature value of 0, which nudges the response to be more predictable and less random. This function returns the text response generated by the model.\\r\\nPython\\r\\ndef generate_text(prompt, temp=0): response = co.generate( model='command', prompt=prompt, max_tokens=300, temperature=temp) return response.generations[0].text\\r\\nOur examples will revolve around a company\\u2019s activities for launching a new wireless headphone product, such as getting the word out, managing customer interactions, and so on. For this, let\\u2019s define a text snippet containing the product description. We\\u2019ll be utilizing this snippet in several examples throughout this chapter.\\r\\nPython\\r\\nproduct=\\\"\\\"\\\"The CO-1T is a wireless headphone product that uses Bluetooth technology to connect to your devices. \\\\\\\\ It has a long battery life and can be quickly charged using the included USB cable. The headphone is \\\\\\\\ lightweight and comfortable, ideal for long periods of use. It has a built-in microphone for making calls, \\\\\\\\ and a button to control the volume. The CO-1T is a great choice for anyone looking for a wireless headphone \\\\\\\\ product with great battery life.\\\"\\\"\\\"\\r\\nWriting\\r\\n!https://files.readme.io/e7fd8cf-writing.png\\r\\nWe\\u2019ll start with the most general type of use case: writing.\\r\\nHere we can ask the model to write freeform text, for example, with this prompt: \\u201cCreate an email about the launch of the wireless headphone product.\\u201d But that alone might not be very useful in practical applications because the generated text can go in very different directions. We may want to add more context and specificity to the prompt.\\r\\nHere\\u2019s how we can do that. Let\\u2019s say we\\u2019re building an application for users to enter some bullet points and get a complete email written. We can set up the prompt in the following way: create a variable for the user to input some text and merge that, together with the product description, into the main prompt.\\r\\nPython\\r\\n`user_input =\\\"\\\"\\\"\\r\\n* announce product launch\\r\\n* create a call to action\\r\\n* mention live chat for support \\\"\\\"\\\"\\r\\nprompt = f\\\"\\\"\\\"{product} Create an email about the product above mentioning the following: {user_input} \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nAdding this context helps to guide the model in the direction we want it to go. Here is a sample response:\\r\\nHello,\\r\\n\\r\\n\\r\\nWe are excited to announce the launch of our new wireless headphone product, the CO-1T. This product uses Bluetooth technology to connect to your devices and has a long battery life. It is lightweight and comfortable, making it ideal for long periods of use. The CO-1T also has a built-in microphone for making calls, and a button to control the volume.\\r\\n\\r\\n\\r\\nWe are offering a special discount for the first 100 customers to purchase the CO-1T. So, if you are looking for a great wireless headphone product with great battery life, then the CO-1T is the perfect choice for you.\\r\\n\\r\\n\\r\\nDon't miss out on this opportunity to try out our new product. Order now and experience the convenience of wireless headphones.\\r\\n\\r\\n\\r\\nIf you have any questions about the CO-1T, please feel free to contact us through our live chat support. We are always happy to help.\\r\\n\\r\\n\\r\\nThank you,\\r\\n[Your Name]\\r\\n\\r\\n\\r\\nIn this example, we changed the temperature value to 0.5. And throughout this chapter, you\\u2019ll see different temperature values being used in different situations. Increasing the temperature value tells the model to generate less predictable responses and instead be more \\u201ccreative.\\u201d And since this task does require some form of creativity (expanding brief keywords into an entire passage), we increased the temperature value. There is no one right value for a use case, so this is a setting you should try and iterate to get the best outcome for your task.\\r\\nWe have looked at one example, but writing as a use case can mean many different things. So instead of beginning your prompt with \\u201cCreate,\\u201d you can try other ways to extract different forms of content and formats that your application needs, such as using \\u201cExplain,\\u201d \\u201cGenerate,\\u201d \\u201cWrite,\\u201d \\u201cProvide,\\u201d \\u201cDesign,\\u201d \\u201cDescribe,\\u201d and so on.\\r\\nQuestion Answering\\r\\n!https://files.readme.io/f48f2db-Question_Answering.png\\r\\nThis use case is about answering a user's question. This could be a single-turn, question-answering scenario or a multi-turn, chatbot setting.\\r\\nQuestion answering can take place in either a closed or open setting. In a closed-book question-answering setting, we rely on the model to answer questions based on the general knowledge from which it has been trained. Here\\u2019s one example:\\r\\nPython\\r\\n`user_input =\\\"What features should I consider when choosing a wireless headphone\\\" prompt = user_input\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nSample response:\\r\\nThere are a few features to consider when choosing a wireless headphone. These include:\\r\\n\\r\\n\\r\\n1. Sound quality: It is important to choose a headphone that has good sound quality. This will ensure that you enjoy your music or podcasts.\\r\\n2. Comfort: It is important to choose a headphone that is comfortable to wear. This will ensure that you can wear it for long periods of time without experiencing any discomfort.\\r\\n3. Battery life: It is important to choose a headphone that has a long battery life. This will ensure that you can use it for long periods of time without having to recharge it.\\r\\n4. Price: It is important to choose a headphone that is within your budget. There are a variety of options available at different price points.\\r\\n\\r\\n\\r\\nThis works well for a question that is open-ended and doesn\\u2019t have one correct answer. But let\\u2019s say we have a customer asking for specific information about the wireless headphone, such as its feature set. For this, we need to turn to an extractive question-answering setting.\\r\\nIn this setting, we can get the model to refer to specific knowledge bases to help it do its job well. This way, we can design a system that can handle questions that require factual responses.\\r\\nHere, a customer asks a product question. We can append the customer\\u2019s question and the product description to the prompt, as follows.\\r\\nPython\\r\\n`user_input =\\\"How do I control the sound levels\\\"\\r\\nprompt = f\\\"\\\"\\\"{product} Given the product description above, answer this question: {user_input}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nAnd the model picks up the relevant information from the prompt to provide the correct answer.\\r\\nSample response:\\r\\nThe sound levels can be controlled by using the button on the headphones.\\r\\n\\r\\n\\r\\nBrainstorming\\r\\n!https://files.readme.io/ba6c262-Brainstorming.png\\r\\nAnother form of writing is brainstorming, where we want the model to generate a list of options based on a given prompt. This can be for writing outlines, generating ideas, providing critical analysis, and so on. This use case forces the model to go broad and cover different perspectives of a situation.\\r\\nIn this example, we want the model to act as an assistant to a customer support agent in identifying possible ways to troubleshoot a technical problem that a customer is facing.\\r\\nPython\\r\\n`user_input = \\\"I can't get the Bluetooth connection working\\\" prompt = f\\\"\\\"\\\"{product} A customer provided the following complaint about this product: {user_input}. Provide a bulleted list of possible ways to troubleshoot so we can advise the customer accordingly. \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.9) print(response)`\\r\\nSample response:\\r\\n- Check to see if the headphones are fully charged\\r\\n- Try resetting the headphones by holding the power button for 5 seconds\\r\\n- Make sure that your device is within range of the headphones\\r\\n- Try restarting your device\\r\\n- Check to see if the headphones are properly paired with your device\\r\\n- If you are still having trouble connecting, please contact customer service for further assistance.\\r\\n\\r\\n\\r\\nTransforming\\r\\n!https://files.readme.io/f1274c6-Transforming.png\\r\\nThe first thing that comes to mind when thinking about generative models is their ability to write a fresh piece of text, but one rather understated aspect is their ability to synthesize an existing piece of text.\\r\\nOne example is transforming a passage of text into a different form, making it reusable for different purposes.\\r\\nFor example, creating a list of Frequently Asked Questions (FAQs) about wireless headphones is crucial but requires some effort. We can cut short this process by getting the model to generate a list of FAQs based on the product description, as follows:\\r\\nPython\\r\\n`prompt =f\\\"\\\"\\\"Turn the following product description into a list of frequently asked questions (FAQ).\\r\\nProduct description: {product} \\\"\\\"\\\" response = generate_text(prompt, temp=0) print(response)`\\r\\nSample response:\\r\\nFrequently Asked Questions (FAQ)\\r\\n\\r\\n\\r\\nWhat is the CO-1T?\\r\\nThe CO-1T is a wireless headphone product that uses Bluetooth technology to connect to your devices. It has a long battery life and can be quickly charged using the included USB cable. The headphone is lightweight and comfortable, ideal for long periods of use. It has a built-in microphone for making calls, and a button to control the volume. The CO-1T is a great choice for anyone looking for a wireless headphone product with great battery life.\\r\\n\\r\\n\\r\\nHow long does the battery last?\\r\\nThe battery life of the CO-1T is long, and it can be quickly charged using the included USB cable.\\r\\n\\r\\n\\r\\nIs the CO-1T comfortable to wear?\\r\\nThe CO-1T is designed to be lightweight and comfortable, ideal for long periods of use.\\r\\n\\r\\n\\r\\nDoes the CO-1T have a built-in microphone?\\r\\nYes, the CO-1T has a built-in microphone for making calls.\\r\\n\\r\\n\\r\\nDoes the CO-1T have a button to control the volume?\\r\\nYes, the CO-1T has a button to control the volume.\\r\\n\\r\\n\\r\\nSummarizing\\r\\n!https://files.readme.io/d3e9e0c-Summarizing.png\\r\\nOne popular use case for synthesizing text is summarization. Here, we take a long passage of text and summarize it to its essence. These can be articles, conversation transcripts, reports, meeting notes, and so on.\\r\\nIn this example, we create a prompt to summarize a list of customer reviews about the wireless headphone.\\r\\nPython\\r\\n`user_input =\\\"\\\"\\\"Customer reviews of the CO-1T wireless headphones:\\r\\n\\\"The CO-1T is a great pair of headphones! The design is sleek and modern, and the headphones are \\\\ very comfortable to wear. The sound quality is excellent, and I can hear every detail of my music. \\\\ The built-in microphone means I can make calls without having to take my phone out of my pocket. I \\\\ highly recommend the CO-1T to anyone looking for a great pair of wireless headphones!\\\"\\r\\n\\\"I'm very disappointed with the CO-1T. The design is nice, but the battery life is terrible. I can \\\\ only use them for a few hours before they need to be recharged. This is very inconvenient, and I'm \\\\ not sure if I can recommend them to anyone.\\\"\\r\\n\\\"The CO-1T is a mixed bag. The speaker quality is great, but the built-in microphone's quality is \\\\ poor. I can hear every detail of my music, but my voice sounds distorted when I make calls. The \\\\ design is nice, and the headphones are comfortable to wear, but the battery life is only average. \\\\ I'm not sure if I can recommend them to anyone.\\\" \\\"\\\"\\\"\\r\\nprompt = f\\\"\\\"\\\"Summarize the following.\\r\\n{user_input} \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nExample response:\\r\\nThe CO-1T wireless headphones have mixed reviews. Some people love the design and sound quality, while others are disappointed with the battery life and microphone quality.\\r\\n\\r\\n\\r\\nAlternatively, there is a more streamlined way to generate quality summaries, and that is via the Summarize endpoint . It builds upon the Command model and is designed specifically to perform summarization. It supports a much longer context length than the Generate endpoint at 100,000 characters maximum. It also provides a much easier way to define the types of summaries, such as long vs. short, or paragraphs vs. bullets, without having to define the prompts.\\r\\nHere\\u2019s how to call the Summarize endpoint to summarize the customer reviews:\\r\\nPython\\r\\nresponse = co.summarize( text=user_input, length='short', format='paragraph', model='summarize-xlarge', temperature=0.3, additional_command=\\\"analyzing these customer reviews\\\" ) print(response.summary)\\r\\nSample response:\\r\\nPython\\r\\nThe CO-1T wireless headphones have received mixed reviews from customers. Some people love the design and sound quality, while others are disappointed with the battery life and microphone quality.\\r\\nRewriting\\r\\n!https://files.readme.io/5c4986a-Rewriting.png\\r\\nRewriting text is another useful use case where you need to modify some aspects of the text while maintaining its overall meaning. One example is changing the tone of a piece of text to tailor it to a specific audience. Here we want to rewrite the product description so it\\u2019s more relatable to students.\\r\\nPython\\r\\n`user_input = \\\"college students\\\"\\r\\nprompt = f\\\"\\\"\\\"Create a version of this product description that's tailored towards {user_input}.\\r\\n{product}\\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0.5) print(response)`\\r\\nSample response:\\r\\nThe CO-1T is a great wireless headphone option for college students who are always on the go. It uses Bluetooth technology to connect to your devices, so you don't have to worry about getting tangled up in cords. The battery life is long, and it can be quickly charged using the included USB cable. The headphone is lightweight and comfortable, making it ideal for long periods of use. It has a built-in microphone for making calls, and a button to control the volume. Plus, the price is just right for a college student's budget.\\r\\n\\r\\n\\r\\nAnother extremely useful way of looking at text synthesis is information extraction. Here, we leverage the model\\u2019s ability to capture the context of a piece of text to extract the correct information as specified by the prompt.\\r\\nHere is an example of an email that a customer is, unfortunately, asking for a refund for the wireless headphones. We can have the model process this email by getting it to extract information, such as the product name, refund reason, and pick-up address.\\r\\nPython\\r\\n`user_input =\\\"\\\"\\\"I am writing to request a refund for a recent CO-1T purchase I made on your platform. \\\\ Unfortunately, the produce has not met my expectations due to its poor battery life. \\\\ Please arrange for the pick-up at this address: to 171 John Street, Toronto ON, M5T 1X2.\\\"\\\"\\\"\\r\\nprompt =f\\\"\\\"\\\"Extract the product, refund reason and pick-up address from this email:\\r\\n{user_input} \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nSample response:\\r\\nProduct: CO-1T\\r\\nRefund reason: Poor battery life\\r\\nPick-up address:  171 John Street, Toronto ON, M5T 1X2\\r\\n\\r\\n\\r\\nClassifying\\r\\n!https://files.readme.io/49c3495-Classifying.png\\r\\nOne of the most widely deployed use cases in NLP is text classification. Here, the task is to classify a piece of text into one of a few predefined classes. In this example, we want to classify incoming customer messages into one of three categories: Order, Support, or Refunds.\\r\\nWe can create the prompt as follows.\\r\\nPython\\r\\n`user_input =\\\"\\\"\\\"The battery drains fast\\\"\\\"\\\"\\r\\nprompt = f\\\"\\\"\\\"The following is a user message to a customer support agent. Classify the message into one of the following categories: Order, Support, or Refunds.\\r\\n{user_input} \\\"\\\"\\\"\\r\\nresponse = generate_text(prompt, temp=0) print(response)`\\r\\nHere\\u2019s a sample response where the generative model correctly classifies the text into the right category:\\r\\nSupport\\r\\n\\r\\n\\r\\nAlternatively, the Classify endpoint provides a simple API for running text classification. The endpoint leverages Cohere\\u2019s embeddings models and makes it easy to add training examples and even create custom models that are specifically tailored to your task.\\r\\nHere\\u2019s how we can use the Classify endpoint. It requires a minimum of two examples per class, which is passed as an argument to the API call. We have six examples altogether \\u2013 two for each class.\\r\\nPython\\r\\n`from cohere.responses.classify import Example\\r\\nresponse = co.classify( model='embed-english-v3.0', inputs=[user_input], examples=[Example(\\\"I can\\\\'t connect to the bluetooth\\\", \\\"Support\\\"), Example(\\\"Why is max volume so low\\\", \\\"Support\\\"), Example(\\\"When will my order arrive\\\", \\\"Order\\\"), Example(\\\"How much is the shipping cost\\\", \\\"Order\\\"), Example(\\\"What is your refund policy\\\", \\\"Refunds\\\"), Example(\\\"How do I return my product\\\", \\\"Refunds\\\")])\\r\\nprint(response.classifications[0].prediction)`\\r\\nSample response:\\r\\nSupport\\r\\n\\r\\n\\r\\nConclusion\\r\\nThis chapter provides a starting point for understanding the range of use cases you can build with the Cohere Command model. Take these use cases as the initial set of examples to further experiment on what\\u2019s possible.\",\n",
            "      \"title\": \"Use Case Patterns\",\n",
            "      \"url\": \"https://docs.google.com/document/d/1X9XM5nLjjF_8b6ulj35FK8ioWCJTg6n0KtYtXLkr9Dw/edit?usp=drivesdk\"\n",
            "    },\n",
            "    {\n",
            "      \"editedBy\": \"Meor Amer\",\n",
            "      \"id\": \"1wngAfCJY1IgD6H__4AkQXFfymKUpSeJL13TItbigdyA\",\n",
            "      \"mimeType\": \"application/vnd.google-apps.document\",\n",
            "      \"modifiedTime\": \"2023-12-01T07:50:02.204Z\",\n",
            "      \"text\": \"\\ufeffValidating Outputs\\r\\nIn this chapter, you'll learn how to implement validation on LLM outputs.\\r\\nSuggest Edits\\r\\n!https://files.readme.io/1a4c229-validating-llm-outputs.png\\r\\nThis chapter was written in collaboration with the Guardrails AI team.\\r\\nIntroduction\\r\\nIn previous chapters, we covered prompt engineering techniques to elicit the desired responses from a large language model (LLM).\\r\\nHowever, one key property of LLMs that\\u2019s different from traditional software is that the output is probabilistic in nature. The same input (i.e., the prompt) may not always produce the same response. While this property makes it possible to build entirely new classes of natural language applications, it also means that those applications require a mechanism for validating their outputs.\\r\\nHere\\u2019s an example. In Chapter 1 , we looked at a text extraction task of turning a list of bank invoices in a text document into a JSON object containing three fields: \\u201cInvoice Number,\\u201d \\u201cMerchant Name,\\u201d and \\u201cAccount Number.\\u201d For brevity, we\\u2019ll turn it into a shorter version with the document containing just one invoice, as follows.\\r\\nPython\\r\\nprompt=\\\"\\\"\\\"Turn the following information into a JSON string with the following keys: Invoice Number, Merchant Name, and Account Number. Bank Invoice: INVOICE #0521 MERCHANT ALLBIRDS ACC XXX3846 \\\"\\\"\\\"\\r\\nThis produced an LLM response that followed exactly what we wanted, as shown below.\\r\\nJSON\\r\\n{ \\\"Invoice Number\\\": \\\"0521\\\", \\\"Merchant Name\\\": \\\"Allbirds\\\", \\\"Account Number\\\": \\\"XXXX3846\\\" }\\r\\nBut how do we ensure we\\u2019ll get the same response every time? Perhaps another time, the output may miss some information, such as the returning incomplete information like this one.\\r\\nJSON\\r\\n{ \\\"Invoice Number\\\": \\\"0521\\\" }\\r\\nThere are many other ways that a response may not match the expected structure. For example, what if the generated output contained fields we never specified? What if the document provided were more challenging to parse, causing an unclear response? What if we wanted to impose a rule that a field can only take up values within a specific range? In these cases and many others, we must add a step to validate the output.\\r\\nIn the rest of this chapter, we\\u2019ll look at LLM output validation and examples of how to implement it using an open-source package called Guardrails AI. This chapter comes with a Google Colaboratory notebook .\\r\\nWhen Is Output Validation Needed\\r\\nTo build robust and production-ready LLM applications, the outputs need to be predictable. This helps to safeguard the application against unexpected behaviors and to ensure a reliable user experience. The following provides some example scenarios when output validation may be needed.\\r\\n* Structure compliance : Some LLM applications require their output to go beyond just freeform text and instead follow a specific structure containing specific types of information. We looked at a toy example earlier of a text extraction task that requires a JSON output that follows a certain format. We can extend this to synthetic data generation cases, where the generated data must meet certain criteria.\\r\\n* Safe responses : Due to their probabilistic nature, LLM applications require additional guardrails to ensure their outputs are safe, ethical, and privacy-preserving. For example, we may want to confirm that an output does not contain profanity. Alternatively, we may want to ensure that an output does not contain personally identifiable information (PII).\\r\\n* Semantic similarity : In some applications, we may require the output to be similar enough to a target. For example, in text summarization tasks, we want to ensure that the summary does not deviate too far from the original document. For this, with the help of text embeddings, we want to validate that the summary and the document are similar enough semantically.\\r\\n* Valid choices : We may also want the LLM to generate valid outputs per given definitions or constraints. For example, creating an LLM chess player will require the LLM output to generate only valid moves for a given board state. We could also validate that a generated piece of code is syntactically correct.\\r\\n* Quality assurance : More generally, we may want to implement a validation step to ensure an LLM output meets a certain quality standard for a respective application\\u2019s use case and provides value to users.\\r\\nWe can bake these types of validation into an application by implementing a set of validation steps followed by an automated action to fix any gaps found. Let\\u2019s see how we can do this.\\r\\nIntroduction to Guardrails AI\\r\\nGuardrails AI is a Python package that enables developers to enhance the outputs of LLms by adding structural, type, and quality assurances. Guardrails helps developers with two key activities in a validation process:\\r\\n* Validation : Performing output validation for LLMs in a similar style to the Pydantic package, which is a data validation library for Python. Some examples are validating the structure of generated JSON output, identifying bias in generated text, and checking for bugs in generated code.\\r\\n* Correction : Performing corrective actions based on the validation results, such as asking the LLM to re-generate the response or fixing the output directly.\\r\\n!https://txt.cohere.com/content/images/2023/09/Output-Validation.png\\r\\nValidation and correction are two key activities in a validation process\\r\\nImplementation-wise, the following steps are involved in incorporating Guardrails into an LLM application:\\r\\n* Create the output schema : The RAIL spec contains the overall schema of the LLM output, the type info for each field, the quality criteria for each field, and the corrective action to be taken if the quality criteria are not met. It also contains the prompt template and any custom code for implementing the schema. Alternatively, the output schema can also be defined using Pydantic, which we\\u2019ll use in our example later.\\r\\n* Initialize a Guard object based on the schema : The Guard class is the main entry point for using Guardrails. It is initialized using the output schema created in the previous step.\\r\\n* Wrap an LLM call with the Guard object : The gd.Guard object wraps around an LLM API call to validate, structure, and correct the outputs.\\r\\n!https://txt.cohere.com/content/images/2023/09/Output-Validation-with-Guardrails-AI.png\\r\\nThe key steps in output validation with Guardrails: creating the output schema, initializing a Guard object, and wrapping an LLM call with it\\r\\nLet\\u2019s look at an example of using Guardrails in a text extraction task. The task is to extract the information from a doctor\\u2019s note into a JSON object. The following is the doctor\\u2019s note.\\r\\nPython\\r\\ndoctors_notes = \\\"\\\"\\\"49 y/o Male with chronic macular rash to face & hair, worse in beard, eyebrows & nares. Itchy, flaky, slightly scaly. Moderate response to OTC steroid cream\\\"\\\"\\\"\\r\\nSpecifically, we want our extracted information to contain the following fields:\\r\\n* Patient's gender\\r\\n* Patient's age\\r\\n* A list of symptoms, each with a severity rating and an affected area\\r\\n* A list of medications, each with information about the patient's response to the medication\\r\\nSetup\\r\\nFirst, let\\u2019s install the packages required: cohere , guardrails-ai , and pydantic .\\r\\npip install \"cohere<5\" guardrails-ai pydantic -q\\r\\n\\r\\n\\r\\nNext, import the packages.\\r\\nPython\\r\\nimport cohere import guardrails as gd from guardrails.validators import ValidRange, ValidChoices from pydantic import BaseModel, Field from rich import print from typing import List\\r\\nDefine the Output Schema\\r\\nNext, we define the output schema that defines what the LLM response should look like. As mentioned earlier, Guardrails provides an option to define the schema using Pydantic. We\\u2019ll use this option, and below is the schema we\\u2019ll use for the doctor notes extraction task.\\r\\nPython\\r\\n`class Symptoms(BaseModel): symptom: str = Field(..., description=\\\"Symptom that a patient is experiencing\\\") affected_area: str = Field( ..., description=\\\"What part of the body the symptom is affecting\\\", validators=[ValidChoices([\\\"head\\\", \\\"neck\\\", \\\"chest\\\"], on_fail=\\\"reask\\\")] )\\r\\nclass CurrentMeds(BaseModel): medication: str = Field(..., description=\\\"Name of the medication the patient is taking\\\") response: str = Field(..., description=\\\"How the patient is responding to the medication\\\")\\r\\nclass PatientInfo(BaseModel): gender: str = Field(..., description=\\\"Patient's gender\\\") age: int = Field(..., description=\\\"Patient's age\\\", validators=[ValidRange(0, 100)]) symptoms: List[Symptoms] = Field(..., description=\\\"Symptoms that the patient is experiencing\\\") current_meds: List[CurrentMeds] = Field(..., description=\\\"Medications that the patient is currently taking\\\")`\\r\\nIn the schema, we defined a few \\u201cvalidators,\\u201d a Guardrails feature that lets us define the type of validation to perform. One example is ValidChoices , useful for situations where we want to enforce that a response can only be within a predefined list of items. In our example, in the symptom field, the value can only be one of head, neck, or chest. And if the generated response doesn\\u2019t fulfill this criteria, it will be re-prompted. This is shown by the on_fail setting that triggers a reask .\\r\\nThe Guardrails documentation provides more information about the types of validators in Guardrails.\\r\\nInitialize a Guard Object Based on the Schema\\r\\nNext, we initialize a Guard object based on the schema we have defined.\\r\\nFirst, we define the base instruction prompt for the LLM as follows.\\r\\nPython\\r\\n`PROMPT = \\\"\\\"\\\"Given the following doctor's notes about a patient, please extract a dictionary that contains the patient's information.\\r\\n{{doctors_notes}}\\r\\n@complete_json_suffix_v2 \\\"\\\"\\\"`\\r\\nThen, we initialize a Guard object from the PatientInfo Pydantic model.\\r\\nPython\\r\\nguard = gd.Guard.from_pydantic(PatientInfo, prompt=PROMPT) print(guard.base_prompt)\\r\\nGuardrails then uses this information to construct the full prompt for the LLM, which looks like the following example.\\r\\nGiven the following doctor's notes about a patient,\\r\\nplease extract a dictionary that contains the patient's information.\\r\\n\\r\\n\\r\\n{doctors_notes}\\r\\n\\r\\n\\r\\nGiven below is XML that describes the information to extract from this document and the tags to extract it into.\\r\\n\\r\\n\\r\\n<output>\\r\\n    <string name=\\\"gender\\\" description=\\\"Patient's gender\\\"/>\\r\\n    <integer name=\\\"age\\\" format=\\\"valid-range: min=0 max=100\\\" description=\\\"Patient's age\\\"/>\\r\\n    <list name=\\\"symptoms\\\" description=\\\"Symptoms that the patient is experiencing\\\">\\r\\n        <object>\\r\\n            <string name=\\\"symptom\\\" description=\\\"Symptom that a patient is experiencing\\\"/>\\r\\n            <string name=\\\"affected_area\\\" format=\\\"valid-choices: choices=['head', 'neck', 'chest']\\\"\\r\\ndescription=\\\"What part of the body the symptom is affecting\\\"/>\\r\\n        </object>\\r\\n    </list>\\r\\n    <list name=\\\"current_meds\\\" description=\\\"Medications that the patient is currently taking\\\">\\r\\n        <object>\\r\\n            <string name=\\\"medication\\\" description=\\\"Name of the medication the patient is taking\\\"/>\\r\\n            <string name=\\\"response\\\" description=\\\"How the patient is responding to the medication\\\"/>\\r\\n        </object>\\r\\n    </list>\\r\\n</output>\\r\\n\\r\\n\\r\\nONLY return a valid JSON object (no other text is necessary), where the key of the field in JSON is the `name`\\r\\nattribute of the corresponding XML, and the value is of the type specified by the corresponding XML's tag. The JSON\\r\\nMUST conform to the XML format, including any types and format requests e.g. requests for lists, objects and\\r\\nspecific types. Be correct and concise.\\r\\n\\r\\n\\r\\nHere are examples of simple (XML, JSON) pairs that show the expected behavior:\\r\\n- `<string name='foo' format='two-words lower-case' />` => `{{'foo': 'example one'}}`\\r\\n- `<list name='bar'><string format='upper-case' /></list>` => `{{\\\"bar\\\": ['STRING ONE', 'STRING TWO', etc.]}}`\\r\\n- `<object name='baz'><string name=\\\"foo\\\" format=\\\"capitalize two-words\\\" /><integer name=\\\"index\\\" format=\\\"1-indexed\\\"\\r\\n/></object>` => `{{'baz': {{'foo': 'Some String', 'index': 1}}}}`\\r\\n\\r\\n\\r\\nWrap an LLM Call with the Guard Object\\r\\nWe\\u2019re ready to run an LLM call using the Cohere Generate endpoint. For this, we wrap the LLM call with the Guard object. This means it will take care of the validation and reasking (if any) until the final generated output fulfills the defined schema.\\r\\nPython\\r\\nco = cohere.Client(api_key='COHERE_API_KEY') raw_llm_output, validated_output = guard( co.generate, prompt_params={\\\"doctors_notes\\\": doctors_notes}, model='command', max_tokens=1024, temperature=0.6 )\\r\\nAnd we get the final validated output as follows.\\r\\nJSON\\r\\n{ 'patient_info': { 'gender': 'Male', 'age': 49, 'symptoms': [ {'symptom': 'Chronic macular rash', 'affected area': 'head'}, { 'symptom': 'Itchy, flaky, slightly scaly', 'affected area': 'head' } ], 'current_meds': [ {'medication': 'OTC steroid cream', 'response': 'Moderate'} ] } }\\r\\nBehind the scenes, Guardrails performs the validation step on the output against the schema, raises any errors if there are mismatches, and triggers a reask. We can trace the execution steps as follows.\\r\\nPython\\r\\nprint(guard.state.most_recent_call.history[0].rich_group)\\r\\nThe LLM call first returned the following response. Two symptoms were generated, and for both \\u201cFace & hair\\u201d and \\u201cBeard, eyebrows & nares,\\u201d the affected areas did not fall within the three options we had defined earlier.\\r\\nJSON\\r\\n{ \\\"patient_info\\\": { \\\"gender\\\": \\\"Male\\\", \\\"age\\\": 49, \\\"symptoms\\\": [ { \\\"symptom\\\": \\\"Chronic macular rash\\\", \\\"affected area\\\": \\\"Face & hair\\\" }, { \\\"symptom\\\": \\\"Itchy, flaky, slightly scaly\\\", \\\"affected area\\\": \\\"Beard, eyebrows & nares\\\" } ], \\\"current_meds\\\": [ { \\\"medication\\\": \\\"OTC steroid cream\\\", \\\"response\\\": \\\"Moderate\\\" } ] } }\\r\\nGuardrails captured this discrepancy by raising a FieldReAsk object containing the incorrect value, the error message, and other additional information.\\r\\nJSON\\r\\n{ 'patient_info': { 'gender': 'Male', 'age': 49, 'symptoms': [ { 'symptom': 'Chronic macular rash', 'affected area': FieldReAsk( incorrect_value='Face & hair', error_message=\\\"Value Face & hair is not in choices ['head', 'neck', 'chest'].\\\", fix_value=None, path=['patient_info', 'symptoms', 0, 'affected area'] ) }, { 'symptom': 'Itchy, flaky, slightly scaly', 'affected area': FieldReAsk( incorrect_value='Beard, eyebrows & nares', error_message=\\\"Value Beard, eyebrows & nares is not in choices ['head', 'neck', 'chest'].\\\", fix_value=None, path=['patient_info', 'symptoms', 1, 'affected area'] ) } ], 'current_meds': [ {'medication': 'OTC steroid cream', 'response': 'Moderate'} ] } }\\r\\nBased on this information, it triggered another LLM call to re-generate the response. Here is the full prompt.\\r\\nI was given the following JSON response, which had problems due to incorrect values.\\r\\n\\r\\n\\r\\n {\\r\\n   \\\"patient_info\\\": {\\r\\n     \\\"symptoms\\\": [\\r\\n       {\\r\\n         \\\"affected area\\\": {\\r\\n           \\\"incorrect_value\\\": \\\"Face & hair\\\",\\r\\n           \\\"error_message\\\": \\\"Value Face & hair is not in choices ['head', 'neck', 'chest'].\\\"\\r\\n        }\\r\\n       },\\r\\n       {\\r\\n         \\\"affected area\\\": {\\r\\n           \\\"incorrect_value\\\": \\\"Beard, eyebrows & nares\\\",\\r\\n           \\\"error_message\\\": \\\"Value Beard, eyebrows & nares is not in choices ['head', 'neck', 'chest'].\\\"\\r\\n         }\\r\\n       }\\r\\n     ]\\r\\n   }\\r\\n }\\r\\n\\r\\n\\r\\n Help me correct the incorrect values based on the given error messages.\\r\\n\\r\\n\\r\\n Given below is XML that describes the information to extract from this document and the tags to extract it\\r\\n into.\\r\\n\\r\\n\\r\\n <output>\\r\\n     <object name=\\\"patient_info\\\">\\r\\n         <list name=\\\"symptoms\\\" description=\\\"Symptoms that the patient is currently experiencing. Each symptom\\r\\n should be classified into a separate item in the list.\\\">\\r\\n             <object>\\r\\n                 <string name=\\\"affected area\\\" description=\\\"What part of the body the symptom is affecting\\\"\\r\\n format=\\\"lower-case; valid-choices: choices=['head', 'neck', 'chest']\\\"/>\\r\\n             </object>\\r\\n         </list>\\r\\n     </object>\\r\\n </output>\\r\\n\\r\\n\\r\\n ONLY return a valid JSON object (no other text is necessary), where the key of the field in JSON is the `name`\\r\\n attribute of the corresponding XML, and the value is of the type specified by the corresponding XML's tag. The\\r\\n JSON MUST conform to the XML format, including any types and format requests e.g. requests for lists, objects\\r\\n and specific types. Be correct and concise. If you are unsure anywhere, enter `null`.\\r\\n\\r\\n\\r\\nThis returned the following response.\\r\\nJSON\\r\\n{ \\\"patient_info\\\": { \\\"symptoms\\\": [ { \\\"affected area\\\": \\\"head\\\", \\\"error_message\\\": null }, { \\\"affected area\\\": \\\"head\\\", \\\"error_message\\\": null } ] } }\\r\\nGuardrails then generated the final validated output, which now completely fulfills the schema.\\r\\nJSON\\r\\n{ 'patient_info': { 'gender': 'Male', 'age': 49, 'symptoms': [ {'symptom': 'Chronic macular rash', 'affected area': 'head'}, { 'symptom': 'Itchy, flaky, slightly scaly', 'affected area': 'head' } ], 'current_meds': [ {'medication': 'OTC steroid cream', 'response': 'Moderate'} ] } }\\r\\nConclusion\\r\\nIn this chapter, we looked at LLM output validation and how to implement it using Guardrails AI. Output validation is key to ensuring a generative AI application is robust and predictable enough to be deployed confidently.\",\n",
            "      \"title\": \"Validating Outputs\",\n",
            "      \"url\": \"https://docs.google.com/document/d/1wngAfCJY1IgD6H__4AkQXFfymKUpSeJL13TItbigdyA/edit?usp=drivesdk\"\n",
            "    },\n",
            "    {\n",
            "      \"editedBy\": \"Meor Amer\",\n",
            "      \"id\": \"10x9mJOnEr62hg1IFxgAtD1aIFS4NXJ2l5Lt-UhJXLVg\",\n",
            "      \"mimeType\": \"application/vnd.google-apps.document\",\n",
            "      \"modifiedTime\": \"2024-02-29T06:01:59.503Z\",\n",
            "      \"text\": \"\\ufeffEvaluating Outputs\\r\\nIn this chapter, you'll learn about the different techniques for evaluating LLM outputs.\\r\\nSuggest Edits\\r\\n!https://files.readme.io/7eb0059-Evaluating_LLM_Outputs.png\\r\\nIntroduction\\r\\nLarge language models (LLMs) offer exciting new ways to build applications that leverage natural language as the interface. However, as impressive as this technology may be, it is crucial to evaluate the generated outputs of LLMs to ensure the quality of an application.\\r\\nEvaluating LLM outputs is especially important because the outputs produced by these models are probabilistic \\u2013 meaning the same prompt does not necessarily produce the same outputs every time. Evaluations provide a way to measure the quality level of the outputs, ensuring a great user experience.\\r\\nIn this chapter, we look at a few techniques for evaluating the outputs generated by an LLM.\\r\\nReal User Feedback\\r\\nThe gold standard for evaluation is gathering actual feedback from real application users. The best way to gain insights into an application\\u2019s quality and usefulness is by collecting feedback from users who interact with the application. In contrast, the rest of the methods we\\u2019ll discuss are all proxies for understanding real user experience and behaviors.\\r\\nThe specific tactics for gathering user feedback can come in different forms, for example:\\r\\n* Explicit feedback : By implementing features to gather user feedback, such as thumbs up/down for an output, rating the output, and more\\r\\n* Implicit feedback : By observing user behaviors, such as considering ignored outputs as negatives, analyzing time spent on the output, and more\\r\\nThis creates a flywheel for continuously improving an application. As more users start using the application, more data becomes available to inform the effectiveness of an application, providing signals on areas for improvement.\\r\\nBut, of course, the challenge is that this can happen only after we deploy the application and users have been using it for a while. So, we must also perform evaluations before an application is deployed. For this, let\\u2019s look at alternative evaluation methods.\\r\\nHuman Evaluation\\r\\nThe next best option is to have human annotators evaluate the outputs of an application in the pre-deployment stage. A typical evaluation approach requires building a test dataset, and evaluation is performed against this test dataset.\\r\\n!https://txt.cohere.com/content/images/2023/10/Human-evaluation.png\\r\\nAn example human evaluation comparing two LLM outputs.\\r\\nLet\\u2019s look at a question-answering example. Here, we have one test data point: the prompt asks a question about a headphone product given a user review. The evaluation task is to rate the response generated by the LLM.\\r\\nGiven the following user review, answer the question.\\r\\n\\r\\n\\r\\nUser review: The CO-1T is a great pair of headphones! The sound quality is the best out there, and I can hear every detail of my music.\\r\\n\\r\\n\\r\\nQuestion: Why is the CO-1T a great wireless headphone?\\r\\n\\r\\n\\r\\nAnd let\\u2019s suppose that this is the generated response.\\r\\n\\\"Because the audio experience is unrivaled\\\"\\r\\n\\r\\n\\r\\nThere are several ways to approach evaluation for this response, as follows.\\r\\nReference\\r\\nHere, the evaluator would compare each test data point against the ground truth of an ideal response.\\r\\nWith our example, the ideal response might be, \\u201cBecause the sound quality is the best out there.\\u201d Based on this, the evaluator provides a Yes/No judgment on whether the generated response provides an accurate response.\\r\\nBut this approach requires the ground truth to be constructed beforehand. Given that no two use cases are quite the same, this means having to construct ground truth for each prompt and application. Moreover, the quality of the ground truth directly affects the evaluation outcome \\u2013 if not constructed correctly, it can produce misleading results.\\r\\nScoring\\r\\nHere, the evaluator would evaluate the generated response by assigning a score, such as a rating between 0 and 10. There is no ground truth as a reference, so it\\u2019s up to the evaluator to provide a verdict on the quality of an output.\\r\\nThe score can be a single score or a set of scores, and it can be broad or granular, depending on the use case. For example, a creative writing task might require more granular scoring for different output characteristics, such as fluency, interestingness, and conciseness.\\r\\nAn evaluation criterion can be a score along a scale, and it can also be a check against a flag. For example, a summarization task might require checking whether the output is consistent and does not generate content that doesn't exist in the actual document. A specialized task might require checking for specific rules, such as the number of syllables in a haiku.\\r\\nA/B Testing\\r\\nHere, the evaluator would be given a pair of LLM-generated responses and asked to rate the better response. This is useful for comparing an application\\u2019s quality over different time snapshots or different sets of configurations, such as prompts and parameters.\\r\\nWith our example, let\\u2019s suppose the evaluator is tasked to compare the following two responses to our user question above.\\r\\n1. \\\"Because the audio experience is unrivaled\\\"\\r\\n2. \\\"Because the microphone has the best quality\\\"\\r\\n\\r\\n\\r\\nWe can probably agree that the winning response should be the first one (\\u201cBecause the audio experience is unrivaled\\\") as it answers the question accurately, while the second response (\\u201cBecause the microphone has the best quality\\u201d) talks about the microphone\\u2019s quality instead of the sound quality.\\r\\nThe challenge with human evaluation is that it cannot be scaled efficiently. The cost and time incurred are significantly higher than the alternative methods, which can be automated.\\r\\nAnother challenge is that human evaluation is subjective \\u2013 the verdict from one evaluator may not be the same as another. The example above is relatively straightforward, but in more challenging tasks, there will be more ambiguity and room for interpretation about what makes a response good or bad. Many factors can influence an evaluator\\u2019s verdict, such as expertise, style, and biases, impacting the evaluation outcome.\\r\\nLLM-Generated Evaluation\\r\\nAn alternative to human evaluation is to have an LLM to evaluate the output. With the same setup as above, this is done by having a prompt instructing the LLM to provide the verdict of a generated answer against the reference.\\r\\n!https://txt.cohere.com/content/images/2023/10/LLM-Generated-Evaluation.png\\r\\nAn example LLM-generated evaluation comparing two LLM outputs.\\r\\nAny human evaluation paradigms that we discussed (reference, scoring, and A/B testing) could be replicated using LLM-generated evaluation.\\r\\nThe example below uses the Command model to perform an A/B testing evaluation for the same question-answering task. The model's task is to choose the winning response between two responses to the question.\\r\\nPython\\r\\n`# Add text to evaluate ref_answer = \\\"Because the sound quality is the best out there\\\" gen_answers = [\\\"Because the audio experience is unrivaled\\\", \\\"Because the microphone has the best quality\\\"]\\r\\nRun evaluation\\r\\nfor gen_answer in gen_answers: prompt=f\\\"\\\"\\\"User review: The CO-1T is a great pair of headphones! The sound quality is the \\\\ best out there, and I can hear every detail of my music. Question: Why is the CO-1T a great headphone? Answer #1: {gen_answers[0]} Answer #2: {gen_answers[1]}\\r\\nGiven the question about the user review, state whether Answer #1 or Answer #2 provides \\\\\\\\\\r\\nthe more accurate answer.\\\"\\\"\\\"\\r\\n\\r\\n\\r\\nresponse = co.generate(prompt=prompt,max_tokens=50, temperature=0).generations[0].text\\r\\nprint(response)`\\r\\n\\r\\n\\r\\nThe generated verdict is \\u201cAnswer #1\\u201d, which is what we expect the winning response should be.\\r\\nAnswer #1\\r\\n\\r\\n\\r\\nThis approach is promising as it eliminates the cost and time constraints of human evaluation, but the jury is still out on whether it can surpass human evaluation in accuracy and quality. Its effectiveness on one task doesn\\u2019t guarantee that it will generalize to other tasks and domains, and the only way to know is by testing it on a specific application.\\r\\nLLM-generated evaluation also faces the same subjectivity challenge as human evaluation. Many factors can affect a model\\u2019s evaluation outcome, such as the model\\u2019s overall capability, whether it\\u2019s being trained specifically to perform evaluations, the presence of training data that could introduce biases, and more.\\r\\nWord-Level Metrics\\r\\nAnother evaluation approach compares the reference and generated output at the word/token (or word/token group) level. Several evaluation metrics are available, such as BLEU , ROUGE , Perplexity , and BERTScore .\\r\\n!https://txt.cohere.com/content/images/2023/10/Word-level-Metrics.png\\r\\nLet\\u2019s look at an example with ROUGE , originally created for evaluating summaries. It measures the number of matching \\u201cn-grams\\u201d between the reference and generated text. An N-gram is a contiguous sequence of n items in a text, where n can be 1, 2, and so on. To keep it simple, we\\u2019ll use n=1, also called \\u201cunigrams.\\u201d For example, in the sentence \\u201cI love cats,\\u201d the unigrams are \\u201cI,\\u201d \\u201clove,\\u201d and \\u201ccats.\\u201d\\r\\nWe calculate the precision, recall, and F1-score of the n-grams of the question-answering task against a reference answer of \\u201cBecause the sound quality is the best out there.\\u201d\\r\\n* Precision is the ratio of the count of matching unigrams divided by the count of unigrams in the generated text\\r\\n* Recall is the ratio of the count of matching unigrams divided by the count of unigrams in the reference text\\r\\n* F1-score is calculated from precision and recall with the following formula: 2 * (precision * recall) / (precision + recall)\\r\\nHere is an example using ROUGE:\\r\\nPython\\r\\n`from collections import Counter\\r\\ndef rouge_1(reference, candidate): # Turn into unigrams reference_words = reference.split() candidate_words = candidate.split()\\r\\n# Compute the number of overlapping words\\r\\nreference_count = Counter(reference_words)\\r\\ncandidate_count = Counter(candidate_words)\\r\\noverlap = sum(min(candidate_count[w], reference_count[w]) for w in candidate_count)\\r\\n\\r\\n\\r\\n# Compute precision, recall, and F1 score\\r\\nrecall = overlap / len(reference_words)\\r\\nprecision = overlap / len(candidate_words)\\r\\nf1 = 2 * (recall * precision) / (recall + precision)\\r\\n\\r\\n\\r\\n# Return resuls\\r\\nreturn {\\\"recall\\\": recall, \\\"precision\\\": precision, \\\"f1\\\": f1}\\r\\n\\r\\n\\r\\nfor idx,gen_answer in enumerate(gen_answers): result = rouge_1(ref_answer, gen_answer) print(f\\\"Answer #{idx+1}\\\") print(f\\\"Precision: {result['precision']:.2f}\\\") print(f\\\"Recall: {result['recall']:.2f}\\\") print(f\\\"F1-Score: {result['f1']:.2f}\\\") print(\\\"\\\\n\\\")`\\r\\nThis gives the following outcome.\\r\\nAnswer #1\\r\\nPrecision: 0.50\\r\\nRecall: 0.33\\r\\nF1-Score: 0.40\\r\\n\\r\\n\\r\\nAnswer #2\\r\\nPrecision: 0.71\\r\\nRecall: 0.56\\r\\nF1-Score: 0.63\\r\\n\\r\\n\\r\\nHere, the second generated answer scored higher than the first in precision, recall, and F1-score, which is not the expected outcome. This is because it has more unigram overlaps with the reference answer, for example, with the words \\u201cbest\\u201d and \\u201cquality.\\u201d\\r\\nThis is an example where word-level metrics may fall short. They can be handy because they are easy to interpret and their implementation is fast and cheap, but they may not capture the overall meaning and accuracy when comparing two pieces of text.\\r\\nConclusion\\r\\nThis chapter looked at a few techniques for evaluating LLM outputs, from human evaluations to automated ones.\\r\\nThere is a trade-off to be considered: on the one hand, automated evaluations are much more cost and time-efficient, which makes them practical options in some cases, such as in the early prototyping stages. On the other hand, human evaluations are still the gold standard for getting the strongest signal on an application's accuracy and usefulness.\\r\\nIt\\u2019s also worth noting that this chapter looks at evaluating LLM outputs in general without making any assumptions about the actual task. In practice, there are other approaches not mentioned here that better suit specific tasks, such as code execution or information extraction.\\r\\nUltimately, each evaluation approach has its potential pitfalls. An evaluation outcome can only be considered reliable if we have first understood and mitigated the associated limitations.\\r\\nOriginal Source\\r\\nThis material comes from the post: Evaluating LLM Outputs .\\r\\nUpdated about 1 month ago\\r\\n________________\\r\\n\\r\\n\\r\\nWhat\\u2019s Next\\r\\n* Conclusion - Prompt Engineering\\r\\n* Table of Contents\\r\\n* IntroductionReal User FeedbackHuman EvaluationReferenceScoringA/B TestingLLM-Generated EvaluationWord-Level MetricsConclusionOriginal Source\",\n",
            "      \"title\": \"Evaluating Outputs\",\n",
            "      \"url\": \"https://docs.google.com/document/d/10x9mJOnEr62hg1IFxgAtD1aIFS4NXJ2l5Lt-UhJXLVg/edit?usp=drivesdk\"\n",
            "    }\n",
            "  ]\n",
            "}\n"
          ]
        }
      ],
      "source": [
        "! curl --request POST \\\n",
        "\t\t--url https://demo-conn-gdrive.onrender.com/search \\\n",
        "\t\t--header 'Authorization: Bearer YOUR_CONNECTOR_API_KEY' \\\n",
        "\t\t--header 'Content-Type: application/json' \\\n",
        "\t\t--data '{\"query\": \"prompt chaining\"}'"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "SbRh6GNuRnmw"
      },
      "source": [
        "# Create a chatbot"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "0V7dWvznljbD"
      },
      "source": [
        "The `Chatbot` class below handles the interaction between the user and chatbot.  We define the connector for the chatbot to use with the attribute `self.connectors`.\n",
        "\n",
        "The run() method contains the logic for getting the user message, displaying the chatbot response with citations, along with a way for the user to end the conversation."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 3,
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 17
        },
        "id": "PB5kpanxRnmw",
        "outputId": "ee14bf68-0921-41c8-b6c3-bc652a107a4d"
      },
      "outputs": [],
      "source": [
        "class Chatbot:\n",
        "    def __init__(self, connectors: List[str]):\n",
        "        \"\"\"\n",
        "        Initializes an instance of the Chatbot class.\n",
        "\n",
        "        \"\"\"\n",
        "        self.conversation_id = str(uuid.uuid4())\n",
        "        self.connectors = [ChatConnector(id=connector) for connector in connectors]\n",
        "\n",
        "    def run(self):\n",
        "        \"\"\"\n",
        "        Runs the chatbot application.\n",
        "\n",
        "        \"\"\"\n",
        "        while True:\n",
        "            # Get the user message\n",
        "            message = input(\"User: \")\n",
        "\n",
        "            # Typing \"quit\" ends the conversation\n",
        "            if message.lower() == \"quit\":\n",
        "                print(\"Ending chat.\")\n",
        "                break\n",
        "            else:                       # If using Google Colab, remove this line to avoid printing the same thing twice\n",
        "              print(f\"User: {message}\") # If using Google Colab, remove this line to avoid printing the same thing twice\n",
        "\n",
        "            # Generate response\n",
        "            response = co.chat_stream(\n",
        "                    message=message,\n",
        "                    model=\"command-r-plus\",\n",
        "                    conversation_id=self.conversation_id,\n",
        "                    connectors=self.connectors,\n",
        "            )\n",
        "\n",
        "            # Print the chatbot response, citations, and documents\n",
        "            print(\"\\nChatbot:\")\n",
        "            citations = []\n",
        "            cited_documents = []\n",
        "\n",
        "            # Display response\n",
        "            for event in response:\n",
        "                if event.event_type == \"text-generation\":\n",
        "                    print(event.text, end=\"\")\n",
        "                elif event.event_type == \"citation-generation\":\n",
        "                    citations.extend(event.citations)\n",
        "                elif event.event_type == \"stream-end\":\n",
        "                    cited_documents = event.response.documents\n",
        "\n",
        "            # Display citations and source documents\n",
        "            if citations:\n",
        "              print(\"\\n\\nCITATIONS:\")\n",
        "              for citation in citations:\n",
        "                print(citation)\n",
        "\n",
        "              print(\"\\nDOCUMENTS:\")\n",
        "              for document in cited_documents:\n",
        "                print({'id': document['id'],\n",
        "                        'text': document['text'][:50] + '...'})\n",
        "\n",
        "            print(f\"\\n{'-'*100}\\n\")"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "TAIvNbpxkA1h"
      },
      "source": [
        "# Run the chatbot"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "AL4D455vmED3"
      },
      "source": [
        "We can now run the chatbot.  For this, we create the instance of `Chatbot` using Cohere's managed web-search connector.  Then we run the chatbot by invoking the `run()` method.\n",
        "\n",
        "The format of each citation is:\n",
        "- `start`: The starting point of a span where one or more documents are referenced\n",
        "- `end`: The ending point of a span where one or more documents are referenced\n",
        "- `text`: The text representing this span\n",
        "- `document_ids`: The IDs of the documents being referenced (`doc_0` being the ID of the first document passed to the `documents` creating parameter in the endpoint call, and so on)"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 8,
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 1000
        },
        "id": "JeEZkEVPRnmx",
        "outputId": "4e157035-f0cc-4f68-cde2-2404d92b230a"
      },
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "User: What is prompt engineering\n",
            "\n",
            "Chatbot:\n",
            "Prompt engineering is a process of constructing prompts for a large language model (LLM) to get a desired response. It involves techniques such as adding specific details, context, output format requirements, and examples to a prompt to guide the LLM's response. Prompt engineering also involves chaining multiple prompts together to accomplish a complex task and validating and evaluating the outputs of LLMs to ensure the quality and accuracy of the responses.\n",
            "\n",
            "CITATIONS:\n",
            "start=35 end=55 text='constructing prompts' document_ids=['demo-conn-gdrive-6bfrp6_0', 'demo-conn-gdrive-6bfrp6_1', 'demo-conn-gdrive-6bfrp6_2', 'demo-conn-gdrive-6bfrp6_3', 'demo-conn-gdrive-6bfrp6_4']\n",
            "start=62 end=88 text='large language model (LLM)' document_ids=['demo-conn-gdrive-6bfrp6_0', 'demo-conn-gdrive-6bfrp6_3']\n",
            "start=98 end=115 text='desired response.' document_ids=['demo-conn-gdrive-6bfrp6_0', 'demo-conn-gdrive-6bfrp6_3']\n",
            "start=154 end=170 text='specific details' document_ids=['demo-conn-gdrive-6bfrp6_0']\n",
            "start=172 end=179 text='context' document_ids=['demo-conn-gdrive-6bfrp6_0']\n",
            "start=181 end=207 text='output format requirements' document_ids=['demo-conn-gdrive-6bfrp6_0']\n",
            "start=213 end=221 text='examples' document_ids=['demo-conn-gdrive-6bfrp6_0']\n",
            "start=237 end=262 text=\"guide the LLM's response.\" document_ids=['demo-conn-gdrive-6bfrp6_0']\n",
            "start=296 end=330 text='chaining multiple prompts together' document_ids=['demo-conn-gdrive-6bfrp6_1']\n",
            "start=364 end=374 text='validating' document_ids=['demo-conn-gdrive-6bfrp6_3']\n",
            "start=379 end=389 text='evaluating' document_ids=['demo-conn-gdrive-6bfrp6_4']\n",
            "start=424 end=431 text='quality' document_ids=['demo-conn-gdrive-6bfrp6_4']\n",
            "start=436 end=444 text='accuracy' document_ids=['demo-conn-gdrive-6bfrp6_3']\n",
            "\n",
            "DOCUMENTS:\n",
            "{'id': 'demo-conn-gdrive-6bfrp6_0', 'text': \"\\ufeffConstructing Prompts\\r\\nIn this chapter, you'll lea...\"}\n",
            "{'id': 'demo-conn-gdrive-6bfrp6_1', 'text': \"\\ufeffChaining Prompts\\r\\nIn this chapter, you'll learn a...\"}\n",
            "{'id': 'demo-conn-gdrive-6bfrp6_2', 'text': \"\\ufeffUse Case Patterns\\r\\nIn this chapter, you'll learn ...\"}\n",
            "{'id': 'demo-conn-gdrive-6bfrp6_3', 'text': \"\\ufeffValidating Outputs\\r\\nIn this chapter, you'll learn...\"}\n",
            "{'id': 'demo-conn-gdrive-6bfrp6_4', 'text': \"\\ufeffEvaluating Outputs\\r\\nIn this chapter, you'll learn...\"}\n",
            "\n",
            "----------------------------------------------------------------------------------------------------\n",
            "\n",
            "Ending chat.\n"
          ]
        }
      ],
      "source": [
        "# Define the connector\n",
        "connectors = [\"demo-conn-gdrive-6bfrp6\"]\n",
        "\n",
        "# Create an instance of the Chatbot class\n",
        "chatbot = Chatbot(connectors)\n",
        "\n",
        "# Run the chatbot\n",
        "chatbot.run()"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "metadata": {},
      "outputs": [],
      "source": []
    }
  ],
  "metadata": {
    "colab": {
      "provenance": []
    },
    "kernelspec": {
      "display_name": "base",
      "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.11.4"
    },
    "orig_nbformat": 4
  },
  "nbformat": 4,
  "nbformat_minor": 0
}