09_documents.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# RAG\n",
    "In this section we will start to see the glimpses of RAG. We start by figuring out how to handle external documents. We have already been exposed to building a database in the previous section, and we will use this knowledge to build a database over an example document.\n",
    "\n",
    "As with data storage, we have many, _**many**_ options for processing external documents. In this section we will make use of LlamaIndex. The approach will likely vary depending on the nature of your documents - html, pdf, word, folders, etc.\n",
    "\n",
    "Here, we focus on parsing a single PDF using `llama_index` and `PyMuPDFReader`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 58,
   "metadata": {},
   "outputs": [],
   "source": [
    "from llama_index.readers.file import PyMuPDFReader\n",
    "from llama_index.core.node_parser import SentenceSplitter\n",
    "\n",
    "from pydantic import BaseModel, Field\n",
    "\n",
    "import fitz\n",
    "\n",
    "from PIL import Image\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "import chromadb\n",
    "from chromadb.utils.embedding_functions import OpenAIEmbeddingFunction\n",
    "\n",
    "import dotenv\n",
    "import os\n",
    "\n",
    "from openai import OpenAI\n",
    "\n",
    "from jinja2 import Environment, FileSystemLoader, select_autoescape\n",
    "from typing import Any\n",
    "\n",
    "dotenv.load_dotenv()\n",
    "OPENAI_API_KEY = os.getenv(\"OPENAI_API_KEY\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "loader = PyMuPDFReader()\n",
    "documents = loader.load(file_path=\"data/paper.pdf\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "30"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "len(documents)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This list contains 1 item for each page."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "A Philosophical Introduction to Language Models\n",
      "Part I: Continuity With Classic Debates\n",
      "Raphaël Millière\n",
      "Department of Philosophy\n",
      "Macquarie University\n",
      "raphael.milliere@mq.edu.eu\n",
      "Cameron Buckner\n",
      "Department of Philosophy\n",
      "University of Houston\n",
      "cjbuckner@uh.edu\n",
      "Abstract\n",
      "Large language models like GPT-4 have achieved remarkable proficiency in a broad spec-\n",
      "trum of language-based tasks, some of which are traditionally associated with hallmarks of\n",
      "human intelligence. This has prompted ongoing disagreements about the extent to which\n",
      "we can meaningfully ascribe any kind of linguistic or cognitive competence to language\n",
      "models. Such questions have deep philosophical roots, echoing longstanding debates\n",
      "about the status of artificial neural networks as cognitive models. This article–the first part\n",
      "of two companion papers–serves both as a primer on language models for philosophers,\n",
      "and as an opinionated survey of their significance in relation to classic debates in the\n",
      "philosophy cognitive science,...\n"
     ]
    }
   ],
   "source": [
    "print(documents[0].text[:1000] + \"...\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Extracting images\n",
    "It is probably handy to have the images extracted from the pdf. This is not always easy to do, but for this paper, we can use PyMuPDF to extract the images. Objects in a pdf are identified by a `xref` (cross reference) number.\n",
    "\n",
    "If you know this number, you can extract the image. But how do you find the `xref` number? One method is use PyMuPDF's image extraction functions. We can just loop through all `xref`s and try and extract the image. If it doesn't work, then it's not an image! PyMuPDF will do most of this for us."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "def get_images(path: str):\n",
    "    doc = fitz.open(path)\n",
    "    for p, page in enumerate(doc):\n",
    "        images = page.get_images()\n",
    "        if len(images) > 0:\n",
    "            print(f\"Page {p} has {len(images)} images\")\n",
    "            for i, img in enumerate(images):\n",
    "                xref = img[0]\n",
    "                mref = img[1]\n",
    "                basepix = fitz.Pixmap(doc,xref)\n",
    "                maskpix = fitz.Pixmap(doc,mref)\n",
    "                pix = fitz.Pixmap(basepix, maskpix)\n",
    "                pix.save(f\"./data/page_{p}_image_{i}.png\")\n",
    "    print(\"Done\")\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Page 4 has 1 images\n",
      "Page 6 has 1 images\n",
      "Page 10 has 1 images\n",
      "Done\n"
     ]
    }
   ],
   "source": [
    "get_images(\"data/paper.pdf\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we inspect one of these images, we can see that sure enough, it is a correct image."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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qKgobDYbDofDv4Nj2rRpPPnkk5x77rmsXr0arVY7oGdDjmayVwl4saFD0Wo0xJhDaW5uJi4urtt0f0vVTlzVGzC3bSDGXUKy2k2aMRE5NBdbxJl83xHOqXMuIczjYd26daTEZ5I75tAzDF05PQfLxq92uWj8TTZ+/N4EveFRUZyx986+a+uduLMXAmlQBAOVO2pRtCbGnD6csPAwAFa8tQbJZOSY08ZiNBr579rVdOzwkHVcCg2qFiISw0hOTWJnZDHoFDKGprP6419QnCHUbWpBkbxoVSZaa0ORS7V49E52fFWC2qFFiw6Xy3XE+1d7SqPRIMuyv+qdoih4PJ79EpIURWHx4sVs27aNRx99dMB/iOj1epxOp//vXq8XlUrVLQi76qqryMnJobCwkE2bNnHnnXcG/Rafwcrr8KJzhmBO6r3kwS6KooDsJjNay441SylXdaJv/IVY506iaCdBH4kSOhQldSJK6EUo+ni8mhBAhVaWaa3eSF1dHREREaSnpxMXF3fgrXetrZS1t1PR2UmVw0GTLGNXlG7lclONRobvzcY/ULncgf7/VBgYBkUwoA/R0emRsNschIWH4XQ6URkkPG5wOnzZ9zgkNMZD38nrQjW4jQqTLhtFZEyE/9+uXrGDkDwVJ11wku9wHOXIC1kEQmxsLGq1mtraWjIyMmhubsZqtZKcnIzb7Uar1foDge+++46HH354wM8KAOTm5vLWW2/hcDgwGAzs3r2bxMREDAaD/7q1Wi0nnXQSW7Zs4bjjjmP69On93e1Bo729nT179pCVldXtTIjKykqamprIy8vDYDD4H7c3uTGFhWCIDPDgpygoigweC3TWQNtOaNkCbbvIsDeSJhmRTJnIcfko5mkohmS82jAUyXd8cleQ7QVcsozF46FDraG4oYH6wkJfNv7atftl4+9bG39EVNRRv/VOGNgGRTAwdEIWm74pY9PzRXiit2L0hDL0TynsXFPH989uQm0CQ3UUsZdqkA6R6JNzbDYbV5aw7d/leGJ2om8II/fPyZimgHO5iVWdP4NFhSnewElXTeqz/+ShoaHMmzePhx56iPPPP58vvviCWbNmodVqufTSS3nwwQfZunUrjz76KJdccgmfffYZOp2OWbNmERYW1id97A05OTkMGTKEJ554grFjx/J///d/3HzzzezatYvHHnuMl156iZCQEFas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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "img = Image.open(\"data/page_4_image_0.png\")\n",
    "plt.imshow(img)\n",
    "plt.axis(\"off\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In some cases, this might not be possible. Another method is to convert the pdf pages to images. We can then pass the images to a vision LLM and ask it to extract the images. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Creating a vector database"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we have our documents, we can create a vector database. We will use Chroma as before.\n",
    "\n",
    "First, we use the `text_parser` we created before to split the documents into chunks, and create indices. Essentially, the process is:\n",
    "\n",
    "- Split the document into chunks;\n",
    "- Add the chunks to a list;\n",
    "- Add the chunks to a database, assigning a unique index, and any metadata to the chunks.\n",
    "\n",
    "The splitting can occur in a few different ways: at `.`, page-breaks, paragraphs, sentences. You can also choose different chunk sizes and overlap sizes.\n",
    "\n",
    "We use the `SentenceSplitter` from LlamaIndex, and just pick some generic parameters."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "34"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def chunker(chunk_size: int, overlap: int, documents: Any) -> tuple[list[str], list[int]]:\n",
    "    text_parser = SentenceSplitter(\n",
    "        chunk_size=chunk_size,\n",
    "        chunk_overlap=overlap,\n",
    "    )\n",
    "\n",
    "    text_chunks = []\n",
    "    doc_idxs = []\n",
    "    for doc_idx, doc in enumerate(documents):\n",
    "        cur_text_chunks = text_parser.split_text(doc.text)\n",
    "        text_chunks.extend(cur_text_chunks)\n",
    "        doc_idxs.extend([doc_idx] * len(cur_text_chunks))\n",
    "\n",
    "    return text_chunks, doc_idxs\n",
    "\n",
    "text_chunks, doc_idxs = chunker(chunk_size=1024, overlap=128, documents=documents)\n",
    "\n",
    "len(text_chunks)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Reusing roughly the same database structure as before:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [],
   "source": [
    "class DocumentDB:\n",
    "    def __init__(self, name: str, model_name: str = \"text-embedding-3-small\"):\n",
    "        self.model_name = model_name\n",
    "        self.client = chromadb.PersistentClient(path=\"./\")\n",
    "        self.embedding_function = OpenAIEmbeddingFunction(api_key=OPENAI_API_KEY, model_name=model_name)\n",
    "        self.chat_db = self.client.create_collection(name=name, embedding_function=self.embedding_function, metadata={\"hnsw:space\": \"cosine\"})\n",
    "        self.id_counter = 0\n",
    "\n",
    "\n",
    "    def add_chunks_to_db(self, chunks: list[str], doc_idxs: list[int], metadata: dict = {}):\n",
    "        \"\"\"Add text chunks to the database.\n",
    "\n",
    "        Args:\n",
    "            chunks (list[str]): List of text chunks.\n",
    "            doc_idxs (list[int]): List of corresponding document indices.\n",
    "        \"\"\"\n",
    "        self.chat_db.add(\n",
    "            documents=chunks,\n",
    "            metadatas=[{\"doc_idx\": idx} for idx in doc_idxs],\n",
    "            ids=[f\"chunk_{self.id_counter + i}\" for i in range(len(chunks))]\n",
    "        )\n",
    "        self.id_counter += len(chunks)\n",
    "\n",
    "\n",
    "    def get_all_entries(self) -> dict:\n",
    "        \"\"\"Grab all of the entries in the database.\n",
    "\n",
    "        Returns:\n",
    "            dict: All entries in the database.\n",
    "        \"\"\"\n",
    "        return self.chat_db.get()\n",
    "    \n",
    "\n",
    "    def clear_db(self, reinitialize: bool = True):\n",
    "        \"\"\"Clear the database of all entries, and reinitialize it.\n",
    "\n",
    "        Args:\n",
    "            reinitialize (bool, optional): _description_. Defaults to True.\n",
    "        \"\"\"\n",
    "        self.client.delete_collection(self.chat_db.name)\n",
    "        # re-initialize the database\n",
    "        if reinitialize:\n",
    "            self.__init__(self.chat_db.name, self.model_name)\n",
    "\n",
    "\n",
    "    def query_db(self, query_text: str, n_results: int = 2) -> dict:\n",
    "        \"\"\"Given some query text, return the n_results most similar entries in the database.\n",
    "\n",
    "        Args:\n",
    "            query_text (str): The text to query the database with.\n",
    "            n_results (int): The number of results to return.\n",
    "\n",
    "        Returns:\n",
    "            dict: The most similar entries in the database.\n",
    "        \"\"\"\n",
    "        return self.chat_db.query(query_texts=[query_text], n_results=n_results)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we add our chunks to the database:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [],
   "source": [
    "doc_db = DocumentDB(\"paper_db\")\n",
    "doc_db.add_chunks_to_db(chunks=text_chunks, doc_idxs=doc_idxs)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you have already created the database then you will get an error if you try to run this again. You'll need to delete the `chroma.sqlite3` file and the folder with a name consisting of a long string of numbers and letters."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We now try a query and see what results we get back:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Sample query results for 'Abstract':\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "{'ids': [['chunk_30', 'chunk_12', 'chunk_11']],\n",
       " 'distances': [[0.7026290379547134, 0.7119312067010161, 0.7212011058066763]],\n",
       " 'metadatas': [[{'doc_idx': 27}, {'doc_idx': 11}, {'doc_idx': 10}]],\n",
       " 'embeddings': None,\n",
       " 'documents': [['A Philosophical Introduction to Language Models\\nPart I\\nQiu, L., Shaw, P., Pasupat, P., Nowak, P., Linzen, T., Sha, F. & Toutanova, K. (2022), Improving\\nCompositional Generalization with Latent Structure and Data Augmentation, in ‘Proceedings of the\\n2022 Conference of the North American Chapter of the Association for Computational Linguistics:\\nHuman Language Technologies’, Association for Computational Linguistics, Seattle, United States,\\npp. 4341–4362.\\nQuilty-Dunn, J., Porot, N. & Mandelbaum, E. (2022), ‘The Best Game in Town: The Re-Emergence of\\nthe Language of Thought Hypothesis Across the Cognitive Sciences’, Behavioral and Brain Sciences\\npp. 1–55.\\nRaffel, C., Shazeer, N., Roberts, A., Lee, K., Narang, S., Matena, M., Zhou, Y., Li, W. & Liu, P. J. (2020),\\n‘Exploring the limits of transfer learning with a unified text-to-text transformer’, The Journal of\\nMachine Learning Research 21(1), 140:5485–140:5551.\\nRamesh, A., Dhariwal, P., Nichol, A., Chu, C. & Chen, M. (2022), ‘Hierarchical Text-Conditional Image\\nGeneration with CLIP Latents’.\\nSalton, G., Wong, A. & Yang, C. S. (1975), ‘A vector space model for automatic indexing’, Communica-\\ntions of the ACM 18(11), 613–620.\\nSavelka, J., Agarwal, A., An, M., Bogart, C. & Sakr, M. (2023), Thrilled by Your Progress! Large\\nLanguage Models (GPT-4) No Longer Struggle to Pass Assessments in Higher Education Program-\\nming Courses, in ‘Proceedings of the 2023 ACM Conference on International Computing Education\\nResearch V.1’, pp. 78–92.\\nSavelka, J., Ashley, K. D., Gray, M. A., Westermann, H. & Xu, H. (2023), Can GPT-4 Support Analysis\\nof Textual Data in Tasks Requiring Highly Specialized Domain Expertise?, in ‘Proceedings of the\\n2023 Conference on Innovation and Technology in Computer Science Education V. 1’, pp. 117–123.\\nSchmidhuber, J. (1990), Towards Compositional Learning with Dynamic Neural Networks, Inst. für\\nInformatik.\\nSchut, L., Tomasev, N., McGrath, T., Hassabis, D., Paquet, U. & Kim, B. (2023), ‘Bridging the Human-AI\\nKnowledge Gap: Concept Discovery and Transfer in AlphaZero’.\\nSearle, J. R. (1980), ‘Minds, Brains, and Programs’, Behavioral and Brain Sciences 3(3), 417–57.\\nShinn, N., Cassano, F., Berman, E., Gopinath, A., Narasimhan, K. & Yao, S. (2023), ‘Reflexion:\\nLanguage Agents with Verbal Reinforcement Learning’.\\nSmolensky, P. (1988), ‘On the proper treatment of connectionism’, Behavioral and Brain Sciences\\n11(1), 1–23.\\nSmolensky, P. (1989), Connectionism and Constituent Structure, in R. Pfeifer, Z. Schreter, F. Fogelman-\\nSoulié & L. Steels, eds, ‘Connectionism in Perspective’, Elsevier.\\nSmolensky, P., McCoy, R., Fernandez, R., Goldrick, M. & Gao, J. (2022a), ‘Neurocompositional\\nComputing: From the Central Paradox of Cognition to a New Generation of AI Systems’, AI\\nMagazine 43(3), 308–322.\\nSmolensky, P., McCoy, R. T., Fernandez, R., Goldrick, M. & Gao, J. (2022b), ‘Neurocompositional\\ncomputing in human and machine intelligence: A tutorial’.\\nSober, E. (1998), Morgan’s canon, in ‘The Evolution of Mind’, Oxford University Press, New York, NY,\\nUS, pp. 224–242.\\n28',\n",
       "   'A Philosophical Introduction to Language Models\\nPart I\\nInitial DNN performance on SCAN and other synthetic datasets probing compositional gener-\\nalization – such as CFQ (Keysers et al. 2019) and COGS (Kim & Linzen 2020) – was somewhat\\nunderwhelming. Testing generally revealed a significant gap between performance on the train set\\nand on the test set, suggesting a failure to properly generalize across syntactic distribution shifts.\\nSince then, however, many Transformer-based models have achieved good to perfect accuracy on these\\ntests. This progress was enabled by various strategies, including tweaks to the vanilla Transformer\\narchitecture to provide more effective inductive biases (Csordás et al. 2022, Ontanon et al. 2022) and\\ndata augmentation to help models learn the right kind of structure (Andreas 2020, Akyürek et al.\\n2020, Qiu et al. 2022).\\nMeta-learning, or learning to learn better by generalizing from exposure to many related learning\\ntasks (Conklin et al. 2021, Lake & Baroni 2023), has also shown promise without further architectural\\ntweaks. Standard supervised learning rests on the assumption that training and testing data are\\ndrawn from the same distribution, which can lead models to “overfit” to the training data and fail to\\ngeneralize to the testing data. Meta-learning exposes models to several distributions of related tasks,\\nin order to promote acquisition of generalizable knowledge. For example, Lake & Baroni (2023) show\\nthat a standard Transformer-based neural network, when trained on a stream of distinct artificial\\ntasks, can achieve systematic generalization in a controlled few-shot learning experiment, as well as\\nstate-of-the-art performance on systematic generalization benchmarks. At test time, the model exhibits\\nhuman-like accuracy and error patterns, all without explicit compositional rules. While meta-learning\\nacross various tasks helps promote compositional generalization, recent work suggests that merely\\nextending the standard training of a network beyond the point of achieving high accuracy on training\\ndata can lead it to develop more tree-structured computations and generalize significantly better to\\nheld-out test data that require learning hierarchical rules (Murty et al. 2023). The achievements of\\nTransformer models on compositional generalization benchmarks provide tentative evidence that\\nbuilt-in rigid compositional rules may not be needed to emulate the structure-sensitive operations of\\ncognition.\\nOne interpretation of these results is that, given the right architecture, learning objective, and\\ntraining data, ANNs might achieve human-like compositional generalization by implementing a\\nlanguage of thought architecture – in accordance with the second horn of the classicist dilemma\\n(Quilty-Dunn et al. 2022, Pavlick 2023). But an alternative interpretation is available, on which ANNs\\ncan achieve compositional generalization with non-classical constituent structure and composition\\nfunctions. Behavioral evidence alone is insufficient to arbitrate between these two hypotheses.8 But\\nit is also worth noting that the exact requirements for implementing a language of thought are still\\nsubject to debate (Smolensky 1989, McGrath et al. 2023).\\nOn the traditional Fodorian view, mental processes operate on discrete symbolic representations\\nwith semantic and syntactic structure, such that syntactic constituents are inherently semantically\\nevaluable and play direct causal roles in cognitive processing. By contrast, the continuous vectors that\\nbear semantic interpretation in ANNs are taken to lack discrete, semantically evaluable constituents\\nthat participate in processing at the algorithmic level, which operates on lower-level activation values\\ninstead. This raises the question whether the abstracted descriptions of stable patterns observed\\nin the aggregate behavior of ANNs’ lower-level mechanisms can fulfill the requirements of classical\\nconstituent structure, especially when their direct causal efficacy in processing is not transparent.\\nFor proponents of connectionism who argue that ANNs may offer a non-classical path to modeling\\ncognitive structure, this is a feature rather than a bug. Indeed, classical models likely make overly\\nrigid assumptions about representational formats, binding mechanisms, algorithmic transparency,\\nand demands for systematicity; conversely, even modern ANNs likely fail to implement their specific\\n8See Part II for a brief discussion of mechanistic evidence in favor of the second hypothesis.\\n12',\n",
       "   'A Philosophical Introduction to Language Models\\nPart I\\n3.1. Compositionality\\nAccording to a long-standing critique of the connectionist research program, artificial neural networks\\nwould be fundamentally incapable of accounting for the core structure-sensitive features of cognition,\\nsuch as the productivity and systematicity of language and thought. This critique centers on a\\ndilemma: either ANNs fail to capture the features of cognition that can be readily accounted for in a\\nclassical symbolic architecture; or they merely implement such an architecture, in which case they lack\\nindependent explanatory purchase as models of cognition (Fodor & Pylyshyn 1988, Pinker & Prince\\n1988, Quilty-Dunn et al. 2022). The first horn of the dilemma rests on the hypothesis that ANNs lack\\nthe kind of constituent structure required to model productive and systematic thought – specifically,\\nthey lack compositionally structured representations involving semantically-meaningful, discrete\\nconstituents (Macdonald 1995). By contrast, classicists argue that thinking occurs in a language of\\nthought with a compositional syntax and semantics (Fodor 1975). On this view, cognition involves\\nthe manipulation of discrete mental symbols combined according to compositional rules. Hence, the\\nsecond horn of the dilemma: if some ANNs turn out to exhibit the right kind of structure-sensitive\\nbehavior, they must do so because they implement rule-based computation over discrete symbols.\\nThe remarkable progress of LLMs in recent years calls for a reexamination of old assumptions\\nabout compositionality as a core limitation of connectionist models. A large body of empirical\\nresearch investigates whether language models exhibit human-like levels of performance on tasks\\nthought to require compositional processing. These studies evaluate models’ capacity for compositional\\ngeneralization, that is, whether they can systematically recombine previously learned elements to\\nmap new inputs made up from these elements to their correct output (Schmidhuber 1990). This is\\ndifficult to do with LLMs trained on gigantic natural language corpora, such as GPT-3 and GPT-4,\\nbecause it is near-impossible to rule out that the training set contains that exact syntactic pattern.\\nSynthetic datasets overcome this with a carefully designed train-test split.\\nThe SCAN dataset, for example, contains a set of natural language commands (e.g., “jump twice”)\\nmapped unambiguously to sequences of actions (e.g., JUMP JUMP) (Lake & Baroni 2018). The\\ndataset is split into a training set, providing broad coverage of the space of possible commands, and\\na test set, specifically designed to evaluate models’ abilities to compositionally generalize (3). To\\nsucceed on SCAN, models must learn to interpret words in the input (including primitive commands,\\nmodifiers and conjunctions) in order to properly generalize to novel combinations of familiar elements\\nas well as entirely new commands. The test set evaluates generalization in a number of challenging\\nways, including producing action sequences longer than seen before, generalizing across primitive\\ncommands by producing the action sequence for a novel composed command, and generalizing in a\\nfully systematic fashion by “bootstrapping” from limited data to entirely new compositions.\\nFigure 3 | Examples of inputs and outputs from the SCAN dataset (Lake & Baroni 2018) with an\\nillustrative train-test split.7\\n7Several train-test splits exist for the SCAN dataset to test different aspects of generalization, such as generalization to\\nlonger sequence lengths, to new templates, or to new primitives (Lake & Baroni 2018).\\n11']],\n",
       " 'uris': None,\n",
       " 'data': None,\n",
       " 'included': ['metadatas', 'documents', 'distances']}"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "sample_query = \"Abstract\"\n",
    "results = doc_db.query_db(sample_query, n_results=3)\n",
    "print(f\"Sample query results for '{sample_query}':\")\n",
    "results"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is all pretty messy, but we can see that we have\n",
    "\n",
    "`'documents'` The documents returned by the database query\n",
    "\n",
    "`'metadatas'` Any metadata we wanted to include, in this case only the index. But we could easily include the author and title of the paper...\n",
    "\n",
    "`'distances'` The similarity measure between the query and the returned context.\n",
    "\n",
    "The next step is to put these contexts, along with the query, into an LLM."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [],
   "source": [
    "client = OpenAI()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Our prompt will be simple for now. We use the standard way to load Jinja templates."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {},
   "outputs": [],
   "source": [
    "def load_template(template_filepath: str, arguments: dict[str, Any]) -> str:\n",
    "    env = Environment(\n",
    "        loader=FileSystemLoader(searchpath='./'),\n",
    "        autoescape=select_autoescape()\n",
    "    )\n",
    "    template = env.get_template(template_filepath)\n",
    "    return template.render(**arguments)\n",
    "\n",
    "system_prompt = load_template(\n",
    "    template_filepath=\"prompts/documents/rag_system_prompt.jinja\",\n",
    "    arguments={}\n",
    ")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "```\n",
    "You are a helpful academic assistant that is an expert at extracting information from academic papers. You will be given a query, and some chunks of text that corresponds to a document. You will also be given the cosine similarity of the query with the text chunks.\n",
    "You must answer the query using the information in the text.\n",
    "Your answer must be concise and to the point.\n",
    "If you are unsure of something, you should say that you are unsure.\n",
    "\n",
    "### Input Format ###\n",
    "\n",
    "Query: <query>\n",
    "Context: <text chunk>\\n\\n\"\n",
    "Cosine Similarity: <similarity>\n",
    "----------\n",
    "```\n",
    "---"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We now need to combine the call to the retriever, along with combining the context into a function."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [],
   "source": [
    "def combine_context(documents: list[str], scores: list[float]) -> str:\n",
    "    string = \"\"\n",
    "    for document, score in zip(documents, scores):\n",
    "        string += f\"{document}\\nCosine distance: {score:.2f}\\n{'-'*10}\\n\"\n",
    "    return string\n",
    "\n",
    "def get_context(user_input: str, n_results: int = 2, doc_db: DocumentDB = doc_db) -> str:\n",
    "    results = doc_db.query_db(user_input, n_results=n_results)\n",
    "    context_list = results[\"documents\"][0]\n",
    "    combined_context = combine_context(context_list, results[\"distances\"][0])\n",
    "    if not combined_context:\n",
    "        combined_context = \"No relevant chat history found.\"\n",
    "    return combined_context\n",
    "\n",
    "query = \"What are the main findings of this paper?\"\n",
    "context = get_context(query, n_results=3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Query: What are the main findings of this paper?\n",
      "\n",
      "Context: A Philosophical Introduction to Language Models\n",
      "Part I\n",
      "were all they could do, LLMs like GPT-4 would simply be Blockheads come to life. Compare this\n",
      "to a human student who had found a test’s answer key on the Internet and reproduced its answers\n",
      "without any deeper understanding; such regurgitation would not be good evidence that the student\n",
      "was intelligent. For these reasons, “data contamination”–when the training set contains the very\n",
      "question on which the LLM’s abilities are assessed–is considered a serious concern in any report of an\n",
      "LLM’s performance, and many think it must be ruled out by default when comparing human and\n",
      "LLM performance (Aiyappa et al. 2023). Moreover, GPT-4’s pre-training and fine-tuning requires\n",
      "an investment in computation on a scale available only to well-funded corporations and national\n",
      "governments–a process which begins to look quite inefficient when compared to the data and energy\n",
      "consumed by the squishy, 20-watt engine between our ears before it generates similarly sophisticated\n",
      "output.\n",
      "In this opinionated review paper, we argue that LLMs are more than mere Blockheads; but this\n",
      "skeptical interpretation of LLMs serves as a useful foil to develop a subtler view. While LLMs can simply\n",
      "regurgitate large sections of their prompt or training sets, they are also capable of flexibly blending\n",
      "patterns from their training data to produce genuinely novel outputs. Many empiricist philosophers\n",
      "have defended the idea that sufficiently flexible copying of abstract patterns from previous experience\n",
      "could form the basis of not only intelligence, but full-blown creativity and rational decision-making\n",
      "(Baier 2002, Hume 1978, Buckner 2023); and more scientific research has emphasized that the\n",
      "kind of flexible generalization that can be achieved by interpolating vectors in the semantic spaces\n",
      "acquired by these models may explain why these systems often appear more efficient, resilient, and\n",
      "capable than systems based on rules and symbols (Smolensky 1988, Smolensky et al. 2022a). A\n",
      "useful framework for exploring the philosophical significance of such LLMs, then, might be to treat\n",
      "the worry that they are merely unintelligent, inefficient Blockheads as a null hypothesis, and survey\n",
      "the empirical evidence that can be mustered to refute it.5\n",
      "We adopt that approach here, and use it to provide a brief introduction to the architecture,\n",
      "achievements, and philosophical questions surrounding state-of-the-art LLMs such as GPT-4. There\n",
      "has, in our opinion, never been a more important time for philosophers from a variety of backgrounds–\n",
      "but especially philosophy of mind, philosophy of language, epistemology, and philosophy of science–to\n",
      "engage with foundational questions about artificial intelligence. Here, we aim to provide a wide\n",
      "range of those philosophers (and philosophically-inclined researchers from other disciplines) with an\n",
      "opinionated survey that can help them to overcome the barriers imposed by the technical complexity\n",
      "of these systems and the ludicrous pace of recent research achievements.\n",
      "2. A primer on LLMs\n",
      "2.1. Historical foundations\n",
      "The origins of large language models can be traced back to the inception of AI research. The early\n",
      "history of natural language processing (NLP) was marked by a schism between two competing\n",
      "paradigms: the symbolic and the stochastic approaches. A major influence on the symbolic paradigm\n",
      "in NLP was Noam Chomsky’s transformational-generative grammar (Chomsky 1957), which posited\n",
      "that the syntax of natural languages could be captured by a set of formal rules that generated well-\n",
      "5Such a method of taking a deflationary explanation for data as a null hypothesis and attempting to refute it with\n",
      "empirical evidence has been a mainstay of comparative psychology for more than a century, in the form of Morgan’s Canon\n",
      "(Buckner 2017, Sober 1998). As DNN-based systems approach the complexity of an animal brain, it may be useful to take\n",
      "lessons from comparative psychology in arbitrating fair comparisons to human intelligence (Buckner 2021). In comparative\n",
      "psychology, standard deflationary explanations for data include reflexes, innate-releasing mechanisms, and simple operant\n",
      "conditioning. Here, we suggest that simple deflationary explanations for an AI-inspired version of Morgan’s Canon include\n",
      "Blockhead-style memory lookup.\n",
      "3\n",
      "Cosine distance: 0.69\n",
      "----------\n",
      "A Philosophical Introduction to Language Models\n",
      "Part I\n",
      "Evidential targets\n",
      "Corresponding data for LLMs\n",
      "Architecture\n",
      "Transformer\n",
      "Learning objective\n",
      "Next-token prediction\n",
      "Model size\n",
      "1010 −1012 trainable parameters\n",
      "Training data\n",
      "Internet-scale text corpora\n",
      "Behavior\n",
      "Performance on benchmarks & targeted experiments\n",
      "Representations & computations\n",
      "Findings from probing & intervention experiments\n",
      "Table 1 | Kinds of empirical evidence that can be brought to bear in philosophical debates about LLMs\n",
      "cognitive capacity, simply because its operations can be explained in less abstract and more deflation-\n",
      "ary terms. In the present context, the fallacy manifests in claims that LLMs could not possibly be good\n",
      "models of some cognitive capacity 𝜙because their operations merely consist in a collection of statistical\n",
      "calculations, or linear algebra operations, or next-token predictions. Such arguments are only valid if\n",
      "accompanied by evidence demonstrating that a system, defined in these terms, is inherently incapable\n",
      "of implementing 𝜙. To illustrate, consider the flawed logic in asserting that a piano could not possibly\n",
      "produce harmony because it can be described as a collection of hammers striking strings, or (more\n",
      "pointedly) that brain activity could not possibly implement cognition because it can be described\n",
      "as a collection of neural firings. The critical question is not whether the operations of an LLM can\n",
      "be simplistically described in non-mental terms, but whether these operations, when appropriately\n",
      "organized, can implement the same processes or algorithms as the mind, when described at an\n",
      "appropriate level of computational abstraction.\n",
      "The Redescription Fallacy is a symptom of a broader trend to treat key philosophical questions\n",
      "about artificial neural networks as purely theoretical, leading to sweeping in-principle claims that are\n",
      "not amenable to empirical disconfirmation. Hypotheses here should be guided by empirical evidence\n",
      "regarding the capacities of artificial neural networks like LLMs and their suitability as cognitive models\n",
      "(see table 1). In fact, considerations about the architecture, learning objective, model size, and training\n",
      "data of LLMs are often insufficient to arbitrate these issues. Indeed, our contention is that many of\n",
      "the core philosophical debates on the capacities of neural networks in general, and LLMs in particular,\n",
      "hinge at least partly on empirical evidence concerning their internal mechanisms and knowledge\n",
      "they acquire during the course of training. In other words, many of these debates cannot be settled a\n",
      "priori by considering general characteristics of untrained models. Rather, we must take into account\n",
      "experimental findings about the behavior and inner workings of trained models.\n",
      "In this section, we examine long-standing debates about the capacities of artificial neural networks\n",
      "that have been revived and transformed by the development of deep learning and the recent success of\n",
      "LLMs in particular. Behavioral evidence obtained from benchmarks and targeted experiments matters\n",
      "greatly to those debates. However, we note from the outset that such evidence is also insufficient to\n",
      "paint the full picture; connecting to concerns about Blockheads reviewed in the first section, we must\n",
      "also consider evidence about how LLMs process information internally to close the gap between claims\n",
      "about their performance and putative competence. Sophisticated experimental methods have been\n",
      "developed to identify and intervene on the representations and computations acquired by trained\n",
      "LLMs. These methods hold great promise to arbitrate some of the philosophical issues reviewed here\n",
      "beyond tentative hypotheses supported by behavioral evidence. We leave a more detailed discussion\n",
      "of these methods and the corresponding experimental findings to Part II.\n",
      "10\n",
      "Cosine distance: 0.70\n",
      "----------\n",
      "A Philosophical Introduction to Language Models\n",
      "Part I: Continuity With Classic Debates\n",
      "Raphaël Millière\n",
      "Department of Philosophy\n",
      "Macquarie University\n",
      "raphael.milliere@mq.edu.eu\n",
      "Cameron Buckner\n",
      "Department of Philosophy\n",
      "University of Houston\n",
      "cjbuckner@uh.edu\n",
      "Abstract\n",
      "Large language models like GPT-4 have achieved remarkable proficiency in a broad spec-\n",
      "trum of language-based tasks, some of which are traditionally associated with hallmarks of\n",
      "human intelligence. This has prompted ongoing disagreements about the extent to which\n",
      "we can meaningfully ascribe any kind of linguistic or cognitive competence to language\n",
      "models. Such questions have deep philosophical roots, echoing longstanding debates\n",
      "about the status of artificial neural networks as cognitive models. This article–the first part\n",
      "of two companion papers–serves both as a primer on language models for philosophers,\n",
      "and as an opinionated survey of their significance in relation to classic debates in the\n",
      "philosophy cognitive science, artificial intelligence, and linguistics. We cover topics such as\n",
      "compositionality, language acquisition, semantic competence, grounding, world models,\n",
      "and the transmission of cultural knowledge. We argue that the success of language models\n",
      "challenges several long-held assumptions about artificial neural networks. However, we\n",
      "also highlight the need for further empirical investigation to better understand their\n",
      "internal mechanisms. This sets the stage for the companion paper (Part II), which turns\n",
      "to novel empirical methods for probing the inner workings of language models, and new\n",
      "philosophical questions prompted by their latest developments.\n",
      "1. Introduction\n",
      "Deep learning has catalyzed a significant shift in artificial intelligence over the past decade, leading\n",
      "up to the development of Large Language Models (LLMs). The reported achievements of LLMs,\n",
      "often heralded for their ability to perform a wide array of language-based tasks with unprecedented\n",
      "proficiency, have captured the attention of both the academic community and the public at large.\n",
      "State-of-the-art LLMs like GPT-4 are even claimed to exhibit “sparks of general intelligence” (Bubeck\n",
      "et al. 2023). They can produce essays and dialogue responses that often surpass the quality of an\n",
      "average undergraduate student’s work (Herbold et al. 2023); they achieve better scores than most\n",
      "humans on a variety of AP tests for college credit and rank in the 80-99th percentile on graduate\n",
      "admissions tests like the GRE or LSAT (OpenAI 2023a); their programming proficiency “favorably\n",
      "compares to the average software engineer’s ability” (Bubeck et al. 2023, Savelka, Agarwal, An,\n",
      "Bogart & Sakr 2023); they can solve many difficult mathematical problems (Zhou et al. 2023)–even\n",
      "phrasing their solution in the form of a Shakespearean sonnet, if prompted to do so. LLMs also\n",
      "form the backbone of multimodal systems that can answer advanced questions about visual inputs\n",
      "arXiv:2401.03910v1  [cs.CL]  8 Jan 2024\n",
      "Cosine distance: 0.73\n",
      "----------\n",
      "\n"
     ]
    }
   ],
   "source": [
    "user_prompt = (\n",
    "    f\"Query: {query}\\n\\n\"\n",
    "    f\"Context: {context}\"\n",
    ")\n",
    "\n",
    "print(user_prompt)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The main findings of the paper highlight that large language models (LLMs) like GPT-4 demonstrate remarkable proficiency in various language-based tasks, prompting debates about their cognitive and linguistic competence. The authors argue that while LLMs can regurgitate information, they also exhibit the ability to blend patterns from their training data to produce novel outputs, suggesting a form of creativity and rational decision-making. The paper emphasizes the importance of empirical evidence in understanding the internal mechanisms of LLMs and challenges traditional assumptions about artificial neural networks. It serves as both a primer for philosophers and an opinionated survey of the philosophical implications of LLMs in relation to cognitive science and artificial intelligence."
     ]
    }
   ],
   "source": [
    "response = client.chat.completions.create(\n",
    "    model=\"gpt-4o-mini\",\n",
    "    messages=[\n",
    "        {\"role\": \"system\", \"content\": system_prompt},\n",
    "        {\"role\": \"user\", \"content\": user_prompt}\n",
    "    ],\n",
    "    stream=True,\n",
    "    temperature=0.0\n",
    ")\n",
    "\n",
    "for chunk in response:\n",
    "    if chunk.choices[0].delta.content is not None:\n",
    "        print(chunk.choices[0].delta.content, end=\"\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Meh.\n",
    "\n",
    "This is OK, but not all of these chunks are massively useful. This highlights one of the most important parts of building RAG pipelines: RAG systems live and die on the quality of the retrieval process. And the retrieval process depends strongly on the quality of the embeddings created from the documents.\n",
    "\n",
    "But also, consider what question we are actually asking? \n",
    "\n",
    "```python\n",
    "\"What are the main findings of this paper?\"\n",
    "```\n",
    "\n",
    "The only way we are going to get meaningful chunks returned, ready to be ingested by the LLM, is if there are similar chunks within the body of text. In other words, a phrase similar to \"main finding of this paper\" would have to appear in one of the chunks! So we have two main issues:\n",
    "\n",
    "1. The quality of the chunks are not very good due to the parsing process;\n",
    "2. We have to know what kinds of questions to ask of our models.\n",
    "\n",
    "In this case, it would have probably been better to just stuff the entire document into the model context window (this technique is literally called stuffing).\n",
    "\n",
    "Let's ask another question to demonstrate this:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The authors of the paper \"A Philosophical Introduction to Language Models\" are not explicitly mentioned in the provided text chunks. Therefore, I am unsure who wrote this paper.\n"
     ]
    }
   ],
   "source": [
    "def combine_context(documents: list[str], scores: list[float]) -> str:\n",
    "    string = \"\"\n",
    "    for document, score in zip(documents, scores):\n",
    "        string += f\"{document}\\nCosine distance: {score:.2f}\\n{'-'*10}\\n\"\n",
    "    return string\n",
    "\n",
    "\n",
    "def rag_query(query: str, n_context, return_context=False):\n",
    "    query_results = doc_db.query_db(query, n_results=n_context)\n",
    "    context_list = query_results[\"documents\"][0]\n",
    "    combined_context = combine_context(context_list, query_results[\"distances\"][0])\n",
    "    if not combined_context:\n",
    "        combined_context = \"No relevant chat history found.\"\n",
    "\n",
    "\n",
    "    system_prompt = load_template(\n",
    "        template_filepath=\"prompts/documents/rag_system_prompt.jinja\",\n",
    "        arguments={}\n",
    "    )\n",
    "\n",
    "    user_prompt = (\n",
    "        f\"Query: {query}\\n\\n\"\n",
    "        f\"Context: {combined_context}\"\n",
    "    )\n",
    "\n",
    "    response = client.chat.completions.create(\n",
    "        model=\"gpt-4o-mini\",\n",
    "        messages=[\n",
    "            {\"role\": \"system\", \"content\": system_prompt},\n",
    "            {\"role\": \"user\", \"content\": user_prompt}\n",
    "        ],\n",
    "        stream=False,\n",
    "        temperature=0.0\n",
    "    )\n",
    "    \n",
    "    if return_context:\n",
    "        return response.choices[0].message.content, context_list\n",
    "    else:\n",
    "        return response.choices[0].message.content\n",
    "\n",
    "\n",
    "response = rag_query(\n",
    "    query=\"Who wrote this paper?\",\n",
    "    n_context=2\n",
    ")\n",
    "\n",
    "print(response)    "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Of course, this is ridiculous. We know that this paper was written by Raphaël Millière and Cameron Buckner. But how would the retriever know how to receive the correct information? Where in the text would there be anything similar to, \"Who wrote this paper?\". You might get lucky if you include the word \"authors\", but try that for this paper, and you'll get the same result."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The paper does not explicitly state an author. However, based on the context provided, a best guess for the author could be \"Buckner, C. J.\" as they are mentioned multiple times in the text and seem to be discussing relevant topics related to language models and philosophy.\n"
     ]
    }
   ],
   "source": [
    "response = rag_query(\n",
    "    query=\"Who wrote this paper? If there is no explicitely stated author, then make a best guess.\",\n",
    "    n_context=5\n",
    ")\n",
    "print(response)   "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Give the model a little more freedom, and it can sometimes infer one of the authors. Note that we can actually extract the authors in a couple of ways - sometimes they are included in the metadata of the pdf, but their names will usually be in the first document chunk!\n",
    "\n",
    "You could use this information and either add it as metadata to the entire collection or to individual chunks."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Further work\n",
    "\n",
    "This example is a very naive form of RAG. Additional techniques might include hybrid search or contextual retrieval."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "venv",
   "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.8"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}