demo_notebook.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Text2Cypher Workflow Demo Notebook"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This notebooks demonstrates a text2cypher workflow with visualization capabilities."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Imports"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import nest_asyncio\n",
    "nest_asyncio.apply()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "import asyncio\n",
    "from IPython.display import Image, display\n",
    "import os\n",
    "\n",
    "from neo4j import GraphDatabase\n",
    "from langchain_neo4j import Neo4jGraph\n",
    "from langchain_openai import ChatOpenAI, OpenAIEmbeddings\n",
    "\n",
    "from ps_genai_agents.workflows.multi_agent import create_text2cypher_with_visualization_workflow\n",
    "from ps_genai_agents.components.state import OutputState\n",
    "from ps_genai_agents.utils import load_config\n",
    "from ps_genai_agents.retrievers.cypher_examples import Neo4jVectorSearchCypherExampleRetriever, YAMLCypherExampleRetriever"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "True"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from dotenv import load_dotenv\n",
    "load_dotenv()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [],
   "source": [
    "CONFIG = load_config(\"data/discrete_manufacturing/config.json\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "title: Discrete Manufacturing GenAI\n",
      "scope_description: This application may answer questions related to Manufacturing Bill of Materials, discrete manufacturing and supply chain management.\n",
      "cypher_query_yaml_file_path: data/discrete_manufacturing/queries/queries.yml\n",
      "example_questions: ['What are the most common apple types?', 'What are the suppliers of TLA 86447~6814?', 'What are the suppliers of TLA 86447~6814 and what are all child items of finished good uid 97756?', 'How many suppliers operate outside the US and what are the TLA counts of each country? visualize the result.']\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "[None, None, None, None]"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "[print(f\"{k}: {v}\") for k, v in CONFIG.items()]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Neo4j Graph"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This class handles interaction with our Neo4j database. We use `enhanced_schema` to gain more detail about the graph contents."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "graph = Neo4jGraph(enhanced_schema=True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'node_props': {'TLA': [{'property': 'tla_item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['97756~37830', '40408~48475', '90615~58107', '86447~6814'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'bill_sequence_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '6814',\n",
       "    'max': '58107',\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['97756', '40408', '90615', '86447'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'item_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '17205',\n",
       "    'max': '70917',\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'organization_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '200',\n",
       "    'max': '200',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'organization_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['10141'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['ABC100, 50kW, 60Hz, Standby, Natural Gas/Propane G',\n",
       "     'ABC345z, 150kW, 60Hz, Standby, Natural Gas/Propane',\n",
       "     'GeneralDiesel Generator Set, 450kW Standby 60Hz , ',\n",
       "     'A839C84D-AERIAL12345'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'bom_item_type',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '4',\n",
       "    'max': '4',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'item_type',\n",
       "    'type': 'STRING',\n",
       "    'values': ['CTO', 'PRECONFIG-MAKE'],\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'planning_make_buy_code',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '1',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'UOM_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Each'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'maximum_order_quantity',\n",
       "    'type': 'FLOAT',\n",
       "    'min': '1.0',\n",
       "    'max': '2.0',\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'planning_make_buy_code_description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Make'],\n",
       "    'distinct_count': 1}],\n",
       "  'Item': [{'property': 'item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['20866',\n",
       "     '13482',\n",
       "     '68878',\n",
       "     '61383',\n",
       "     '1704',\n",
       "     '5251',\n",
       "     '94432',\n",
       "     '25772',\n",
       "     '36919',\n",
       "     '36756'],\n",
       "    'distinct_count': 1395},\n",
       "   {'property': 'item_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '27',\n",
       "    'max': '99813',\n",
       "    'distinct_count': 1364},\n",
       "   {'property': 'organization_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '200',\n",
       "    'max': '200',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'organization_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['10141'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['BOOT-BATTERY RED',\n",
       "     'RELAY-POWER',\n",
       "     'PANEL - CONTROL',\n",
       "     'LINK-TERMINAL',\n",
       "     'COPPER STRIP(COIL)',\n",
       "     'SEALANT,THREAD',\n",
       "     'LABEL-WARNING (VARIOUS VOLTAGES)',\n",
       "     'SENDER,PRESSURE',\n",
       "     'THERMOSTAT',\n",
       "     'CLAMP-HOSE'],\n",
       "    'distinct_count': 836},\n",
       "   {'property': 'bom_item_type',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '4',\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'item_type',\n",
       "    'type': 'STRING',\n",
       "    'values': ['COMMON-B',\n",
       "     'EXPENSE ITEM',\n",
       "     'PHANTOM',\n",
       "     'DWG-REF',\n",
       "     'ELEC-SW',\n",
       "     'FEATURE',\n",
       "     'SPECIFICATION',\n",
       "     'CAPACITY',\n",
       "     'MODEL',\n",
       "     'COMMON-M'],\n",
       "    'distinct_count': 10},\n",
       "   {'property': 'planning_make_buy_code',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '2',\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'UOM_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Each', 'Pound', 'Foot', 'Gallon'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'planning_make_buy_code_description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Buy', 'Make'],\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'maximum_order_quantity',\n",
       "    'type': 'FLOAT',\n",
       "    'min': '1.0',\n",
       "    'max': '330.0',\n",
       "    'distinct_count': 7}],\n",
       "  'FinishedGood': [{'property': 'tla_item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['97756~37830', '40408~48475', '90615~58107', '86447~6814'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'bill_sequence_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '6814',\n",
       "    'max': '58107',\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['97756', '40408', '90615', '86447'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'item_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '17205',\n",
       "    'max': '70917',\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'organization_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '200',\n",
       "    'max': '200',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'organization_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['10141'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['ABC100, 50kW, 60Hz, Standby, Natural Gas/Propane G',\n",
       "     'ABC345z, 150kW, 60Hz, Standby, Natural Gas/Propane',\n",
       "     'GeneralDiesel Generator Set, 450kW Standby 60Hz , ',\n",
       "     'A839C84D-AERIAL12345'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'bom_item_type',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '4',\n",
       "    'max': '4',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'item_type',\n",
       "    'type': 'STRING',\n",
       "    'values': ['CTO', 'PRECONFIG-MAKE'],\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'planning_make_buy_code',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '1',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'UOM_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Each'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'maximum_order_quantity',\n",
       "    'type': 'FLOAT',\n",
       "    'min': '1.0',\n",
       "    'max': '2.0',\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'planning_make_buy_code_description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Make'],\n",
       "    'distinct_count': 1}],\n",
       "  'StopBOMExplosion': [{'property': 'item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['82977', '60822', '19472'],\n",
       "    'distinct_count': 3},\n",
       "   {'property': 'item_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '56514',\n",
       "    'max': '75192',\n",
       "    'distinct_count': 3},\n",
       "   {'property': 'organization_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '200',\n",
       "    'max': '200',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'organization_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['10141'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Genset, Configurable Spark Ignited',\n",
       "     'Commercial Diesel Generator Set, 450 kW Standby 60'],\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'bom_item_type',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '1',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'item_type',\n",
       "    'type': 'STRING',\n",
       "    'values': ['MODEL'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'planning_make_buy_code',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '1',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'UOM_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Each'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'maximum_order_quantity',\n",
       "    'type': 'FLOAT',\n",
       "    'min': '1.0',\n",
       "    'max': '2.0',\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'planning_make_buy_code_description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Make'],\n",
       "    'distinct_count': 1}],\n",
       "  'Model': [{'property': 'item_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['82977', '60822', '19472'],\n",
       "    'distinct_count': 3},\n",
       "   {'property': 'item_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '56514',\n",
       "    'max': '75192',\n",
       "    'distinct_count': 3},\n",
       "   {'property': 'organization_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '200',\n",
       "    'max': '200',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'organization_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['10141'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Genset, Configurable Spark Ignited',\n",
       "     'Commercial Diesel Generator Set, 450 kW Standby 60'],\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'bom_item_type',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '1',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'item_type',\n",
       "    'type': 'STRING',\n",
       "    'values': ['MODEL'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'planning_make_buy_code',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '1',\n",
       "    'max': '1',\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'UOM_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Each'],\n",
       "    'distinct_count': 1},\n",
       "   {'property': 'maximum_order_quantity',\n",
       "    'type': 'FLOAT',\n",
       "    'min': '1.0',\n",
       "    'max': '2.0',\n",
       "    'distinct_count': 2},\n",
       "   {'property': 'planning_make_buy_code_description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Make'],\n",
       "    'distinct_count': 1}],\n",
       "  'Supplier': [{'property': 'supplier_name',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Supplier-1',\n",
       "     'Supplier-2',\n",
       "     'Supplier-3',\n",
       "     'Supplier-4',\n",
       "     'Supplier-5',\n",
       "     'Supplier-6',\n",
       "     'Supplier-7',\n",
       "     'Supplier-8',\n",
       "     'Supplier-9',\n",
       "     'Supplier-10'],\n",
       "    'distinct_count': 180},\n",
       "   {'property': 'vendor_site_code',\n",
       "    'type': 'STRING',\n",
       "    'values': ['CHANHASSEN-00',\n",
       "     'HARRISBURG-01',\n",
       "     'SHANGHAI-00',\n",
       "     'MINNEAPOLIS-00',\n",
       "     'DOWNERS GROV-00',\n",
       "     '10024',\n",
       "     'MEMPHIS-00',\n",
       "     'MOORPARK-02',\n",
       "     'SIOUX FALLS-01',\n",
       "     'HONGKONG-00'],\n",
       "    'distinct_count': 131},\n",
       "   {'property': 'country',\n",
       "    'type': 'STRING',\n",
       "    'values': ['US', 'CN', 'HK', 'IN', 'MX', 'CA', 'GB', 'MY', 'SG', 'BR'],\n",
       "    'distinct_count': 11}],\n",
       "  'Cost': [{'property': 'item_uid', 'type': 'STRING', 'values': ['20866']},\n",
       "   {'property': 'cost_type',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Reac Q4 23',\n",
       "     'Reac Q2 24',\n",
       "     'Reac Q2 22',\n",
       "     'Reac Q3 22',\n",
       "     'ZZFrzn23']},\n",
       "   {'property': 'cost_type_description',\n",
       "    'type': 'STRING',\n",
       "    'values': ['2023 Reactive Q4',\n",
       "     '2024 Reactive Q2',\n",
       "     '2022 Reactive Q2',\n",
       "     '2022 Reactive Q3',\n",
       "     '2023 Frozen Cost Type']},\n",
       "   {'property': 'cost_type_name',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Reactive Cost', 'Frozen Cost']},\n",
       "   {'property': 'year', 'type': 'INTEGER', 'values': ['2023', '2024', '2022']},\n",
       "   {'property': 'item_cost',\n",
       "    'type': 'FLOAT',\n",
       "    'values': ['1.153312', '1.165848', '1.090632', '1.12824']},\n",
       "   {'property': 'material_cost',\n",
       "    'type': 'FLOAT',\n",
       "    'values': ['1.078096', '1.090632', '1.027952', '1.06556']},\n",
       "   {'property': 'resource_cost', 'type': 'FLOAT', 'values': ['0.0']},\n",
       "   {'property': 'time_period',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Q4', 'Q2', 'Q3']}],\n",
       "  'CypherQuery': [{'property': 'questionEmbedding',\n",
       "    'type': 'LIST',\n",
       "    'max_size': 1536,\n",
       "    'min_size': 1536},\n",
       "   {'property': 'question',\n",
       "    'type': 'STRING',\n",
       "    'values': ['What are the cost types associated with TLA 97756~',\n",
       "     'What are the top 10 items shared between the TLAs?',\n",
       "     'What are buy items used in the most TLAs?',\n",
       "     'What are make items that are used in the most TLAs',\n",
       "     'What are the shared items between these TLAs: 4193',\n",
       "     'What are the top 5 parts suppliers?',\n",
       "     'What are the top 5 suppliers in terms of TLA count',\n",
       "     'What are the top 5 TLAs that have parts sourced wi',\n",
       "     'What are the top 5 TLAs that have parts sourced ou',\n",
       "     'What are the buy vs make item counts for each TLA?'],\n",
       "    'distinct_count': 14},\n",
       "   {'property': 'cypherStatement',\n",
       "    'type': 'STRING',\n",
       "    'values': ['MATCH (:TLA {tla_item_uid: \"97756~37830\"})--(:Mode',\n",
       "     'MATCH (a:Item)<-[r:HAS_CHILD]-()\\nWITH a, collect(d',\n",
       "     'MATCH (a:Item)<-[r:HAS_CHILD]-()\\nWHERE a.planning_',\n",
       "     'WITH [\"41938\",\"64911\"] AS req_tla_uids\\nMATCH (a:It',\n",
       "     'MATCH (s:Supplier)<-[:HAS_SUPPLIER]-(i)\\nWITH s, co',\n",
       "     'MATCH (s:Supplier)<-[:HAS_SUPPLIER]-(i)<-[r:HAS_CH',\n",
       "     'MATCH (i:Item)<-[r:HAS_CHILD]-()\\nWITH DISTINCT i, ',\n",
       "     'MATCH (c:Cost) \\nWHERE c.time_period = \"Q1\" AND c.y',\n",
       "     'MATCH (c:Cost)<-[:HAS_COST]-(n:FinishedGood)\\nWHERE',\n",
       "     'MATCH p=(n:TLA)-[:HAS_CHILD]->(i:Item) \\nRETURN n.t'],\n",
       "    'distinct_count': 11},\n",
       "   {'property': 'embeddingModel',\n",
       "    'type': 'STRING',\n",
       "    'values': ['text-embedding-ada-002'],\n",
       "    'distinct_count': 1}]},\n",
       " 'rel_props': {'HAS_CHILD': [{'property': 'bill_sequence_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '264',\n",
       "    'max': '99258',\n",
       "    'distinct_count': 151},\n",
       "   {'property': 'effectivity_date',\n",
       "    'type': 'DATE_TIME',\n",
       "    'min': '2001-10-29T10:30:07.07Z',\n",
       "    'max': '2024-07-02T05:33:38.38Z',\n",
       "    'distinct_count': 390},\n",
       "   {'property': 'tla_uid',\n",
       "    'type': 'STRING',\n",
       "    'values': ['41938', '64911', '97406', '45147'],\n",
       "    'distinct_count': 4},\n",
       "   {'property': 'component_sequence_id',\n",
       "    'type': 'INTEGER',\n",
       "    'min': '265',\n",
       "    'max': '99342',\n",
       "    'distinct_count': 2002},\n",
       "   {'property': 'implementation_date',\n",
       "    'type': 'DATE_TIME',\n",
       "    'min': '2002-12-10T00:00:00Z',\n",
       "    'max': '2024-07-02T05:33:38.38Z',\n",
       "    'distinct_count': 351},\n",
       "   {'property': 'component_quantity',\n",
       "    'type': 'FLOAT',\n",
       "    'min': '0.0',\n",
       "    'max': '165.0',\n",
       "    'distinct_count': 49},\n",
       "   {'property': 'component_uom',\n",
       "    'type': 'STRING',\n",
       "    'values': ['Each', 'Gallon', 'Pound', 'Foot'],\n",
       "    'distinct_count': 4}]},\n",
       " 'relationships': [{'start': 'TLA', 'type': 'HAS_COST', 'end': 'Cost'},\n",
       "  {'start': 'TLA', 'type': 'HAS_CHILD', 'end': 'Item'},\n",
       "  {'start': 'TLA', 'type': 'HAS_CHILD', 'end': 'StopBOMExplosion'},\n",
       "  {'start': 'TLA', 'type': 'HAS_CHILD', 'end': 'Model'},\n",
       "  {'start': 'Item', 'type': 'HAS_COST', 'end': 'Cost'},\n",
       "  {'start': 'Item', 'type': 'HAS_SUPPLIER', 'end': 'Supplier'},\n",
       "  {'start': 'Item', 'type': 'HAS_CHILD', 'end': 'Item'},\n",
       "  {'start': 'FinishedGood', 'type': 'HAS_COST', 'end': 'Cost'},\n",
       "  {'start': 'FinishedGood', 'type': 'HAS_CHILD', 'end': 'Item'},\n",
       "  {'start': 'FinishedGood', 'type': 'HAS_CHILD', 'end': 'StopBOMExplosion'},\n",
       "  {'start': 'FinishedGood', 'type': 'HAS_CHILD', 'end': 'Model'},\n",
       "  {'start': 'StopBOMExplosion', 'type': 'HAS_COST', 'end': 'Cost'},\n",
       "  {'start': 'Model', 'type': 'HAS_COST', 'end': 'Cost'}],\n",
       " 'metadata': {'constraint': [{'id': 10,\n",
       "    'name': 'constraint_ITEM_item_uid',\n",
       "    'type': 'UNIQUENESS',\n",
       "    'entityType': 'NODE',\n",
       "    'labelsOrTypes': ['Item'],\n",
       "    'properties': ['item_uid'],\n",
       "    'ownedIndex': 'constraint_ITEM_item_uid',\n",
       "    'propertyType': None},\n",
       "   {'id': 20,\n",
       "    'name': 'constraint_Supplier_name_id_country',\n",
       "    'type': 'UNIQUENESS',\n",
       "    'entityType': 'NODE',\n",
       "    'labelsOrTypes': ['Supplier'],\n",
       "    'properties': ['supplier_name', 'vendor_site_code', 'country'],\n",
       "    'ownedIndex': 'constraint_Supplier_name_id_country',\n",
       "    'propertyType': None},\n",
       "   {'id': 3,\n",
       "    'name': 'constraint_TLA_item_uid',\n",
       "    'type': 'UNIQUENESS',\n",
       "    'entityType': 'NODE',\n",
       "    'labelsOrTypes': ['TLA'],\n",
       "    'properties': ['tla_item_uid'],\n",
       "    'ownedIndex': 'constraint_TLA_item_uid',\n",
       "    'propertyType': None},\n",
       "   {'id': 22,\n",
       "    'name': 'constraint_cost_id',\n",
       "    'type': 'UNIQUENESS',\n",
       "    'entityType': 'NODE',\n",
       "    'labelsOrTypes': ['Cost'],\n",
       "    'properties': ['item_uid', 'cost_type'],\n",
       "    'ownedIndex': 'constraint_cost_id',\n",
       "    'propertyType': None},\n",
       "   {'id': 16,\n",
       "    'name': 'constraint_name_has_child',\n",
       "    'type': 'RELATIONSHIP_UNIQUENESS',\n",
       "    'entityType': 'RELATIONSHIP',\n",
       "    'labelsOrTypes': ['HAS_CHILD'],\n",
       "    'properties': ['effectivity_date',\n",
       "     'tla_uid',\n",
       "     'bill_sequence_id',\n",
       "     'component_sequence_id'],\n",
       "    'ownedIndex': 'constraint_name_has_child',\n",
       "    'propertyType': None}],\n",
       "  'index': [{'label': 'Cost',\n",
       "    'properties': ['item_uid', 'cost_type'],\n",
       "    'size': 12039,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 12039.0},\n",
       "   {'label': 'Item',\n",
       "    'properties': ['item_uid'],\n",
       "    'size': 1395,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 1395.0},\n",
       "   {'label': 'Item',\n",
       "    'properties': ['item_number'],\n",
       "    'size': 0,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 0.0},\n",
       "   {'label': 'Item',\n",
       "    'properties': ['item_id'],\n",
       "    'size': 1395,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 0.9777777777777777,\n",
       "    'distinctValues': 1364.0},\n",
       "   {'label': 'Item',\n",
       "    'properties': ['neo4j_last_modified_date'],\n",
       "    'size': 0,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 0.0},\n",
       "   {'label': 'Item',\n",
       "    'properties': ['organization_id', 'item_id'],\n",
       "    'size': 1395,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 0.9777777777777777,\n",
       "    'distinctValues': 1364.0},\n",
       "   {'label': 'Supplier',\n",
       "    'properties': ['supplier_name', 'vendor_site_code', 'country'],\n",
       "    'size': 202,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 202.0},\n",
       "   {'label': 'TLA',\n",
       "    'properties': ['tla_item_uid'],\n",
       "    'size': 4,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 4.0},\n",
       "   {'label': 'TLA',\n",
       "    'properties': ['bill_sequence_id'],\n",
       "    'size': 4,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 4.0},\n",
       "   {'label': 'TLA',\n",
       "    'properties': ['item_number'],\n",
       "    'size': 0,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 0.0},\n",
       "   {'label': 'TLA',\n",
       "    'properties': ['item_uid'],\n",
       "    'size': 4,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 4.0},\n",
       "   {'label': 'TLA',\n",
       "    'properties': ['item_id'],\n",
       "    'size': 4,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 4.0},\n",
       "   {'label': 'TLA',\n",
       "    'properties': ['organization_id', 'item_id'],\n",
       "    'size': 4,\n",
       "    'type': 'RANGE',\n",
       "    'valuesSelectivity': 1.0,\n",
       "    'distinctValues': 4.0}]}}"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "graph.get_structured_schema"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## LLM"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We will be using an OpenAI LLM for this demo."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "llm = ChatOpenAI(model=\"gpt-4o\", temperature=0)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Cypher Example Retriever"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This class is responsible for collecting and formatting Cypher examples for few shot prompting."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Embedder"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "embedder = OpenAIEmbeddings(model=\"text-embedding-ada-002\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Neo4j Driver"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "neo4j_driver = GraphDatabase.driver(uri=os.getenv(\"NEO4J_URI\"), auth=(os.getenv(\"NEO4J_USERNAME\"), os.getenv(\"NEO4J_PASSWORD\")))\n",
    "vector_index_name = \"cypher_query_vector_index\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [],
   "source": [
    "cypher_query_yaml_file_path = CONFIG.get(\"cypher_query_yaml_file_path\", \"./\")\n",
    "cypher_example_retriever = Neo4jVectorSearchCypherExampleRetriever(neo4j_driver=neo4j_driver, vector_index_name=vector_index_name, embedder=embedder)\n",
    "# cypher_example_retriever = YAMLCypherExampleRetriever(cypher_query_yaml_file_path=cypher_query_yaml_file_path)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Agent"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [],
   "source": [
    "scope_description = CONFIG.get(\"scope_description\", \"\")\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [],
   "source": [
    "agent = create_text2cypher_with_visualization_workflow(llm=llm, \n",
    "                                                       graph=graph, \n",
    "                                                       scope_description=scope_description, \n",
    "                                                       cypher_example_retriever=cypher_example_retriever, \n",
    "                                                       llm_cypher_validation=False, \n",
    "                                                       attempt_cypher_execution_on_final_attempt=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here we can see the agent workflow. \n",
    "* The workflow always starts at `guardrails` where the input question is determined to be in scope or not.\n",
    "* The workflow always ends at `final_answer` where the generated contents are formatted to be returned to the user.\n",
    "* Dotted lines indicate conditional paths."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "display(Image(agent.get_graph().draw_mermaid_png()))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Questions"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Helper Functions"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {},
   "outputs": [],
   "source": [
    "async def ask_question(question: str, debug: bool = False) -> OutputState:\n",
    "    \"\"\"wrapper to simplify asking questions in the notebook.\"\"\"\n",
    "\n",
    "    async def ask():\n",
    "        response = await agent.ainvoke({\"question\": question}, debug=debug)\n",
    "        return response\n",
    "\n",
    "    return asyncio.run(ask())\n",
    "\n",
    "def print_answer(response: OutputState) -> None:\n",
    "    print(response.get(\"question\"))\n",
    "    print(response.get(\"answer\"))\n",
    "\n",
    "def print_cypher_queries(response: OutputState) -> None:\n",
    "\n",
    "   [print(c.get(\"subquestion\") + \"\\n\\n\" + c.get(\"statement\")+\"\\n\\n\") for c in response.get(\"cyphers\")]\n",
    "\n",
    "def print_cypher_results(response: OutputState) -> None:\n",
    "\n",
    "    [(print(c.get(\"subquestion\") + \"\\n\\n\"), [print(r) for r in c.get(\"records\")], print(\"\\n\\n\")) for c in response.get(\"cyphers\")]\n",
    "\n",
    "def print_viz_results(response: OutputState) -> None:\n",
    "    [\n",
    "        (print(v.get(\"subquestion\") + \"\\n\\n\" + v.get(\"chart_description\") + \"\\n\\n\"), display(v.get(\"chart\"))) for v in response.get(\"visualizations\")\n",
    "    ]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The agent response is a Python dictionary with the following format:\n",
    "```python\n",
    "{\n",
    "    answer: str,\n",
    "    question: str,\n",
    "    steps: List[str],\n",
    "    cyphers: List[\n",
    "        subquestion: str,\n",
    "        statement: str,\n",
    "        errors: List[str],\n",
    "        records: List[Dict[str, Any]],\n",
    "        next_action: str,\n",
    "        steps: List[str],\n",
    "    ],\n",
    "    visualizations: List[\n",
    "        subquestion: str\n",
    "        chart: Any\n",
    "        chart_description: str\n",
    "        steps: List[str]\n",
    "    ]\n",
    "}\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1. Out of Scope"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The agent can detect whether a question is in scope and avoid further processing."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [],
   "source": [
    "q1 = await ask_question(\"What are the most common apple types?\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "What are the most common apple types?\n",
      "This question is out of scope. Therefore I cannot answer this question.\n"
     ]
    }
   ],
   "source": [
    "print_answer(q1)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can see the agent only performs 2 steps - only `guardrails` requires an LLM call."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "['guardrails', 'final_answer']"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "q1.get(\"steps\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2. Cypher Question without Visualization"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The agent is capable of creating Cypher queries to answer questions within the scope of the data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [],
   "source": [
    "q2 = await ask_question(\"What are the suppliers of TLA 86447~6814?\", debug=False)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "What are the suppliers of TLA 86447~6814?\n",
      "- Supplier-20 (DECATUR-00, US)\n",
      "- Supplier-57 (10001, US)\n",
      "- Supplier-15 (STOUGHTON-00, US)\n",
      "- Supplier-55 (AHMEDNAGAR-00, IN)\n",
      "- Supplier-55 (10031, IN)\n",
      "- Supplier-55 (RANJANGAON-00, IN)\n",
      "- Supplier-55 (WUXI-01, CN)\n",
      "- Supplier-113 (SAINT PAUL-00, US)\n",
      "- Supplier-148 (10001, US)\n",
      "- Supplier-165 (10001, US)\n",
      "- Supplier-162 (MINNEAPOLIS-00, US)\n"
     ]
    }
   ],
   "source": [
    "print_answer(q2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "All Cypher queries are saved for evaluation."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Who are the suppliers of TLA 86447~6814?\n",
      "\n",
      "MATCH (:TLA {tla_item_uid: \"86447~6814\"})-[:HAS_CHILD]->(i:Item)-[:HAS_SUPPLIER]->(s:Supplier)\n",
      "RETURN DISTINCT s.supplier_name, s.vendor_site_code, s.country\n",
      "\n",
      "\n"
     ]
    }
   ],
   "source": [
    "print_cypher_queries(q2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Results are saved as well for evaluation or futher processing."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Who are the suppliers of TLA 86447~6814?\n",
      "\n",
      "\n",
      "{'s.supplier_name': 'Supplier-20', 's.vendor_site_code': 'DECATUR-00', 's.country': 'US'}\n",
      "{'s.supplier_name': 'Supplier-57', 's.vendor_site_code': '10001', 's.country': 'US'}\n",
      "{'s.supplier_name': 'Supplier-15', 's.vendor_site_code': 'STOUGHTON-00', 's.country': 'US'}\n",
      "{'s.supplier_name': 'Supplier-55', 's.vendor_site_code': 'AHMEDNAGAR-00', 's.country': 'IN'}\n",
      "{'s.supplier_name': 'Supplier-55', 's.vendor_site_code': '10031', 's.country': 'IN'}\n",
      "{'s.supplier_name': 'Supplier-55', 's.vendor_site_code': 'RANJANGAON-00', 's.country': 'IN'}\n",
      "{'s.supplier_name': 'Supplier-55', 's.vendor_site_code': 'WUXI-01', 's.country': 'CN'}\n",
      "{'s.supplier_name': 'Supplier-113', 's.vendor_site_code': 'SAINT PAUL-00', 's.country': 'US'}\n",
      "{'s.supplier_name': 'Supplier-148', 's.vendor_site_code': '10001', 's.country': 'US'}\n",
      "{'s.supplier_name': 'Supplier-165', 's.vendor_site_code': '10001', 's.country': 'US'}\n",
      "{'s.supplier_name': 'Supplier-162', 's.vendor_site_code': 'MINNEAPOLIS-00', 's.country': 'US'}\n",
      "\n",
      "\n",
      "\n"
     ]
    }
   ],
   "source": [
    "print_cypher_results(q2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 3. Multi-Cypher Query Question without Visualization"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The agent is capable of splitting the input question into multiple subquestions. These will be individually addressed with their own Cypher queries. \n",
    "The final answer will summarize the query results together."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {},
   "outputs": [],
   "source": [
    "q3 = await ask_question(\"What are the suppliers of TLA 86447~6814 and what are all child items of finished good uid 97756?\", debug=False)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "What are the suppliers of TLA 86447~6814 and what are all child items of finished good uid 97756?\n",
      "**Suppliers of TLA 86447~6814:**\n",
      "\n",
      "- Supplier-20 (Vendor Site Code: DECATUR-00, Country: US)\n",
      "- Supplier-57 (Vendor Site Code: 10001, Country: US)\n",
      "- Supplier-15 (Vendor Site Code: STOUGHTON-00, Country: US)\n",
      "- Supplier-55 (Vendor Site Code: AHMEDNAGAR-00, Country: IN)\n",
      "- Supplier-55 (Vendor Site Code: 10031, Country: IN)\n",
      "- Supplier-55 (Vendor Site Code: RANJANGAON-00, Country: IN)\n",
      "- Supplier-55 (Vendor Site Code: WUXI-01, Country: CN)\n",
      "- Supplier-113 (Vendor Site Code: SAINT PAUL-00, Country: US)\n",
      "- Supplier-148 (Vendor Site Code: 10001, Country: US)\n",
      "- Supplier-165 (Vendor Site Code: 10001, Country: US)\n",
      "- Supplier-162 (Vendor Site Code: MINNEAPOLIS-00, Country: US)\n",
      "\n",
      "**Child items of finished good UID 97756:**\n",
      "\n",
      "- Item UID: 42409, Description: ANTIFREEZE\n",
      "- Item UID: 62611, Description: SILENCER,EXHAUST\n",
      "- Item UID: 93626, Description: GENERATOR\n",
      "- Item UID: 52754, Description: LIST,LITERATURE\n",
      "- Item UID: 62277, Description: TRANSFORMER,CURRENT\n",
      "- Item UID: 94536, Description: INSTALLATION,CONTROL BOX\n",
      "- Item UID: 8832, Description: INSTALLATION,COOLING SYSTEM\n",
      "- Item UID: 17305, Description: CODE-DES FEATURE COMMERCIAL COMMON (FUEL SYSTEM: GAS)\n",
      "- Item UID: 66602, Description: BATTERY CHARGING ALTERNATOR-NO\n",
      "- Item UID: 64604, Description: CB,Loc A,70A-250A,3P,LSI,600VAC,100%,UL\n",
      "- Item UID: 28919, Description: CODE-DES FEATURE PCC1302 (Max Over Excitation Duty Cycle (56%))\n",
      "- Item UID: 29897, Description: INSTALLATION,HARNESS\n",
      "- Item UID: 92671, Description: Enclosure - Wind Load 180MPH, ASCE7-10\n",
      "- Item UID: 56301, Description: CODE-DES FEATURE PCC1302 (Daylight Savings Time Enable)\n",
      "- Item UID: 68549, Description: CODE-DES FEATURE COMMERCIAL COMMON (Overspeed Shutdown Threshold 60Hz - 30 - 2250 rpm)\n",
      "- Item UID: 19262, Description: CODE-DES FEATURE PCC1302 ( High AC Current Shutdown Delay)\n",
      "- Item UID: 78322, Description: NAMEPLATE,GENSET\n",
      "- Item UID: 54954, Description: OUTLINE,CIRCUIT BREAKER\n",
      "- Item UID: 9421, Description: PANEL,DISPLAY\n",
      "- Item UID: 7315, Description: INSTALLATION,LABELS\n",
      "- Item UID: 7328, Description: TEST RECORD-SAFETY SHUTDOWNS\n",
      "- Item UID: 23280, Description: INSTALLATION,GUARD\n",
      "- Item UID: 718, Description: CODE-DES FEATURE COMMERCIAL COMMON (Intake Manifold Over Pressure(IMOP) Enable - Enabled)\n",
      "- Item UID: 54354, Description: CODE-DES FEATURE PCC1302 (Full Wave Enable Firing Angle)\n",
      "- Item UID: 89321, Description: INSTALLATION,LABELS\n",
      "- Item UID: 61148, Description: INSTALLATION,SHUNT\n",
      "- Item UID: 90708, Description: INSTALLATION,LABELS\n",
      "- Item UID: 34602, Description: NFPA 110 Type 10 Level 1 Capable\n",
      "- Item UID: 42415, Description: INSTALLATION,COOLANT HEATER\n",
      "- Item UID: 6622, Description: CODE-DES FEATURE COMMERCIAL COMMON (SINGLE PHASE GENSET CONNECTION)\n",
      "- Item UID: 60302, Description: ENGINE AIR CLEANER-NORMAL DUTY\n",
      "- Item UID: 31900, Description: CODE-DES FEATURE PCC1302 (AVR Gains for 5.9L Gas/RB - 45/50KW, 1.0% V/Hz RS, (ARROW))\n",
      "- Item UID: 95579, Description: Literature-English\n",
      "- Item UID: 25354, Description: TEST SPEC\n",
      "- Item UID: 31223, Description: CODE-DES FEATURE PCC1302 (Read Point 21300)\n",
      "- Item UID: 74144, Description: INSTALLATION,STARTER\n",
      "- Item UID: 42543, Description: INSTALLATION,CURRENT TRANSFORMER\n",
      "- Item UID: 291, Description: Listing-UL 2200\n",
      "- Item UID: 32869, Description: INSTALLATION,LEADS\n",
      "- Item UID: 53520, Description: CODE-DES FEATURE COMMERCIAL COMMON (Auto Mains Failure Enable)\n",
      "- Item UID: 99512, Description: Coolant Heater, Extreme Cold Ambient\n",
      "- Item UID: 28311, Description: OUTLINE,GENSET\n",
      "- Item UID: 30713, Description: Battery Charger - 6 Amp, Regulated\n",
      "- Item UID: 62928, Description: Skidbase-Housing Ready\n",
      "- Item UID: 11713, Description: Shutdown-Low Coolant Lvl\n",
      "- Item UID: 34029, Description: LIST,SHIPPING PARTS\n",
      "- Item UID: 63922, Description: INSTALLATION,GENSET\n",
      "- Item UID: 64122, Description: INSTALLATION,CHASSIS\n",
      "- Item UID: 73170, Description: INSTALLATION,FUEL PIPES\n",
      "- Item UID: 81642, Description: CONTROL MTG-LEFT FACING\n",
      "- Item UID: 58567, Description: FEATURE ENGINE OIL\n",
      "- Item UID: 18729, Description: CODE-CODE-DES FEATURE COMMERCIAL COMMON (LCT Warning Temperature Threshold)\n",
      "- Item UID: 56409, Description: Voltage-120/240,1Phase,3 Wire\n",
      "- Item UID: 9423, Description: INSTALLATION,AIR FILTER\n",
      "- Item UID: 82404, Description: Engine Starter-12VDC Motor\n",
      "- Item UID: 41511, Description: CODE-DES FEATURE COMMERCIAL COMMON (Secondary Overspeed Shutdown Threshold 60Hz - 1800 - 2250 rpm)\n",
      "- Item UID: 55742, Description: LABEL,EMISSIONS\n",
      "- Item UID: 27473, Description: Heater-Alternator,120V\n",
      "- Item UID: 40344, Description: DIAGRAM,WIRING\n",
      "- Item UID: 78112, Description: Emissions Certification-Spark Ignited, EPA, Emergency, Stationary, 40CFR60\n",
      "- Item UID: 53527, Description: Enclosure-Aluminum, Sound Attenuated, Level 1, with Exhaust System\n",
      "- Item UID: 37756, Description: INSTALLATION,ENGINE ACCESSORIES\n",
      "- Item UID: 92408, Description: PRODUCT REVISION-A\n",
      "- Item UID: 12614, Description: CODE-DES FEATURE COMMERCIAL COMMON (50/40 Stdby (45/36 Pr) kW 1P)\n",
      "- Item UID: 26115, Description: CODE-DES FEATURE PCC1302 (ECM Can Enable)\n",
      "- Item UID: 44895, Description: INSTALLATION,SENSOR\n",
      "- Item UID: 75561, Description: INSTALLATION,ENCLOSURE\n",
      "- Item UID: 39952, Description: INSTALLATION,HEATER\n",
      "- Item UID: 92161, Description: CODE-DES FEATURE PCC1302 ( Loss Of AC Sensing)\n",
      "- Item UID: 43740, Description: CODE-DES FEATURE PCC1302 (CONFIG I/P#3:LOW COOLANT SHUTDOWN)\n",
      "- Item UID: 29373, Description: OUTLINE,ENCLOSURE\n",
      "- Item UID: 24753, Description: INSTALLATION,FUEL SYSTEM\n",
      "- Item UID: 14270, Description: CODE-DES CONTROLLER PCC1302 (DIDO COMMERCIAL CALIBRATION)\n",
      "- Item UID: 31319, Description: FEATURE,Engine Coolant-50/50 Mixture\n",
      "- Item UID: 16309, Description: INSTALLATION,LABELS\n",
      "- Item UID: 90924, Description: INSTALLATION,ELECTRICAL\n",
      "- Item UID: 4691, Description: WD-CONTROL (PCC CCS)\n",
      "- Item UID: 82977, Description: Genset, Configurable Spark Ignited\n",
      "- Item UID: 19381, Description: Display Language-English\n",
      "- Item UID: 99315, Description: INSTALLATION,LABELS\n",
      "- Item UID: 25147, Description: ST 5YR 2500HR Parts + Labor + Travel\n",
      "- Item UID: 20743, Description: INSTALLATION,CONNECTION BOX\n",
      "- Item UID: 57285, Description: Extension-Coolant Drain\n",
      "- Item UID: 18801, Description: CODE-DES FEATURE PCC 1302 (Genset Overload parameters)\n",
      "- Item UID: 7689, Description: INSTALLATION,LEADS\n",
      "- Item UID: 23633, Description: INSTALLATION,HEATER\n",
      "- Item UID: 18497, Description: Duty Rating-Standby Power\n",
      "- Item UID: 44865, Description: CODE-DES FEATURE PCC1302 (250/500:5 Current Transformer)\n",
      "- Item UID: 17718, Description: CODE-DES FEATURE COMMERCIAL COMMON (Configurable Customer Output 2 - READY TO LOAD)\n",
      "- Item UID: 76878, Description: Load Connection-Single\n",
      "- Item UID: 72446, Description: CODE-DES FEATURE COMMERCIAL COMMON (Genset Nominal Voltage : 240V)\n",
      "- Item UID: 62458, Description: DIAGRAM,GENSET SCHEMATIC\n",
      "- Item UID: 89474, Description: Packing-Skid,Poly Bag\n",
      "- Item UID: 85928, Description: INSTALLATION,OIL SYSTEM\n",
      "- Item UID: 75819, Description: INSTALLATION,HEATER\n",
      "- Item UID: 92732, Description: Rack, Larger Battery\n",
      "- Item UID: 83536, Description: Exciter/Reg-PMG,3Ph Sensr\n",
      "- Item UID: 24091, Description: SPECIFICATION,TEST\n",
      "- Item UID: 65262, Description: INSTALLATION,CIRCUIT BREAKER\n",
      "- Item UID: 74875, Description: CODE-DES FEATURE PCC1302 (Alternator Protection RS curve enabled)\n",
      "- Item UID: 31354, Description: GENSET CONTROL-POWERCOMMAND 1.1\n",
      "- Item UID: 62515, Description: OUTLINE,GENSET\n",
      "- Item UID: 4614, Description: INSTALLATION,TERMINAL BLOCK\n",
      "- Item UID: 55702, Description: Alt-60Hz,Reconnect,Full Output,120C,40C amb,IMS\n",
      "- Item UID: 90941, Description: CODE-DES FEATURE COMMERCIAL COMMON (Intake Manifold Temperature Source - SPN 52)\n",
      "- Item UID: 52441, Description: INSTALLATION,LABELS\n",
      "- Item UID: 18421, Description: Certification-Seismic, IBC2000, IBC2003, IBC2006, IBC2009, IBC2012\n",
      "- Item UID: 94696, Description: EnclosureColor-Green,Aluminum Encl\n",
      "- Item UID: 89653, Description: INSTALLATION,LEADS\n",
      "- Item UID: 75621, Description: INSTALLATION,BATTERY CHARGER\n",
      "- Item UID: 79400, Description: Extension-Oil Drain\n",
      "- Item UID: 69555, Description: OUTLINE,GENSET\n",
      "- Item UID: 93485, Description: Eng Oil Htr-120V,1Ph\n",
      "- Item UID: 64207, Description: CODE-DES FEATURE PCC1302 (Read Point Location - Freq Comp)\n",
      "- Item UID: 51979, Description: INSTALLATION,ENCLOSURE\n",
      "- Item UID: 45972, Description: Gauge-Oil Pressure\n",
      "- Item UID: 25390, Description: INSTALLATION,BATTERY TRAY\n",
      "- Item UID: 17383, Description: CODE-DES FEATURE PCC1302 (Rolling Restart Enable - Disabled)\n",
      "- Item UID: 11990, Description: INSTALLATION,SILENCER\n",
      "- Item UID: 83070, Description: CODE-DES FEATURE PCC1302 (AVR GAINS BC/UC/HC LESS THAN 200KW)\n",
      "- Item UID: 73694, Description: Relays-Aux,Qty2-25A-15VDC/10A-30VDC\n",
      "- Item UID: 55693, Description: Engine Cooling-High Ambient Air Temperature\n",
      "- Item UID: 54973, Description: Meters-AC OutputAnalog (kVA)\n",
      "- Item UID: 6777, Description: Single Gas Fuel - Natural Gas or LP Vapor\n",
      "- Item UID: 19146, Description: 50kW, 60HZ, Standby, Natural Gas/Propane Genset\n",
      "- Item UID: 57419, Description: EngGov-Electr,Isoch Only\n",
      "- Item UID: 25242, Description: CODE-DES FEATURE PCC1302 (Cycle Crank Rest Time)\n",
      "- Item UID: 81274, Description: INSTALLATION,GENERATOR\n",
      "- Item UID: 10249, Description: Stop Switch-Emergency\n",
      "- Item UID: 93621, Description: CODE-DES FEATURE COMMERCIAL COMMON (Excitation Source-PMG)\n",
      "- Item UID: 48101, Description: SOFTWARE,CONTROL\n",
      "- Item UID: 60527, Description: INSTALLATION,CONTROL HOUSING\n"
     ]
    }
   ],
   "source": [
    "print_answer(q3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "What are the suppliers of TLA 86447~6814?\n",
      "\n",
      "MATCH (:TLA {tla_item_uid: \"86447~6814\"})-[:HAS_CHILD]->(i:Item)-[:HAS_SUPPLIER]->(s:Supplier)\n",
      "RETURN DISTINCT s.supplier_name, s.vendor_site_code, s.country\n",
      "\n",
      "\n",
      "What are all child items of finished good UID 97756?\n",
      "\n",
      "MATCH (:FinishedGood {item_uid: \"97756\"})-[:HAS_CHILD]->(i:Item)\n",
      "RETURN i.item_uid, i.description, i.item_id, i.organization_code, i.UOM_code, i.maximum_order_quantity, i.planning_make_buy_code_description\n",
      "\n",
      "\n"
     ]
    }
   ],
   "source": [
    "print_cypher_queries(q3)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 4. Question with Visualization"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If visualization is requested, the agent will attempt to create either a bar, line or scatter plot to fit the results gathered from Neo4j."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/var/folders/7_/vqs74z3j5hscgzbt0ydbmqyw0000gq/T/ipykernel_55190/1953630900.py:1: RuntimeWarning: coroutine 'ask_question' was never awaited\n",
      "  q4 = await ask_question(\"How many suppliers operate outside the US and what are the TLA counts of each country? visualize the result.\", debug=False)\n",
      "RuntimeWarning: Enable tracemalloc to get the object allocation traceback\n"
     ]
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAioAAAGwCAYAAACHJU4LAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjAsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvlHJYcgAAAAlwSFlzAAAPYQAAD2EBqD+naQAAMB9JREFUeJzt3Qd0FFX7x/EHCBB6kyrVwEsPRZASpEgXELArSlNUpIigIBZQkGah2JAmiIJgAxH+gooEJIggSFdURI0IBhUIRQIk+z/PPe/uuyGBbDabzN3N93POnCSzm9072+a39z5zJ4fL5XIJAACAhXI63QAAAIBLIagAAABrEVQAAIC1CCoAAMBaBBUAAGAtggoAALAWQQUAAFgrTIJYUlKS/PHHH1KoUCHJkSOH080BAAA+0CncTp48KeXKlZOcOXOGblDRkFKhQgWnmwEAAPwQGxsr5cuXD92goj0p7g0tXLiw080BAAA+iI+PNx0N7v14yAYV93CPhhSCCgAAwcWXsg2KaQEAgLUIKgAAwFoEFQAAYK2grlEBAKSUmJgo58+fd7oZyOby5MmT5qHHviCoAEAIzU1x5MgROX78uNNNAURDSpUqVUxgyQiCCgCECHdIKVWqlOTPn5+JMOH4hKyHDx+WihUrZui1SFABgBAZ7nGHlBIlSjjdHEBKlixpwsqFCxckd+7cft8OxbQAEALcNSnakwLYwD3koyE6IwgqABBCGO5BqL0WCSoAAMBaBBUAAGAtggoAZEPR0dGma55DmWE7ggoAZAOtW7eWYcOGSSj75ZdfTPjasWOH000JGpUrV5bp06eLzQgqAAAEeOI9PSQ3VCQmJpp5UZxCUAGAENe3b19Zv369zJgxw/Q46KK9D97+/vtvueOOO+TKK680hzjXrVtX3nnnHZ/vQ3dkzz33nFStWlXy5s1rJvmaMGGC5/Ldu3fLddddJ/ny5TPzvNx3331y6tSpy/b49OjRw7Td+9v/xIkTpX///lKoUCFzH7Nnz/ZcrrOgqgYNGpht1Nv05bHR+3nmmWfMvB+FCxeWBx54QM6dO5ds2yZNmmRuX9tfr149ef/991MMo33yySdy9dVXm+3fuHFjmvf98ccfS+PGjSU8PFyuuOIK6dmzp+eyY8eOSe/evaVYsWLm+ejcubP8+OOPnsuffvppqV+/frLb054RfYwu3rYXXnhBypYtax73QYMGeQ5l18fn119/lYcfftjzulALFiyQokWLyooVK6RWrVqe7dG5UHRSQW/6nF177bWSmZjwDZkqMiJKbLbrQIzTTQAynQaUH374QerUqSPjxo0z6/bu3ZvsOmfPnjU72VGjRpmd9apVq+Tuu++WiIgIueaaa9K8j9GjR8ucOXNk2rRp0qJFCzMj6ffff28uO336tHTs2FGaNWsmW7dulbi4OLn33ntl8ODBZqeYHi+++KKMHz9eHn/8cRMWBg4cKK1atZLq1avLli1bTFs///xzqV27ts9Tt69du9aEBQ0cGuD69etnduruoKUh5e2335bXX39dqlWrJhs2bJC77rrLBBu9b7fHHnvMhIKrrrrKBIzL0cdXg8kTTzwhCxcuNMHo//7v/5KFDA0mK1asMM+HPi/XX3+97Nu3L12Tp61bt86EFP35008/yW233WYCzoABA+TDDz80oUtDo/7t7cyZMzJlyhSZO3eueSwqVKhgtuutt96SRx991FxHA8+iRYtMQM1MBBUACHFFihQxO239Zl6mTBmzzh0i3LQn5ZFHHvH8PWTIEFmzZo28++67aQaVkydPmjD0yiuvSJ8+fcw6DTgaWNTixYtNENIdcoECBcw6vW63bt3MzrB06dI+b4vurB988EHzu+68NRjpTliDigYHpTtW93b6Qh+bN954wzw+GnA0zOnOWAOR7oy1F0fDjwYtpTts7WGYNWtWsqCi/9e+fXuf7lND0O233256ctw0NCh3QImJiZHmzZubdRoINCwsX75cbrnlFp+3TQOTPta5cuWSGjVqSJcuXUww02BSvHhxs157py5+vHS7X3vtNU+b1D333CPz58/3BBXtEdLn9dZbb5XMxNAPAMDUIeiOWYd8dAdWsGBBE1R+++23NP/3u+++k4SEBGnbtu0lL9cdnjukqKioKDOksn///nS1MzIy0vO7DlXoDlZ7aDJC2+Y9o68GEh2Wio2NNb0Q2rugAUQfE/eioevAgQPJbqdRo0Y+36cW/F7u8QoLC5MmTZp41mn40jCml6WHBi8NI27au+LL46Xhzfuxdvfy6OOxefNm87f2hmlI8X5eMwM9KgAAef75502viNY5aFjRnY/WH3jXalyK1m0E4ky7WoTqzV1L4e3iYQ8NK5lZ6Omuo9GhGu118qa1G97Ss8PO6GOWM5MfL23fxTPL6nmktBdMe1W0XkdrcnS4LLPRowIA2YB+Q77cOVd0mKF79+6m9kJ7GHR4Q+tafKF1G7pj0yGF1NSsWVN27txpalW87093ttpLoHTYRuta3LSte/bsyZJzy2jb/v33X8/f2mOgvSY61OIuJtWeJS0U9l70cn9pb8XlHi89aujrr79OVuysvU/aHvfjpYWt3mHFn8Oy03pdXExri5YuXWqKmHV4T3vGMhtBBQCyAT0aRHd8Wiz6119/pfhWrWHjs88+k02bNpnhhfvvv1/+/PNPn25bC1G1XmTkyJGeIRHd2c+bN89c3qtXL3MdrV/R8KE1JVoDo8W67voUPSJIey100foZLZJN72R0+o1fA9Pq1atN20+cOOHT/2mvkdZfaKGqFrSOHTvWFPpqkNL6Da3d0SNj3nzzTbNt27dvl5dfftn87S+9Dz2qSn/q461HRWm9jvu50NCodSQbN240QUoDpPbo6Hr3ETtHjx41hazapldffdX0cPjzutDi4EOHDpnXRVq0KFqLe5999llTdJwVCCoAkA3ozlZrFfQbuX4bv7j25Mknn5SGDRuaHZHuBLX2Qw9t9dVTTz0lI0aMkDFjxpgeAT26xF0LofUfWu/yzz//mMNxb775ZlOfoUWebnrIsQYZPSRXC1S1R6dNmzbp2kat63jppZdMkWu5cuU8O/W0aFs0HLRs2dK0+4YbbjCH/7pp7Y5unx79o9vWqVMnE6jch0P7Qx/j9957zxTN6lE4GtT0qCU3HV7Ro7C6du1qama050RDlHsoR9uhxa4aULQHTP/XuxjaV1oArOFVe0fcxciXo+FNa1W0F0afq6yQw3XxIFcQiY+PN9Xsmpo14cE+HJ4MZA09+uLgwYNm56m9F/CN7nS150aPpoFvtPdJe3M0ZPn7mkzP/ptiWgAAkCYNFTpEpYebpxVSAomgAgC4LB0mchdxpkZrO3SWWBtpUeyl+FPTkZ7DgnXW19To0JTW7QSb7t27myEmnbnX1/liAoGgAgC4LK33uNwRJXq5rS7Xbi1Ozazp37WeJLXDhVV6JrizSVYcipwaggoAIM0iVT0cNxg51e5KlSo5cr+hiKN+AACAtQgqAADAWgQVAABgLYIKAACwFkEFAABYi6N+AABBJ27vziy9v1K162Xp/eF/6FEBACDA9LxAel4jPamhnixRz5ukZz9G+hFUAAAIsPXr18ugQYPMWaT1rNQ6+VuHDh3k9OnTTjct6DD0AwBAgK1evTrZ3wsWLDA9K9u2bTNnaYbv6FEBACALTuinihcv7nRTgg5BBQCATJSUlCTDhg2TqKgoqVOnjtPNCToM/QAAkIm0VmXPnj2yceNGp5sSlAgqAABkksGDB8vKlStlw4YNUr58eaebE5QIKgAABJjL5ZIhQ4bIsmXLJDo6WqpUqeJ0k4IWQQUAgEwY7lm8eLF89NFHZi6VI0eOmPVFihSRfPnyOd28oEJQAQAEHdtnip05c6b52bp162Tr58+fL3379nWoVcGJoAIAQCYM/SAwODwZAABYi6ACAACsRVABAADWIqgAAABrEVQAAIC1CCoAAMBajgaVxMREeeqpp8yMfToBTkREhIwfP57DugAAgPPzqEyZMsVMivPmm29K7dq15ZtvvpF+/fqZmfuGDh3qZNMAAEB2DyqbNm2S7t27S5cuXczflStXlnfeeUe2bNniZLMAAIAlHA0qzZs3l9mzZ8sPP/wg//nPf2Tnzp3mNNhTp05N9foJCQlmcYuPj8/C1gIAbLFwWOr7iczSe/rwLL0/WBJUHnvsMRM2atSoIbly5TI1KxMmTJBevXqlev1JkybJM888k+btRkZEic12HYhxugkAgEykZQ26/PLLL+ZvLW8YM2aMdO7c2emmBR1Hi2nfffddWbRokTnD5Pbt202tygsvvGB+pmb06NFy4sQJzxIbG5vlbQYAIC3ly5eXyZMny7Zt20z95XXXXWdKHfbu3et004KOoz0qjz76qOlVuf32283fdevWlV9//dX0nPTp0yfF9fPmzWsWAABs1q1bt2R/62iB9rBs3rzZ9K4gSILKmTNnJGfO5J06OgSUlJTkWJsAAAgkLWt477335PTp09KsWTOnmxN0wpxOnJoyK1asaBLmt99+awpp+/fv72SzAADIsN27d5tgcvbsWSlYsKAsW7ZMatWq5XSzgo6jQeXll182E749+OCDEhcXJ+XKlZP777/fFBwBABDMqlevLjt27DA1le+//74paVi/fj1hJZiCSqFChWT69OlmAQAglOTJk0eqVq1qfr/66qtl69atMmPGDJk1a5bTTQsqnOsHAIAsoPWX3nOBIQh6VAAACEU6nYbOmaI1mCdPnjTTcERHR8uaNWucblrQIagAAIKO7TPFat1l79695fDhw+b8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bP3YsWPNZTfddFNAGgcAALI3v3pUdIba3r17p1h/1113mcsAAAAcCyqtW7eWL7/8MsX6jRs3yrXXXut3YyZPnmwObx42bJjftwEAALL50M8NN9wgo0aNMjUqTZs2Nes2b94s7733njzzzDOyYsWKZNf1xdatW2XWrFlMFgcAADIWVB588EHz87XXXjNLapelZ/K3U6dOSa9evWTOnDny7LPPXvJ6CQkJZnFL6yzOAAAgGwaVpKSkgDZi0KBB0qVLF2nXrt1lg8qkSZNMjw2Q1SIjosRmuw7EON0EALCnRiWQlixZYg5t1hCSFj3S6MSJE54lNjY2S9oIAACCLKisXbtWunbtKhEREWbR3z///PN03YYGjYceekgWLVok4eHhaV4/b968Urhw4WQLAAAIXX4FFa1L6dSpkxQqVMgEDV00NFx//fXy6quv+nw7WowbFxcnDRs2lLCwMLOsX79eXnrpJfM7JzcEACB786tGZeLEiTJt2jQZPHiwZ93QoUMlKirKXKY1J75o27at7N69O9m6fv36SY0aNcxRRbly5fKneQAAIDsHlePHj5selYt16NDBBAxfaY+MTrvvrUCBAlKiRIkU6wEAQPbj19CPzo2ybNmyFOs/+ugjU6sCAADgWI9KrVq1ZMKECRIdHS3NmjXzTPgWExMjI0aMMDUm3kNC6aG3CQAA4HdQmTdvnhQrVkz27dtnFreiRYuay7wnfEtvUAEAAMhQUDl48KA//wYAABBcE74BAAAEtEelf//+l738jTfe8OdmAQAAMh5Ujh07luzv8+fPy549e8xhy9ddd50/NwkAABCYoJLaocl6osKBAwea6fQBAACsqlHJmTOnDB8+3MxYCwAAYF0x7YEDB+TChQuBvEkAAJCN+TX0oz0n3lwulxw+fFhWrVolffr0CVTbAABANudXUPn2229TDPuULFlSXnzxxTSPCAIAAMjUoKI9J9qLoicQVL/88ossX75cKlWqJGFhft0kAABAYGpUevToIW+99Zb5XQ9Jbtq0qelN0fUzZ8705yYBAAACE1S2b98u1157rfn9/fffl9KlS8uvv/4qCxcuTHZCQgAAgCwPKmfOnJFChQqZ3z/99FO58cYbTZ2K9qxoYAEAAHAsqFStWtXUpMTGxsqaNWukQ4cOZn1cXJwULlw4IA0DAADwK6iMGTNGHnnkEalcubI0adJEmjVr5uldadCgQaDbCAAAsim/DtG5+eabpUWLFmbulHr16nnWt23bVnr27BnI9gEAgGzM72OJy5QpYxZv11xzTSDaBAAAEPgp9AEAAAKJoAIAAKxFUAEAANYiqAAAAGsRVAAAgLUIKgAAwFoEFQAAYC2CCgAAsBZBBQAAWIugAgAArEVQAQAA1iKoAAAAaxFUAABA6J09GQCAUBAZESU223UgRrIzelQAAIC1CCoAAMBaBBUAAGAtggoAALAWQQUAAFiLoAIAAKxFUAEAANYiqAAAAGsRVAAAgLUIKgAAwFoEFQAAYC2CCgAAsBZBBQAAWIugAgAArEVQAQAA1iKoAAAAaxFUAACAtQgqAADAWgQVAABgLYIKAACwFkEFAABYi6ACAACsRVABAADWIqgAAABrEVQAAIC1CCoAAMBaBBUAAGAtggoAALAWQQUAAFiLoAIAAKxFUAEAANYiqAAAAGsRVAAAgLUIKgAAwFoEFQAAYC1Hg8qkSZOkcePGUqhQISlVqpT06NFD9u/f72STAACARRwNKuvXr5dBgwbJ5s2b5bPPPpPz589Lhw4d5PTp0042CwAAWCLMyTtfvXp1sr8XLFhgela2bdsmLVu2dKxdAADADo4GlYudOHHC/CxevHiqlyckJJjFLT4+PsvaBgAAsnFQSUpKkmHDhklUVJTUqVPnkjUtzzzzTJa3DQgVkRFRYqtdB2KcbgIAC1lz1I/WquzZs0eWLFlyyeuMHj3a9Lq4l9jY2CxtIwAAyIY9KoMHD5aVK1fKhg0bpHz58pe8Xt68ec0CAACyB0eDisvlkiFDhsiyZcskOjpaqlSp4mRzAACAZcKcHu5ZvHixfPTRR2YulSNHjpj1RYoUkXz58jnZNAAAkN1rVGbOnGlqTVq3bi1ly5b1LEuXLnWyWQAAwBKOD/0AAABYf9QPAADAxQgqAADAWgQVAABgLYIKAACwFkEFAABYi6ACAACsRVABAADWIqgAAABrEVQAAIC1CCoAAMBaBBUAAGAtggoAALAWQQUAAFiLoAIAAKxFUAEAANYiqAAAAGsRVAAAgLUIKgAAwFoEFQAAYC2CCgAAsBZBBQAAWIugAgAArEVQAQAA1iKoAAAAaxFUAACAtQgqAADAWgQVAABgLYIKAACwFkEFAABYi6ACAACsRVABAADWIqgAAABrhTndAFzawmFTxWa9pw93uglA0Irbu1NsVqp2vTSvw2eUXeIsfk358nq6FHpUAACAtQgqAADAWgQVAABgLYIKAACwFkEFAABYi6ACAACsRVABAADWIqgAAABrEVQAAIC1CCoAAMBaBBUAAGAtggoAALAWQQUAAFiLoAIAAKxFUAEAANYiqAAAAGsRVAAAgLUIKgAAwFoEFQAAYC2CCgAAsBZBBQAAWIugAgAArEVQAQAA1iKoAAAAaxFUAACAtQgqAADAWgQVAABgLYIKAACwFkEFAABYi6ACAACsRVABAADWIqgAAABrEVQAAIC1CCoAAMBaVgSVV199VSpXrizh4eHSpEkT2bJli9NNAgAAFnA8qCxdulSGDx8uY8eOle3bt0u9evWkY8eOEhcX53TTAABAdg8qU6dOlQEDBki/fv2kVq1a8vrrr0v+/PnljTfecLppAADAYWFO3vm5c+dk27ZtMnr0aM+6nDlzSrt27eSrr75Kcf2EhASzuJ04ccL8jI+PT3a9xKQLYrOL23sp/yaclWDfjlB5LtiOzBcK25Ce7Th56pTYLNyH7QiFzyjFayrrX0/ubXK5XGn/s8tBhw4d0ha6Nm3alGz9o48+6rrmmmtSXH/s2LHm+iwsLCwsLCwS9EtsbGyaWcHRHpX00p4XrWdxS0pKkn/++UdKlCghOXLkyJT71NRXoUIFiY2NlcKFC0uwCoXtCIVtCJXtCIVtUGyHPUJhG0JlO+KzYBu0J+XkyZNSrly5NK/raFC54oorJFeuXPLnn38mW69/lylTJsX18+bNaxZvRYsWlaygT1awvuhCbTtCYRtCZTtCYRsU22GPUNiGUNmOwpm8DUWKFLG/mDZPnjxy9dVXy9q1a5P1kujfzZo1c7JpAADAAo4P/ehQTp8+faRRo0ZyzTXXyPTp0+X06dPmKCAAAJC9OR5UbrvtNjl69KiMGTNGjhw5IvXr15fVq1dL6dKlxQY61KRzvFw85BRsQmE7QmEbQmU7QmEbFNthj1DYhlDZjryWbUMOrah1uhEAAABWTvgGAABwKQQVAABgLYIKAACwFkEFAABYi6DyX3rE0ZAhQ+Sqq64ylc46K1+3bt08c7xUrlzZzH67efPmZP83bNgwad26tTitb9++0qNHjxTro6OjTbuPHz+e7He3P/74Q+rWrSstW7b0nDvJBt7bo79ruydPnpzsOsuXL8+0GYkzwt3eBx54IMVlgwYNMpfpdRITE6V58+Zy4403JruOPg/6+nviiSckGN4bbpMmTTITOD7//PNiG92Ghx56SKpWrSrh4eHmqMKoqCiZOXOmnDlzJtl7XBfdDp0x85577pFjx44FxWtKp3nQ86Tp2ecv9tprr5nJMX///Xdxkh7hOXDgQKlYsaJ5LenEntremJgYz3W+/fZbczRo2bJlzXUqVaokXbt2lY8//ti388Jk4fPhXnR29E6dOsmuXbs81/G+XCdNa9y4sXz00Udim75e26Jzm+l7ZNy4cXLhwoVU9xlOIKiIyC+//GImnvviiy/Mh+zu3bvNIdJt2rQxHwJu+gE3atQoCRUHDhyQFi1amA+CNWvW+DxLoBP0sZ8yZYoVOw1f6M58yZIl8u+//3rWnT17VhYvXmw+pJXuDBcsWGBea4sWLfJcT0NB8eLFzeGBwfLeUHrG85EjR1p35vOff/5ZGjRoIJ9++qlMnDjR7Aj1pKfa1pUrV8rnn3/uua5+QB8+fFh+++0385xs2LBBhg4dKsHwmtIdyvz58+Xrr7+WWbNmea5z8OBBs60vv/yylC9fXpx00003mcf/zTfflB9++EFWrFhhvuj9/fff5nLdkTdt2lROnTplrvPdd9+Z11vPnj3lySeftOrLlAYTfa3ooqE9LCzMBCpv+nzo5d98840JxjfffLN5D9mm03+35ccff5QRI0bI008/bdcXjkCeZDBYde7c2XXllVe6Tp06leKyY8eOmZ+VKlVyDR061JUnTx7XqlWrPJc/9NBDrlatWrmc1qdPH1f37t1TrF+3bp058ZNuh/fvO3fudJUpU8Z15513us6fP++yjff26O9du3Z11ahRw5yw0m3ZsmVme2xte506dVxvv/22Z/2iRYtckZGR5jK9jtuMGTNcxYoVc/3xxx+u5cuXu3Lnzu3asWOHK1jeGyo6Otpc79y5c65y5cq5YmJiXLbo2LGjq3z58qlug0pKSvK8x6dNm5bssvHjx7tq1arlCqbX1IIFC1wFCxZ0/fzzz2bb2rRp4+rZs6fLafp60fervlZSo89PiRIlLttW93Nl4+ftl19+abYvLi7O/K2/62eUW3x8vFmn73eb9EllW9q3b+9q2rRpsn2Gk7J9j4qe1FATu347LFCgQIrLvc8lVKVKFdP1qidH1Kn+g9WmTZukVatW5tvN22+/bb4J2E57H/TbsH4rdLr72lf9+/c336jctKchtRmXtQelXr16cvfdd8t9991nJj/Uv4PpvTFv3jy54447JHfu3Oan/m0D/aauPSmX2gZ1qeHDQ4cOmeGGJk2aSDC9pnQIqG3btua6r7zyiuzZsydZD4tTChYsaBYdsk1ISEhxuT5P+nxp78+l2DjUq7QHSD9LddhEh4EupsMo7veEDq/YLl++fHLu3DmxRbYPKj/99JMZ96xRo4ZP19fuR+1K9e6qt4V2Y7s/DNxL586dU1xPu1G1xkA/xGx946dG260zF9swJOKLu+66SzZu3Ci//vqrWXQcXtddTJ8DrZXQ7mOtnXjsscckmN4beqbV999/37Nt+vPdd981H962bEP16tVTnBDV/R7xHs7V33WdflDrMIk+N1OnTpVge03Nnj3bBBStodPfS5YsKU7TL0Q61KlDOhpydSjk8ccf99R16FCQ8n6utm7dmuzzTD/jbPy8LVSokBnGWrp0qeTM+b/dqoZ2vVxrbR5++GFTB3XrrbeKrVwulxkK1VKA6667TmyR7YNKeouz9A3/yCOPmG+9NiVOpXUDO3bsSLbMnTs3xfW6d+8uy5Ytky+//FKCjdapuMeubaevlS5dupgPZ/0WrL/rDjI1+s04f/78JgTb0mPk63vjnXfekYiICE8vkIZJrXvSD21bbdmyxbw/ateunezb/aOPPmrW687TXSysz5sWPgfTa6pUqVJy//33S82aNVMtsneK9uJqAb/u1LUuQos1GzZsaLYnNZGRkZ7PMj0HnPZM2Ph5q68nLQrWL4YaIN2mTZtmLv/kk0+kVq1a5vNY689ss/K/oUtrAXUbtJhZ61Rske2DSrVq1cy3pu+//z5dJ1LUgjatpLeJdm1r16P3cuWVV6a4nnYD33777eYFqcWCwUSPTtIPBB1+Cwba/e7+Fqm/X2ooTj/Q9MNCT8ypR5rYcHSDr+8N7dLeu3ev+cbsXvbt22dFUa2+B3Qb9u/fn2y9HsGkl2nPiTfd6et63Xb9RqknSdXnZ926dRJMrynlfi5sozvD9u3by1NPPWUeWz3qRHtJ9TFX3s+V9kS4P8ts4/15q0f0aAjRMDVnzhzPdfSoJr28Q4cOJlhqAIiLixPbtPlv6NJiWt236WvrUkOlTsj2QUXTre74Xn31VfMiu1hqh2Vp8tQ32YQJE+TkyZMSbPSDW7uDe/XqJddff72sX79egokepqy1A3rkhu30W6P2vJ0/fz7Vw0b10Fj9oNZDNvXDQnf6+u3s9ddfl2B4b+gRDHpEg34z9u7J07/1+UnPF4DMoPUCulPUYc7UtsGX2ijlfaSN7a+pYKM9Dfrc6M5cX3PaaxqM9HNVh30u9VrRLyF6BJ3uN2wNXRUrVrQy3Gb7oKL0g1i7dvWF9MEHH5hUqUMLL730kjRr1izV/9GiRz2cVw8NDNY3le4Me/fubcKK7liChc77oiFLnx/b6Y5OX0vaw+De6XnTniHtPXHPEaNj2C+88IIpKNRDg21/b2iw0su0p6tOnTqeRf/Wb5k2FNVqz6cOGTRq1MgMR2n79Vu7Fj9qkPJ+XvSLh865oodqamDUoSAdbtH5boLlNWUrLZTVXip93HVoTYc533vvPXnuuefMcLR+AdReiVWrVpkhLa2T0EPL9bp6HWXT9uqQob5WdNHnQ4vitS5L6/8uRWuGtEdbC7WDye7du5N9Edm5c2eW3r990ckB2g28fft2k3T1GHL9kNIPJ02/WuSYGj26Yfz48XLnnXdKsNKwojsi/RagHww69KDf6oOBzndhcw2EN53sKTXak6WPv4ZErU9x09qCDz/80AwBaWGbkwXPl3tvzJgxw7z+LzW3kNYjvPjii+ZoLX2/OEXrZ3TuDm2HBkOtAdIhBf0mr/VmDz74oOe6Wnumi9Lt1LClR6OkdiSHja8pm2kQ0SOodJhT53DSHiGdG2bAgAGmqNZdMK/DQdqrol+i9Mgz/UKoIVPnkLl4nhIn6RFxOimd0mJaLTrX4HW5CUC1N0yPHtX3k22lA5ejXzy8aWDMynqhHHqMcpbdGwAAQDow9AMAAKxFUAEAANYiqAAAAGsRVAAAgLUIKgAAwFoEFQAAYC2CCgAAsBZBBQAAWIugAgAArEVQARCU9FxIenoBPfcIgNBFUAEQ0vRMwwCCF0EFgF+SkpLMWW319PB6kj89Rbz7FPZ6tlU9U26+fPnMCf30bON6Zlk3PXGbnknWW48ePaRv376ev/VM0noiwf79+5uTvuntz54923O5ntxNNWjQwPSsuE8Gp7eht6VtKVeunFSvXt2cxFLP6nyx+vXry1NPPZUJjw6AQCGoAPCLnol48uTJZke/b98+Wbx4sZQuXVpOnz4tHTt2lGLFisnWrVvNGWX1LNCDBw9O933o2Zf1zLl69mM9y/HAgQNl//795rItW7aYn3rbelZnPeO029q1a831PvvsM3NWcA073333nWmPm97mrl27pF+/fgF5PABkjrBMul0AIezkyZMyY8YMeeWVV6RPnz5mXUREhLRo0ULmzJkjZ8+elYULF0qBAgXMZXq9bt26yZQpU0yY8dX1119vAooaNWqUTJs2TdatW2d6SUqWLGnWa49NmTJlkv2f3u/cuXMlT548nnUanubPny+NGzc2f+vvrVq1kquuuioAjwiAzEKPCoB0096JhIQEadu2baqX1atXzxNSVFRUlBkqcveG+CoyMtLzuw7vaCCJi4tL8//q1q2bLKSoAQMGyDvvvGNClNataA+Q9rQAsBs9KgDSTWtPMiJnzpzicrmSrTt//nyK6+XOnTvZ3xpWNPCkxTskuWmPjtbSLFu2zIQYvb+bb77Zr/YDyDr0qABIt2rVqpmworUgF6tZs6bs3LnT1Kq4xcTEmHCiQzZKh220rsQtMTFR9uzZk642uHtM9H99ERYWZoapdMhHl9tvvz3DgQtA5qNHBUC6hYeHm5qRkSNHmsCgQztHjx6VvXv3Sq9evWTs2LEmFDz99NNm/ZAhQ+Tuu+/21KfoEUHDhw+XVatWmdqWqVOnyvHjx9PVhlKlSpmgsXr1ailfvrxpU5EiRS77P/fee68JUu7wBMB+9KgA8Ise7TNixAgZM2aM2fnfdtttpn4kf/78smbNGvnnn39M4aoOr2gtixbUumltiAaZ3r17ewpa27Rpk6771x6Sl156SWbNmmUOQ+7evbtPPUHNmzeXGjVqSJMmTfzabgBZK4fr4oFiAAhR+nGnYUWPJNIeHQD2Y+gHQLagQ1BLliyRI0eOMHcKEEQIKgCyBa1pueKKK8zstjoZHYDgQFABkC0wyg0EJ4ppAQCAtQgqAADAWgQVAABgLYIKAACwFkEFAABYi6ACAACsRVABAADWIqgAAACx1f8DK86A/sSeMmoAAAAASUVORK5CYII=",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "q4 = await ask_question(\"How many suppliers operate outside the US and what are the TLA counts of each country? visualize the result.\", debug=False)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We recieve a description along with each generated chart."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "How many suppliers operate outside the US and what are the TLA counts of each country?\n",
      "\n",
      "This chart displays the number of suppliers operating outside the US for each country. The countries are represented on the x-axis, the number of suppliers on the y-axis, and the TLA (Three-Letter Acronym) counts are used to differentiate the bars by color.\n",
      "\n",
      "\n"
     ]
    },
    {
     "data": {
      "image/png": "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AJD1o370XD916tSRX375xUzupkt8fLxERkbKww8/7MtdAgAA+KdHZdeuXfLll1+aI4Hc9PL48eOlSZMmvtwlAACAf3pUrr/+evntt98uWp+QkCDVqlXz5S4BAAD8E1QmTJgggwYNktWrV5vhH1308pAhQ0ytSmJiomcBAADI0aGfDh06mJ/33HOPZxI4l8tlfnbs2NHzu16nRwcBAADkWFDZuHGjTw8GAACQ7UGlefPmvvwZAABApvg8O9vx48dlwYIF6SZ86927t5QoUcLXuwQAAMh6Me3mzZulcuXKMn36dBNYdNHLVapUMdcBAAA41qMyYMAAuffee2X27NmSJ08es06LZvv372+ui4uL80vjAABAaPOpR+X777+X4cOHe0KK0svDhg0z1wEAADgWVBo2bOipTUlL19WrV88f7QIAAPBt6Ecnexs8eLDpPbnpppvMum3btsmsWbNk4sSJsmfPHs9t9fw/AAAAORZU7rvvPvPziSeeyPA6neiNCd8AAIAjQeXQoUNZfmAAAIBsCSqVKlXy5c8AAACyP6i8/vrrl72+R48evtwtAABA1oOKFtKmdf78eTlz5ozky5dPChYsSFABAADOHZ7sno3WvZw6dUoOHDggN998s6xYscI/LQMAACHPp6CSkerVq5tDky/sbQEAAHA8qKiwsDA5cuSIP+8SAACEMJ9qVNauXZvud50z5ddff5WZM2dKVFSUv9oGAABCnE9BpXPnzul+14ndSpUqJS1btpRXXnnFX20DAAAhzqegkpqa6v+WAAAAZEeNik6Tv2vXLnMEEAAAgKNBZciQIbJgwQJPSLnlllvMGZUrVKggMTExfmscAAAIbT4FldWrV0u9evXM5ffff19+/PFH+eabb2To0KHy1FNP+buNAAAgRPkUVP744w8pU6aMufzRRx/J3XffLddff7306dNH4uLi/N1GAAAQonwKKtdcc418/fXXZtgnOjpa2rRpY9brNPp58uTxdxsBAECI8umon969e8s999wjZcuWNYcmt27d2qz/4osvpGbNmv5uIwAACFE+BZUxY8ZIRESExMfHm2Gf8PBws157U5588kl/txEAAIQon4KKuuuuuy5a17Nnz3S/161b19Sw6NFAAAAAjp7r50J6NND58+ez8yEAAEAQy9agAgAAkBUEFQAAYC2CCgAAsBZBBQAAWIugAgAA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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "print_viz_results(q4)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We still recieve everything else in the result such as the summary and Cypher info."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "How many suppliers operate outside the US and what are the TLA counts of each country? visualize the result.\n",
      "- **China (CN):** 8 suppliers, TLA count: 4\n",
      "- **Hong Kong (HK):** 1 supplier, TLA count: 3\n",
      "- **India (IN):** 9 suppliers, TLA count: 4\n",
      "- **Mexico (MX):** 4 suppliers, TLA count: 4\n",
      "- **Canada (CA):** 2 suppliers, TLA count: 4\n",
      "- **United Kingdom (GB):** 7 suppliers, TLA count: 4\n",
      "- **Malaysia (MY):** 1 supplier, TLA count: 2\n",
      "- **Singapore (SG):** 1 supplier, TLA count: 3\n",
      "- **Brazil (BR):** 3 suppliers, TLA count: 4\n",
      "- **Poland (PL):** 1 supplier, TLA count: 2\n"
     ]
    }
   ],
   "source": [
    "print_answer(q4)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "How many suppliers operate outside the US and what are the TLA counts of each country?\n",
      "\n",
      "MATCH (s:Supplier)<-[:HAS_SUPPLIER]-(i)<-[r:HAS_CHILD]-()\n",
      "WHERE s.country <> \"US\"\n",
      "WITH s.country AS country, count(distinct s) AS supplier_count, collect(distinct r.tla_uid) AS tla_uids\n",
      "RETURN country, supplier_count, size(tla_uids) AS tla_count_per_country;\n",
      "\n",
      "\n"
     ]
    }
   ],
   "source": [
    "print_cypher_queries(q4)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "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.12.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}