Build applications that make decisions (chatbots, agents, simulations, etc...). Monitor, trace, persist, and execute on your own infrastructure.
Python aiburrchatbot-frameworkdagsgenerative-aigraphshacktoberfestllmopsllmsmlopspersistent-data-structurestate-machinestate-managementvisibility
Updates multi-agent example
Stefan Krawczykb99375764c5b
diff --git a/docs/examples/agents.rst b/docs/examples/agents.rstindex 47e16bcb..b061a605 100644--- a/docs/examples/agents.rst+++ b/docs/examples/agents.rst@@ -7,4 +7,37 @@ Burr allows you to create agents that can interact with each other via State.Multi-Agent Example---------------------See `github repository example <https://github.com/DAGWorks-Inc/burr/tree/main/examples/multi-agent-collaboration>`_.+Here we list the different agent examples we have with Burr.++Divide and Conquer+__________________+A single agent can usually operate effectively using a handful of tools within a single domain, but even using powerful+models like `gpt-4`, it can be less effective at using many tools.++One way to approach complicated tasks is through a "divide-and-conquer" approach: create a "specialized agent" for+each task or domain and route tasks to the correct "expert". This means that each agent can become a sequence of LLM+calls that chooses how to use a specific "tool".++The examples we link to below are inspired by the paper `AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation by Wu, et. al.<https://arxiv.org/abs/2308.08155>`_.+They can be found in `this part of our repository <https://github.com/DAGWorks-Inc/burr/tree/main/examples/multi-agent-collaboration>`_.++We have two implementations that show case this. One uses LangChain's LCEL, the other uses Hamilton. From a Burr+standpoint they look pretty similar as Burr doesn't care what code you use within an action, or how you set up+your state. Each implementation has a `notebook.ipynb` that shows the basics. The `application.py` files contain extra+things like examples of `tracing` and `hooks`.++`LangChain/LCEL <https://github.com/DAGWorks-Inc/burr/tree/main/examples/multi-agent-collaboration/lcel>`_:++* .. raw:: html++ <a target="_blank" href="https://colab.research.google.com/github/dagworks-inc/burr/blob/main/examples/multi-agent-collaboration/lcel/notebook.ipynb">+ <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>+ </a>++`Hamilton <https://github.com/DAGWorks-Inc/burr/tree/main/examples/multi-agent-collaboration/hamilton>`_:++* .. raw:: html++ <a target="_blank" href="https://colab.research.google.com/github/dagworks-inc/burr/blob/main/examples/multi-agent-collaboration/hamilton/notebook.ipynb">+ <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>+ </a>diff --git a/examples/multi-agent-collaboration/README.md b/examples/multi-agent-collaboration/README.mdindex ce5296e0..8079b6b9 100644--- a/examples/multi-agent-collaboration/README.md+++ b/examples/multi-agent-collaboration/README.md@@ -2,13 +2,12 @@This example resembles the example from following [cookbook](https://github.com/langchain-ai/langgraph/blob/main/examples/multi_agent/multi-agent-collaboration.ipynb).-There are three implementations:+There are two implementations:-1. `hamilton_application.py` -- this uses [Hamilton](https://github.com/dagworks-inc/hamilton) inside the actions.-2. `lcel_application.py` -- this uses LangChain's LCEL inside the actions.-3. `application.py` -- this simplifies the graph to have tool calling happen inside the actions.+1. `hamilton/` -- this uses [Hamilton](https://github.com/dagworks-inc/hamilton) inside the defined actions.+2. `lcel/` -- this uses LangChain's LCEL inside the defined actions.-# `hamilton_application.py` vs `lecl_application.py`:+# `hamilton/application.py` vs `lcel/application.py`:- They should be functionally equivalent, except that langchain uses deprecatedopenai tool constructs underneath, while Hamilton uses the non-deprecated function calling@@ -16,12 +15,12 @@ constructs.- Compare the two examples to see the code. Burr however doesn't change.## show me the prompts-With Hamilton the prompts can be found in `func_agent.py`.+With Hamilton the prompts can be found in the moduel [`hamilton/func_agent.py`](hamilton/func_agent.py).With LangChain that's difficult. You'll need to dive into their code to see what ends up being sent.# Tracing-You'll see that both `hamilton_application.py` and `lecl_application.py`+You'll see that both `hamilton/application.py` and `lcel/application.py`have some lightweight `tracing` set up. This is a simple way to plug into Burr'stracer functionality -- this will allow you to see more in the Burr UI.@@ -45,22 +44,26 @@ export TAVILY_API_KEY=YOUR_KEYTo run the example, you can do:-```bash-python hamilton_application.py-```-Application run:-+Run the notebook:+<a target="_blank" href="https://colab.research.google.com/github/dagworks-inc/burr/blob/main/examples/multi-agent-collaboration/hamilton/notebook.ipynb">+ <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>+</a>-or```bash-python lcel_application.py+python hamilton/application.py```Application run:-+or++Run the notebook:+<a target="_blank" href="https://colab.research.google.com/github/dagworks-inc/burr/blob/main/examples/multi-agent-collaboration/lcel/notebook.ipynb">+ <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>+</a>+```bash-python application.py+python lcel/application.py```Application run:-+diff --git a/examples/multi-agent-collaboration/hamilton-multi-agent.png b/examples/multi-agent-collaboration/hamilton-multi-agent.pngdeleted file mode 100644index b4c3129f..00000000Binary files a/examples/multi-agent-collaboration/hamilton-multi-agent.png and /dev/null differdiff --git a/examples/multi-agent-collaboration/hamilton/README.md b/examples/multi-agent-collaboration/hamilton/README.mdnew file mode 100644index 00000000..be72ac84--- /dev/null+++ b/examples/multi-agent-collaboration/hamilton/README.md@@ -0,0 +1,51 @@+# Multi Agent Collaboration++This example resembles the example found originally [here](https://github.com/langchain-ai/langgraph/blob/main/examples/multi_agent/multi-agent-collaboration.ipynb).+++## show me the prompts+With Hamilton the prompts can be found in the moduel [`func_agent.py`](func_agent.py).++# Tracing+You'll see that in `application.py` we+have some lightweight `tracing` set up for Hamilton. This is a simple way to plug into Burr's+tracer functionality -- this will allow you to see more in the Burr UI.++More functionality is on the roadmap!++# Running the example+Install the dependencies:++```bash+pip install "burr[start]" -r requirements.txt+```++Make sure you have the API Keys in your environment:++```bash+export OPENAI_API_KEY=YOUR_KEY+export TAVILY_API_KEY=YOUR_KEY+```++Run the notebook:+<a target="_blank" href="https://colab.research.google.com/github/dagworks-inc/burr/blob/main/examples/multi-agent-collaboration/hamilton/notebook.ipynb">+ <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>+</a>+or do it manually:+```bash+jupyter notebook+```+and open the notebook `notebook.ipynb`.++```bash+python application.py+```+Application run:+++# What to adjust+There are a few things:++1. The `query` that you provide for the agents to work over. This is just a matter of setting the `query` variable in+the initial state passed in to the application.+2. You can adjust the `prompts` used in the actual function calls in `func_agent.py`.diff --git a/examples/multi-agent-collaboration/hamilton/__init__.py b/examples/multi-agent-collaboration/hamilton/__init__.pynew file mode 100644index 00000000..e69de29bdiff --git a/examples/multi-agent-collaboration/application.py b/examples/multi-agent-collaboration/hamilton/alternative_implementation.pysimilarity index 100%rename from examples/multi-agent-collaboration/application.pyrename to examples/multi-agent-collaboration/hamilton/alternative_implementation.pydiff --git a/examples/multi-agent-collaboration/hamilton_application.py b/examples/multi-agent-collaboration/hamilton/application.pysimilarity index 85%rename from examples/multi-agent-collaboration/hamilton_application.pyrename to examples/multi-agent-collaboration/hamilton/application.pyindex 183bf87b..b16dc891 100644--- a/examples/multi-agent-collaboration/hamilton_application.py+++ b/examples/multi-agent-collaboration/hamilton/application.py@@ -19,9 +19,34 @@ from burr.lifecycle import PostRunStepHookfrom burr.tracking import client as burr_tclientfrom burr.visibility import ActionSpanTracer, TracerFactory+# --- some set up for the tools ---++repl = PythonREPL()+tavily_tool = TavilySearchResults(max_results=5)+++def python_repl(code: str) -> dict:+ """Use this to execute python code. If you want to see the output of a value,+ you should print it out with `print(...)`. This is visible to the user.++ :param code: string. The python code to execute.+ :return: the output+ """+ try:+ result = repl.run(code)+ except BaseException as e:+ return {"error": repr(e), "status": "error", "code": f"```python\n{code}\n```"}+ return {"status": "success", "code": f"```python\n{code}\n```", "Stdout": result}+++# These are our tools that we will use in the application.+tools = [tavily_tool, python_repl]+class SimpleTracer(h_lifecycle.NodeExecutionHook):- """Simple Hamilton Tracer that plugs into Burr's tracing capture."""+ """Simple Hamilton Tracer that plugs into Burr's tracing capture.+ This will tell Burr about what Hamilton is doing internally.+ """def __init__(self, tracer: TracerFactory):self._tracer: TracerFactory = tracer@@ -61,29 +86,20 @@ class SimpleTracer(h_lifecycle.NodeExecutionHook):context_manager.__exit__(None, None, None)-def initialize_tool_dag(agent_name: str, tracer: TracerFactory) -> driver.Driver:- """Initialize the tool DAG with the tracer."""+def initialize_agent_dag(agent_name: str, tracer: TracerFactory) -> driver.Driver:+ """Initialize the agent DAG with the tracer.++ Right now there is no difference between the agents, but this is here for future use.+ """tracer = SimpleTracer(tracer)# Initialize some things needed for tools.- tool_dag = driver.Builder().with_modules(func_agent).with_adapters(tracer).build()- return tool_dag+ agent_dag = driver.Builder().with_modules(func_agent).with_adapters(tracer).build()+ return agent_dag-repl = PythonREPL()---def python_repl(code: str) -> dict:- """Use this to execute python code. If you want to see the output of a value,- you should print it out with `print(...)`. This is visible to the user.+# --- End Tool Setup- :param code: string. The python code to execute.- :return: the output- """- try:- result = repl.run(code)- except BaseException as e:- return {"error": repr(e), "status": "error", "code": f"```python\n{code}\n```"}- return {"status": "success", "code": f"```python\n{code}\n```", "Stdout": result}+# --- Start defining Action@action(reads=["query", "messages"], writes=["messages"])@@ -95,8 +111,8 @@ def chart_generator(state: State, __tracer: TracerFactory) -> tuple[dict, State]:return:"""query = state["query"]- tool_dag = initialize_tool_dag("chart_generator", __tracer)- result = tool_dag.execute(+ agent_dag = initialize_agent_dag("chart_generator", __tracer)+ result = agent_dag.execute(["parsed_tool_calls", "llm_function_message"],inputs={"tools": [python_repl],@@ -114,9 +130,6 @@ def chart_generator(state: State, __tracer: TracerFactory) -> tuple[dict, State]return result, state-tavily_tool = TavilySearchResults(max_results=5)--@action(reads=["query", "messages"], writes=["messages"])def researcher(state: State, __tracer: TracerFactory) -> tuple[dict, State]:"""The researcher action.@@ -126,8 +139,8 @@ def researcher(state: State, __tracer: TracerFactory) -> tuple[dict, State]::return:"""query = state["query"]- tool_dag = initialize_tool_dag("researcher", __tracer)- result = tool_dag.execute(+ agent_dag = initialize_agent_dag("researcher", __tracer)+ result = agent_dag.execute(["parsed_tool_calls", "llm_function_message"],inputs={"tools": [tavily_tool],@@ -144,9 +157,6 @@ def researcher(state: State, __tracer: TracerFactory) -> tuple[dict, State]:return result, state-tools = [tavily_tool, python_repl]--@action(reads=["messages", "parsed_tool_calls"], writes=["messages", "parsed_tool_calls"])def tool_node(state: State) -> tuple[dict, State]:"""Given a tool call, execute it and return the result."""@@ -189,6 +199,7 @@ def tool_node(state: State) -> tuple[dict, State]:@action(reads=[], writes=[])def terminal_step(state: State) -> tuple[dict, State]:+ """Terminal step we have here that does nothing, but it could"""return {}, state@@ -200,32 +211,42 @@ class PrintStepHook(PostRunStepHook):print("state======\n", state)-def default_state_and_entry_point() -> tuple[dict, str]:+def default_state_and_entry_point(query: str = None) -> tuple[dict, str]:"""Returns the default state and entry point for the application."""+ if query is None:+ query = (+ "Fetch the UK's GDP over the past 5 years,"+ " then draw a line graph of it."+ " Once the python code has been written and the graph drawn, the task is complete."+ )return {"messages": [],- "query": "Fetch the UK's GDP over the past 5 years,"- " then draw a line graph of it."- " Once the python code has been written and the graph drawn, the task is complete.",+ "query": query,"sender": "","parsed_tool_calls": [],}, "researcher"-def main(app_instance_id: str = None, sequence_number: int = None):- """Main function to run the application."""+def main(query: str = None, app_instance_id: str = None, sequence_number: int = None):+ """Main function to run the application.++ :param query: the query for the agents to run over.+ :param app_instance_id: a prior app instance id to restart from.+ :param sequence_number: a prior sequence number to restart from.+ :return:+ """project_name = "demo:hamilton-multi-agent-v1"if app_instance_id:tracker = burr_tclient.LocalTrackingClient(project_name)persisted_state = tracker.load("demo", app_id=app_instance_id, sequence_no=sequence_number)if not persisted_state:print(f"Warning: No persisted state found for app_id {app_instance_id}.")- state, entry_point = default_state_and_entry_point()+ state, entry_point = default_state_and_entry_point(query)else:state = persisted_state["state"]entry_point = persisted_state["position"]else:- state, entry_point = default_state_and_entry_point()+ state, entry_point = default_state_and_entry_point(query)# look up app_id for particular user# if None -- then proceed with defaults# else load from state, and set entry pointdiff --git a/examples/multi-agent-collaboration/func_agent.py b/examples/multi-agent-collaboration/hamilton/func_agent.pysimilarity index 97%rename from examples/multi-agent-collaboration/func_agent.pyrename to examples/multi-agent-collaboration/hamilton/func_agent.pyindex b80788af..e76efdaf 100644--- a/examples/multi-agent-collaboration/func_agent.py+++ b/examples/multi-agent-collaboration/hamilton/func_agent.py@@ -118,23 +118,6 @@ def base_system_prompt(tool_names: list[str], system_message: str) -> str:)-def get_current_weather(location: str, unit: str = "fahrenheit") -> str:- """Get the current weather in a given location-- :param location: the location to get the weather for.- :param unit: the unit of temperature to return. Celsius or Fahrenheit.- :return: JSON string with the location and temperature, and unit.- """- if "tokyo" in location.lower():- return json.dumps({"location": "Tokyo", "temperature": "10", "unit": unit})- elif "san francisco" in location.lower():- return json.dumps({"location": "San Francisco", "temperature": "72", "unit": unit})- elif "paris" in location.lower():- return json.dumps({"location": "Paris", "temperature": "22", "unit": unit})- else:- return json.dumps({"location": location, "temperature": "unknown"})--def message_history(base_system_prompt: str, user_query: str, messages: list[dict]) -> list[dict]:"""Creates the message history for the LLM model.@@ -267,9 +250,28 @@ def executed_tool_calls(return results+def _get_current_weather(location: str, unit: str = "fahrenheit") -> str:+ """Get the current weather in a given location++ Dummy function to simulate a weather API call.++ :param location: the location to get the weather for.+ :param unit: the unit of temperature to return. Celsius or Fahrenheit.+ :return: JSON string with the location and temperature, and unit.+ """+ if "tokyo" in location.lower():+ return json.dumps({"location": "Tokyo", "temperature": "10", "unit": unit})+ elif "san francisco" in location.lower():+ return json.dumps({"location": "San Francisco", "temperature": "72", "unit": unit})+ elif "paris" in location.lower():+ return json.dumps({"location": "Paris", "temperature": "22", "unit": unit})+ else:+ return json.dumps({"location": location, "temperature": "unknown"})++if __name__ == "__main__":# some code to test a few things.- jspec = _tool_function_spec(get_current_weather)+ jspec = _tool_function_spec(_get_current_weather)import pprintpprint.pprint(jspec)@@ -281,7 +283,7 @@ if __name__ == "__main__":result = dr.execute(["executed_tool_calls"],inputs={- "tools": [get_current_weather],+ "tools": [_get_current_weather],"system_message": "You are an accurate weather forecaster.","user_query": "What is the weather in Tokyo, Japan? Use celsius.","messages": [],diff --git a/examples/multi-agent-collaboration/hamilton/notebook.ipynb b/examples/multi-agent-collaboration/hamilton/notebook.ipynbnew file mode 100644index 00000000..c809f9eb--- /dev/null+++ b/examples/multi-agent-collaboration/hamilton/notebook.ipynb@@ -0,0 +1,990 @@+{+ "cells": [+ {+ "cell_type": "markdown",+ "id": "a80d8df22739b896",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Basic Multi-agent Collaboration\n",+ "\n",+ "A single agent can usually operate effectively using a handful of tools within a single domain, but even using powerful models like `gpt-4`, it can be less effective at using many tools. \n",+ "\n",+ "One way to approach complicated tasks is through a \"divide-and-conquer\" approach: create a \"specialized agent\" for each task or domain and route tasks to the correct \"expert\". This means that each agent can become a sequence of LLM calls that chooses how to use a specific \"tool\".\n",+ "\n",+ "This notebook (inspired by the paper [AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation](https://arxiv.org/abs/2308.08155), by Wu, et. al.) shows one way to do this using Burr.\n"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 1,+ "id": "41629c14988dec58",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:01:33.103630Z",+ "start_time": "2024-04-14T22:01:33.100150Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# %pip install -U burr[start] langchain-community langchain-core langchain-experimental openai sf-hamilton[visualization]"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 2,+ "id": "642649bc6414efb4",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:03:15.394918Z",+ "start_time": "2024-04-14T22:03:15.392234Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# Environment variables\n",+ "import os\n",+ "# Make sure TAVILY_API_KEY & OPENAI_API_KEY are set\n",+ "# os.environ['TAVILY_API_KEY'] = 'your_tavily_api_key' # get one at https://tavily.com\n",+ "# os.environ['OPENAI_API_KEY'] = 'your_openai_api_key' # get one at https://platform.openai.com"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 20,+ "id": "1bd6ddb8fb909d38",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:14:30.125534Z",+ "start_time": "2024-04-14T22:14:27.831337Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# import everything that you'll need\n",+ "import json\n",+ "import pprint\n",+ "\n",+ "from hamilton import driver\n",+ "from langchain_community.tools.tavily_search import TavilySearchResults\n",+ "from langchain_experimental.utilities import PythonREPL\n",+ "\n",+ "from burr import core\n",+ "from burr.core import ApplicationBuilder, State, action, default\n",+ "from burr.lifecycle import PostRunStepHook\n",+ "from burr.tracking import client as burr_tclient\n",+ "\n",+ "# our hamilton module -- see below\n",+ "import func_agent"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "1ca3c55452268be9",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ " # Define the tools that the agents will use\n",+ "\n",+ "Here we construct the python objects that will be used as tools by our code."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 4,+ "id": "ed8e5eefad5726d",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:14:30.132311Z",+ "start_time": "2024-04-14T22:14:30.127372Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "repl = PythonREPL()\n",+ "tavily_tool = TavilySearchResults(max_results=5)\n",+ "\n",+ "def python_repl(code: str) -> dict:\n",+ " \"\"\"Use this to execute python code. If you want to see the output of a value,\n",+ " you should print it out with `print(...)`. This is visible to the user.\n",+ "\n",+ " :param code: string. The python code to execute.\n",+ " :return: the output\n",+ " \"\"\"\n",+ " try:\n",+ " result = repl.run(code)\n",+ " except BaseException as e:\n",+ " return {\"error\": repr(e), \"status\": \"error\", \"code\": f\"```python\\n{code}\\n```\"}\n",+ " return {\"status\": \"success\", \"code\": f\"```python\\n{code}\\n```\", \"Stdout\": result}\n",+ "\n",+ "# These are our tools that we will use in the application.\n",+ "tools = [tavily_tool, python_repl]"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "6126c2b461163f05",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Define the agents\n",+ "Our \"agents\" are effectively an execution of a series of LLM calls. \n",+ "In this example we use Hamilton to orchestrate this series of LLM calls.\n",+ "\n",+ "For the source code and to see all the prompts used, see [func_agent.py](./func_agent.py). You'll see the structure of\n",+ "this as the output of the next cell."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 5,+ "id": "c37033a4a91bd2f3",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:14:30.791938Z",+ "start_time": "2024-04-14T22:14:30.358694Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "data": {+ "image/svg+xml": [+ "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n",+ "<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\"\n",+ " \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\">\n",+ "<!-- Generated by graphviz version 9.0.0 (20230911.1827)\n",+ " -->\n",+ "<!-- Pages: 1 -->\n",+ "<svg width=\"1395pt\" height=\"227pt\"\n",+ " viewBox=\"0.00 0.00 1394.67 226.80\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n",+ "<g id=\"graph0\" class=\"graph\" transform=\"scale(1 1) rotate(0) translate(4 222.8)\">\n",+ "<polygon fill=\"white\" stroke=\"none\" points=\"-4,4 -4,-222.8 1390.67,-222.8 1390.67,4 -4,4\"/>\n",+ "<g id=\"clust1\" class=\"cluster\">\n",+ "<title>cluster__legend</title>\n",+ "<polygon fill=\"#ffffff\" stroke=\"black\" points=\"8,-80.8 8,-210.8 92.85,-210.8 92.85,-80.8 8,-80.8\"/>\n",+ "<text text-anchor=\"middle\" x=\"50.42\" y=\"-193.5\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">Legend</text>\n",+ "</g>\n",+ "<!-- message_history -->\n",+ "<g id=\"node1\" class=\"node\">\n",+ "<title>message_history</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M799.12,-104.6C799.12,-104.6 690.52,-104.6 690.52,-104.6 684.52,-104.6 678.52,-98.6 678.52,-92.6 678.52,-92.6 678.52,-53 678.52,-53 678.52,-47 684.52,-41 690.52,-41 690.52,-41 799.12,-41 799.12,-41 805.12,-41 811.12,-47 811.12,-53 811.12,-53 811.12,-92.6 811.12,-92.6 811.12,-98.6 805.12,-104.6 799.12,-104.6\"/>\n",+ "<text text-anchor=\"start\" x=\"689.32\" y=\"-81.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">message_history</text>\n",+ "<text text-anchor=\"start\" x=\"736.57\" y=\"-53.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- llm_function_response -->\n",+ "<g id=\"node3\" class=\"node\">\n",+ "<title>llm_function_response</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M998.22,-104.6C998.22,-104.6 852.12,-104.6 852.12,-104.6 846.12,-104.6 840.12,-98.6 840.12,-92.6 840.12,-92.6 840.12,-53 840.12,-53 840.12,-47 846.12,-41 852.12,-41 852.12,-41 998.22,-41 998.22,-41 1004.22,-41 1010.22,-47 1010.22,-53 1010.22,-53 1010.22,-92.6 1010.22,-92.6 1010.22,-98.6 1004.22,-104.6 998.22,-104.6\"/>\n",+ "<text text-anchor=\"start\" x=\"850.92\" y=\"-81.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">llm_function_response</text>\n",+ "<text text-anchor=\"start\" x=\"876.42\" y=\"-53.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">ChatCompletion</text>\n",+ "</g>\n",+ "<!-- message_history->llm_function_response -->\n",+ "<g id=\"edge3\" class=\"edge\">\n",+ "<title>message_history->llm_function_response</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M811.48,-72.8C817.1,-72.8 822.87,-72.8 828.67,-72.8\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"828.33,-76.3 838.33,-72.8 828.33,-69.3 828.33,-76.3\"/>\n",+ "</g>\n",+ "<!-- llm_client -->\n",+ "<g id=\"node2\" class=\"node\">\n",+ "<title>llm_client</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M775.12,-186.6C775.12,-186.6 714.52,-186.6 714.52,-186.6 708.52,-186.6 702.52,-180.6 702.52,-174.6 702.52,-174.6 702.52,-135 702.52,-135 702.52,-129 708.52,-123 714.52,-123 714.52,-123 775.12,-123 775.12,-123 781.12,-123 787.12,-129 787.12,-135 787.12,-135 787.12,-174.6 787.12,-174.6 787.12,-180.6 781.12,-186.6 775.12,-186.6\"/>\n",+ "<text text-anchor=\"start\" x=\"713.32\" y=\"-163.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">llm_client</text>\n",+ "<text text-anchor=\"start\" x=\"721.57\" y=\"-135.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">OpenAI</text>\n",+ "</g>\n",+ "<!-- llm_client->llm_function_response -->\n",+ "<g id=\"edge5\" class=\"edge\">\n",+ "<title>llm_client->llm_function_response</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M787.19,-135.78C804.03,-128.04 824.09,-118.82 843.6,-109.85\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"845.04,-113.04 852.66,-105.68 842.12,-106.68 845.04,-113.04\"/>\n",+ "</g>\n",+ "<!-- parsed_tool_calls -->\n",+ "<g id=\"node6\" class=\"node\">\n",+ "<title>parsed_tool_calls</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M1179.32,-145.6C1179.32,-145.6 1067.72,-145.6 1067.72,-145.6 1061.72,-145.6 1055.72,-139.6 1055.72,-133.6 1055.72,-133.6 1055.72,-94 1055.72,-94 1055.72,-88 1061.72,-82 1067.72,-82 1067.72,-82 1179.32,-82 1179.32,-82 1185.32,-82 1191.32,-88 1191.32,-94 1191.32,-94 1191.32,-133.6 1191.32,-133.6 1191.32,-139.6 1185.32,-145.6 1179.32,-145.6\"/>\n",+ "<text text-anchor=\"start\" x=\"1066.52\" y=\"-122.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">parsed_tool_calls</text>\n",+ "<text text-anchor=\"start\" x=\"1115.27\" y=\"-94.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- llm_function_response->parsed_tool_calls -->\n",+ "<g id=\"edge9\" class=\"edge\">\n",+ "<title>llm_function_response->parsed_tool_calls</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M1010.58,-90.43C1021.81,-92.77 1033.28,-95.16 1044.39,-97.49\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"1043.38,-100.85 1053.88,-99.47 1044.81,-94 1043.38,-100.85\"/>\n",+ "</g>\n",+ "<!-- llm_function_message -->\n",+ "<g id=\"node9\" class=\"node\">\n",+ "<title>llm_function_message</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M1195.82,-63.6C1195.82,-63.6 1051.22,-63.6 1051.22,-63.6 1045.22,-63.6 1039.22,-57.6 1039.22,-51.6 1039.22,-51.6 1039.22,-12 1039.22,-12 1039.22,-6 1045.22,0 1051.22,0 1051.22,0 1195.82,0 1195.82,0 1201.82,0 1207.82,-6 1207.82,-12 1207.82,-12 1207.82,-51.6 1207.82,-51.6 1207.82,-57.6 1201.82,-63.6 1195.82,-63.6\"/>\n",+ "<text text-anchor=\"start\" x=\"1050.02\" y=\"-40.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">llm_function_message</text>\n",+ "<text text-anchor=\"start\" x=\"1113.02\" y=\"-12.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">dict</text>\n",+ "</g>\n",+ "<!-- llm_function_response->llm_function_message -->\n",+ "<g id=\"edge13\" class=\"edge\">\n",+ "<title>llm_function_response->llm_function_message</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M1010.58,-55.17C1016.29,-53.98 1022.05,-52.78 1027.8,-51.58\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"1028.25,-55.06 1037.33,-49.59 1026.82,-48.21 1028.25,-55.06\"/>\n",+ "</g>\n",+ "<!-- executed_tool_calls -->\n",+ "<g id=\"node4\" class=\"node\">\n",+ "<title>executed_tool_calls</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M1374.67,-181.6C1374.67,-181.6 1248.83,-181.6 1248.83,-181.6 1242.83,-181.6 1236.83,-175.6 1236.83,-169.6 1236.83,-169.6 1236.83,-130 1236.83,-130 1236.83,-124 1242.83,-118 1248.83,-118 1248.83,-118 1374.67,-118 1374.67,-118 1380.67,-118 1386.67,-124 1386.67,-130 1386.67,-130 1386.67,-169.6 1386.67,-169.6 1386.67,-175.6 1380.67,-181.6 1374.67,-181.6\"/>\n",+ "<text text-anchor=\"start\" x=\"1247.62\" y=\"-158.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">executed_tool_calls</text>\n",+ "<text text-anchor=\"start\" x=\"1303.5\" y=\"-130.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- tool_names -->\n",+ "<g id=\"node5\" class=\"node\">\n",+ "<title>tool_names</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M416.8,-109.6C416.8,-109.6 343.45,-109.6 343.45,-109.6 337.45,-109.6 331.45,-103.6 331.45,-97.6 331.45,-97.6 331.45,-58 331.45,-58 331.45,-52 337.45,-46 343.45,-46 343.45,-46 416.8,-46 416.8,-46 422.8,-46 428.8,-52 428.8,-58 428.8,-58 428.8,-97.6 428.8,-97.6 428.8,-103.6 422.8,-109.6 416.8,-109.6\"/>\n",+ "<text text-anchor=\"start\" x=\"342.25\" y=\"-86.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">tool_names</text>\n",+ "<text text-anchor=\"start\" x=\"371.87\" y=\"-58.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- base_system_prompt -->\n",+ "<g id=\"node7\" class=\"node\">\n",+ "<title>base_system_prompt</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M637.52,-187.6C637.52,-187.6 499.67,-187.6 499.67,-187.6 493.67,-187.6 487.67,-181.6 487.67,-175.6 487.67,-175.6 487.67,-136 487.67,-136 487.67,-130 493.67,-124 499.67,-124 499.67,-124 637.52,-124 637.52,-124 643.52,-124 649.52,-130 649.52,-136 649.52,-136 649.52,-175.6 649.52,-175.6 649.52,-181.6 643.52,-187.6 637.52,-187.6\"/>\n",+ "<text text-anchor=\"start\" x=\"498.47\" y=\"-164.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">base_system_prompt</text>\n",+ "<text text-anchor=\"start\" x=\"561.1\" y=\"-136.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">str</text>\n",+ "</g>\n",+ "<!-- tool_names->base_system_prompt -->\n",+ "<g id=\"edge10\" class=\"edge\">\n",+ "<title>tool_names->base_system_prompt</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M429.15,-97.89C444.75,-104.41 462.59,-111.88 480.15,-119.22\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"478.47,-122.31 489.04,-122.94 481.17,-115.85 478.47,-122.31\"/>\n",+ "</g>\n",+ "<!-- parsed_tool_calls->executed_tool_calls -->\n",+ "<g id=\"edge6\" class=\"edge\">\n",+ "<title>parsed_tool_calls->executed_tool_calls</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M1191.76,-126.8C1202.62,-128.9 1213.99,-131.09 1225.21,-133.26\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"1224.39,-136.67 1234.88,-135.13 1225.72,-129.8 1224.39,-136.67\"/>\n",+ "</g>\n",+ "<!-- base_system_prompt->message_history -->\n",+ "<g id=\"edge1\" class=\"edge\">\n",+ "<title>base_system_prompt->message_history</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M636.96,-123.71C647.09,-118.89 657.59,-113.88 667.88,-108.98\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"669.19,-112.23 676.71,-104.77 666.18,-105.91 669.19,-112.23\"/>\n",+ "</g>\n",+ "<!-- tool_function_specs -->\n",+ "<g id=\"node8\" class=\"node\">\n",+ "<title>tool_function_specs</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M260.57,-79.6C260.57,-79.6 131.72,-79.6 131.72,-79.6 125.72,-79.6 119.72,-73.6 119.72,-67.6 119.72,-67.6 119.72,-28 119.72,-28 119.72,-22 125.72,-16 131.72,-16 131.72,-16 260.57,-16 260.57,-16 266.57,-16 272.57,-22 272.57,-28 272.57,-28 272.57,-67.6 272.57,-67.6 272.57,-73.6 266.57,-79.6 260.57,-79.6\"/>\n",+ "<text text-anchor=\"start\" x=\"130.52\" y=\"-56.5\" font-family=\"Helvetica,sans-Serif\" font-weight=\"bold\" font-size=\"14.00\">tool_function_specs</text>\n",+ "<text text-anchor=\"start\" x=\"187.9\" y=\"-28.5\" font-family=\"Helvetica,sans-Serif\" font-style=\"italic\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- tool_function_specs->llm_function_response -->\n",+ "<g id=\"edge4\" class=\"edge\">\n",+ "<title>tool_function_specs->llm_function_response</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M273.03,-36.06C389.73,-20.19 619.83,2.43 811.12,-31.8 818.97,-33.2 826.98,-35.1 834.95,-37.31\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"833.72,-40.6 844.3,-40.07 835.7,-33.88 833.72,-40.6\"/>\n",+ "</g>\n",+ "<!-- tool_function_specs->tool_names -->\n",+ "<g id=\"edge8\" class=\"edge\">\n",+ "<title>tool_function_specs->tool_names</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M273.01,-60.31C288.7,-62.89 305.02,-65.58 320.02,-68.06\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"319.26,-71.48 329.7,-69.65 320.4,-64.57 319.26,-71.48\"/>\n",+ "</g>\n",+ "<!-- _message_history_inputs -->\n",+ "<g id=\"node10\" class=\"node\">\n",+ "<title>_message_history_inputs</title>\n",+ "<polygon fill=\"#ffffff\" stroke=\"black\" stroke-dasharray=\"5,2\" points=\"627.9,-105.6 509.3,-105.6 509.3,-40 627.9,-40 627.9,-105.6\"/>\n",+ "<text text-anchor=\"start\" x=\"526.47\" y=\"-77.5\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">messages</text>\n",+ "<text text-anchor=\"start\" x=\"596.85\" y=\"-77.5\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">list</text>\n",+ "<text text-anchor=\"start\" x=\"523.85\" y=\"-56.5\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">user_query</text>\n",+ "<text text-anchor=\"start\" x=\"597.6\" y=\"-56.5\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">str</text>\n",+ "</g>\n",+ "<!-- _message_history_inputs->message_history -->\n",+ "<g id=\"edge2\" class=\"edge\">\n",+ "<title>_message_history_inputs->message_history</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M628.1,-72.8C640.56,-72.8 653.9,-72.8 666.94,-72.8\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"666.77,-76.3 676.77,-72.8 666.77,-69.3 666.77,-76.3\"/>\n",+ "</g>\n",+ "<!-- _executed_tool_calls_inputs -->\n",+ "<g id=\"node11\" class=\"node\">\n",+ "<title>_executed_tool_calls_inputs</title>\n",+ "<polygon fill=\"#ffffff\" stroke=\"black\" stroke-dasharray=\"5,2\" points=\"1163.82,-208.1 1083.22,-208.1 1083.22,-163.5 1163.82,-163.5 1163.82,-208.1\"/>\n",+ "<text text-anchor=\"start\" x=\"1098.02\" y=\"-180\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">tools</text>\n",+ "<text text-anchor=\"start\" x=\"1132.52\" y=\"-180\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- _executed_tool_calls_inputs->executed_tool_calls -->\n",+ "<g id=\"edge7\" class=\"edge\">\n",+ "<title>_executed_tool_calls_inputs->executed_tool_calls</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M1164.02,-178.17C1181.93,-174.7 1203.86,-170.46 1225.24,-166.33\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"1225.71,-169.8 1234.87,-164.47 1224.39,-162.93 1225.71,-169.8\"/>\n",+ "</g>\n",+ "<!-- _base_system_prompt_inputs -->\n",+ "<g id=\"node12\" class=\"node\">\n",+ "<title>_base_system_prompt_inputs</title>\n",+ "<polygon fill=\"#ffffff\" stroke=\"black\" stroke-dasharray=\"5,2\" points=\"458.67,-178.1 301.57,-178.1 301.57,-133.5 458.67,-133.5 458.67,-178.1\"/>\n",+ "<text text-anchor=\"start\" x=\"316.37\" y=\"-150\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">system_message</text>\n",+ "<text text-anchor=\"start\" x=\"428.87\" y=\"-150\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">str</text>\n",+ "</g>\n",+ "<!-- _base_system_prompt_inputs->base_system_prompt -->\n",+ "<g id=\"edge11\" class=\"edge\">\n",+ "<title>_base_system_prompt_inputs->base_system_prompt</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M459.13,-155.8C464.64,-155.8 470.22,-155.8 475.8,-155.8\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"475.7,-159.3 485.7,-155.8 475.7,-152.3 475.7,-159.3\"/>\n",+ "</g>\n",+ "<!-- _tool_function_specs_inputs -->\n",+ "<g id=\"node13\" class=\"node\">\n",+ "<title>_tool_function_specs_inputs</title>\n",+ "<polygon fill=\"#ffffff\" stroke=\"black\" stroke-dasharray=\"5,2\" points=\"90.72,-70.1 10.12,-70.1 10.12,-25.5 90.72,-25.5 90.72,-70.1\"/>\n",+ "<text text-anchor=\"start\" x=\"24.92\" y=\"-42\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">tools</text>\n",+ "<text text-anchor=\"start\" x=\"59.42\" y=\"-42\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">list</text>\n",+ "</g>\n",+ "<!-- _tool_function_specs_inputs->tool_function_specs -->\n",+ "<g id=\"edge12\" class=\"edge\">\n",+ "<title>_tool_function_specs_inputs->tool_function_specs</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M91.08,-47.8C96.45,-47.8 102.12,-47.8 107.93,-47.8\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"107.71,-51.3 117.71,-47.8 107.71,-44.3 107.71,-51.3\"/>\n",+ "</g>\n",+ "<!-- input -->\n",+ "<g id=\"node14\" class=\"node\">\n",+ "<title>input</title>\n",+ "<polygon fill=\"#ffffff\" stroke=\"black\" stroke-dasharray=\"5,2\" points=\"77.42,-180.1 23.42,-180.1 23.42,-143.5 77.42,-143.5 77.42,-180.1\"/>\n",+ "<text text-anchor=\"middle\" x=\"50.42\" y=\"-156\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">input</text>\n",+ "</g>\n",+ "<!-- function -->\n",+ "<g id=\"node15\" class=\"node\">\n",+ "<title>function</title>\n",+ "<path fill=\"#b4d8e4\" stroke=\"black\" d=\"M72.85,-125.1C72.85,-125.1 28,-125.1 28,-125.1 22,-125.1 16,-119.1 16,-113.1 16,-113.1 16,-100.5 16,-100.5 16,-94.5 22,-88.5 28,-88.5 28,-88.5 72.85,-88.5 72.85,-88.5 78.85,-88.5 84.85,-94.5 84.85,-100.5 84.85,-100.5 84.85,-113.1 84.85,-113.1 84.85,-119.1 78.85,-125.1 72.85,-125.1\"/>\n",+ "<text text-anchor=\"middle\" x=\"50.42\" y=\"-101\" font-family=\"Helvetica,sans-Serif\" font-size=\"14.00\">function</text>\n",+ "</g>\n",+ "</g>\n",+ "</svg>\n"+ ],+ "text/plain": [+ "<hamilton.driver.Driver at 0x12b12fdf0>"+ ]+ },+ "execution_count": 5,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "# The Agent that we'll use. Our agents here only differ by the system message passed in.\n",+ "agent_dag = driver.Builder().with_modules(func_agent).build()\n",+ "agent_dag"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "e0ce269d3e58716b",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Define the actions that map to agents\n",+ "We now then create specific actions that map to the agents we need for this not example.\n",+ " \n",+ "We want a \"chart generator\" action, that will map to an agent that can generate a chart based on provided context/data.\n",+ "\n",+ "We want a \"researcher\" action, that will map to an agent that can search for information on a topic.\n",+ "\n",+ "We then want a \"tool_node\" action, that will run a tool as specified by the prior action, i.e. agent."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 7,+ "id": "d262371331b8f996",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:28:18.243782Z",+ "start_time": "2024-04-14T22:28:18.231891Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "@action(reads=[\"query\", \"messages\"], writes=[\"messages\"])\n",+ "def chart_generator(state: State) -> tuple[dict, State]:\n",+ " \"\"\"The chart generator action.\n",+ "\n",+ " :param state: state of the application\n",+ " :return: \n",+ " \"\"\"\n",+ " query = state[\"query\"]\n",+ " result = agent_dag.execute(\n",+ " [\"parsed_tool_calls\", \"llm_function_message\"],\n",+ " inputs={\n",+ " \"tools\": [python_repl],\n",+ " \"system_message\": \"Any charts you display will be visible by the user. When done say 'FINAL ANSWER'.\",\n",+ " \"user_query\": query,\n",+ " \"messages\": state[\"messages\"],\n",+ " },\n",+ " )\n",+ " new_message = result[\"llm_function_message\"]\n",+ " parsed_tool_calls = result[\"parsed_tool_calls\"]\n",+ " state = state.update(parsed_tool_calls=parsed_tool_calls)\n",+ " state = state.append(messages=new_message)\n",+ " state = state.update(sender=\"chart_generator\")\n",+ " return result, state\n",+ "\n",+ "@action(reads=[\"query\", \"messages\"], writes=[\"messages\"])\n",+ "def researcher(state: State) -> tuple[dict, State]:\n",+ " \"\"\"The researcher action.\n",+ "\n",+ " :param state: state of the application\n",+ " :return:\n",+ " \"\"\"\n",+ " query = state[\"query\"]\n",+ " result = agent_dag.execute(\n",+ " [\"parsed_tool_calls\", \"llm_function_message\"],\n",+ " inputs={\n",+ " \"tools\": [tavily_tool],\n",+ " \"system_message\": \"You should provide accurate data for the chart generator to use. When done say 'FINAL ANSWER'.\",\n",+ " \"user_query\": query,\n",+ " \"messages\": state[\"messages\"],\n",+ " },\n",+ " )\n",+ " new_message = result[\"llm_function_message\"]\n",+ " parsed_tool_calls = result[\"parsed_tool_calls\"]\n",+ " state = state.update(parsed_tool_calls=parsed_tool_calls)\n",+ " state = state.append(messages=new_message)\n",+ " state = state.update(sender=\"researcher\")\n",+ " return result, state\n",+ "\n",+ "\n",+ "@action(reads=[\"messages\", \"parsed_tool_calls\"], writes=[\"messages\", \"parsed_tool_calls\"])\n",+ "def tool_node(state: State) -> tuple[dict, State]:\n",+ " \"\"\"Given a tool call, execute it and return the result.\"\"\"\n",+ " new_messages = []\n",+ " parsed_tool_calls = state[\"parsed_tool_calls\"]\n",+ "\n",+ " for tool_call in parsed_tool_calls:\n",+ " tool_name = tool_call[\"function_name\"]\n",+ " tool_args = tool_call[\"function_args\"]\n",+ " tool_found = False\n",+ " for tool in tools:\n",+ " name = getattr(tool, \"name\", None)\n",+ " if name is None:\n",+ " name = tool.__name__\n",+ " if name == tool_name:\n",+ " tool_found = True\n",+ " kwargs = json.loads(tool_args)\n",+ " # Execute the tool!\n",+ " if hasattr(tool, \"_run\"):\n",+ " result = tool._run(**kwargs)\n",+ " else:\n",+ " result = tool(**kwargs)\n",+ " new_messages.append(\n",+ " {\n",+ " \"tool_call_id\": tool_call[\"id\"],\n",+ " \"role\": \"tool\",\n",+ " \"name\": tool_name,\n",+ " \"content\": result,\n",+ " }\n",+ " )\n",+ " if not tool_found:\n",+ " raise ValueError(f\"Tool {tool_name} not found.\")\n",+ "\n",+ " for tool_result in new_messages:\n",+ " state = state.append(messages=tool_result)\n",+ " state = state.update(parsed_tool_calls=[])\n",+ " # We return a list, because this will get added to the existing list\n",+ " return {\"messages\": new_messages}, state\n",+ "\n",+ "@action(reads=[], writes=[])\n",+ "def terminal_step(state: State) -> tuple[dict, State]:\n",+ " \"\"\"Terminal step we have here that does nothing, but it could\"\"\"\n",+ " return {}, state"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "2f467fb7ae6360f9",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Define the Graph / Application\n",+ "With Burr we need to now construct our application, i.e. graph, by:\n",+ "\n",+ "1. Defining what the actions are and how to transition between them.\n",+ "2. Defining the initial state of the application. In our example this means we need to provide a \"query\" for the agents to work on.\n",+ "\n",+ "Because Burr comes with built in persistence, we can also load a prior execution and continue from \n",+ "any point in its history by specifying a `app_instance_id` and `sequence_number` when building the application."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 11,+ "id": "79b4924965e77be3",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:27:20.323166Z",+ "start_time": "2024-04-14T22:27:20.319966Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# Adjust these if you want to load a prior execution\n",+ "app_instance_id = None\n",+ "sequence_id = None\n",+ "project_name = \"demo:hamilton-multi-agent-v1\"\n",+ "\n",+ "# CHANGE THIS IF YOU WANT SOMETHING DIFFERENT!\n",+ "default_query = (\"Fetch the UK's GDP over the past 5 years, then draw a line graph of it. \"\n",+ " \"Once the python code has been written and the graph drawn, the task is complete.\")"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 14,+ "id": "d8d69620528ea842",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:27:24.193962Z",+ "start_time": "2024-04-14T22:27:24.188457Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# Determine initial state and entry point\n",+ "def default_state_and_entry_point() -> tuple[dict, str]:\n",+ " \"\"\"Returns the default state and entry point for the application.\"\"\"\n",+ " return {\n",+ " \"messages\": [],\n",+ " \"query\": default_query,\n",+ " \"sender\": \"\",\n",+ " \"parsed_tool_calls\": [],\n",+ " }, \"researcher\"\n",+ "\n",+ "if app_instance_id:\n",+ " tracker = burr_tclient.LocalTrackingClient(project_name)\n",+ " persisted_state = tracker.load(\"demo\", app_id=app_instance_id, sequence_no=sequence_id)\n",+ " if not persisted_state:\n",+ " print(f\"Warning: No persisted state found for app_id {app_instance_id}.\")\n",+ " state, entry_point = default_state_and_entry_point()\n",+ " else:\n",+ " state = persisted_state[\"state\"]\n",+ " entry_point = persisted_state[\"position\"]\n",+ "else:\n",+ " state, entry_point = default_state_and_entry_point()"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 13,+ "id": "5812de2d0cdc8f21",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:28:23.019998Z",+ "start_time": "2024-04-14T22:28:22.190999Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "data": {+ "image/svg+xml": [+ "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n",+ "<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\"\n",+ " \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\">\n",+ "<!-- Generated by graphviz version 9.0.0 (20230911.1827)\n",+ " -->\n",+ "<!-- Pages: 1 -->\n",+ "<svg width=\"1032pt\" height=\"194pt\"\n",+ " viewBox=\"0.00 0.00 1032.10 193.50\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n",+ "<g id=\"graph0\" class=\"graph\" transform=\"scale(1 1) rotate(0) translate(4 189.5)\">\n",+ "<polygon fill=\"white\" stroke=\"none\" points=\"-4,4 -4,-189.5 1028.1,-189.5 1028.1,4 -4,4\"/>\n",+ "<!-- researcher -->\n",+ "<g id=\"node1\" class=\"node\">\n",+ "<title>researcher</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M392.6,-185.5C392.6,-185.5 345.1,-185.5 345.1,-185.5 339.1,-185.5 333.1,-179.5 333.1,-173.5 333.1,-173.5 333.1,-161.5 333.1,-161.5 333.1,-155.5 339.1,-149.5 345.1,-149.5 345.1,-149.5 392.6,-149.5 392.6,-149.5 398.6,-149.5 404.6,-155.5 404.6,-161.5 404.6,-161.5 404.6,-173.5 404.6,-173.5 404.6,-179.5 398.6,-185.5 392.6,-185.5\"/>\n",+ "<text text-anchor=\"middle\" x=\"368.85\" y=\"-162.45\" font-family=\"Times,serif\" font-size=\"14.00\">researcher</text>\n",+ "</g>\n",+ "<!-- chart_generator -->\n",+ "<g id=\"node2\" class=\"node\">\n",+ "<title>chart_generator</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M407.22,-118.5C407.22,-118.5 330.47,-118.5 330.47,-118.5 324.47,-118.5 318.47,-112.5 318.47,-106.5 318.47,-106.5 318.47,-94.5 318.47,-94.5 318.47,-88.5 324.47,-82.5 330.47,-82.5 330.47,-82.5 407.22,-82.5 407.22,-82.5 413.22,-82.5 419.22,-88.5 419.22,-94.5 419.22,-94.5 419.22,-106.5 419.22,-106.5 419.22,-112.5 413.22,-118.5 407.22,-118.5\"/>\n",+ "<text text-anchor=\"middle\" x=\"368.85\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">chart_generator</text>\n",+ "</g>\n",+ "<!-- researcher->chart_generator -->\n",+ "<g id=\"edge3\" class=\"edge\">\n",+ "<title>researcher->chart_generator</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M362.79,-149.08C362.21,-143.25 362,-136.59 362.14,-130.14\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"365.61,-130.66 362.7,-120.48 358.63,-130.26 365.61,-130.66\"/>\n",+ "</g>\n",+ "<!-- tool_node -->\n",+ "<g id=\"node3\" class=\"node\">\n",+ "<title>tool_node</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M214.85,-36C214.85,-36 168.85,-36 168.85,-36 162.85,-36 156.85,-30 156.85,-24 156.85,-24 156.85,-12 156.85,-12 156.85,-6 162.85,0 168.85,0 168.85,0 214.85,0 214.85,0 220.85,0 226.85,-6 226.85,-12 226.85,-12 226.85,-24 226.85,-24 226.85,-30 220.85,-36 214.85,-36\"/>\n",+ "<text text-anchor=\"middle\" x=\"191.85\" y=\"-12.95\" font-family=\"Times,serif\" font-size=\"14.00\">tool_node</text>\n",+ "</g>\n",+ "<!-- researcher->tool_node -->\n",+ "<g id=\"edge1\" class=\"edge\">\n",+ "<title>researcher->tool_node</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M332.77,-164.33C246.04,-158.73 31.41,-142.57 10.35,-118.5 -32.94,-69.03 78.3,-39.46 145.33,-26.6\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"145.8,-30.08 155,-24.81 144.53,-23.19 145.8,-30.08\"/>\n",+ "<text text-anchor=\"middle\" x=\"82.1\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">len(parsed_tool_calls) > 0</text>\n",+ "</g>\n",+ "<!-- terminal -->\n",+ "<g id=\"node4\" class=\"node\">\n",+ "<title>terminal</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M695.72,-36C695.72,-36 657.97,-36 657.97,-36 651.97,-36 645.97,-30 645.97,-24 645.97,-24 645.97,-12 645.97,-12 645.97,-6 651.97,0 657.97,0 657.97,0 695.72,0 695.72,0 701.72,0 707.72,-6 707.72,-12 707.72,-12 707.72,-24 707.72,-24 707.72,-30 701.72,-36 695.72,-36\"/>\n",+ "<text text-anchor=\"middle\" x=\"676.85\" y=\"-12.95\" font-family=\"Times,serif\" font-size=\"14.00\">terminal</text>\n",+ "</g>\n",+ "<!-- researcher->terminal -->\n",+ "<g id=\"edge2\" class=\"edge\">\n",+ "<title>researcher->terminal</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M405,-163.71C498.81,-155.66 746.09,-128.89 794.85,-67.5 817.62,-38.82 761.76,-26.96 719.33,-22.15\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"719.88,-18.69 709.58,-21.15 719.17,-25.65 719.88,-18.69\"/>\n",+ "<text text-anchor=\"middle\" x=\"899.97\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">'FINAL ANSWER' in messages[-1]['content']</text>\n",+ "</g>\n",+ "<!-- chart_generator->researcher -->\n",+ "<g id=\"edge6\" class=\"edge\">\n",+ "<title>chart_generator->researcher</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M374.91,-118.97C375.48,-124.8 375.7,-131.46 375.55,-137.92\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"372.08,-137.38 374.99,-147.57 379.07,-137.79 372.08,-137.38\"/>\n",+ "</g>\n",+ "<!-- chart_generator->tool_node -->\n",+ "<g id=\"edge4\" class=\"edge\">\n",+ "<title>chart_generator->tool_node</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M318.13,-86.92C311.33,-85.36 304.43,-83.84 297.85,-82.5 258.76,-74.52 239.96,-93.08 209.35,-67.5 203.16,-62.33 199.16,-54.8 196.58,-47.21\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"200.03,-46.55 194.1,-37.77 193.26,-48.33 200.03,-46.55\"/>\n",+ "<text text-anchor=\"middle\" x=\"281.1\" y=\"-54.2\" font-family=\"Times,serif\" font-size=\"14.00\">len(parsed_tool_calls) > 0</text>\n",+ "</g>\n",+ "<!-- chart_generator->terminal -->\n",+ "<g id=\"edge5\" class=\"edge\">\n",+ "<title>chart_generator->terminal</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M419.44,-91.8C447.97,-86.62 483.98,-78.68 514.85,-67.5 529.8,-62.08 531.71,-56.6 546.6,-51 575.26,-40.21 608.86,-32.06 634.75,-26.68\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"635.1,-30.18 644.21,-24.78 633.72,-23.32 635.1,-30.18\"/>\n",+ "<text text-anchor=\"middle\" x=\"670.97\" y=\"-54.2\" font-family=\"Times,serif\" font-size=\"14.00\">'FINAL ANSWER' in messages[-1]['content']</text>\n",+ "</g>\n",+ "<!-- tool_node->researcher -->\n",+ "<g id=\"edge7\" class=\"edge\">\n",+ "<title>tool_node->researcher</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M185.69,-36.49C179.3,-58.11 172.52,-94.91 190.6,-118.5 206.49,-139.24 274.45,-153.03 321.7,-160.31\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"321.03,-163.75 331.43,-161.76 322.06,-156.83 321.03,-163.75\"/>\n",+ "<text text-anchor=\"middle\" x=\"250.47\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">sender == 'researcher'</text>\n",+ "</g>\n",+ "<!-- tool_node->chart_generator -->\n",+ "<g id=\"edge8\" class=\"edge\">\n",+ "<title>tool_node->chart_generator</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M227.01,-21.99C268.32,-26.17 333.57,-35.11 351.85,-51 357.84,-56.21 361.72,-63.66 364.23,-71.16\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"360.84,-72.02 366.72,-80.83 367.62,-70.28 360.84,-72.02\"/>\n",+ "<text text-anchor=\"middle\" x=\"437.1\" y=\"-54.2\" font-family=\"Times,serif\" font-size=\"14.00\">sender == 'chart_generator'</text>\n",+ "</g>\n",+ "</g>\n",+ "</svg>\n"+ ],+ "text/plain": [+ "<graphviz.graphs.Digraph at 0x12b1c90c0>"+ ]+ },+ "execution_count": 13,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "# Build the application \n",+ "def build_application(state: dict, entry_point: str):\n",+ " _app = (\n",+ " ApplicationBuilder()\n",+ " # set the actions\n",+ " .with_actions(\n",+ " researcher=researcher,\n",+ " chart_generator=chart_generator,\n",+ " tool_node=tool_node,\n",+ " terminal=terminal_step,\n",+ " )\n",+ " # set the transitions\n",+ " .with_transitions(\n",+ " (\"researcher\", \"tool_node\", core.expr(\"len(parsed_tool_calls) > 0\")),\n",+ " (\n",+ " \"researcher\",\n",+ " \"terminal\",\n",+ " core.expr(\"'FINAL ANSWER' in messages[-1]['content']\"),\n",+ " ),\n",+ " (\"researcher\", \"chart_generator\", default),\n",+ " (\"chart_generator\", \"tool_node\", core.expr(\"len(parsed_tool_calls) > 0\")),\n",+ " (\n",+ " \"chart_generator\",\n",+ " \"terminal\",\n",+ " core.expr(\"'FINAL ANSWER' in messages[-1]['content']\"),\n",+ " ),\n",+ " (\"chart_generator\", \"researcher\", default),\n",+ " (\"tool_node\", \"researcher\", core.expr(\"sender == 'researcher'\")),\n",+ " (\"tool_node\", \"chart_generator\", core.expr(\"sender == 'chart_generator'\")),\n",+ " )\n",+ " # set a few other things\n",+ " .with_identifiers(partition_key=\"demo\")\n",+ " .with_state(**state)\n",+ " .with_entrypoint(entry_point)\n",+ " .with_tracker(project=project_name)\n",+ " .build()\n",+ " )\n",+ " return _app\n",+ "app = build_application(state, entry_point)\n",+ "app.visualize(\n",+ " output_file_path=\"statemachine\", include_conditions=True, format=\"png\"\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "b05e65c77dcc38b5",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# open up the Burr UI to trace the execution\n",+ "In another terminal run:\n",+ "```bash\n",+ "burr\n",+ "```\n",+ "and then open up the browser to [http://localhost:7241](http://localhost:7241) to see the execution of the application when you execute `run()` below."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 11,+ "id": "7173415dbbb0b554",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:29:47.695377Z",+ "start_time": "2024-04-14T22:28:41.193974Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "name": "stderr",+ "output_type": "stream",+ "text": [+ "Python REPL can execute arbitrary code. Use with caution.\n"+ ]+ },+ {+ "data": {+ "image/png": "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",+ "text/plain": [+ "<Figure size 1000x500 with 1 Axes>"+ ]+ },+ "metadata": {},+ "output_type": "display_data"+ },+ {+ "data": {+ "image/png": "iVBORw0KGgoAAAANSUhEUgAAA1sAAAHWCAYAAACBjZMqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAAB3DElEQVR4nO3deZyN5f/H8deZfcYYY2yTJca+Z0sm2cJIVKS0+EayFZMtEdmVJclSlkRUKEv1bceESFF9LYWQRLKMnbGOMXP//rh+czLN4IzOcZ+ZeT8fj/Nwn/tcc5/3PdxmPue+7s/tsCzLQkRERERERNzKx+4AIiIiIiIi2ZGKLREREREREQ9QsSUiIiIiIuIBKrZEREREREQ8QMWWiIiIiIiIB6jYEhERERER8QAVWyIiIiIiIh6gYktERERERMQDVGyJiIiIiIh4gIotERERF3zzzTc4HA6WLFlidxQREckiVGyJiLjB8OHDcTgcHDt2LMPXK1euTMOGDZ3P9+7di8Ph4NVXX00zzrIsunXrhsPhYPjw4dd938TERF5//XXuuusu8ubNS0BAAIULF+b+++/n/fffJzk5Od17pj78/f3Jnz8/d955J4MGDWLfvn3ptp9aYFz5NSVLlqR9+/b88ccfLn1vkpKSmDJlCrfffju5c+cmNDSU22+/nSlTppCUlOTSNm6mBQsWMGnSJNve/59/T76+vtx66620bt2azZs3e+Q9R48ezX//+98b+tq1a9c6s17t33+q5s2bkzdvXg4fPpzutdOnT3PLLbdwxx13kJKSckNZRES8jYotEREvYVkW3bt3Z+bMmQwZMuS6xdbRo0epW7cuPXv2JDQ0lMGDB/Pmm2/y7LPPcu7cOR5//HFGjx6d7usee+wx3nvvPWbPns2QIUMoWbIkkyZNokKFCnzwwQcZvlfPnj157733mDlzJi1atGDhwoXcfvvtHDx48JoZz507R9OmTenVqxeRkZGMHTuW8ePHU7hwYXr16kXTpk05d+6cy9+jm8HuYitV6t/T22+/zeOPP87KlSupU6eORwquGy22UlJSePbZZ8mVK5dL46dNm8alS5fo06dPutcGDRrEsWPHmDlzJj4++vVERLIJS0RE/rVhw4ZZgHX06NEMX69UqZLVoEED5/M9e/ZYgDV+/Hjnuh49eliA9eKLL7r0ns2aNbN8fHysDz/8MMPXf/rpJ2vevHnXfM9Ue/futcqWLWsFBARYmzdvdq5ftWqVBViLFy9OM37KlCkWYI0ePfqaGbt27WoB1uuvv57utTfeeMMCrKeffvqa23C3lJQU6/z581d9vUWLFlbx4sXTrb/a98Ldrvb39Omnn1qA1bVrV7e/Z65cuawOHTpk+uumT59u5cuXz+rVq9c1//1fady4cRZgLVu2zLnuxx9/tHx8fKz+/ftnOsONuHDhgpWcnHxT3ktEcjZ9dCQi4gV69erF1KlTGThwIC+99NJ1x69bt45ly5bRtWtXHnzwwQzH1KpVi3bt2rn0/sWLF2fu3LlcunSJV1555brj7777bgD27Nlz1TH79+9n9uzZ3H333cTGxqZ7vUePHjRq1IhZs2axf/9+wEy3bNSoUbqxKSkpFClShIceeijNukmTJlGpUiWCgoIoVKgQ3bp14+TJk2m+tkSJErRs2ZJly5ZRq1YtgoODefPNNzPM3LBhQ7744gv+/PNP59S4EiVKpMvy8ssvU7RoUYKCgmjcuDG///57um398MMP3HPPPeTJk4eQkBAaNGjAd999d9Xv1/X883v+ySef0KJFCwoXLkxgYCClSpVi1KhRaaaOAuzatYs2bdoQGRlJUFAQRYsW5dFHH+X06dMAOBwOzp07xzvvvOPc5yeffPK6eU6cOMHgwYMZOXIk4eHhLu9H3759qVq1Kt27d+fixYskJyfz9NNPU7x4cYYNGwbAjh07eOihh4iIiCAoKIhatWrx6aefpnv/fv36UaVKFUJDQwkLC6N58+b8/PPPacalToX94IMPGDx4MEWKFCEkJISEhASSkpIYMWIEZcqUISgoiHz58nHXXXcRFxfn8v6IiFyLn90BRERyuj59+jBlyhQGDBiQ4bS/jHz22WcA/Oc//3FbjujoaEqVKuXSL5q7d+8GIF++fFcd89VXX5GcnEz79u2vOqZ9+/asWrWKpUuX0rlzZx555BGGDx9OfHw8kZGRznFr167l4MGDPProo8513bp1Y+7cuXTs2JGePXuyZ88e3njjDTZt2sR3332Hv7+/c+zOnTt57LHH6NatG126dKFcuXIZ5nnxxRc5ffo0+/fvZ+LEiQCEhoamGTN27Fh8fHzo168fp0+f5pVXXqFdu3b88MMPzjErV66kefPm1KxZk2HDhuHj48OcOXO4++67+fbbb6ldu/ZVvydX88/v+dy5cwkNDaVv376EhoaycuVKhg4dSkJCAuPHjwfg0qVLNGvWjMTERJ599lkiIyM5cOAAn3/+OadOnSJPnjy89957dO7cmdq1a9O1a1cASpUqdd08Q4YMITIykm7dujFq1CiX98PPz4+ZM2dy5513MmrUKAoWLMjGjRtZunQpISEhbNu2jbp161KkSBFeeOEFcuXKxaJFi2jVqhUffvghrVu3BuCPP/7gv//9Lw8//DBRUVEcPnyYN998kwYNGvDrr79SuHDhNO87atQoAgIC6NevH4mJiQQEBDB8+HDGjBnj3P+EhAT+97//sXHjRpo2beryPomIXJXdp9ZERLKDG51GWLx4cQuwnn/++Uy9X+vWrS3AOnXqVJr1Fy5csI4ePep8nDx5Mt17ZjSNMNUDDzxgAdbp06cty/p76tzbb79tHT161Dp48KD1xRdfWCVKlLAcDof1008/XXVbvXv3tgBr06ZNVx2zceNGC7D69u1rWZZl7dy5M8Nph927d7dCQ0Od0/++/fZbC7Dmz5+fZtzSpUvTrU/9Hi9duvSqOa50vWmEFSpUsBITE53rJ0+ebAHWli1bLMsy0xTLlCljNWvWzEpJSXGOO3/+vBUVFWU1bdr0mu+f+vc0YsQI6+jRo1Z8fLz1zTffWNWrV7cA57TRjKZCduvWzQoJCbEuXrxoWZZlbdq0yaWpj5mdRvjzzz9bvr6+zqmA1/v3n5HY2FjL39/fCg0NtR577DHn+saNG1tVqlRx7oNlme/pnXfeaZUpU8a57uLFi+mmAu7Zs8cKDAy0Ro4c6VyX+vdWsmTJdN+z2267zWrRooXLmUVEMkvTCEVEbJTala1s2bKZ+rqEhAQg/VmXGTNmUKBAAefjrrvuytR2U7d35syZNOufeuopChQoQOHChWnRooVz2lmtWrWuuq3UbeTOnfuqY1JfS92fsmXLUq1aNRYuXOgck5yczJIlS7jvvvsIDg4GYPHixeTJk4emTZty7Ngx56NmzZqEhoayatWqNO8TFRVFs2bNXP02XFPHjh0JCAhwPq9Xrx6Aszvj5s2b2bVrF48//jjHjx93Zjt37hyNGzdmzZo1LnXbGzZsGAUKFCAyMpKGDRuye/duxo0b55w2mvq9APO9PnbsGPXq1eP8+fPs2LEDgDx58gCwbNkyzp8/75b9B9MwpXnz5sTExNzwNl5++WXy5cuHj4+P8yziiRMnWLlyJW3btnXu07Fjxzh+/DjNmjVj165dHDhwAIDAwEBnI43k5GSOHz9OaGgo5cqVY+PGjener0OHDmm+ZwDh4eFs27aNXbt23fB+iIhci6YRiojcJA6HI926AQMG8OWXX9KtWzfCw8PTXJN0LalFytmzZ52/UAO0adOGypUrA/Dcc8+lu37nes6ePZtm+6mGDh1KvXr18PX1JX/+/FSoUAE/v2v/CEndxj8LtytlVJA98sgjDBo0iAMHDlCkSBG++eYbjhw5wiOPPOIcs2vXLk6fPk3BggUz3O6RI0fSPI+Kirpm1sy49dZb0zzPmzcvgPNasdRf3Dt06HDVbZw+fdr5dVfTtWtXHn74YXx8fAgPD6dSpUoEBgY6X9+2bRuDBw9m5cqVzmL1yu2D2e++ffvy2muvMX/+fOrVq8f999/Pf/7znzT/bjJj4cKFfP/992zduvWGvj5VWFgY5cqV49ixYxQqVAiA33//HcuyGDJkCEOGDMnw644cOUKRIkVISUlh8uTJTJs2jT179qT5t57R9NaM/g2MHDmSBx54gLJly1K5cmXuuecennjiCapWrfqv9k1EJJWKLRERNwgKCgLgwoULGb5+/vx555grhYaG8tVXX1G/fn3atWtHWFiYS2cLypcvD8DWrVupW7euc32xYsUoVqwYYIqA69336J+2bt1KwYIFCQsLS7O+SpUqNGnSJFPbqlChAgC//PIL1apVy3DML7/8AkDFihWd6x555BEGDhzI4sWL6d27N4sWLSJPnjzcc889zjEpKSkULFiQ+fPnZ7jdAgUKpHn+zzMa/4avr2+G6y3LcmYDGD9+/FX3+59nJDNSpkyZq37PT506RYMGDQgLC2PkyJGUKlWKoKAgNm7cyIABA9KcOZswYQJPPvkkn3zyCcuXL6dnz56MGTOG9evXU7Ro0evm+Kfnn3+ehx9+mICAAPbu3evMA/DXX39x6dKldNdLuSo1d79+/a56JrJ06dKAaVc/ZMgQnnrqKUaNGkVERAQ+Pj707t07wzOHGf0bqF+/Prt373Z+b2bNmsXEiROZMWMGnTt3vqF9EBG5kootERE3KF68OGAaMaQWO6nOnz/PX3/9ddUiKl++fCxfvpy6devy4IMPEhcXR3R09DXfr2XLlowdO5b58+enKbb+jXXr1rF79263Nd1o3rw5vr6+vPfee1dtkvHuu+/i5+eXppCKioqidu3aLFy4kNjYWD766CNatWqV5qxOqVKl+Prrr6lbt65bCynI+AxkZqQ2lwgLC8t0geqqb775huPHj/PRRx9Rv3595/qrdYesUqUKVapUYfDgwXz//ffUrVuXGTNmODtfZmaf//rrLxYsWMCCBQvSvVajRg1uu+22G74XWMmSJQHw9/e/7vduyZIlNGrUiNmzZ6dZf+rUKfLnz+/ye0ZERNCxY0c6duzI2bNnqV+/PsOHD1exJSJuoWu2RETcoHHjxgQEBDB9+vR0n6rPnDmTy5cv07x586t+fZEiRYiLiyNXrly0aNGCLVu2XPP96tatS9OmTZk5cyaffPJJhmNSz7S44s8//+TJJ58kICCA559/3uWvu5ZixYrRsWNHvv76a6ZPn57u9RkzZrBy5Uo6deqU7gzLI488wvr163n77bc5duxYmimEAG3btiU5OTnDLniXL192nmm5Ebly5XJOw7sRNWvWpFSpUrz66qvOaZlXOnr06A1vO1Xq2bUr/44vXbrEtGnT0oxLSEjg8uXLadZVqVIFHx8fEhMTnety5crl8vfs448/TvdI/ft59913nddf3YiCBQvSsGFD3nzzTQ4dOpTu9Su/d76+vun+jS9evNh5TZcrjh8/nuZ5aGgopUuXTvO9ERH5N3RmS0TEDQoWLMjQoUMZPHgw9evX5/777yckJITvv/+e999/n5iYGO67775rbqNMmTIsW7aMhg0b0qxZM9auXev8pD8j8+bN45577qFVq1Y0b96cJk2akDdvXuLj4/n6669Zs2ZNhgXexo0bmTdvHikpKZw6dYqffvqJDz/8EIfDwXvvvefW61UmTpzIjh076N69O0uXLnWewVq2bBmffPIJDRo0YMKECem+rm3btvTr149+/foRERGR7ixHgwYN6NatG2PGjGHz5s3ExMTg7+/Prl27WLx4MZMnT3b5+rd/qlmzJgsXLqRv377cfvvthIaGXvfv7ko+Pj7MmjWL5s2bU6lSJTp27EiRIkU4cOAAq1atIiwszNm6/0bdeeed5M2blw4dOtCzZ0/n390/i4+VK1cSGxvLww8/TNmyZbl8+TLvvfcevr6+tGnTJs0+f/3117z22msULlyYqKgo7rjjjgzfu1WrVunWpZ7Jat68eabOKmVk6tSp3HXXXVSpUoUuXbpQsmRJDh8+zLp169i/f7/zPlotW7Zk5MiRdOzYkTvvvJMtW7Ywf/78ax4z/1SxYkUaNmxIzZo1iYiI4H//+x9LlizJ8L5wIiI3xM5WiCIi2c28efOsOnXqWLly5bICAwOt8uXLWyNGjEjTxtqyrt2G/dtvv7WCg4OtqKgo68CBA9d8vwsXLliTJk2yoqOjrbCwMMvPz8+KjIy0WrZsac2fP9+6fPlyuvdMffj5+VkRERHWHXfcYQ0cOND6888/020/tW329VqHX0tiYqI1ceJEq2bNmlauXLmskJAQq0aNGtakSZOsS5cuXfXr6tatawFW586drzpm5syZVs2aNa3g4GArd+7cVpUqVaz+/ftbBw8edI4pXrx4ptp7nz171nr88cet8PBwZ3t+y7r69yL1+zpnzpw06zdt2mQ9+OCDVr58+azAwECrePHiVtu2ba0VK1Zc8/1dadFvWZb13XffWXXq1LGCg4OtwoULW/3797eWLVtmAdaqVassy7KsP/74w3rqqaesUqVKWUFBQVZERITVqFEj6+uvv06zrR07dlj169e3goODLSBTbeAt68Zav1uWZTVo0MCqVKlSuvW7d++22rdvb0VGRlr+/v5WkSJFrJYtW1pLlixxjrl48aL13HPPWbfccosVHBxs1a1b11q3bp3VoEGDNLdZuNa/4ZdeesmqXbu2FR4ebgUHB1vly5e3Xn755Wv+uxQRyQyHZWVinomIiIiIiIi4RNdsiYiIiIiIeICKLREREREREQ9QsSUiIiIiIuIBKrZEREREREQ8QMWWiIiIiIiIB6jYEhERERER8QDd1NgFKSkpHDx4kNy5c+NwOOyOIyIiIiIiNrEsizNnzlC4cGF8fK597krFlgsOHjxIsWLF7I4hIiIiIiJe4q+//qJo0aLXHKNiywW5c+cGzDc0LCzM5jSQlJTE8uXLiYmJwd/f3+44IpIBHaciWYOOVZGswZuO1YSEBIoVK+asEa5FxZYLUqcOhoWFeU2xFRISQlhYmO3/2EQkYzpORbIGHasiWYM3HquuXF6kBhkiIiIiIiIeoGJLRERERETEA1RsiYiIiIiIeICKLREREREREQ9QsSUiIiIiIuIBKrZEREREREQ8QMWWiIiIiIiIB6jYEhERERER8QAVWyIiIiIiIh6gYktERERERLxWcjKsXu1gzZoirF7tIDnZ7kSuU7ElIiIiIiJe6aOPoEQJaNrUj9deq0XTpn6UKGHWZwUqtkRERERExOt89BE89BDs3592/YEDZn1WKLhUbImIiIiIiFdJToZevcCy0r+Wuq53b7x+SqGKLRERERER8Srffpv+jNaVLAv++suM82YqtkRERERExKscOuTecXZRsSUiIiIiIl7lllvcO84uKrZERERERMSr1KsHRYte/XWHA4oVM+O8mYotERERERHxKr6+0KFDxq85HObPSZPMOG+mYktERERERLzKqVMwZ45ZDg1N+1rRorBkCTz44E2PlWl+dgcQERERERG5Up8+cPAglCkDGzbADz9c5quvNtO8eTUaNfLz+jNaqVRsiYiIiIiI1/j8c5g710wXnDsXcueGBg0szp07QIMGt2WZQgs0jVBERERERLzEiRPQtatZ7tsX7rzT3jz/lootERERERHxCr16mXtnlSsHo0bZnebfU7ElIiIiIiK2++QTmDcPfHzM9MHgYLsT/XsqtkRERERExFbHj0O3bmb5+eehTh1787iLii0REREREbHVs8/C4cNQsSIMH253GvdRsSUiIiIiIrb58EN4/31zg+K5cyEoyO5E7qNiS0REREREbHH0KDzzjFkeMABuv93ePO6mYktERERERGwRG2sKrsqVYehQu9O4n63F1vTp06latSphYWGEhYURHR3NV1995Xx95syZNGzYkLCwMBwOB6dOnUq3jRMnTtCuXTvCwsIIDw+nU6dOnD17Ns2YX375hXr16hEUFESxYsV45ZVXPL1rIiIiIiJyDYsWmYevL7zzDgQG2p3I/WwttooWLcrYsWPZsGED//vf/7j77rt54IEH2LZtGwDnz5/nnnvuYdCgQVfdRrt27di2bRtxcXF8/vnnrFmzhq6pd0IDEhISiImJoXjx4mzYsIHx48czfPhwZs6c6fH9ExERERGR9A4fhu7dzfKgQVCjhr15PMXPzje/77770jx/+eWXmT59OuvXr6dSpUr07t0bgG+++SbDr9++fTtLly7lp59+olatWgC8/vrr3Hvvvbz66qsULlyY+fPnc+nSJd5++20CAgKoVKkSmzdv5rXXXktTlImIiIiIiOdZlim0jh+HqlVh8GC7E3mOrcXWlZKTk1m8eDHnzp0jOjrapa9Zt24d4eHhzkILoEmTJvj4+PDDDz/Q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tkREREREcpDz5830QcuC9u3hvvvsTpR9qdgSEREREclBBg+GXbugcGGYNMnuNNmbii0RERERkRxi7dq/C6y33oK8eW2Nk+2p2BIRERERyQHOnYOOHc30waeegnvvtTtR9qdiS0REREQkBxg0CH7/HYoWhddesztNzqBiS0REREQkm1u9+u/27rNmQZ489ubJKVRsiYiIiIhkY2fPmmmDAF26QLNm9ubJSVRsiYiIiIhkYy+8AH/8Abfe+ve9teTmULElIiIiIpJNrVwJU6ea5dmzISzM3jw5jYotEREREZFs6MyZv6cPPv00NGlib56cSMWWiIiIiEg29Pzz8OefUKIEvPKK3WlypkwXW0uXLmXt2rXO51OnTqVatWo8/vjjnDx50q3hREREREQk8+Li4M03zfLbb0Pu3PbmyakyXWw9//zzJCQkALBlyxaee+457r33Xvbs2UPfvn3dHlBERERERFyXkACdOpnl2Fho1MjePDmZX2a/YM+ePVSsWBGADz/8kJYtWzJ69Gg2btzIvboNtYiIiIiIrZ57Dv76C0qWhLFj7U6Ts2X6zFZAQADnz58H4OuvvyYmJgaAiIgI5xkvERERERG5+ZYuNTctBpgzB3LlsjdPTpfpM1t169alb9++1K1blx9//JGFCxcC8Ntvv1G0aFG3BxQRERERkes7dQo6dzbLvXpB/fq2xhFu4MzW1KlT8ff3Z8mSJUyfPp0iRYoA8NVXX3HPPfe4PaCIiIiIiFxf375w4ACULg2jR9udRiCTZ7YuX77MN998w1tvvUVkZGSa1yZOnOjWYCIiIiIi4povvjDTBh0OmDsXQkLsTiSQyTNbfn5+PP300yQmJnoqj4iIiIiIZMLJk9Cli1nu0wfq1rU3j/wt09MIa9euzaZNmzyRRUREREREMql3bzh0CMqWhZdesjuNXCnTDTK6d+/Oc889x/79+6lZsya5/tHipGrVqm4LJyIiIiIiV/fpp/Duu+DjA++8A8HBdieSK2W62Hr00UcB6Nmzp3Odw+HAsiwcDgfJycnuSyciIiIiIhk6fhy6dTPL/fpBnTr25pH0buimxiIiIiIiYq+ePSE+HipUgBEj7E4jGcl0sVW8eHFP5BARERERERd9/DEsWGCmD86dC0FBdieSjGS62Er166+/sm/fPi5dupRm/f333/+vQ4mIiIiISMaOHYOnnzbLAwZA7dr25pGry3Sx9ccff9C6dWu2bNnivFYLzHVbgK7ZEhERERHxoNhYOHIEKlWCYcPsTiPXkunW77169SIqKoojR44QEhLCtm3bWLNmDbVq1eKbb77xQEQREREREQFYvBgWLgRfX9N9MDDQ7kRyLZk+s7Vu3TpWrlxJ/vz58fHxwcfHh7vuuosxY8bQs2dP3YNLRERERMQDjhyB7t3N8sCBULOmvXnk+jJ9Zis5OZncuXMDkD9/fg4ePAiYxhk7d+50bzoREREREcGyTKF17BhUrQpDhtidSFyR6TNblStX5ueffyYqKoo77riDV155hYCAAGbOnEnJkiU9kVFEREREJEdbtAg+/BD8/Ez3wYAAuxOJKzJdbA0ePJhz584BMHLkSFq2bEm9evXIly8fCxcudHtAEREREZGcLD7+7+mDgwdD9er25hHXZbrYatasmXO5dOnS7NixgxMnTpA3b15nR0IREREREfn3LMu0eT9xAqpVg0GD7E4kmXHD99m6UkREhDs2IyIiIiIiV1iwAD75BPz9TfdBf3+7E0lmuFRsPfjggy5v8KOPPrrhMCIiIiIiYhw6BM8+a5aHDjWNMSRrcakbYZ48eVx+ZMb06dOpWrUqYWFhhIWFER0dzVdffeV8/eLFi/To0YN8+fIRGhpKmzZtOHz4cJpt7Nu3jxYtWhASEkLBggV5/vnnuXz5cpox33zzDTVq1CAwMJDSpUszd+7cTOUUEREREbmZLAu6dYOTJ02L9wED7E4kN8KlM1tz5szxyJsXLVqUsWPHUqZMGSzL4p133uGBBx5g06ZNVKpUiT59+vDFF1+wePFi8uTJQ2xsLA8++CDfffcdYNrQt2jRgsjISL7//nsOHTpE+/bt8ff3Z/To0QDs2bOHFi1a8PTTTzN//nxWrFhB586dueWWW9JcfyYiIiIi4i3eew8++8x0HZw7V9MHsyq3XLN1o+677740z19++WWmT5/O+vXrKVq0KLNnz2bBggXcfffdgCn6KlSowPr166lTpw7Lly/n119/5euvv6ZQoUJUq1aNUaNGMWDAAIYPH05AQAAzZswgKiqKCRMmAFChQgXWrl3LxIkTVWyJiIiIiNc5cAB69jTLw4dD5cq2xpF/waViq3r16i53Gty4ceMNBUlOTmbx4sWcO3eO6OhoNmzYQFJSEk2aNHGOKV++PLfeeivr1q2jTp06rFu3jipVqlCoUCHnmGbNmvHMM8+wbds2qlevzrp169JsI3VM7969r5olMTGRxMRE5/OEhAQAkpKSSEpKuqH9c6fUDN6QRUQypuNUJGvQsSrexrKgSxdfTp/2oVatFHr3Tkb/PL3rWM1MBpeKrVatWt1oluvasmUL0dHRXLx4kdDQUD7++GMqVqzI5s2bCQgIIDw8PM34QoUKER8fD0B8fHyaQiv19dTXrjUmISGBCxcuEBwcnC7TmDFjGDFiRLr1y5cvJyQk5Ib31d3i4uLsjiAi16HjVCRr0LEq3mLFilv56qvq+Psn06HDapYvP2N3JK/iDcfq+fPnXR7rUrE1bNiwGw5zPeXKlWPz5s2cPn2aJUuW0KFDB1avXu2x93PFwIED6du3r/N5QkICxYoVIyYmhrCwMBuTGUlJScTFxdG0aVP8NYFXxCvpOBXJGnSsijf56y9o3978ej5yJHTrVs/mRN7Dm47V1Flvrrjha7Y2bNjA9u3bAahUqRLVb/BW1gEBAZQuXRqAmjVr8tNPPzF58mQeeeQRLl26xKlTp9Kc3Tp8+DCRkZEAREZG8uOPP6bZXmq3wivH/LOD4eHDhwkLC8vwrBZAYGAggYGB6db7+/vb/pd7JW/LIyLp6TgVyRp0rIrdLAu6d4eEBKhTB55/3hdfX1+7Y3kdbzhWM/P+LrV+v9KRI0e4++67uf322+nZsyc9e/akZs2aNG7cmKNHj2Z2c+mkpKSQmJhIzZo18ff3Z8WKFc7Xdu7cyb59+4iOjgYgOjqaLVu2cOTIEeeYuLg4wsLCqFixonPMldtIHZO6DRERERERu82eDcuWQVCQ6T6oOit7yHSx9eyzz3LmzBm2bdvGiRMnOHHiBFu3biUhIYGeqW1TXDRw4EDWrFnD3r172bJlCwMHDuSbb76hXbt25MmTh06dOtG3b19WrVrFhg0b6NixI9HR0dSpUweAmJgYKlasyBNPPMHPP//MsmXLGDx4MD169HCemXr66af5448/6N+/Pzt27GDatGksWrSIPn36ZHbXRURERETc7s8/IfUKlpdfhnLl7M0j7pPpaYRLly7l66+/pkKFCs51FStWZOrUqcTExGRqW0eOHKF9+/YcOnSIPHnyULVqVZYtW0bTpk0BmDhxIj4+PrRp04bExESaNWvGtGnTnF/v6+vL559/zjPPPEN0dDS5cuWiQ4cOjBw50jkmKiqKL774gj59+jB58mSKFi3KrFmz1PZdRERERGxnWdCpE5w5A3XrQq9edicSd8p0sZWSkpLhPEV/f39SUlIyta3Zs2df8/WgoCCmTp3K1KlTrzqmePHifPnll9fcTsOGDdm0aVOmsomIiIiIeNqbb8KKFRAcDHPmaPpgdpPpaYR33303vXr14uDBg851Bw4coE+fPjRu3Nit4UREREREsqs9e6BfP7M8ZgyUKWNvHnG/TBdbb7zxBgkJCZQoUYJSpUpRqlQpoqKiSEhI4PXXX/dERhERERGRbCUlxUwfPHcO6tWDZ5+1O5F4QqanERYrVoyNGzfy9ddfs2PHDgAqVKhAkyZN3B5ORERERCQ7mj4dVq2CkBAzfdAn06dAJCu4oftsORwOmjZt6mxkISIiIiIirtm9G/r3N8uvvAKlStmbRzwnU8VWSkoKc+fO5aOPPmLv3r04HA6ioqJ46KGHeOKJJ3A4HJ7KKSIiIiKS5aWkwFNPwfnz0KgRPPOM3YnEk1w+YWlZFvfffz+dO3fmwIEDVKlShUqVKvHnn3/y5JNP0rp1a0/mFBERERHJ8t54A9asgVy5zI2MNX0we3P5zNbcuXNZs2YNK1asoFGjRmleW7lyJa1ateLdd9+lffv2bg8pIiIiIpLV7doFL7xgll99FaKi7M0jnudyLf3+++8zaNCgdIUWmHbwL7zwAvPnz3drOBERERGR7CA5GTp2hAsXoEkT6NbN7kRyM7hcbP3yyy/cc889V329efPm/Pzzz24JJSIiIiKSnUyeDN99B7lzw6xZoFYHOYPLxdaJEycoVKjQVV8vVKgQJ0+edEsoEREREZHsYudOePFFszxhAhQvbm8euXlcLraSk5Px87v6JV6+vr5cvnzZLaFERERERLKD5GR48km4eBFiYqBzZ7sTyc3kcoMMy7J48sknCQwMzPD1xMREt4USEREREckOXnsN1q+HsDBNH8yJXC62OnTocN0x6kQoIiIiImL8+isMGWKWJ02CYsVsjSM2cLnYmjNnjidziIiIiIhkG5cvm+mDiYlw771mWXIe3UZNRERERMTNXn0VfvoJ8uSBmTM1fTCnUrElIiIiIuJGW7fCsGFmecoUKFLE3jxiHxVbIiIiIiJukpRkpgxeugT33QdPPGF3IrGTii0RERERETcZNw42bIC8eeHNNzV9MKdTsSUiIiIi4ga//AIjR5rl11+HW26xN4/Yz23F1qFDh9i3b5+7NiciIiIikmUkJUGHDubPVq3g8cftTiTewG3F1t13301UVJS7NiciIiIikmWMHg2bN0O+fDBjhqYPiuHyfbau59133+X8+fPu2pyIiIiISJawaRO89JJZnjoVChWyN494D7cVW7fffru7NiUiIiIikiVcumS6D16+DG3aQNu2dicSb/Kviq2LFy+ycOFCzp07R9OmTSlTpoy7comIiIiIeL2XXjKNMfLnh2nTNH1Q0nK52Orbty9JSUm8/vrrAFy6dIno6Gi2bdtGSEgI/fv3Jy4ujujoaI+FFRERERHxFhs2mGu1wBRaBQvam0e8j8sNMpYvX07Tpk2dz+fPn8+ff/7Jrl27OHnyJA8//DAvpU5WFRERERHJxhITTffB5GR45BF4+GG7E4k3crnY2rdvHxUrVnQ+X758OQ899BDFixfH4XDQq1cvNm3a5JGQIiIiIiLeZMQI2LbNnM164w2704i3crnY8vHxwbIs5/P169dTp04d5/Pw8HBOnjzp3nQiIiIiIl7mp59g3DizPGOGuV5LJCMuF1sVKlTgs88+A2Dbtm3s27ePRo0aOV//888/KaQ+lyIiIiKSjV28aKYPpqSYGxe3bm13IvFmLjfI6N+/P48++ihffPEF27Zt4957701zE+Mvv/yS2rVreySkiIiIiIg3GDYMtm+HyEiYMsXuNOLtXD6z1bp1a7788kuqVq1Knz59WLhwYZrXQ0JC6N69u9sDioiIiIh4g3Xr4NVXzfKbb0K+fPbmEe+XqftsNW7cmMaNG2f42rBhw9wSSERERETE21y4YG5enJICTzwB999vdyLJClw+syUiIiIiklMNGQK//Qa33AKTJ9udRrIKtxVbFSpUwNfX112bExERERHxCt99B6+9Zpbfegvy5rU3j2QdmZpGeC1jxozh9OnT7tqciIiIiIjtzp830wctCzp2hBYt7E4kWYnbiq1WrVq5a1MiIiIiIl5h0CD4/XcoWvTvs1sirtI1WyIiIiIiGViz5u/27rNmQXi4rXEkC3L5zFbevHlxOBzp1ufJk4eyZcvSr18/mjZt6tZwIiIiIiJ2OHfOTBu0LOjcGZo1szuRZEUuF1uTJk3KcP2pU6fYsGEDLVu2ZMmSJdx3333uyiYiIiIiYosXXoA//oBixWDCBLvTSFblcrHVoUOHa75erVo1xowZo2JLRERERLK0VavgjTfM8ttvQ1iYvXkk63LbNVstW7Zkx44d7tqciIiIiMhNd/YsPPWUWe7WDZo0sTePZG1uK7YSExMJCAhw1+ZERERERG66/v1h714oXhzGj7c7jWR1biu2Zs+eTbVq1dy1ORERERGRm+rrr2H6dLP89tuQO7e9eSTrc/marb59+2a4/vTp02zcuJHffvuNNWvWuC2YiIiIiMjNkpAAnTqZ5R494O677c0j2YPLxdamTZsyXB8WFkbTpk356KOPiIqKclswEREREZGbpV8/2LcPSpaEsWPtTiPZhcvF1qpVqzyZQ0RERETEFsuXw1tvmeW334bQUHvzSPbhtmu2RERERESymtOn/54+2LMnNGhgbx7JXlRsiYiIiEiO1bcv7N8PpUvD6NF2p5HsRsWWiIiIiORIX35ppg06HDBnDuTKZXciyW5UbImIiIhIjnPyJHTpYpZ794a77rI1jmRTLhVbNWrU4OTJkwCMHDmS8+fPezSUiIiIiIgn9ekDBw9C2bLw0kt2p5HsyqVia/v27Zw7dw6AESNGcPbsWY+GEhERERHxlM8+g3feAR8fmDsXQkLsTiTZlUut36tVq0bHjh256667sCyLV199ldCr9MQcOnSoWwOKiIiIiLjLiRPQtatZfu45iI62N49kby4VW3PnzmXYsGF8/vnnOBwOvvrqK/z80n+pw+FQsSUiIiIiXqtnT4iPh/LlYeRIu9NIdudSsVWuXDk++OADAHx8fFixYgUFCxb0aDAREREREXf6739h/nwzffCddyAoyO5Ekt25VGxdKSUlxRM5REREREQ85tgx6NbNLPfvD7Vr25tHcoZMF1sAu3fvZtKkSWzfvh2AihUr0qtXL0qVKuXWcCIiIiIi7vDss3DkCFSqBMOH251GcopM32dr2bJlVKxYkR9//JGqVatStWpVfvjhBypVqkRcXJwnMoqIiIiI3LAPP4QPPgBfX9N9MDDQ7kSSU2T6zNYLL7xAnz59GDt2bLr1AwYMoGnTpm4LJyIiIiLybxw9Cs88Y5ZfeAFq1bI3j+QsmT6ztX37djp16pRu/VNPPcWvv/7qllAiIiIiIu7Qo4cpuKpUgSFD7E4jOU2mi60CBQqwefPmdOs3b96sDoUiIiIi4jUWLYLFi8HPT9MHxR6ZnkbYpUsXunbtyh9//MGdd94JwHfffce4cePo27ev2wOKiIiIiGTW4cPQvbtZfvFFqFHD3jySM2W62BoyZAi5c+dmwoQJDBw4EIDChQszfPhwevbs6faAIiIiIiKZYVnmOq3jx6FaNRg0yO5EklNluthyOBz06dOHPn36cObMGQBy587t9mAiIiIiIjfigw/g44//nj4YEGB3Ismpbug+W6lUZImIiIiINzl0yDTFABg6FG67zd48krNlukGGiIiIiIg3sizo1g1OnjTXaL3wgt2JJKdTsSUiIiIi2cK8efDZZ+DvD++8Y/4UsZOKLRERERHJ8g4ehNRebcOHQ+XKtsYRAdxUbJ06dcodmxERERERyTTLgq5d4dQpqFUL+ve3O5GIkelia9y4cSxcuND5vG3btuTLl48iRYrw888/uzWciIiIiMj1vPMOfPGF6Tr4zjumC6GIN8h0sTVjxgyKFSsGQFxcHHFxcXz11Vc0b96c559/3u0BRURERESuZv9+6NXLLI8aBRUr2ptH5EqZrvvj4+Odxdbnn39O27ZtiYmJoUSJEtxxxx1uDygiIiIikhHLgi5dICEB6tSB556zO5FIWpk+s5U3b17++usvAJYuXUqTJk0AsCyL5ORk96YTEREREbmKt9+GpUshMBDmzAFfX7sTiaSV6WLrwQcf5PHHH6dp06YcP36c5s2bA7Bp0yZKly6dqW2NGTOG22+/ndy5c1OwYEFatWrFzp0704zZvXs3rVu3pkCBAoSFhdG2bVsOHz6cZsyJEydo164dYWFhhIeH06lTJ86ePZtmzC+//EK9evUICgqiWLFivPLKK5nddRERERHxEvv2QZ8+Zvnll6F8eXvziGQk08XWxIkTiY2NpWLFisTFxREaGgrAoUOH6N69e6a2tXr1anr06MH69euJi4sjKSmJmJgYzp07B8C5c+eIiYnB4XCwcuVKvvvuOy5dusR9991HSkqKczvt2rVj27ZtxMXF8fnnn7NmzRq6du3qfD0hIYGYmBiKFy/Ohg0bGD9+PMOHD2fmzJmZ3X0RERERsZllQadOcOYM3Hkn9O5tdyKRjGX6mi1/f3/69euXbn2f1I8WMmHp0qVpns+dO5eCBQuyYcMG6tevz3fffcfevXvZtGkTYWFhALzzzjvkzZuXlStX0qRJE7Zv387SpUv56aefqFWrFgCvv/469957L6+++iqFCxdm/vz5XLp0ibfffpuAgAAqVarE5s2bee2119IUZSIiIiLi/WbOhK+/huBgTR8U73ZDjTF37drFqlWrOHLkSJozTABDhw694TCnT58GICIiAoDExEQcDgeBgYHOMUFBQfj4+LB27VqaNGnCunXrCA8PdxZaAE2aNMHHx4cffviB1q1bs27dOurXr09AQIBzTLNmzRg3bhwnT54kb968aXIkJiaSmJjofJ6QkABAUlISSUlJN7x/7pKawRuyiEjGdJyKZA06VrOevXuhXz8/wMGoUclERaWgv77sz5uO1cxkyHSx9dZbb/HMM8+QP39+IiMjcTgcztccDscNF1spKSn07t2bunXrUvn/b/ldp04dcuXKxYABAxg9ejSWZfHCCy+QnJzMoUOHANMdsWDBgml3ys+PiIgI4uPjnWOioqLSjClUqJDztX8WW2PGjGHEiBHpMi5fvpyQkJAb2j9PiIuLszuCiFyHjlORrEHHataQkgLDht3J2bMFqFjxGCVLfseXX9qdSm4mbzhWz58/7/LYTBdbL730Ei+//DIDBgzI7JdeU48ePdi6dStr1651ritQoACLFy/mmWeeYcqUKfj4+PDYY49Ro0YNfHwyfbmZywYOHEjfvn2dzxMSEihWrBgxMTHO6Yx2SkpKIi4ujqZNm+Lv7293HBHJgI5TkaxBx2rWMmOGD1u2+BISYrFkSR5Kl77X7khyk3jTsZo6680VmS62Tp48ycMPP5zZL7um2NhYZ2OLokWLpnktJiaG3bt3c+zYMfz8/AgPDycyMpKSJUsCEBkZyZEjR9J8zeXLlzlx4gSRkZHOMf/sYJj6PHXMlQIDA9NMXUzl7+9v+1/ulbwtj4ikp+NUJGvQser9/vgDXnjBLI8b56BCBf195UTecKxm5v0zfXro4YcfZvny5Zn9sgxZlkVsbCwff/wxK1euTDfV70r58+cnPDyclStXcuTIEe6//34AoqOjOXXqFBs2bHCOXblyJSkpKc6bLEdHR7NmzZo08yvj4uIoV65cuimEIiIiIuJdUlLgqafg/Hlo2BAy2QBbxDaZPrNVunRphgwZwvr166lSpUq6yq5nz54ub6tHjx4sWLCATz75hNy5czuvscqTJw/BwcEAzJkzhwoVKlCgQAHWrVtHr1696NOnD+XKlQOgQoUK3HPPPXTp0oUZM2aQlJREbGwsjz76KIULFwbg8ccfZ8SIEXTq1IkBAwawdetWJk+ezMSJEzO7+yIiIiJyk02dCqtXQ65c5kbGHryaRMStMl1szZw5k9DQUFavXs3q1avTvOZwODJVbE2fPh2Ahg0bplk/Z84cnnzySQB27tzJwIEDOXHiBCVKlODFF19M12Z+/vz5xMbG0rhxY3x8fGjTpg1Tpkxxvp4nTx6WL19Ojx49qFmzJvnz52fo0KFq+y4iIiLi5X7/HVJbBYwfD9eYCCXidTJdbO3Zs8dtb25Z1nXHjB07lrFjx15zTEREBAsWLLjmmKpVq/Ltt99mKp+IiIiI2CclBTp2hAsXoHFj6NbN7kQimfOvTsJaluVSwSQiIiIikllTpsDatRAaCrNna/qgZD039E/23XffpUqVKgQHBxMcHEzVqlV577333J1NRERERHKo336DgQPN8oQJULy4vXlEbkSmpxG+9tprDBkyhNjYWOrWrQvA2rVrefrppzl27Fi666lERERERDIjORmefBIuXoSmTaFLF7sTidyYTBdbr7/+OtOnT6d9+/bOdffffz+VKlVi+PDhKrY8LDkZVq92sGZNEXLlctCoEfj62p1KRERExH0mToR16yAszEwfdDjsTiRyYzI9jfDQoUPceeed6dbfeeedHDp0yC2hJGMffQQlSkDTpn689lotmjb1o0QJs15EREQkO9i+HQYPNssTJ0KxYvbmEfk3Ml1slS5dmkWLFqVbv3DhQsqUKeOWUJLeRx/BQw/B/v1p1x84YNar4BIREZGs7vJlM30wMRGaNzedCEWyskxPIxwxYgSPPPIIa9ascV6z9d1337FixYoMizD595KToVcvyKjxo2WZU+u9e8MDD2hKoYiIiGRdEybAjz9Cnjwwc6amD0rWl+liq02bNvzwww9MnDiR//73vwBUqFCBH3/8kerVq7s7nwDffpv+jNaVLAv++guqV4eyZaFQIShY0Pz5z+XQUP3HJSIiIt5n2zYYOtQsT54MRYvam0fEHTJdbAHUrFmTefPmuTuLXIWrl8Jt2WIe1xIUdO1i7MrliAjdz0JEREQ8L3X64KVL0LIlXNGHTSRLc6nYSkhIICwszLl8LanjxH1uucW1ccOGQf78cPgwHDmS9s/Dh+HcOdNC9c8/zeN6fH2hQIHrF2YFC5pHQMC/208RERHJmV55Bf73P8ibF958U7NwJPtwqdjKmzcvhw4domDBgoSHh+PI4AiwLAuHw0FycrLbQ+Z09eqZU+kHDmR83ZbDYV4fMuTa12ydO5dxEZbRuhMnzLVi8fHm4Yq8eV0rzFKnM4qIiIhs2QLDh5vlKVOgcGFb44i4lUvF1sqVK4mIiABg1apVHg0k6fn6mrnLDz1kCqsrC67UunfSpOs3x8iVC6KizON6kpLg6FHXCrMjR0xhdvKkeezcef3th4S4XpjlzavpjCIiItlRUhJ06GD+fOABaNfO7kQi7uVSsdWgQYMMl+XmefBBWLLEdCW8sllG0aKm0HrwQfe+n7+/+WTJlU+XUlJMkXWtYix1+fBhuHABzp+HvXvN43r8/Mx0RlcKswIFTHYRERHxfmPGwKZN5jrxGTM0fVCyH5eKrV9++cXlDVatWvWGw8i1Pfig+dRn1arLfPXVZpo3r0ajRn62t3v38YF8+cyjYsXrjz971rXC7MgRU8RdvmyahLjaKCQi4urF2D+XQ0L+3b6LiIjIjdm8GUaNMstTp0JkpK1xRDzCpWKrWrVqOBwOrIwuGLqCrtnyPF9faNDA4ty5AzRocJvthdaNCA01j1Klrj/20qW/pzNerzA7etRMZzxxwjy2b7/+9nPlcr0wCw/XJ24iIiLucOmS6T54+bL5MPmRR+xOJOIZLhVbe/bs8XQOkQwFBECRIuZxPSkppshypTA7fNh0Zjx3Dv74wzyux98/fUF2tcIsf34z/VFERETSe/ll+Pln8/Ny+nR9mCnZl0u/DhYvXtzTOUT+NR8f8592/vxQqdK1x1rW39MZXWkCcvq0uXj3wAHzuB6Hw0yrdOV+ZgULQnCwe74HIiIi3m7jRlNsAUybZn4OimRXLhVbn376qcsbvP/++284jMjN4nBA7tzmUbr09ccnJrreNv/YMXOW7dgx8/j11+tvP3du1wuzPHn0CaCIiGRNiYmm+2ByMrRtCw8/bHciEc9yqdhq1aqVSxvTNVuSXQUGQrFi5nE9yclw/Lhrhdnhw2be+pkz5rF79/W3HxDgemGWP//1bwkgIiJys4waBVu3mp9RU6fanUbE81wqtlJSUjydQyTb8PU1P0RcmRZhWZCQ4Hp3xoQEU5zt35/2FgBX43CYgsuVtvkFC0JQ0L/ffxERkYz89BOMHWuWp083P59Esjtdwi9iI4fDTAvMkwfKlr3++AsXTNHlSmF27Jgp5o4eNY+tW6+//bAw1wqzQoXM1EdNZxQREVdcvGi6DyYnw2OPuf/+oCLeyqVia8qUKXTt2pWgoCCmTJlyzbE9e/Z0SzARSS84GIoXN4/ruXzZFFyuFGaHD5sGIAkJ5rFr1/W3HxR07a6MV66LiNB0RhGRnGz4cHMNc6FC8PrrdqcRuXlcKrYmTpxIu3btCAoKYuLEiVcd53A4VGyJeAk/P3ODSFduEmlZpuOiq23zz541n1Lu22ce1+PjAwUKuNY2v0ABc42ciIhkD+vXw/jxZvnNN023XpGcItP32dI9t0SyH4fD3LQ5PBzKlbv++PPnXe/OePy46c6Y+twV4eGuFWYFC5obZGs6o4iId7pwATp2ND8H/vMfeOABuxOJ3Fy6ZktEMi0kBEqUMI/ruXzZXDPmSmF25IgZf+qUeezcef3tBwe7XphFRJizbJ6WnAyrVztYs6YIuXI5aNRI0yhFJGcaOhR27IBbboHJk+1OI3LzZarY2rVrF7/88gs1atQgKiqKL774gnHjxnHhwgVatWrFoEGDcOgjZhG5gp+f+SF7yy3XH2tZcPKk64XZuXPmU9O9e83jeq7sFHm9wqxgQfD3z/z+fvQR9OoF+/f7AbV47TUoWtT8kqELwkUkJ/n+e5gwwSzPnGk+8BLJaVwutj7++GPatm2Lj48PDoeDmTNn0q1bNxo2bEhYWBjDhw/Hz8+PAQMGeDKviGRjDof5YRwRARUqXH/8uXOut80/ccKccTp0yDxckTeva/czK1QIcuUyhdZDD5mi8UoHDpj1S5ao4BKRnOH8edN90LLMny1b2p1IxB4uF1svv/wy/fv356WXXmLu3Lk8/fTTjBkzht69ewMwc+ZMJk6cqGJLRG6aXLmgZEnzuJ5Ll8x0RlcKsyNHTGF28qR57Nhx/e0HB5v3+GehBWadwwG9e5vrFTSlUESyu8GDTWfbIkXgGr3VRLI9l4utnTt3snDhQhwOBx06dKBLly40adLE+XpMTIyz8BIR8TYBAeaHfpEi1x+bkmLOhLnaNv/CBfO4FsuCv/6Cb7+Fhg3dsksiIl7p229h0iSz/NZbpumRSE7lcrF17tw5cufODYCPjw/BwcGEhIQ4Xw8ODiYxMdH9CUVEbjIfH8if3zwqVrz2WMsy0xlnzYI+fa6/7T//dE9GERFvdO6c6T5oWdCpEzRvbnciEXu53JfL4XCkaX7xz+ciIjmRw2Haz1er5tr4fv3g7bfNNEURkexm4EDYvRuKFfu7OYZITuZysWVZFmXLliUiIoKIiAjOnj1L9erVnc/Lly/vyZwiIl6tXj3TdfBan0H5+sKxY+bT3ttugy++yPgaLxGRrGj1anj9dbM8ezbkyWNvHhFv4PI0wjlz5ngyh4hIlubra9q7P/SQKbiuLKJSC7B580xnwpdfhm3bTHeuBg3glVegdm17couIuMPZs2b6IEDXrtC0qb15RLyFy8VWhw4dPJlDRCTLe/BB097d3Gfr7/VFi5qLxVPbvj/1FIwda4qz1avhjjvg4Ydh9GgoXdqW6CIi/8qAAbBnDxQvDq++ancaEe/h8jRCERG5vgcfNDdYjou7TN++/yMu7jJ79qS9v1bevDBuHPz2G3ToYM58LV5s7i0WG2u6HIqIZBUrVsC0aWZ59mz4/35qIoKKLRERt/P1hQYNLOrXP0CDBtZV76t1660wdy5s3mw6dl2+DFOnQqlSMGqU6eolIuLNzpwx16ECdO8OjRvbm0fE26jYEhGxWdWq8OWXsHIl1Kplrn0YOtRMKXzzTVOEiYh4o+efN7e0iIoyZ+xFJC0VWyIiXqJRI/jhB/jgAyhZEuLj4emnoUoV+O9/1blQRLzL8uXmAyEwt7QIDbU3j4g3UrElIuJFfHzgkUdg+3bTQCN/ftixA1q3hrvugu+/tzuhiAicPg2dO5vlZ5+Fhg1tjSPitVzuRpgqOTmZuXPnsmLFCo4cOUJKSkqa11euXOm2cCIiOVVAAPTsCU8+aVrDv/aaKbTq1oVWrWDMGNDtDUXELs89B3/9Za4xHTPG7jQi3ivTZ7Z69epFr169SE5OpnLlytx2221pHiIi4j5hYfDSS7Brl/kU2cfHTCmsXBm6dYNDh+xOKCI5zdKlpuugwwFz5kCuXHYnEvFemT6z9cEHH7Bo0SLuvfdeT+QREZEMFCkCb70FffrAwIHw6acwc6a5UfJzz5mL1NVuWUQ87dSpv6cP9uoF9erZGkfE62X6zFZAQACldddNERFbVKwIn3wCa9ZAnTpw/rxpE1+qlGkbn5Rkd0IRyc769IEDB6BMGXj5ZbvTiHi/TBdbzz33HJMnT8ZSWywREdvUq2eu4VqyxPzSc/SouSFyxYrmBsn6L1pE3O3zz829AR0O82dIiN2JRLxfpqcRrl27llWrVvHVV19RqVIl/P3907z+0UcfuS2ciIhcncMBbdrA/ffDrFkwYgT8/ju0bQu1a5vGGg0a2J1SRLKDkyeha1ez/NxzcOed9uYRySoyfWYrPDyc1q1b06BBA/Lnz0+ePHnSPERE5Oby94dnnjGF1vDh5mL1H380rZhbtoStW+1OKCJZXa9epiFP+fIwcqTdaUSyjkyf2ZozZ44ncoiIyL8UGgrDhpkuhSNHmgYaX3wBX31lWsiPGAFFi9qdUkSymk8+gffeM91Q586F4GC7E4lkHbqpsYhINhMZCdOmwa+/mmmGKSnw9tvm2q6BA83NSEVEXHH8uPkAB0zX0zvusDePSFbj0pmtGjVqsGLFCvLmzUv16tVxOBxXHbtx40a3hRMRkRtXtqxpoLFuHfTvD2vXwtixpoX84MFm6mFgoN0pRcSbPfssHD5smu8MH253GpGsx6Vi64EHHiDw/38it2rVypN5RETEzaKjTav4zz6DF16A7dtN++bJk03r5kcfNdODRESu9NFH8P774Otrpg8GBdmdSCTrcanYGjZsWIbLIiKSNTgcpmvhvfeaX5qGDYO9e6FdO5gwAcaNgyZN7E4pIt7i6FF4+mmzPGAA3H67vXlEsip9likikoP4+UHnzrBrlzmrlTs3bNwITZtCs2awebPdCUXEG8TGmoKrcmUYOtTuNCJZl4otEZEcKCQEBg2C3buhZ0/TPn75cqhRA9q3hz//tDuhiNhl8WJYtMhMH3znHV3bKfJvqNgSEcnBChQw125t326u3bIs0+K5bFno1w9OnLA7oYjcTEeOQPfuZvnFF80HMCJy41RsiYgIpUqZC+F/+gkaNYJLl8y1XKVKwfjxcPGi3QlFxNMsyxRax47BbbeZYktE/p1MFVsJCQnExcXxxRdfcPToUU9lEhERm9SqBStWwJdfQpUqcOqUaRtftqyZTpScbHdCEfGUhQvhww/NtZ1z50JAgN2JRLI+l4utzZs3U758ee655x7uu+8+SpcuzbJlyzyZTUREbOBwQPPmsGmT+YWrWDH46y948kmoXh2++sp8Ai4i2Ud8PPToYZaHDIFq1WyNI5JtuFxsDRgwgKioKNauXcuGDRto3LgxsbGxnswmIiI28vWFDh1g50545RXIkwe2bDHt4xs3hv/9z+6EIuIOlmXavJ84YT5QGTjQ7kQi2YfLxdaGDRt4/fXXiY6Opnr16rz99tvs3r2bhIQET+YTERGbBQfD88/DH3/Ac8+ZqUWrVpn77jz2mFkvIlnXggXwySemK+k775g/RcQ9XC62Tpw4QdGiRZ3Pw8PDyZUrF8ePH/dIMBER8S4REfDqq/Dbb/DEE2a64QcfQPny0KuXuaheRLKWgwfh2WfN8rBh5lpNEXGfTDXI+PXXX/nll1+cD8uy2L59e5p1IiKSvRUvDu++a26GHBMDSUkwZYrpXDh6NJw/b3dCEXGFZUG3bnDyJNSsCQMG2J1IJPvxy8zgxo0bY/3jquiWLVvicDiwLAuHw0GyWlWJiOQI1arBsmXw9demY+GmTaZV9NSpMGKEaajhl6mfMiJyM737Lnz+uZka/M47Ol5FPMHlw2rPnj2ezCEiIllUkyamWcYHH5hia+9e6NIFJk6EMWPgvvvMlEMR8R4HDpjpvwAjR0KlSvbmEcmuXC62ihcv7skcIiKShfn4wOOPQ5s2MG0avPQS/PorPPAA1KtnuhnWqWN3ShEBM32wSxc4fRruuMM0vhERz8j0CeNdu3bxySefsHfvXhwOB1FRUbRq1YqSJUt6Ip+IiGQhgYHQpw907AjjxsGkSfDttxAdbQqx0aPNDZJFxD5z5pj75QUGmnvpafqgiOdkqkHGmDFjqFixIgMGDODDDz9k8eLFPP/885QvX55XX33VUxlFRCSLCQ83Uwh37TKFl48PfPghVKxobpx6+LDdCUVypn37zAciYM5Aly9vbx6R7M7lYmvVqlUMHjyYF198kWPHjnHo0CHi4+M5evQoL7zwAi+88AJr1qzxZFYREcliihaFt9+Gn3+GFi0gOdlMMyxd2jTROHvW7oQiOYdlQefOkJBgzjanFl0i4jkuF1szZsygc+fODB8+nLx58zrXR0REMHLkSJ566immT5/ukZAiIpK1Va5sup598425GfLZszB8uCm6pk837eNFxLNmzYK4OAgKMtMHfX3tTiSS/blcbP3444888cQTV339iSeeYP369W4JJSIi2VODBvDDD7BokSm0Dh+G7t1NMfbRR+aTdxFxvz//hL59zbKunRS5eVwutg4fPkyJEiWu+npUVBTx8fHuyCQiItmYwwEPPwzbtsHrr0OBAvDbb6aBRt26sHat3QlFspeUFHjqKXNG+a67oGdPuxOJ5BwuF1sXL14kICDgqq/7+/tz6dIlt4QSEZHsLyAAYmPh999hyBAICYF160yr+AcegO3b7U4okj28+SasXAnBwaYToaYPitw8mWr2OWvWLEJDQzN87cyZM24JJCIiOUtYmLmp6jPPmOu4Zs+GTz8113h16mTWFS5sd0qRrGnPHnj+ebM8bpyZvisiN4/LZ7ZuvfVW3nrrLSZOnJjhY9asWdx6662ZevMxY8Zw++23kzt3bgoWLEirVq3YuXNnmjHx8fE88cQTREZGkitXLmrUqMGHH36YZsyJEydo164dYWFhhIeH06lTJ87+o8XVL7/8Qr169QgKCqJYsWK88sormcoqIiKedcst5hP4rVuhVSsz9emtt8wvh4MHmw5qIuK61OmD586Z6yV79LA7kUjO43KxtXfvXvbs2XPdR2asXr2aHj16sH79euLi4khKSiImJoZz5845x7Rv356dO3fy6aefsmXLFh588EHatm3Lpk2bnGPatWvHtm3biIuL4/PPP2fNmjV07drV+XpCQgIxMTEUL16cDRs2MH78eIYPH87MmTMzlVdERDyvfHn4+GNz7dadd8KFC/Dyy1CqFEyZApqxLuKaadNMB9BcucwtGHwydXdVEXEHWw+7pUuX8uSTT1KpUiVuu+025s6dy759+9iwYYNzzPfff8+zzz5L7dq1KVmyJIMHDyY8PNw5Zvv27SxdupRZs2Zxxx13cNddd/H666/zwQcfcPDgQQDmz5/PpUuXePvtt6lUqRKPPvooPXv25LXXXrNlv0VE5PpSm2V8/DGUKwfHjkGvXlChAixcaD61F5GM7d4NAwaY5VdegZIl7c0jklO5fM3WhQsXWLFiBS1btgRg4MCBJCYmOl/39fVl1KhRBAUF3XCY06dPA+beXanuvPNOFi5cSIsWLQgPD2fRokVcvHiRhg0bArBu3TrCw8OpVauW82uaNGmCj48PP/zwA61bt2bdunXUr18/TYOPZs2aMW7cOE6ePJnmvmEAiYmJafYt4f/nriQlJZHkBTeDSc3gDVlEJGM6Tt2nRQto1gzmzPFh1Cgf/vjDwaOPwvjxKYwZk0LDhuoXLzcuOx6rKSnw5JO+nD/vQ6NGKXTqlKx72UmW503HamYyuFxsvfPOO3zxxRfOYuuNN96gUqVKBAcHA7Bjxw4KFy5Mnxu8HXlKSgq9e/embt26VK5c2bl+0aJFPPLII+TLlw8/Pz9CQkL4+OOPKf3/V3jGx8dTsGDBtDvl50dERISzFX18fDxRUVFpxhQqVMj52j+LrTFjxjBixIh0GZcvX05ISMgN7Z8nxMXF2R1BRK5Dx6n7FCkCEyf68umnpfj44zJs2OBHTIwPNWocpn37bZQooUZNcuOy07H62WclWbu2CkFBl3n00ZUsXXrB7kgibuMNx+r58+ddHutysTV//nz69++fZt2CBQso+f/npefNm8fUqVNvuNjq0aMHW7duZe0/brAyZMgQTp06xddff03+/Pn573//S9u2bfn222+pUqXKDb3X9QwcOJC+qXf+w5zZKlasGDExMYSFhXnkPTMjKSmJuLg4mjZtir+/v91xRCQDOk49p00bGD/e4uWXk3nrLR82bizEpk0FeeIJi2HDkilWzO6EkpVkt2P1t99gwQLz692ECQ46dmxkcyIR9/CmYzUhEx2bXC62fv/99zTFTVBQED5XXGlZu3Ztetxgm5vY2FhnY4uiRYs61+/evZs33niDrVu3UqlSJQBuu+02vv32W6ZOncqMGTOIjIzkyJEjabZ3+fJlTpw4QWRkJACRkZEcPnw4zZjU56ljrhQYGEhgYGC69f7+/rb/5V7J2/KISHo6Tj2jSBFz8X+fPvDii7B4sYN333WwaJEPPXvCwIEQHm53SslKssOxmpwMXbuapjJNmsAzz/jicOimWpK9eMOxmpn3d7lBxqlTp9Jcx3T06FFKlCjhfJ6SkpLmdVdYlkVsbCwff/wxK1euTDfVL/UUnc8/2uf4+vqS8v9XRkdHR3Pq1Kk0TTVWrlxJSkoKd9xxh3PMmjVr0syvjIuLo1y5cummEIqISNZRpgwsWgQ//GBaW1+8+HczgAkTzHORnGLSJPj+e8id29yvzuGwO5GIuFxsFS1alK1bt1719V9++SXNWSlX9OjRg3nz5rFgwQJy585NfHw88fHxXLhg5haXL1+e0qVL061bN3788Ud2797NhAkTiIuLo1WrVgBUqFCBe+65hy5duvDjjz/y3XffERsby6OPPkrh/78L5uOPP05AQACdOnVi27ZtLFy4kMmTJ6eZKigiIllX7dqwapW5EXKlSnDyJPTrZ9rIz5unzoWS/e3YYe5HBzBxImTy1qci4iEuF1v33nsvQ4cO5WIGHxNeuHCBESNG0KJFi0y9+fTp0zl9+jQNGzbklltucT4WLlwImFN0X375JQUKFOC+++6jatWqvPvuu7zzzjvce++9zu3Mnz+f8uXL07hxY+69917uuuuuNPfQypMnD8uXL2fPnj3UrFmT5557jqFDh6a5F5eIiGRtDofpXPjzz+ZT/SJF4M8/4YknoGZNWL7c7oQinpGcDE8+ac7k3nOPuZGxiHgHl6/ZGjRoEIsWLaJcuXLExsZStmxZAHbu3Mkbb7zB5cuXGTRoUKbe3LKu3663TJkyfPjhh9ccExERwYIFC645pmrVqnz77beZyiciIlmPr6/5ZfPRR2HyZBg7FjZvNu3jmzQx0wyrV7c7pYj7TJhgptLmyQNvvaXpgyLexOUzW4UKFeL777+nQoUKvPDCC7Ru3ZrWrVszcOBAKlasyNq1a53t1EVEROwWEmIaZezeDb17g78/fP011KgB//kP7N1rd0KRf+/XX2HIELM8aRJk8ooOEfEwl4stgKioKJYuXcrRo0dZv34969ev5+jRoyxdutTZAl5ERMSb5M9vrmHZuRMef9ysmz8fypWDvn3h+HF784ncqMuXzfTBS5fMFNoOHexOJCL/lKliK1VERAS1a9emdu3aREREuDuTiIiI20VFmSJrwwZo3Nj8gjpxIpQqBePGmXbZIlnJ+PHw00/mNgczZ2r6oIg3uqFiS0REJKuqUQPi4mDpUrjtNjh9Gl54AcqWhTlzTLMBEW+3ZQsMG2aWp0yB/2/ALCJeRsWWiIjkOA6HaZixcSO8+65pk71/v2msUa0afPEFuNDDScQWSUlm+mBSEtx/v7kGUUS8k4otERHJsXx8TGv4nTvNlKy8eWHrVmjZEho1gh9/tDuhSHpjx5oPCiIi4M03NX1QxJup2BIRkRwvKMjcBHn3bnj+eQgMhNWr4Y474JFHzHoRb/DzzzBqlFl+4w2IjLQ3j4hcm4otERGR/5c3r7kP12+/mc5uDgcsWgTly8Ozz8KRI3YnlJzs0qW/pw+2bm3uJSci3k3FloiIyD/ceivMnWtuhnzPPabF9htvQOnS8NJLcO6c3QklJxo92vybzJcPpk/X9EGRrEDFloiIyFVUrQpffQUrVkDNmnDmjLmBbJkyptX25ct2J5ScYtMmePllszxtGhQqZG8eEXGNii0REZHruPtu0yzj/ffN/boOHYJu3aBKFfjvf9W5UDzr0iUzrfXyZXj4YWjb1u5EIuIqFVsiIiIu8PEx18hs3w6TJpmpXDt2mGtn6tWD77+3O6FkV6NGmftqFSgAU6fanUZEMkPFloiISCYEBkKvXqZD4aBBEBwM330HdevCgw+aNvIi7vK//8GYMWZ5+nRTcIlI1qFiS0RE5AbkyWOuodm1Czp3Nme+Pv4YKlWCZ56B+Hi7E0pWl5houg8mJ5uzqm3a2J1IRDJLxZaIiMi/UKQIvPWWmeZ1333mF+MZM0znwmHDTFMNkRsxYgRs22aaYbzxht1pRORGqNgSERFxg4oV4dNPYc0aczPkc+dg5EhTdE2dau6NJOKqH3+EcePM8ptvmmsERSTrUbElIiLiRvXqwbp1sGSJaRF/5AjExppibPFidS6U67t40XQfTEmBdu3ggQfsTiQiN0rFloiIiJs5HOb6mm3bzFmtggXh999Ny+7oaHP2S+Rqhg41nS4jI2HKFLvTiMi/oWJLRETEQ/z9oXt3U2gNGwa5csEPP0CDBub6rm3b7E4o3mbdOnj1VbM8cyZERNibR0T+HRVbIiIiHpY7NwwfboquZ54BX1/4/HOoWtV0MjxwwO6E4g0uXDDdBy3LTCO87z67E4nIv6ViS0RE5CaJjIRp08wZrQcfNNfkzJ5tru0aNAhOn7Y7odhp8GD47TcoXNjcOFtEsj4VWyIiIjdZuXLw4Yfw/fdw113mjMaYMVCqlPklOzHR7oRys61dCxMnmuVZsyA83NY4IuImKrZERERsktos45NPoEIFOH4c+vQxywsWmDNfkv2dPw8dO5rpg089Bc2b251IRNxFxZaIiIiNHA64/3745RfTEOGWW2DPHtPy+/bbYcUKuxOKpw0aZK7nK1oUXnvN7jQi4k4qtkRERLyAnx906QK7dsFLL5mmGhs3QpMmcM898PPPdicUT1i9GiZPNsuzZ0OePPbmERH3UrElIiLiRXLlghdfhN274dlnTfv4ZcugenXToW7fPrsTirucPWumDYIptGNi7M0jIu6nYktERMQLFShgbmi7fTs88oi5nufdd6FsWXj+eTh50u6E8m+98AL88Qfceuvf99YSkexFxZaIiIgXK1UKPvgAfvwRGjUynQpffRVKloTx4+HiRbsTyo1YuRKmTjXLs2dDWJi9eUTEM1RsiYiIZAGpzTK+/BKqVIFTp6B/f3Om6913ITnZ7oTiqjNnoFMns/zMM+a6PBHJnlRsiYiIZBEOh2kLvmkTzJljutf99Ze5lqtGDVi61Ew3FO/Wvz/s3QslSsArr9idRkQ8ScWWiIhIFuPrC08+Cb/9BuPGmQ52v/xiCrEmTWDDBrsTytXExcGMGWZ5zhwIDbU3j4h4lootERGRLCo42Jwl2b0b+vaFgABzLVCtWvD44+Z+XeI9EhL+nj4YGwsNG9oaR0RuAhVbIiIiWVy+fDBhAuzcCf/5j5lu+P77UK4c9O4Nx47ZnVAA+vUz0z5LloSxY+1OIyI3g4otERGRbKJECXjvPXMz5JgYSEoyN8wtVQpGj4bz5+1OmHMtWwZvvWUK4blzzf3URCT7U7ElIiKSzVSrZn65X77c3Aw5IcHcKLlMGdNm/PJluxPmLKdO/T19sGdPqFfP1jgichOp2BIREcmmmjaF//0P5s2D4sXh4EHo3Bluuw0++0ydC2+Wvn3hwAEoXdqcYRSRnEPFloiISDbm4wPt2pnruSZMgIgI+PVXuP9+aNAAfvjB7oTZ25dfmq6DqdMHQ0LsTiQiN5OKLRERkRwgMNCcYdm9GwYMgKAg+PZbqFMHHn4Ydu2yO2H2c/IkdOlilvv2hbp17c0jIjefii0REZEcJDzcdML77Tfo2NGccVmyBCpWhB494PBhuxNmH717m6mb5crBqFF2pxERO6jYEhERyYGKFYO33zY3Q27RwjTNmDbNXFc0ciScPWt3wqzt00/h3XfNNM65c8090UQk51GxJSIikoNVrgyffw6rVsHtt5sia9gwU3TNmGHax0vmnDgB3bqZ5X79zFRNEcmZVGyJiIgIDRuaZhkLF5r7ch0+DM88Y4qxjz5S58LM6NkT4uOhQgUYMcLuNCJiJxVbIiIiApjrt9q2Nd0Kp0yB/PnNtV1t2pjmDt99Z3dC7/fxxzB/Pvj6wjvvmEYkIpJzqdgSERGRNAIC4NlnTefCwYNNu/J16+Cuu6BVK9i+3e6E3unYMXj6abPcv7+ZlikiOZuKLREREclQWJjpovf779C1qzlb88knZmph166m0578LTYWjhyBSpXMdW8iIiq2RERE5JpuuQXefBO2bjVntlJS4K23oEwZGDIEEhLsTmi/JUvM9W6p0wcDA+1OJCLeQMWWiIiIuKR8eXNN0tq1EB0N58/DSy+Zhhqvvw6XLtmd0B5HjphmIgCDBkHNmvbmERHvoWJLREREMiW1WcZHH0HZsuZapZ49zY2RFy7MWZ0LLQu6dzffg6pVzTVuIiKpVGyJiIhIpjkc0Lq1mVo4fToUKmQaajz6KNxxB3zzjd0Jb45Fi+DDD8HPz0wfDAiwO5GIeBMVWyIiInLD/P1NB77ffzf3lAoNhZ9+gkaNoEUL2LLF7oSec/gw9OhhlgcPhmrVbI0jIl5IxZaIiIj8a6GhMHSoKbp69DBner78Em67DTp2hL/+sjuhe1mWuU7r+HFTZA0aZHciEfFGKrZERETEbQoVgjfeMDdGfughU5TMnWuu7XrhBTh1yu6E7vH++6ZZiL+/mT7o7293IhHxRiq2RERExO3KlIHFi2H9eqhfHy5ehHHjTOfC116DxES7E964Q4fMPbXAnM2rWtXePCLivVRsiYiIiMekNsv47DPTrfDECXjuOShXDubNM/fsykosC7p1g5MnTYv3AQPsTiQi3kzFloiIiHiUwwEtW8LPP8OsWVC4MPz5JzzxBNSqBXFxdid03bx5pnAMCDDTIzV9UESuRcWWiIiI3BR+ftCpE+zaBaNHQ1gYbNoEMTHmsWmT3Qmv7cABcz8xMJ0XK1e2N4+IeD8VWyIiInJThYTAwIHmvly9e5uzQ3FxUKOGOdu1d6/dCdOzLOja1TT4qF0b+vWzO5GIZAUqtkRERMQW+fPDxImwYwc89phZN2+euZ7ruedMW3VvMXeuaWUfGGiW/fzsTiQiWYGKLREREbFVyZKwYAH873/QuDFcumQ6FpYqZToYXrhgb76//jJn4ABGjYIKFWyNIyJZiIotERER8Qo1a5rphEuXmnbqp0+be3OVLQtz5kBy8s3PZFnQpQskJECdOtC3783PICJZl4otERER8RoOBzRrBhs3mpsFFysG+/fDU09BtWpmKp9l3bw8s2fDsmUQFGSmD/r63rz3FpGsT8WWiIiIeB1fX2jfHn77DcaPh/Bw2LoVWrSAu++Gn37yfIY///z7TNbLL5tryUREMkPFloiIiHitoCDT+W/3bvNnYKC5SXLt2vDoo2a9J1gWdO4MZ85A3brQq5dn3kdEsjcVWyIiIuL1IiLMGa7ffjNnvBwOWLjQNKvo2ROOHnXv+82cCV9/DcHB5noxTR8UkRuhYktERESyjFtvNddybdoE99wDSUnw+uumc+FLL8G5c//+PfbsMa3nAcaOhTJl/v02RSRnUrElIiIiWc5tt8FXX5mzTzVqmOl+Q4aYwuitt+Dy5RvbbkoKdOpkirb69SE21r25RSRnUbElIiIiWVbjxqZZxoIFEBUFhw5B165QpQp88knmOxdOnw6rVkFIiJk+6KPflETkX9B/ISIiIpKl+fjAY4/B9u0waRLkywc7dkCrVubs1Lp1rm3njz+gf3+z/Mor5mbLIiL/hootERERyRYCA03XwN27YeBA09xi7Vq4805o0wZ27kw7PjkZVq92sGZNEVatcvDkk3D+PDRqBM88Y8suiEg2o2JLREREspU8eWD0aNi1y1x/5eMDH30ElSqZIio+3jwvUQKaNvXjtddq0ayZH99+a1rNv/22pg+KiHvovxIRERHJlooUgVmz4Jdf4L77zJmsGTNMkdWmDezfn/5rLl6EjRtvelQRyaZUbImIiEi2VqkSfPoprF4Nt98OiYlXH+twQO/epjATEfm3VGyJiIhIjlC/Powbd+0xlgV//QXffntzMolI9mZrsTVmzBhuv/12cufOTcGCBWnVqhU7r7h6de/evTgcjgwfixcvdo7bt28fLVq0ICQkhIIFC/L8889z+R832Pjmm2+oUaMGgYGBlC5dmrlz596s3RQREREvER/v2rhDhzybQ0RyBluLrdWrV9OjRw/Wr19PXFwcSUlJxMTEcO7/b/9erFgxDh06lOYxYsQIQkNDad68OQDJycm0aNGCS5cu8f333/POO+8wd+5chg4d6nyfPXv20KJFCxo1asTmzZvp3bs3nTt3ZtmyZbbst4iIiNjjllvcO05E5Fr87HzzpUuXpnk+d+5cChYsyIYNG6hfvz6+vr5ERkamGfPxxx/Ttm1bQkNDAVi+fDm//vorX3/9NYUKFaJatWqMGjWKAQMGMHz4cAICApgxYwZRUVFMmDABgAoVKrB27VomTpxIs2bNbs7OioiIiO3q1YOiReHAgYxveOxwmNfr1bv52UQk+7G12Pqn06dPAxAREZHh6xs2bGDz5s1MnTrVuW7dunVUqVKFQoUKOdc1a9aMZ555hm3btlG9enXWrVtHkyZN0myrWbNm9O7dO8P3SUxMJPGKq2cTEhIASEpKIikp6Yb2zZ1SM3hDFhHJmI5TEe81YYKDRx/1xeEAy3I41zscpvp69dVkUlIsUlLsSigi/+RNP1czk8Friq2UlBR69+5N3bp1qVy5coZjZs+eTYUKFbjzzjud6+Lj49MUWoDzefz/T8y+2piEhAQuXLhAcHBwmtfGjBnDiBEj0r3/8uXLCQkJyfzOeUhcXJzdEUTkOnScinifwEDo3/8WZs2qwvHjf/8OkC/fBTp12kpg4CG+/NLGgCJyVd7wc/X8+fMuj/WaYqtHjx5s3bqVtWvXZvj6hQsXWLBgAUOGDPF4loEDB9K3b1/n84SEBIoVK0ZMTAxhYWEef//rSUpKIi4ujqZNm+Lv7293HBHJgI5TEe92770wfDh8881F4uK20rRpZRo29MfXtzpQ3e54IvIP3vRzNXXWmyu8otiKjY3l888/Z82aNRQtWjTDMUuWLOH8+fO0b98+zfrIyEh+/PHHNOsOHz7sfC31z9R1V44JCwtLd1YLIDAwkMDAwHTr/f39bf/LvZK35RGR9HScingvf39o3BgSEw/QuPFtOlZFsgBv+Lmamfe3tRuhZVnExsby8ccfs3LlSqKioq46dvbs2dx///0UKFAgzfro6Gi2bNnCkSNHnOvi4uIICwujYsWKzjErVqxI83VxcXFER0e7cW9ERERERET+Zmux1aNHD+bNm8eCBQvInTs38fHxxMfHc+HChTTjfv/9d9asWUPnzp3TbSMmJoaKFSvyxBNP8PPPP7Ns2TIGDx5Mjx49nGennn76af744w/69+/Pjh07mDZtGosWLaJPnz43ZT9FRERERCTnsbXYmj59OqdPn6Zhw4bccsstzsfChQvTjHv77bcpWrQoMTEx6bbh6+vL559/jq+vL9HR0fznP/+hffv2jBw50jkmKiqKL774gri4OG677TYmTJjArFmz1PZdREREREQ8xtZrtqyMbnCRgdGjRzN69Oirvl68eHG+vE7boIYNG7Jp06ZM5RMREREREblRtp7ZEhERERERya5UbImIiIiIiHiAii0REREREREPULElIiIiIiLiASq2REREREREPEDFloiIiIiIiAfY2vo9q0htUZ+QkGBzEiMpKYnz58+TkJCAv7+/3XFEJAM6TkWyBh2rIlmDNx2rqTWBK7exUrHlgjNnzgBQrFgxm5OIiIiIiIg3OHPmDHny5LnmGIfl6p2Fc7CUlBQOHjxI7ty5cTgcdschISGBYsWK8ddffxEWFmZ3HBHJgI5TkaxBx6pI1uBNx6plWZw5c4bChQvj43Ptq7J0ZssFPj4+FC1a1O4Y6YSFhdn+j01Erk3HqUjWoGNVJGvwlmP1eme0UqlBhoiIiIiIiAeo2BIREREREfEAFVtZUGBgIMOGDSMwMNDuKCJyFTpORbIGHasiWUNWPVbVIENERERERMQDdGZLRERERETEA1RsiYiIiIiIeICKLREREREREQ9QsSUiIiIiIuIBKrZsMGbMGG6//XZy585NwYIFadWqFTt37kwz5uLFi/To0YN8+fIRGhpKmzZtOHz4cJoxPXv2pGbNmgQGBlKtWrUM32vZsmXUqVOH3LlzU6BAAdq0acPevXs9tGci2cvNPFYXLVpEtWrVCAkJoXjx4owfP95TuyWS7bjjWP3555957LHHKFasGMHBwVSoUIHJkyene69vvvmGGjVqEBgYSOnSpZk7d66nd08k27hZx+qhQ4d4/PHHKVu2LD4+PvTu3ftm7F6GVGzZYPXq1fTo0YP169cTFxdHUlISMTExnDt3zjmmT58+fPbZZyxevJjVq1dz8OBBHnzwwXTbeuqpp3jkkUcyfJ89e/bwwAMPcPfdd7N582aWLVvGsWPHMtyOiKR3s47Vr776inbt2vH000+zdetWpk2bxsSJE3njjTc8tm8i2Yk7jtUNGzZQsGBB5s2bx7Zt23jxxRcZOHBgmuNwz549tGjRgkaNGrF582Z69+5N586dWbZs2U3dX5Gs6mYdq4mJiRQoUIDBgwdz22233dR9TMcS2x05csQCrNWrV1uWZVmnTp2y/P39rcWLFzvHbN++3QKsdevWpfv6YcOGWbfddlu69YsXL7b8/Pys5ORk57pPP/3Ucjgc1qVLl9y/IyLZnKeO1ccee8x66KGH0qybMmWKVbRoUSslJcW9OyGSA/zbYzVV9+7drUaNGjmf9+/f36pUqVKaMY888ojVrFkzN++BSM7gqWP1Sg0aNLB69erl1tyZoTNbXuD06dMAREREAKZiT0pKokmTJs4x5cuX59Zbb2XdunUub7dmzZr4+PgwZ84ckpOTOX36NO+99x5NmjTB39/fvTshkgN46lhNTEwkKCgozbrg4GD279/Pn3/+6YbkIjmLu47V06dPO7cBsG7dujTbAGjWrFmmjncR+ZunjlVvomLLZikpKfTu3Zu6detSuXJlAOLj4wkICCA8PDzN2EKFChEfH+/ytqOioli+fDmDBg0iMDCQ8PBw9u/fz6JFi9y5CyI5gieP1WbNmvHRRx+xYsUKUlJS+O2335gwYQJg5p2LiOvcdax+//33LFy4kK5duzrXxcfHU6hQoXTbSEhI4MKFC+7dEZFszpPHqjdRsWWzHj16sHXrVj744AO3bzs+Pp4uXbrQoUMHfvrpJ1avXk1AQAAPPfQQlmW5/f1EsjNPHqtdunQhNjaWli1bEhAQQJ06dXj00UcB8PHRf9MimeGOY3Xr1q088MADDBs2jJiYGDemE5FUOeVY1U9xG8XGxvL555+zatUqihYt6lwfGRnJpUuXOHXqVJrxhw8fJjIy0uXtT506lTx58vDKK69QvXp16tevz7x581ixYgU//PCDu3ZDJNvz9LHqcDgYN24cZ8+e5c8//yQ+Pp7atWsDULJkSbfsg0hO4I5j9ddff6Vx48Z07dqVwYMHp3ktMjIyXbfRw4cPExYWRnBwsHt3RiQb8/Sx6k1UbNnAsixiY2P5+OOPWblyJVFRUWler1mzJv7+/qxYscK5bufOnezbt4/o6GiX3+f8+fPpPhX39fUFzKlbEbm2m3WspvL19aVIkSIEBATw/vvvEx0dTYECBf71fohkd+46Vrdt20ajRo3o0KEDL7/8crr3iY6OTrMNgLi4uBs63kVyopt1rHoTP7sD5EQ9evRgwYIFfPLJJ+TOnds5BzVPnjwEBweTJ08eOnXqRN++fYmIiCAsLIxnn32W6Oho6tSp49zO77//ztmzZ4mPj+fChQts3rwZgIoVKxIQEECLFi2YOHEiI0eO5LHHHuPMmTMMGjSI4sWLU716dTt2XSRLuVnH6rFjx1iyZAkNGzbk4sWLzJkzx9nyVkSuzx3H6tatW7n77rtp1qwZffv2dW7D19fX+aHH008/zRtvvEH//v156qmnWLlyJYsWLeKLL76wZ8dFspibdawCzp+1Z8+e5ejRo2zevJmAgAAqVqx4c3fatj6IORiQ4WPOnDnOMRcuXLC6d+9u5c2b1woJCbFat25tHTp0KM12GjRokOF29uzZ4xzz/vvvW9WrV7dy5cplFShQwLr//vut7du336Q9FcnabtaxevToUatOnTpWrly5rJCQEKtx48bW+vXrb+KeimRt7jhWhw0bluE2ihcvnua9Vq1aZVWrVs0KCAiwSpYsmeY9ROTabuax6sqYm8Hx/2FERERERETEjXTNloiIiIiIiAeo2BIREREREfEAFVsiIiIiIiIeoGJLRERERETEA1RsiYiIiIiIeICKLREREREREQ9QsSUiIiIiIuIBKrZEREREREQ8QMWWiIiIiIiIB6jYEhGRHMeyLJo0aUKzZs3SvTZt2jTCw8PZv3+/DclERCQ7UbElIiI5jsPhYM6cOfzwww+8+eabzvV79uyhf//+vP766xQtWtSt75mUlOTW7YmIiPdTsSUiIjlSsWLFmDx5Mv369WPPnj1YlkWnTp2IiYmhevXqNG/enNDQUAoVKsQTTzzBsWPHnF+7dOlS7rrrLsLDw8mXLx8tW7Zk9+7dztf37t2Lw+Fg4cKFNGjQgKCgIObPn2/HboqIiI0clmVZdocQERGxS6tWrTh9+jQPPvggo0aNYtu2bVSqVInOnTvTvn17Lly4wIABA7h8+TIrV64E4MMPP8ThcFC1alXOnj3L0KFD2bt3L5s3b8bHx4e9e/cSFRVFiRIlmDBhAtWrVycoKIhbbrnF5r0VEZGbScWWiIjkaEeOHKFSpUqcOHGCDz/8kK1bt/Ltt9+ybNky55j9+/dTrFgxdu7cSdmyZdNt49ixYxQoUIAtW7ZQuXJlZ7E1adIkevXqdTN3R0REvIimEYqISI5WsGBBunXrRoUKFWjVqhU///wzq1atIjQ01PkoX748gHOq4K5du3jssccoWbIkYWFhlChRAoB9+/al2XatWrVu6r6IiIh38bM7gIiIiN38/Pzw8zM/Es+ePct9993HuHHj0o1LnQZ43333Ubx4cd566y0KFy5MSkoKlStX5tKlS2nG58qVy/PhRUTEa6nYEhERuUKNGjX48MMPKVGihLMAu9Lx48fZuXMnb731FvXq1QNg7dq1NzumiIhkAZpGKCIicoUePXpw4sQJHnvsMX766Sd2797NsmXL6NixI8nJyeTNm5d8+fIxc+ZMfv/9d1auXEnfvn3tji0iIl5IxZaIiMgVChcuzHfffUdycjIxMTFUqVKF3r17Ex4ejo+PDz4+PnzwwQds2LCBypUr06dPH8aPH293bBER8ULqRigiIiIiIuIBOrMlIiIiIiLiASq2REREREREPEDFloiIiIiIiAeo2BIREREREfEAFVsiIiIiIiIeoGJLRERERETEA1RsiYiIiIiIeICKLREREREREQ9QsSUiIiIiIuIBKrZEREREREQ8QMWWiIiIiIiIB/wfRPd+1AlWo+kAAAAASUVORK5CYII=",+ "text/plain": [+ "<Figure size 1000x500 with 1 Axes>"+ ]+ },+ "metadata": {},+ "output_type": "display_data"+ },+ {+ "data": {+ "text/plain": [+ "(terminal: {} -> {},\n",+ " {},\n",+ " {'messages': [{'role': 'assistant', 'content': None, 'tool_calls': [{'id': 'call_eZDxApbzASyhLjam69JfqcQq', 'type': 'function', 'function': {'name': 'tavily_search_results_json', 'arguments': '{\"query\":\"UK GDP over the past 5 years\"}'}}]}, {'tool_call_id': 'call_eZDxApbzASyhLjam69JfqcQq', 'role': 'tool', 'name': 'tavily_search_results_json', 'content': [{'url': 'https://www.ons.gov.uk/economy/grossdomesticproductgdp', 'content': 'Quarter on Quarter growth: CVM SA %\\nChained Volume Measures (CVM)\\nGross Domestic Product: q-on-q4 growth rate CVM SA %\\nChained Volume Measures (CVM)\\nGross Domestic Product at market prices: Current price: Seasonally adjusted £m\\nCurrent Prices (CP)\\nGross Domestic Product: quarter on quarter growth rate: CP SA %\\nCurrent Prices (CP)\\nGross Domestic Product: q-on-q4 growth quarter growth: CP SA %\\nCurrent Prices (CP)\\nDatasets related to Gross Domestic Product (GDP)\\n A roundup of the latest data and trends on the economy, business and jobs\\nTime series related to Gross Domestic Product (GDP)\\nGross Domestic Product: chained volume measures: Seasonally adjusted £m\\nChained Volume Measures (CVM)\\nGross Domestic Product: Hide\\nData and analysis from Census 2021\\nGross Domestic Product (GDP)\\nGross domestic product (GDP) estimates as the main measure of UK economic growth based on the value of goods and services produced during a given period. Contains current and constant price data on the value of goods and services to indicate the economic performance of the UK.\\nEstimates of short-term indicators of investment in non-financial assets; business investment and asset and sector breakdowns of total gross fixed capital formation.\\n Monthly gross domestic product by gross value added\\nThe gross value added (GVA) tables showing the monthly and annual growths and indices as published within the monthly gross domestic product (GDP) statistical bulletin.\\n'}, {'url': 'https://www.macrotrends.net/global-metrics/countries/GBR/united-kingdom/gdp-growth-rate', 'content': 'U.K. gdp growth rate for 2021 was 7.60%, a 18.63% increase from 2020. U.K. gdp growth rate for 2020 was -11.03%, a 12.64% decline from 2019. U.K. gdp growth rate for 2019 was 1.60%, a 0.1% decline from 2018. Annual percentage growth rate of GDP at market prices based on constant local currency. Aggregates are based on constant 2010 U.S. dollars.'}, {'url': 'https://www.statista.com/topics/3795/gdp-of-the-uk/', 'content': 'Monthly growth of gross domestic product in the United Kingdom from January 2019 to November 2023\\nContribution to GDP growth in the UK 2023, by sector\\nContribution to gross domestic product growth in the United Kingdom in January 2023, by sector\\nGDP growth rate in the UK 1999-2021, by country\\nAnnual growth rates of gross domestic product in the United Kingdom from 1999 to 2021, by country\\nGDP growth rate in the UK 2021, by region\\nAnnual growth rates of gross domestic product in the United Kingdom in 2021, by region\\nGDP growth of Scotland 2021, by local area\\nAnnual growth rates of gross domestic product in Scotland in 2021, by local (ITL 3) area\\nGDP growth of Wales 2021, by local area\\nAnnual growth rates of gross domestic product in Wales in 2021, by local (ITL 3) area\\nGDP growth of Northern Ireland 2021, by local area\\nAnnual growth rates of gross domestic product in Northern Ireland in 2021, by local (ITL 3) area\\nGDP per capita\\nGDP per capita\\nGDP per capita in the UK 1955-2022\\nGross domestic product per capita in the United Kingdom from 1955 to 2022 (in GBP)\\nAnnual GDP per capita growth in the UK 1956-2022\\nAnnual GDP per capita growth in the United Kingdom from 1956 to 2022\\nQuarterly GDP per capita in the UK 2019-2023\\nQuarterly GDP per capita in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\nQuarterly GDP per capita growth in the UK 2019-2023\\nQuarterly GDP per capita growth in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\nGDP per capita of the UK 1999-2021, by country\\nGross domestic product per capita of the United Kingdom from 1999 to 2021, by country (in GBP)\\nGDP per capita of the UK 2021, by region\\nGross domestic product per capita of the United Kingdom in 2021, by region (in GBP)\\nGlobal Comparisons\\nGlobal Comparisons\\nCountries with the largest gross domestic product (GDP) 2022\\n Monthly GDP of the UK 2019-2023\\nMonthly index of gross domestic product in the United Kingdom from January 2019 to November 2023 (2019=100)\\nGVA of the UK 2022, by sector\\nGross value added of the United Kingdom in 2022, by industry sector (in million GBP)\\nGDP of the UK 2021, by country\\nGross domestic product of the United Kingdom in 2021, by country (in million GBP)\\nGDP of the UK 2021, by region\\nGross domestic product of the United Kingdom in 2021, by region (in million GBP)\\nGDP of Scotland 2021, by local area\\nGross domestic product of Scotland in 2021, by local (ITL 3) area (in million GBP)\\nGDP of Wales 2021, by local area\\nGross domestic product of Wales in 2021, by local (ITL 3) area (in million GBP)\\nGDP of Northern Ireland 2021, by local area\\nGross domestic product of Northern Ireland in 2021, by local (ITL 3) area (in million GBP)\\nGDP growth\\nGDP growth\\nGDP growth forecast for the UK 2000-2028\\nForecasted annual growth of gross domestic product in the United Kingdom from 2000 to 2028\\nAnnual GDP growth in the UK 1949-2022\\nAnnual growth of gross domestic product in the United Kingdom from 1949 to 2022\\nQuarterly GDP growth of the UK 2019-2023\\nQuarterly growth of gross domestic product in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023\\nMonthly GDP growth of the UK 2019-2023\\n Transforming data into design:\\nStatista Content & Design\\nStrategy and business building for the data-driven economy:\\nUK GDP - Statistics & Facts\\nUK economy expected to shrink in 2023\\nCharacteristics of UK GDP\\nKey insights\\nDetailed statistics\\nGDP of the UK 1948-2022\\nDetailed statistics\\nAnnual GDP growth in the UK 1949-2022\\nDetailed statistics\\nGDP per capita in the UK 1955-2022\\nEditor’s Picks\\nCurrent statistics on this topic\\nCurrent statistics on this topic\\nKey Economic Indicators\\nMonthly GDP growth of the UK 2019-2023\\nKey Economic Indicators\\nMonthly GDP of the UK 2019-2023\\nKey Economic Indicators\\nContribution to GDP growth in the UK 2023, by sector\\nRelated topics\\nRecommended\\nRecommended statistics\\nGDP\\nGDP\\nGDP of the UK 1948-2022\\nGross domestic product of the United Kingdom from 1948 to 2022 (in million GBP)\\nQuarterly GDP of the UK 2019-2023\\nQuarterly gross domestic product in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in million GBP)\\n The 20 countries with the largest gross domestic product (GDP) in 2022 (in billion U.S. dollars)\\nGDP of European countries in 2022\\nGross domestic product at current market prices of selected European countries in 2022 (in million euros)\\nReal GDP growth rates in Europe 2023\\nAnnual real gross domestic product (GDP) growth rate in European countries in 2023\\nGross domestic product (GDP) of Europe\\'s largest economies 1980-2028\\nGross domestic product (GDP) at current prices of Europe\\'s largest economies from 1980 to 2028 (in billion U.S dollars)\\nUnited Kingdom\\'s share of global gross domestic product (GDP) 2028\\nUnited Kingdom (UK): Share of global gross domestic product (GDP) adjusted for Purchasing Power Parity (PPP) from 2018 to 2028\\nRelated topics\\nRecommended\\nReport on the topic\\nKey figures\\nThe most important key figures provide you with a compact summary of the topic of \"UK GDP\" and take you straight to the corresponding statistics.\\n Industry Overview\\nDigital & Trend reports\\nOverview and forecasts on trending topics\\nIndustry & Market reports\\nIndustry and market insights and forecasts\\nCompanies & Products reports\\nKey figures and rankings about companies and products\\nConsumer & Brand reports\\nConsumer and brand insights and preferences in various industries\\nPolitics & Society reports\\nDetailed information about political and social topics\\nCountry & Region reports\\nAll key figures about countries and regions\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\nInsights on consumer attitudes and behavior worldwide\\nBusiness information on 100m+ public and private companies\\nExplore Company Insights\\nDetailed information for 39,000+ online stores and marketplaces\\nDirectly accessible data for 170 industries from 150+ countries\\nand over 1\\xa0Mio. facts.\\n'}, {'url': 'https://www.macrotrends.net/global-metrics/countries/GBR/united-kingdom/gdp-gross-domestic-product', 'content': \"U.K. gdp for 2021 was $3,122.48B, a 15.45% increase from 2020. U.K. gdp for 2020 was $2,704.61B, a 5.34% decline from 2019. U.K. gdp for 2019 was $2,857.06B, a 0.73% decline from 2018. GDP at purchaser's prices is the sum of gross value added by all resident producers in the economy plus any product taxes and minus any subsidies not included in ...\"}, {'url': 'https://www.ons.gov.uk/economy/grossdomesticproductgdp/timeseries/ihyp/pn2', 'content': 'Preliminary estimate of GDP time series (PGDP), released on 27 April 2018\\nPublications that use this data\\nContact details for this data\\nFooter links\\nHelp\\nAbout ONS\\nConnect with us\\nAll content is available under the Open Government Licence v3.0, except where otherwise stated Year on Year growth: CVM SA %\\nDownload full time series as:\\nDownload filtered time series as:\\nTable\\nNotes\\nFollowing a quality review it has been identified that the methodology used to estimate elements of purchased software within gross fixed capital formation (GFCF) has led to some double counting from 1997 onwards. GDP quarterly national accounts time series (QNA), released on 22 December 2023\\nIHYP: UK Economic Accounts time series (UKEA), released on 22 December 2023\\nIHYP: GDP first quarterly estimate time series\\n(PN2), released on 10 November 2023\\nIHYP: Year on Year growth: CVM SA %\\nSource dataset: GDP first quarterly estimate time series (PN2)\\nContact: Niamh McAuley\\nRelease date: 10 November 2023\\nView previous versions\\n %\\nFilters\\nCustom time period\\nChart\\nDownload this time seriesGross Domestic Product:'}]}, {'role': 'assistant', 'content': \"It looks like we have some relevant data from various sources, but we still need to organize the information regarding the UK's Gross Domestic Product (GDP) over the past five years to generate a line graph. \\n\\nHere are the annual growth rates from the search results:\\n\\n- 2021: 7.60% increase\\n- 2020: -11.03% decrease\\n- 2019: 1.60% increase\\n- 2018: Decline from previous year (no specific figure provided)\\n- 2017: Not provided\\n\\nWe have the following GDP values in billions of U.S. dollars:\\n\\n- 2021: $3,122.48B\\n- 2020: $2,704.61B\\n- 2019: $2,857.06B\\n- 2018: 0.73% decline from 2017 (no specific figure provided)\\n- 2017: Not provided\\n\\nTo draw a line graph, we need the specific GDP values (not just growth rates) for each year. We would need either the GDP values for 2017 and 2018 or the exact growth rates for those years to calculate the values from known 2019-2021 figures. \\n\\nThe provided data does not include a complete dataset for UK GDP over the past five years. It may be necessary to search further or refine the existing data to get the exact figures for the years 2017 and 2018 in order to complete the task. \\n\\nFor now, the task is incomplete, and I'll hand it over to another assistant who may be able to fill in the missing data or find an alternative source for the same.\"}, {'role': 'assistant', 'content': None, 'tool_calls': [{'id': 'call_6xpFCdbCXe51m27xOT4Row64', 'type': 'function', 'function': {'name': 'python_repl', 'arguments': '{\"code\":\"import matplotlib.pyplot as plt\\\\n\\\\n# UK\\'s GDP in U.S. dollars for five years (missing 2017 and 2018)\\\\n# The values for 2017 and 2018 are placeholders and will be replaced with\\\\n# the correct values when available.\\\\nyears = [\\'2017\\', \\'2018\\', \\'2019\\', \\'2020\\', \\'2021\\']\\\\ngdp_values = [None, None, 2857.06, 2704.61, 3122.48] # in billions\\\\n\\\\n# Create a line graph for the available GDP data\\\\nplt.figure(figsize=(10, 5))\\\\nplt.plot(years, gdp_values, marker=\\'o\\')\\\\n\\\\n# Aesthetics for the plot\\\\nplt.title(\\'UK GDP Over the Past 5 Years\\')\\\\nplt.xlabel(\\'Year\\')\\\\nplt.ylabel(\\'GDP in Billions of U.S. Dollars\\')\\\\nplt.grid(True)\\\\nplt.show()\"}'}}]}, {'tool_call_id': 'call_6xpFCdbCXe51m27xOT4Row64', 'role': 'tool', 'name': 'python_repl', 'content': {'status': 'success', 'code': \"```python\\nimport matplotlib.pyplot as plt\\n\\n# UK's GDP in U.S. dollars for five years (missing 2017 and 2018)\\n# The values for 2017 and 2018 are placeholders and will be replaced with\\n# the correct values when available.\\nyears = ['2017', '2018', '2019', '2020', '2021']\\ngdp_values = [None, None, 2857.06, 2704.61, 3122.48] # in billions\\n\\n# Create a line graph for the available GDP data\\nplt.figure(figsize=(10, 5))\\nplt.plot(years, gdp_values, marker='o')\\n\\n# Aesthetics for the plot\\nplt.title('UK GDP Over the Past 5 Years')\\nplt.xlabel('Year')\\nplt.ylabel('GDP in Billions of U.S. Dollars')\\nplt.grid(True)\\nplt.show()\\n```\", 'Stdout': ''}}, {'role': 'assistant', 'content': \"I have generated the Python code to create a line graph, but the actual GDP values for the years 2017 and 2018 are missing. These values are essential to finalize the graph. As soon as the correct GDP values for 2017 and 2018 are obtained, the placeholders in the code can be replaced with these values and the graph can be correctly generated.\\n\\nThe result will display a line graph showing the UK's GDP trend over the past 5 years. Would you like to proceed to find the GDP values for 2017 and 2018, or should I execute the code with the placeholders in place, which will result in an incomplete graph?\"}, {'role': 'assistant', 'content': None, 'tool_calls': [{'id': 'call_uza31sVNsowbS2gc8a2kycB0', 'type': 'function', 'function': {'name': 'tavily_search_results_json', 'arguments': '{\"query\":\"UK GDP 2017 2018 values\"}'}}]}, {'tool_call_id': 'call_uza31sVNsowbS2gc8a2kycB0', 'role': 'tool', 'name': 'tavily_search_results_json', 'content': [{'url': 'https://countryeconomy.com/gdp/uk?year=2018', 'content': \"Main navigation\\nTop menu\\nUnited Kingdom (UK) GDP - Gross Domestic Product\\nGDP United Kingdom 2018\\nGDP improves in United Kingdom\\nGross Domestic Product of United Kingdom grew 1.3% in 2018 compared to last year. You can see GDP in other countries in GDP and see all the economic information about United Kingdom in\\nUnited Kingdom's economy.\\n#COVID-19: 01/07/2024\\nCompare countries\\nLatest published data\\nLinks Your Interests\\nCountry Data\\nSecondary menu If we order the countries according to their GDP per capita, United Kingdom is well positioned in terms of the standard of living of its population, coming 23th out of\\nthe 196 countries whose GDP we publish.\\n To view the evolution of the GDP per capita, it is interesting to look back a few years and compare these data with those of 2008 when the GDP per capita in United Kingdom was €32,280$47,918.\\n The GDP figure in 2018 was €2,420,897$2,881,850 million, leaving United Kingdom placed 5th in the ranking of GDP of the 196 countries that we publish.\"}, {'url': 'https://www.ons.gov.uk/economy/grossdomesticproductgdp', 'content': 'Quarter on Quarter growth: CVM SA %\\nChained Volume Measures (CVM)\\nGross Domestic Product: q-on-q4 growth rate CVM SA %\\nChained Volume Measures (CVM)\\nGross Domestic Product at market prices: Current price: Seasonally adjusted £m\\nCurrent Prices (CP)\\nGross Domestic Product: quarter on quarter growth rate: CP SA %\\nCurrent Prices (CP)\\nGross Domestic Product: q-on-q4 growth quarter growth: CP SA %\\nCurrent Prices (CP)\\nDatasets related to Gross Domestic Product (GDP)\\n A roundup of the latest data and trends on the economy, business and jobs\\nTime series related to Gross Domestic Product (GDP)\\nGross Domestic Product: chained volume measures: Seasonally adjusted £m\\nChained Volume Measures (CVM)\\nGross Domestic Product: Hide\\nData and analysis from Census 2021\\nGross Domestic Product (GDP)\\nGross domestic product (GDP) estimates as the main measure of UK economic growth based on the value of goods and services produced during a given period. Contains current and constant price data on the value of goods and services to indicate the economic performance of the UK.\\nEstimates of short-term indicators of investment in non-financial assets; business investment and asset and sector breakdowns of total gross fixed capital formation.\\n Monthly gross domestic product by gross value added\\nThe gross value added (GVA) tables showing the monthly and annual growths and indices as published within the monthly gross domestic product (GDP) statistical bulletin.\\n'}, {'url': 'https://www.statista.com/topics/3795/gdp-of-the-uk/', 'content': 'Monthly growth of gross domestic product in the United Kingdom from January 2019 to November 2023\\nContribution to GDP growth in the UK 2023, by sector\\nContribution to gross domestic product growth in the United Kingdom in January 2023, by sector\\nGDP growth rate in the UK 1999-2021, by country\\nAnnual growth rates of gross domestic product in the United Kingdom from 1999 to 2021, by country\\nGDP growth rate in the UK 2021, by region\\nAnnual growth rates of gross domestic product in the United Kingdom in 2021, by region\\nGDP growth of Scotland 2021, by local area\\nAnnual growth rates of gross domestic product in Scotland in 2021, by local (ITL 3) area\\nGDP growth of Wales 2021, by local area\\nAnnual growth rates of gross domestic product in Wales in 2021, by local (ITL 3) area\\nGDP growth of Northern Ireland 2021, by local area\\nAnnual growth rates of gross domestic product in Northern Ireland in 2021, by local (ITL 3) area\\nGDP per capita\\nGDP per capita\\nGDP per capita in the UK 1955-2022\\nGross domestic product per capita in the United Kingdom from 1955 to 2022 (in GBP)\\nAnnual GDP per capita growth in the UK 1956-2022\\nAnnual GDP per capita growth in the United Kingdom from 1956 to 2022\\nQuarterly GDP per capita in the UK 2019-2023\\nQuarterly GDP per capita in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\nQuarterly GDP per capita growth in the UK 2019-2023\\nQuarterly GDP per capita growth in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in GBP)\\nGDP per capita of the UK 1999-2021, by country\\nGross domestic product per capita of the United Kingdom from 1999 to 2021, by country (in GBP)\\nGDP per capita of the UK 2021, by region\\nGross domestic product per capita of the United Kingdom in 2021, by region (in GBP)\\nGlobal Comparisons\\nGlobal Comparisons\\nCountries with the largest gross domestic product (GDP) 2022\\n Monthly GDP of the UK 2019-2023\\nMonthly index of gross domestic product in the United Kingdom from January 2019 to November 2023 (2019=100)\\nGVA of the UK 2022, by sector\\nGross value added of the United Kingdom in 2022, by industry sector (in million GBP)\\nGDP of the UK 2021, by country\\nGross domestic product of the United Kingdom in 2021, by country (in million GBP)\\nGDP of the UK 2021, by region\\nGross domestic product of the United Kingdom in 2021, by region (in million GBP)\\nGDP of Scotland 2021, by local area\\nGross domestic product of Scotland in 2021, by local (ITL 3) area (in million GBP)\\nGDP of Wales 2021, by local area\\nGross domestic product of Wales in 2021, by local (ITL 3) area (in million GBP)\\nGDP of Northern Ireland 2021, by local area\\nGross domestic product of Northern Ireland in 2021, by local (ITL 3) area (in million GBP)\\nGDP growth\\nGDP growth\\nGDP growth forecast for the UK 2000-2028\\nForecasted annual growth of gross domestic product in the United Kingdom from 2000 to 2028\\nAnnual GDP growth in the UK 1949-2022\\nAnnual growth of gross domestic product in the United Kingdom from 1949 to 2022\\nQuarterly GDP growth of the UK 2019-2023\\nQuarterly growth of gross domestic product in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023\\nMonthly GDP growth of the UK 2019-2023\\n Transforming data into design:\\nStatista Content & Design\\nStrategy and business building for the data-driven economy:\\nUK GDP - Statistics & Facts\\nUK economy expected to shrink in 2023\\nCharacteristics of UK GDP\\nKey insights\\nDetailed statistics\\nGDP of the UK 1948-2022\\nDetailed statistics\\nAnnual GDP growth in the UK 1949-2022\\nDetailed statistics\\nGDP per capita in the UK 1955-2022\\nEditor’s Picks\\nCurrent statistics on this topic\\nCurrent statistics on this topic\\nKey Economic Indicators\\nMonthly GDP growth of the UK 2019-2023\\nKey Economic Indicators\\nMonthly GDP of the UK 2019-2023\\nKey Economic Indicators\\nContribution to GDP growth in the UK 2023, by sector\\nRelated topics\\nRecommended\\nRecommended statistics\\nGDP\\nGDP\\nGDP of the UK 1948-2022\\nGross domestic product of the United Kingdom from 1948 to 2022 (in million GBP)\\nQuarterly GDP of the UK 2019-2023\\nQuarterly gross domestic product in the United Kingdom from 1st quarter 2019 to 3rd quarter 2023 (in million GBP)\\n The 20 countries with the largest gross domestic product (GDP) in 2022 (in billion U.S. dollars)\\nGDP of European countries in 2022\\nGross domestic product at current market prices of selected European countries in 2022 (in million euros)\\nReal GDP growth rates in Europe 2023\\nAnnual real gross domestic product (GDP) growth rate in European countries in 2023\\nGross domestic product (GDP) of Europe\\'s largest economies 1980-2028\\nGross domestic product (GDP) at current prices of Europe\\'s largest economies from 1980 to 2028 (in billion U.S dollars)\\nUnited Kingdom\\'s share of global gross domestic product (GDP) 2028\\nUnited Kingdom (UK): Share of global gross domestic product (GDP) adjusted for Purchasing Power Parity (PPP) from 2018 to 2028\\nRelated topics\\nRecommended\\nReport on the topic\\nKey figures\\nThe most important key figures provide you with a compact summary of the topic of \"UK GDP\" and take you straight to the corresponding statistics.\\n Industry Overview\\nDigital & Trend reports\\nOverview and forecasts on trending topics\\nIndustry & Market reports\\nIndustry and market insights and forecasts\\nCompanies & Products reports\\nKey figures and rankings about companies and products\\nConsumer & Brand reports\\nConsumer and brand insights and preferences in various industries\\nPolitics & Society reports\\nDetailed information about political and social topics\\nCountry & Region reports\\nAll key figures about countries and regions\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\nInsights on consumer attitudes and behavior worldwide\\nBusiness information on 100m+ public and private companies\\nExplore Company Insights\\nDetailed information for 39,000+ online stores and marketplaces\\nDirectly accessible data for 170 industries from 150+ countries\\nand over 1\\xa0Mio. facts.\\n'}, {'url': 'https://www.macrotrends.net/global-metrics/countries/GBR/united-kingdom/gdp-gross-domestic-product', 'content': \"U.K. gdp for 2021 was $3,122.48B, a 15.45% increase from 2020. U.K. gdp for 2020 was $2,704.61B, a 5.34% decline from 2019. U.K. gdp for 2019 was $2,857.06B, a 0.73% decline from 2018. GDP at purchaser's prices is the sum of gross value added by all resident producers in the economy plus any product taxes and minus any subsidies not included in ...\"}, {'url': 'https://www.ons.gov.uk/economy/grossdomesticproductgdp/bulletins/gdpmonthlyestimateuk/december2018', 'content': 'Quality and methodology\\nThe Gross domestic product (GDP) Quality and Methodology Information report contains important information on:\\nthe strengths and limitations of the data and how it compares with related data\\nuses and users of the data\\nhow the output was created\\nthe quality of the output including the accuracy of the data\\nContact details for this\\nStatistical bulletin\\nFooter links\\nHelp\\nAbout ONS\\nConnect with us\\nAll content is available under the Open Government Licence v3.0, except where otherwise stated Growth in the expenditure approach to measuring GDP was 0.2% in Quarter 4 2018\\nFigure 8: Households were the largest contributor to growth in Quarter 4 2018\\nHousehold expenditure and government expenditure both contributed positively to growth of 0.2% in gross domestic product (GDP) in Quarter 4 (Oct to Dec) 2018. Nominal GDP increased by 0.6% in Quarter 4 2018\\nFigure 9: Gross operating surplus was the only negative contribution to growth in Quarter 4 2018\\nNominal gross domestic product (GDP), or GDP in current prices, grew by 0.6% in Quarter 4 (Oct to Dec) 2018, with the increase driven by a 0.9% increase in compensation of employees (CoE).\\n A large positive contribution from the services sector was partially offset by smaller negative contributions from the production and construction sectors\\nFigure 2: The services sector was the only positive contributor of quarterly GDP growth, at 0.35 percentage points\\nGrowth in the services sector was 0.4% in Quarter 4 (Oct to Dec) 2018. Construction growth contracted in Quarter 4 2018, the first negative three-month growth since May 2018\\nFigure 7: Rolling three-month growth was negative 0.3% in December 2018, as growth faltered after several strong months\\nConstruction contracted by 0.3% in Quarter 4 (Oct to Dec) 2018 (Figure 7).'}]}, {'role': 'assistant', 'content': \"We have obtained additional data which includes the GDP figure for 2018:\\n\\n- GDP United Kingdom 2018: $2,881.85 billion\\n\\nHowever, there is still no specific value for the GDP of the United Kingdom for the year 2017 in the provided search results. This information gap prevents us from completing the line graph accurately. \\n\\nStill, given the latest information, here's an updated data set that can be used for creating a line graph with the known values:\\n\\n- 2021: $3,122.48 billion\\n- 2020: $2,704.61 billion\\n- 2019: $2,857.06 billion\\n- 2018: $2,881.85 billion\\n- 2017: Missing\\n\\nNow we can proceed to generate the Python code to draw the line graph with the data we have, keeping in mind that the information for 2017 will not be displayed, and the line graph will commence from 2018.\"}, {'role': 'assistant', 'content': None, 'tool_calls': [{'id': 'call_FIgytfIsaxDVatVBH9UpMIFq', 'type': 'function', 'function': {'name': 'python_repl', 'arguments': '{\"code\":\"import matplotlib.pyplot as plt\\\\n\\\\n# UK\\'s GDP in U.S. dollars for four years (missing 2017)\\\\nyears = [\\'2018\\', \\'2019\\', \\'2020\\', \\'2021\\']\\\\ngdp_values = [2881.85, 2857.06, 2704.61, 3122.48] # in billions\\\\n\\\\n# Create a line graph for the available GDP data\\\\nplt.figure(figsize=(10, 5))\\\\nplt.plot(years, gdp_values, marker=\\'o\\', linestyle=\\'-\\', color=\\'b\\')\\\\n\\\\n# Aesthetics for the plot\\\\nplt.title(\\'UK GDP Over the Past 4 Years\\')\\\\nplt.xlabel(\\'Year\\')\\\\nplt.ylabel(\\'GDP in Billions of U.S. Dollars\\')\\\\nplt.grid(True)\\\\n\\\\n# Show the plot\\\\nplt.show()\"}'}}]}, {'tool_call_id': 'call_FIgytfIsaxDVatVBH9UpMIFq', 'role': 'tool', 'name': 'python_repl', 'content': {'status': 'success', 'code': \"```python\\nimport matplotlib.pyplot as plt\\n\\n# UK's GDP in U.S. dollars for four years (missing 2017)\\nyears = ['2018', '2019', '2020', '2021']\\ngdp_values = [2881.85, 2857.06, 2704.61, 3122.48] # in billions\\n\\n# Create a line graph for the available GDP data\\nplt.figure(figsize=(10, 5))\\nplt.plot(years, gdp_values, marker='o', linestyle='-', color='b')\\n\\n# Aesthetics for the plot\\nplt.title('UK GDP Over the Past 4 Years')\\nplt.xlabel('Year')\\nplt.ylabel('GDP in Billions of U.S. Dollars')\\nplt.grid(True)\\n\\n# Show the plot\\nplt.show()\\n```\", 'Stdout': ''}}, {'role': 'assistant', 'content': \"The Python code to draw a line graph of the UK's GDP over the past 4 years (2018 to 2021) has been executed. Due to the missing GDP data for 2017, the graph starts from the year 2018.\\n\\nHere is the code used to generate the graph:\\n\\n```python\\nimport matplotlib.pyplot as plt\\n\\n# UK's GDP in U.S. dollars for four years (missing 2017)\\nyears = ['2018', '2019', '2020', '2021']\\ngdp_values = [2881.85, 2857.06, 2704.61, 3122.48] # in billions\\n\\n# Create a line graph for the available GDP data\\nplt.figure(figsize=(10, 5))\\nplt.plot(years, gdp_values, marker='o', linestyle='-', color='b')\\n\\n# Aesthetics for the plot\\nplt.title('UK GDP Over the Past 4 Years')\\nplt.xlabel('Year')\\nplt.ylabel('GDP in Billions of U.S. Dollars')\\nplt.grid(True)\\n\\n# Show the plot\\nplt.show()\\n```\\n\\nThis graph represents the UK's GDP trend from 2018 to 2021. Since the visualization is not visible in this medium, the provided code can be used in a Python environment to produce the line graph.\\n\\nFINAL ANSWER: The task is complete once the graph is visible after running the provided Python code in an appropriate environment.\"}], 'query': \"Fetch the UK's GDP over the past 5 years, then draw a line graph of it. Once the python code has been written and the graph drawn, the task is complete.\", 'sender': 'chart_generator', 'parsed_tool_calls': [], '__SEQUENCE_ID': 12, '__PRIOR_STEP': 'terminal'})"+ ]+ },+ "execution_count": 11,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "# this will run until completion.\n",+ "last_action, last_result, last_state = app.run(halt_after=[\"terminal\"])"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "c2880bdfee354b7",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:30:48.865592Z",+ "start_time": "2024-04-14T22:30:48.861637Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ },+ "scrolled": true+ },+ "outputs": [],+ "source": [+ "pprint.pprint(last_state)"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "dedde58d-f684-49d9-81a3-df52e75c447d",+ "metadata": {},+ "source": [+ "# Change the Query!\n",+ "Right now we provide the starting query as state. So we just create a new application by adjusting \n",+ "the initial state we provide."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 16,+ "id": "8883f456-2217-4802-be0f-3e14cc1475bd",+ "metadata": {},+ "outputs": [],+ "source": [+ "# Let's change the query\n",+ "state[\"query\"] = (\"Fetch the USA's GDP over the past 5 years, then draw a line graph of it. \"\n",+ " \"Once the python code has been written and the graph drawn, the task is complete.\")\n",+ "app2 = build_application(state, entry_point)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 17,+ "id": "9d0b8a14d4614069",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:30:27.699594Z",+ "start_time": "2024-04-14T22:30:27.696685Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "name": "stderr",+ "output_type": "stream",+ "text": [+ "Python REPL can execute arbitrary code. Use with caution.\n"+ ]+ },+ {+ "data": {+ "image/png": "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MDU1FZo0aSK8/fbbQkpKSo2ug4hIJAg1uC+FiIiIiIiIag3nkBEREREREekJCzIiIiIiIiI9YUFGRERERESkJyzIiIiIiIiI9IQFGRERERERkZ6wICMiIiIiItITPhi6lqhUKiQnJ0MqlUIkEuk7HCIiIiIi0hNBEJCbmwsXFxeIxY/ugbEgqyXJyclwc3PTdxhERERERGQgkpKS4Orq+sgxLMhqiVQqBVCRdJlMptdYSktLsW/fPgQFBcHExESvsdRHzK/uMce6xfzqFvOrW8yvbjG/usX86pYh5VepVMLNzU1dIzwKC7JaUnmbokwmM4iCzMLCAjKZTO9vxvqI+dU95li3mF/dYn51i/nVLeZXt5hf3TLE/GozlYmLehAREREREekJCzIiIiIiIiI9YUFGRERERESkJyzIiIiIiIiI9IQFGRERERERkZ6wICMiIiIiItITFmRERERERER6woKMiIiIiIhIT1iQERERERER6QkLMiIiIiIiqtPKVQJOxmciKkOEk/GZKFcJ+g5Ja8b6DoCIiIiIiOhJ7YlOwdwdMUjJKQJghN+un4GztQSzh/hiYGtnfYf3WOyQERERERFRnbQnOgWT1569V4z9S5FThMlrz2JPdIqeItMeCzIiIiIiIqpzylUC5u6IQXU3J1Zum7sjxuBvX2RBRkREREREdc6p+MwqnbH7CQBScopwKj7z2QX1BFiQERERERFRnZOW+/Bi7EnG6QsLMiIiIiIiqnPkUkmtjtMXFmRERERERFTndPW0g7P1w4stEQBnawm6eto9u6CeAAsyIiIiIiKqc4zEInw8qGW1+0T3/jt7iC+MxKJqxxgKFmRERERERFQn5RWXAQAerLmcrCVY/nrHOvEcMj4YmoiIiIiI6pySMhV+PBAHAJg1qCVaOlpi39GTCOrlB38vucF3xiqxICMiIiIiojpnc1QS7mQXQi41w+hu7jCCCnevCPDztKszxRjAWxaJiIiIiKiOKS4rx9J73bHJgc0gMTHSc0RPjgUZERERERHVKZvP3EZyThEcZWYY2bWJvsN5KizIiIiIiIioziguK8fSgxXdsSmBXnW6OwawICMiIiIiojpk0+kkpOQUwUkmwYgubvoO56mxICMiIiIiojqhqLQcSw/eAABM6VO3545VYkFGRERERER1wsbTSVAoi+BsXT+6YwALMiIiIiIi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zMxgZmZWZbuJiYne3wCVDCmW+oj51T3mWLeYX91ifnWL+dUt5le3GlJ+03OLse5UEgBg2gAf9V1uumQI+a3J+fW6yqIgCAgNDcW2bdtw4MABeHp6avUaQRDU87f8/f1x6dIljdUQw8LCIJPJ4Ovrqx4THh6ucZywsDD4+/sDAExNTdGpUyeNMSqVCuHh4eoxRERERERUM/87fANFpSq0d7NBoLeDvsMxSHotyEJCQrB27VqsX78eUqkUCoUCCoUChYWFAICbN29i/vz5iIqKwq1bt3D8+HEMHz4c5ubmGDRoEAAgKCgIvr6+GD16NC5cuIC9e/fik08+QUhIiLqDNWnSJNy8eRMfffQRrl69imXLlmHTpk2YNm2aOpbp06fjp59+wq+//oorV65g8uTJyM/PV6+6SERERERE2kvLLcLak4kAgKn9m3NlxYfQ6y2Ly5cvBwAEBgZqbF+9ejXGjh0LiUSCo0eP4vvvv0dWVhYcHR0REBCA48ePQy6veHaBkZERdu7cicmTJ8Pf3x+WlpYYM2YMPv/8c/XxPD09sWvXLkybNg2LFy+Gq6srfv75Z/WS9wAwYsQIpKen47PPPoNCoUD79u2xZ8+eKgt9EBERERHR4604dBNFpSp0aGKD3uyOPZReCzJBEB6538XFBbt3737scdzd3R87LjAwEOfOnXvkmNDQUISGhj72fERERERE9HBpyiKsu9cdm9afzx17FL3eskhERERERPXP8sM3UFymQid3W/Rqbq/vcAwaCzIiIiIiIqo1qcoirDt5CwC7Y9pgQUZERERERLVm+aEbKClTobO7LXp4NdJ3OAaPBRkREREREdUKRU4R1p+61x0bwO6YNliQERERERFRrVh2KA4lZSp09bBD92bsjmmDBRkRERERET215OxCbDiVBACYOoDPHdMWCzIiIiIiInpqyw/dQEm5Cn6edujejCsraosFGRERERERPZXk7EJsPH2vO9bfW8/R1C0syIiIiIiI6KksPRiHknIVujW1gz/njtUICzIiIiIiInpit7MKsOlMRXdsGrtjNcaCjIiIiIiIntjSgzdQWi6ge7NG8GvK7lhNsSAjIiIiIqInkpRZgM2V3bEB7I49CRZkRERERET0RJYdikOZSkBPL3t08bDTdzh1EgsyIiIiIiKqsYru2G0AwNT+zfUcTd3FgoyIiIiIiGrs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",+ "text/plain": [+ "<Figure size 1000x500 with 1 Axes>"+ ]+ },+ "metadata": {},+ "output_type": "display_data"+ }+ ],+ "source": [+ "# this will run until completion.\n",+ "last_action, last_result, last_state = app2.run(halt_after=[\"terminal\"])"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 21,+ "id": "54543e628379f27a",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "{'messages': [{'role': 'assistant', 'content': None, 'tool_calls': [{'id': 'call_DcmKJnsbk0w4QF1cwPys8qTQ', 'type': 'function', 'function': {'name': 'tavily_search_results_json', 'arguments': '{\"query\":\"USA GDP over the past 5 years\"}'}}]}, {'tool_call_id': 'call_DcmKJnsbk0w4QF1cwPys8qTQ', 'role': 'tool', 'name': 'tavily_search_results_json', 'content': [{'url': 'https://www.thebalancemoney.com/us-gdp-by-year-3305543', 'content': \"U.S. GDP by Year, Compared to Recessions and Events\\nThe Strange Ups and Downs of the U.S. Economy Since 1929\\nThe Balance / Julie Bang\\nU.S. gross domestic product (GDP) by year is a good overview of economic growth in the United States. Rebasing changes the reference year (or base year) for the real (chained dollar and quantity index) estimates and price indexes and expresses GDP and other NIPA aggregates in terms of the prices of one year. You can compare the GDP by year to fiscal and monetary policies to get a complete picture of what works and what doesn't in the U.S. economy.\\n Real GDP is important because without canceling out the effects of inflation, the GDP could appear to grow, when really all that's happened is an increase in prices.\\n Key Takeaways\\nTypes of GDP\\nThe\\xa0Bureau of Economic Analysis\\xa0compiles the data.\"}, {'url': 'https://usafacts.org/data/topics/economy/economic-indicators/gdp/gross-domestic-product/', 'content': 'Data Adjustments\\nIs the economy growing?\\nRelated Metrics\\nAnnual percent change in real GDP\\n5.7%\\n2021\\nAnnual percent change in real GDP\\n5.7%\\n2021\\nExplore Gross domestic product\\nInteract with the data\\nData Adjustments\\nState Display\\nOur nation, in numbers\\nUSAFacts is a not-for-profit, nonpartisan civic initiative making government data easy for all Americans to access and understand.\\n • Check your spelling\\n• Try other search terms\\n• Use fewer words\\nGross domestic product\\nGross domestic product\\nGross domestic product (GDP) is the value of all goods and services produced in the US. All topics\\nExplore articles, data and trends by topic\\nAbout\\nWhat makes USAFacts different\\nWe frequently add data and we\\'re interested in what would be useful to people. Newsletter\\nData delivered to your inbox\\nKeep up with the latest data and most popular content. But only the official BEA inflation-adjusted \"real GDP\" value is used to calculate annual percent change in GDP and therefore how well the economy is doing.'}, {'url': 'https://www.statista.com/statistics/188105/annual-gdp-of-the-united-states-since-1990/', 'content': 'Industry Overview\\nDigital & Trend reports\\nOverview and forecasts on trending topics\\nIndustry & Market reports\\nIndustry and market insights and forecasts\\nCompanies & Products reports\\nKey figures and rankings about companies and products\\nConsumer & Brand reports\\nConsumer and brand insights and preferences in various industries\\nPolitics & Society reports\\nDetailed information about political and social topics\\nCountry & Region reports\\nAll key figures about countries and regions\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\nInsights on consumer attitudes and behavior worldwide\\nBusiness information on 100m+ public and private companies\\nExplore Company Insights\\nDetailed information for 39,000+ online stores and marketplaces\\nDirectly accessible data for 170 industries from 150+ countries\\nand over 1\\xa0Mio. facts.\\n What is GDP?\\nGDP and national debt\\nGross domestic product of the United States from 1990 to 2022\\n(in billion current U.S. dollars )\\nAdditional Information\\nShow sources information\\nShow publisher information\\nUse Ask Statista Research Service\\nJanuary 2023\\nUnited States\\n1990 to 2022\\nOther statistics on the topicService sector of the U.S.\\nEconomy\\nU.S. real GDP growth by quarter Q1 2013- Statistics on\\n\"\\nGDP of the U.S.\\n\"\\nOther statistics that may interest you GDP of the U.S.\\nOverview\\nGDP by sector and industry\\nGDP by state\\nGDP by metropolitan area\\nInternational comparison\\nFurther related statistics\\nFurther Content: You might find this interesting as well\\nStatistics\\nTopics Q3 2023\\nEconomy\\nU.S. real GDP growth rate 1990-2022\\nEconomy\\nCountries with the largest gross domestic product (GDP) per capita 2022\\nEconomy\\nCountries with the largest gross domestic product (GDP) 2022\\n Transforming data into design:\\nStatista Content & Design\\nStrategy and business building for the data-driven economy:\\nU.S. annual GDP 1990-2022\\n'}, {'url': 'https://www.macrotrends.net/global-metrics/countries/USA/united-states/gdp-gross-domestic-product', 'content': \"U.S. gdp for 2021 was $23,315.08B, a 10.71% increase from 2020. U.S. gdp for 2020 was $21,060.47B, a 1.5% decline from 2019. U.S. gdp for 2019 was $21,380.98B, a 4.13% increase from 2018. GDP at purchaser's prices is the sum of gross value added by all resident producers in the economy plus any product taxes and minus any subsidies not included ...\"}, {'url': 'https://www.macrotrends.net/global-metrics/countries/USA/united-states/gdp-growth-rate', 'content': 'U.S. gdp growth rate for 2021 was 5.95%, a 8.71% increase from 2020. U.S. gdp growth rate for 2020 was -2.77%, a 5.06% decline from 2019. U.S. gdp growth rate for 2019 was 2.29%, a 0.65% decline from 2018. Annual percentage growth rate of GDP at market prices based on constant local currency. Aggregates are based on constant 2010 U.S. dollars.'}]}, {'role': 'assistant', 'content': 'Based on the search results provided, I will compile the GDP values for USA over the past 5 years. Here is the data from the search results:\\n\\n- U.S. GDP for 2021: $23,315.08 billion (10.71% increase from 2020)\\n- U.S. GDP for 2020: $21,060.47 billion (1.5% decline from 2019)\\n- U.S. GDP for 2019: $21,380.98 billion (4.13% increase from 2018)\\n- U.S. GDP for 2018 and 2017 is not provided directly in this data.\\n\\nI will attempt to extract the missing GDP data for 2018 and 2017 from the search results, as this will be necessary to create a line graph of the USA\\'s GDP over the past 5 years. If that\\'s not possible, I would need to combine multiple search results to find all the required data. \\n\\nTo get the complete and accurate data for the missing years, I will refer back to the search results to find the needed information:\\n\\nFrom the Source \"https://www.macrotrends.net/global-metrics/countries/USA/united-states/gdp-growth-rate,\" we can see the following:\\n- U.S. GDP for 2019 was $21,380.98 billion.\\n- U.S. GDP growth rate for 2018 from 2019 was a 2.29% decrease when the GDP was $21,380.98 billion.\\n- U.S. GDP growth rate for 2017 from 2018 was a 0.95% decrease (approximate figure inferred from the trend) when the GDP was higher than in 2019.\\n\\nTo calculate the GDP for the year 2018, we would need to reverse the 2.29% decrease observed in 2019. Similarly, to find the GDP for 2017, we reverse the approximate 0.95% decrease from 2018.\\n\\nThe calculations would be as follows:\\n\\n- 2018 GDP = 2019 GDP / (1 - (-2.29%))\\n- 2017 GDP = 2018 GDP / (1 - (-0.95%)) (using the approximate GDP growth rate decrease)\\n\\nLet\\'s calculate these values:\\n\\n- 2018 GDP = $21,380.98B / 0.9771 = $21,879.24 billion (approximately)\\n- 2017 GDP = $21,879.24B / 0.9905 = $22,093.88 billion (approximately)\\n\\nNow we have the approximate GDP for the years 2018 and 2017. We can proceed to create a Python code snippet that will generate a line graph of the US GDP for the past 5 years. \\n\\nHowever, I must note that the GDP figures for 2018 and 2017 are approximations based on the provided growth rate figures and may differ slightly from the actual GDP values. If the precise values are required, we would need to find more specific data sources.'}, {'role': 'assistant', 'content': None, 'tool_calls': [{'id': 'call_gr4eDsbMrJVlqaC0b1K2HtOI', 'type': 'function', 'function': {'name': 'python_repl', 'arguments': '{\"code\":\"import matplotlib.pyplot as plt\\\\n\\\\n# GDP values in billion dollars and the corresponding years\\\\nyears = [2017, 2018, 2019, 2020, 2021]\\\\ngdp_values = [22093.88, 21879.24, 21380.98, 21060.47, 23315.08] # Approximations for 2017 and 2018\\\\n\\\\n# Create line graph\\\\nplt.figure(figsize=(10, 5))\\\\nplt.plot(years, gdp_values, marker=\\'o\\')\\\\nplt.title(\\'USA GDP Over the Past 5 Years\\')\\\\nplt.xlabel(\\'Year\\')\\\\nplt.ylabel(\\'GDP (in billion USD)\\')\\\\nplt.grid(True)\\\\nplt.show()\"}'}}]}, {'tool_call_id': 'call_gr4eDsbMrJVlqaC0b1K2HtOI', 'role': 'tool', 'name': 'python_repl', 'content': {'status': 'success', 'code': \"```python\\nimport matplotlib.pyplot as plt\\n\\n# GDP values in billion dollars and the corresponding years\\nyears = [2017, 2018, 2019, 2020, 2021]\\ngdp_values = [22093.88, 21879.24, 21380.98, 21060.47, 23315.08] # Approximations for 2017 and 2018\\n\\n# Create line graph\\nplt.figure(figsize=(10, 5))\\nplt.plot(years, gdp_values, marker='o')\\nplt.title('USA GDP Over the Past 5 Years')\\nplt.xlabel('Year')\\nplt.ylabel('GDP (in billion USD)')\\nplt.grid(True)\\nplt.show()\\n```\", 'Stdout': ''}}, {'role': 'assistant', 'content': \"The line graph of the USA's GDP over the past 5 years has been created using the approximated values for 2017 and 2018, as well as the provided values for 2019, 2020, and 2021. The task is now complete.\\n\\nFINAL ANSWER\"}], 'query': \"Fetch the USA's GDP over the past 5 years, then draw a line graph of it. Once the python code has been written and the graph drawn, the task is complete.\", 'sender': 'chart_generator', 'parsed_tool_calls': [], '__SEQUENCE_ID': 6, '__PRIOR_STEP': 'terminal'}\n"+ ]+ }+ ],+ "source": [+ "pprint.pprint(last_state)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "7e15b805-4feb-4541-8d2f-5075368bb293",+ "metadata": {},+ "outputs": [],+ "source": []+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": "Python 3 (ipykernel)",+ "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.10.4"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 5+}diff --git a/examples/multi-agent-collaboration/hamilton/requirements.txt b/examples/multi-agent-collaboration/hamilton/requirements.txtnew file mode 100644index 00000000..149171c8--- /dev/null+++ b/examples/multi-agent-collaboration/hamilton/requirements.txt@@ -0,0 +1,6 @@+burr[start]+langchain-community+langchain-core+langchain-experimental+openai+sf-hamilton[visualization]diff --git a/examples/multi-agent-collaboration/hamilton-multi-agent-v2.png b/examples/multi-agent-collaboration/hamilton/statemachine.pngsimilarity index 100%rename from examples/multi-agent-collaboration/hamilton-multi-agent-v2.pngrename to examples/multi-agent-collaboration/hamilton/statemachine.pngdiff --git a/examples/multi-agent-collaboration/lcel-multi-agent.png b/examples/multi-agent-collaboration/lcel-multi-agent.pngdeleted file mode 100644index 0a869a95..00000000Binary files a/examples/multi-agent-collaboration/lcel-multi-agent.png and /dev/null differdiff --git a/examples/multi-agent-collaboration/lcel/README.md b/examples/multi-agent-collaboration/lcel/README.mdnew file mode 100644index 00000000..ae3fa5af--- /dev/null+++ b/examples/multi-agent-collaboration/lcel/README.md@@ -0,0 +1,47 @@+# Multi Agent Collaboration++This example resembles the example found originally [here](https://github.com/langchain-ai/langgraph/blob/main/examples/multi_agent/multi-agent-collaboration.ipynb).+++# Tracing+You'll see that in `application.py` we+have some lightweight `tracing` set up for Hamilton. This is a simple way to plug into Burr's+tracer functionality -- this will allow you to see more in the Burr UI.++More functionality is on the roadmap!++# Running the example+Install the dependencies:++```bash+pip install "burr[start]" -r requirements.txt+```++Make sure you have the API Keys in your environment:++```bash+export OPENAI_API_KEY=YOUR_KEY+export TAVILY_API_KEY=YOUR_KEY+```++Run the notebook:+<a target="_blank" href="https://colab.research.google.com/github/dagworks-inc/burr/blob/main/examples/multi-agent-collaboration/lcel/notebook.ipynb">+ <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>+</a>+or do it manually:+```bash+jupyter notebook+```+and open the notebook `notebook.ipynb`.++```bash+python application.py+```+Application run:+++# What to adjust+There are a few things:++1. The `query` that you provide for the agents to work over. Set this as the initial human message in state.+2. You can adjust the `prompts` used by the agents in the code.diff --git a/examples/multi-agent-collaboration/lcel/__init__.py b/examples/multi-agent-collaboration/lcel/__init__.pynew file mode 100644index 00000000..e69de29bdiff --git a/examples/multi-agent-collaboration/lcel_application.py b/examples/multi-agent-collaboration/lcel/application.pysimilarity index 86%rename from examples/multi-agent-collaboration/lcel_application.pyrename to examples/multi-agent-collaboration/lcel/application.pyindex 0489adeb..a764cfce 100644--- a/examples/multi-agent-collaboration/lcel_application.py+++ b/examples/multi-agent-collaboration/lcel/application.py@@ -26,13 +26,28 @@ from burr.lifecycle import PostRunStepHookfrom burr.tracking import client as burr_tclientfrom burr.visibility import ActionSpanTracer, TracerFactory+# ---- Define the tools -----tavily_tool = TavilySearchResults(max_results=5)+repl = PythonREPL()-# Warning: This executes code locally, which can be unsafe when not sandboxed-repl = PythonREPL()+@tool+def python_repl(code: Annotated[str, "The python code to execute to generate your chart."]):+ """Use this to execute python code. If you want to see the output of a value,+ you should print it out with `print(...)`. This is visible to the user."""+ try:+ # Warning: This executes code locally, which can be unsafe when not sandboxed+ result = repl.run(code)+ except BaseException as e:+ return f"Failed to execute. Error: {repr(e)}"+ return f"Succesfully executed:\n```python\n{code}\n```\nStdout: {result}"+++tools = [tavily_tool, python_repl]+tool_executor = ToolExecutor(tools)+# Define the tracerclass LangChainTracer(BaseCallbackHandler):"""Example tracer to plug into Burr's tracing capture."""@@ -64,6 +79,7 @@ class LangChainTracer(BaseCallbackHandler):context_manager.__exit__(None, None, None)+# Agents / actionsdef create_agent(llm, tools, system_message: str):"""Helper function to create an agent with a system message and tools."""functions = [convert_to_openai_function(t) for t in tools]@@ -88,20 +104,8 @@ def create_agent(llm, tools, system_message: str):return prompt | llm.bind_functions(functions)-@tool-def python_repl(code: Annotated[str, "The python code to execute to generate your chart."]):- """Use this to execute python code. If you want to see the output of a value,- you should print it out with `print(...)`. This is visible to the user."""- try:- result = repl.run(code)- except BaseException as e:- return f"Failed to execute. Error: {repr(e)}"- return f"Succesfully executed:\n```python\n{code}\n```\nStdout: {result}"---# Helper function to create a node for a given agent-def _agent_node(messages: list, sender: str, agent, name: str, tracer: TracerFactory) -> dict:- """Helper function to create a node for a given agent."""+def _exercise_agent(messages: list, sender: str, agent, name: str, tracer: TracerFactory) -> dict:+ """Helper function to exercise the agent code."""tracer = LangChainTracer(tracer)result = agent.invoke({"messages": messages, "sender": sender}, config={"callbacks": [tracer]})# We convert the agent output into a format that is suitable to append to the global state@@ -117,7 +121,7 @@ def _agent_node(messages: list, sender: str, agent, name: str, tracer: TracerFac}-# Objects for the agents+# Define the actual agents via langchainllm = ChatOpenAI(model="gpt-4-1106-preview")research_agent = create_agent(llm,@@ -134,23 +138,21 @@ chart_agent = create_agent(@action(reads=["messages", "sender"], writes=["messages", "sender"])def research_node(state: State, __tracer: TracerFactory) -> tuple[dict, State]:# Research agent and node- result = _agent_node(state["messages"], state["sender"], research_agent, "Researcher", __tracer)+ result = _exercise_agent(+ state["messages"], state["sender"], research_agent, "Researcher", __tracer+ )return result, state.append(messages=result["messages"]).update(sender="Researcher")@action(reads=["messages", "sender"], writes=["messages", "sender"])def chart_node(state: State, __tracer: TracerFactory) -> tuple[dict, State]:# Chart agent and node- result = _agent_node(+ result = _exercise_agent(state["messages"], state["sender"], chart_agent, "Chart Generator", __tracer)return result, state.append(messages=result["messages"]).update(sender="Chart Generator")-tools = [tavily_tool, python_repl]-tool_executor = ToolExecutor(tools)--@action(reads=["messages"], writes=["messages"])def tool_node(state: State) -> tuple[dict, State]:"""This runs tools in the graph@@ -182,6 +184,7 @@ def tool_node(state: State) -> tuple[dict, State]:@action(reads=[], writes=[])def terminal_step(state: State) -> tuple[dict, State]:+ """Terminal step we have here that does nothing, but it could"""return {}, state@@ -191,34 +194,40 @@ class PrintStepHook(PostRunStepHook):print("state======\n", state)-def default_state_and_entry_point() -> tuple[dict, str]:+def default_state_and_entry_point(query: str = None) -> tuple[dict, str]:+ """Sets the default state & entry point+ :param query: the query for the agents to work on.+ :return:+ """+ if query is None:+ query = (+ "Fetch the UK's GDP over the past 5 years,"+ " then draw a line graph of it."+ " Once you code it up, finish."+ )return (dict(- messages=[- HumanMessage(- content="Fetch the UK's GDP over the past 5 years,"- " then draw a line graph of it."- " Once you code it up, finish."- )- ],+ messages=[HumanMessage(content=query)],sender=None,),"researcher",)-def main(app_instance_id: str = None):+def main(query: str = None, app_instance_id: str = None, sequence_id: int = None):"""Main function to run the multi-agent collaboration example.+ Pass in a query to start from a specific query.Pass in an app_instance_id to restart from a previous run.+ Pass in an sequence_id to restart from a previous run and a specific position in it."""project_name = "demo:lcel-multi-agent"if app_instance_id:tracker = burr_tclient.LocalTrackingClient(project_name)- persisted_state = tracker.load("demo", app_id=app_instance_id, sequence_no=None)+ persisted_state = tracker.load("demo", app_id=app_instance_id, sequence_no=sequence_id)if not persisted_state:print(f"Warning: No persisted state found for app_id {app_instance_id}.")- initial_state, entry_point = default_state_and_entry_point()+ initial_state, entry_point = default_state_and_entry_point(query)else:initial_state = persisted_state["state"]# for now we need to manually deserialize LangChain messages into LangChain Objects@@ -229,7 +238,7 @@ def main(app_instance_id: str = None):)entry_point = persisted_state["position"]else:- initial_state, entry_point = default_state_and_entry_point()+ initial_state, entry_point = default_state_and_entry_point(query)app = (core.ApplicationBuilder().with_state(**initial_state)@@ -262,4 +271,7 @@ def main(app_instance_id: str = None):if __name__ == "__main__":main()- # main(SOME_APP_ID) # use this to restart from a previous state+ # main("Fetch the UK's GDP over the past 5 years,"+ # " then draw a line graph of it."+ # " Once you code it up, finish.")+ # main(app_instance_id=SOME_APP_ID) # use this to restart from a previous statediff --git a/examples/multi-agent-collaboration/lcel/notebook.ipynb b/examples/multi-agent-collaboration/lcel/notebook.ipynbnew file mode 100644index 00000000..77a66cf1--- /dev/null+++ b/examples/multi-agent-collaboration/lcel/notebook.ipynb@@ -0,0 +1,752 @@+{+ "cells": [+ {+ "cell_type": "markdown",+ "id": "a80d8df22739b896",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Basic Multi-agent Collaboration\n",+ "\n",+ "A single agent can usually operate effectively using a handful of tools within a single domain, but even using powerful models like `gpt-4`, it can be less effective at using many tools. \n",+ "\n",+ "One way to approach complicated tasks is through a \"divide-and-conquer\" approach: create a \"specialized agent\" for each task or domain and route tasks to the correct \"expert\". This means that each agent can become a sequence of LLM calls that chooses how to use a specific \"tool\".\n",+ "\n",+ "This notebook (inspired by the paper [AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation](https://arxiv.org/abs/2308.08155), by Wu, et. al.) shows one way to do this using Burr.\n"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 1,+ "id": "41629c14988dec58",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:48:28.506330Z",+ "start_time": "2024-04-14T22:48:28.502236Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# %pip install -U burr[start] langchain-community langchain-core langchain-experimental openai"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 2,+ "id": "642649bc6414efb4",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:03:15.394918Z",+ "start_time": "2024-04-14T22:03:15.392234Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# Environment variables\n",+ "import os\n",+ "# Make sure TAVILY_API_KEY & OPENAI_API_KEY are set\n",+ "# os.environ['TAVILY_API_KEY'] = 'your_tavily_api_key' # get one at https://tavily.com\n",+ "# os.environ['OPENAI_API_KEY'] = 'your_openai_api_key' # get one at https://platform.openai.com"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 26,+ "id": "1bd6ddb8fb909d38",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:14:30.125534Z",+ "start_time": "2024-04-14T22:14:27.831337Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# import everything that you'll need\n",+ "import pprint\n",+ "import json\n",+ "from typing import Annotated, Any, Optional\n",+ "from uuid import UUID\n",+ "\n",+ "from langchain_community.tools.tavily_search import TavilySearchResults\n",+ "from langchain_core.callbacks import BaseCallbackHandler\n",+ "from langchain_core.messages import FunctionMessage, HumanMessage\n",+ "from langchain_core.outputs import LLMResult\n",+ "from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder\n",+ "from langchain_core.tools import tool\n",+ "from langchain_core.utils.function_calling import convert_to_openai_function\n",+ "from langchain_experimental.utilities import PythonREPL\n",+ "from langchain_openai import ChatOpenAI\n",+ "from langgraph.prebuilt.tool_executor import ToolExecutor, ToolInvocation\n",+ "\n",+ "from burr import core\n",+ "from burr.core import Action, State, action, default, expr\n",+ "from burr.lifecycle import PostRunStepHook\n",+ "from burr.tracking import client as burr_tclient\n",+ "from burr.visibility import ActionSpanTracer, TracerFactory"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "1ca3c55452268be9",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ " # Define the tools that the agents will use\n",+ "\n",+ "Here we construct the python objects that will be used as tools by our code."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 2,+ "id": "ed8e5eefad5726d",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:14:30.132311Z",+ "start_time": "2024-04-14T22:14:30.127372Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "tavily_tool = TavilySearchResults(max_results=5)\n",+ "repl = PythonREPL()\n",+ "\n",+ "@tool\n",+ "def python_repl(code: Annotated[str, \"The python code to execute to generate your chart.\"]):\n",+ " \"\"\"Use this to execute python code. If you want to see the output of a value,\n",+ " you should print it out with `print(...)`. This is visible to the user.\"\"\"\n",+ " try:\n",+ " # Warning: This executes code locally, which can be unsafe when not sandboxed\n",+ " result = repl.run(code)\n",+ " except BaseException as e:\n",+ " return f\"Failed to execute. Error: {repr(e)}\"\n",+ " return f\"Succesfully executed:\\n```python\\n{code}\\n```\\nStdout: {result}\"\n",+ "\n",+ "tools = [tavily_tool, python_repl]\n",+ "tool_executor = ToolExecutor(tools)"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "6126c2b461163f05",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Define the agents\n",+ "Our \"agents\" are effectively an execution of a series of LLM calls. \n",+ "In this example we use LCEL to orchestrate this series of LLM calls.\n",+ "\n",+ "Unfortunately LangChain & LCEL don't give you an easy way to figure out all the prompts used, etc."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 13,+ "id": "c37033a4a91bd2f3",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:14:30.791938Z",+ "start_time": "2024-04-14T22:14:30.358694Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# The Agent that we'll use. Our agents here only differ by the system message passed in.\n",+ "def create_agent(llm, tools, system_message: str):\n",+ " \"\"\"Helper function to create an agent with a system message and tools.\"\"\"\n",+ " functions = [convert_to_openai_function(t) for t in tools]\n",+ "\n",+ " prompt = ChatPromptTemplate.from_messages(\n",+ " [\n",+ " (\n",+ " \"system\",\n",+ " \"You are a helpful AI assistant, collaborating with other assistants.\"\n",+ " \" Use the provided tools to progress towards answering the question.\"\n",+ " \" If you are unable to fully answer, that's OK, another assistant with different tools \"\n",+ " \" will help where you left off. Execute what you can to make progress.\"\n",+ " \" If you or any of the other assistants have the final answer or deliverable,\"\n",+ " \" prefix your response with FINAL ANSWER so the team knows to stop.\"\n",+ " \" You have access to the following tools: {tool_names}.\\n{system_message}\",\n",+ " ),\n",+ " MessagesPlaceholder(variable_name=\"messages\"),\n",+ " ]\n",+ " )\n",+ " prompt = prompt.partial(system_message=system_message)\n",+ " prompt = prompt.partial(tool_names=\", \".join([tool.name for tool in tools]))\n",+ " return prompt | llm.bind_functions(functions)\n",+ "\n",+ "def _exercise_agent(messages: list, sender: str, agent, name: str) -> dict:\n",+ " \"\"\"Helper function to exercise the agent code.\"\"\"\n",+ " result = agent.invoke({\"messages\": messages, \"sender\": sender})\n",+ " # We convert the agent output into a format that is suitable to append to the global state\n",+ " if isinstance(result, FunctionMessage):\n",+ " pass\n",+ " else:\n",+ " result = HumanMessage(**result.dict(exclude={\"type\", \"name\"}), name=name)\n",+ " return {\n",+ " \"messages\": result,\n",+ " # Since we have a strict workflow, we can\n",+ " # track the sender so we know who to pass to next.\n",+ " \"sender\": name,\n",+ " }\n",+ "\n",+ "# Define the actual agents via langchain's LCEL\n",+ "llm = ChatOpenAI(model=\"gpt-4-1106-preview\")\n",+ "research_agent = create_agent(\n",+ " llm,\n",+ " [tavily_tool],\n",+ " system_message=\"You should provide accurate data for the chart generator to use.\",\n",+ ")\n",+ "chart_agent = create_agent(\n",+ " llm,\n",+ " [python_repl],\n",+ " system_message=\"Any charts you display will be visible by the user.\",\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "e0ce269d3e58716b",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Define the actions that map to agents\n",+ "We now then create specific actions that map to the agents we need for this not example.\n",+ " \n",+ "We want a \"chart generator\" action, that will map to an agent that can generate a chart based on provided context/data.\n",+ "\n",+ "We want a \"researcher\" action, that will map to an agent that can search for information on a topic.\n",+ "\n",+ "We then want a \"tool_node\" action, that will run a tool as specified by the prior action, i.e. agent."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 14,+ "id": "d262371331b8f996",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:28:18.243782Z",+ "start_time": "2024-04-14T22:28:18.231891Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "@action(reads=[\"messages\", \"sender\"], writes=[\"messages\", \"sender\"])\n",+ "def research_node(state: State) -> tuple[dict, State]:\n",+ " # Research agent and node\n",+ " result = _exercise_agent(state[\"messages\"], state[\"sender\"], research_agent, \"Researcher\")\n",+ " return result, state.append(messages=result[\"messages\"]).update(sender=\"Researcher\")\n",+ "\n",+ "\n",+ "@action(reads=[\"messages\", \"sender\"], writes=[\"messages\", \"sender\"])\n",+ "def chart_node(state: State) -> tuple[dict, State]:\n",+ " # Chart agent and node\n",+ " result = _exercise_agent(\n",+ " state[\"messages\"], state[\"sender\"], chart_agent, \"Chart Generator\"\n",+ " )\n",+ " return result, state.append(messages=result[\"messages\"]).update(sender=\"Chart Generator\")\n",+ "\n",+ "\n",+ "@action(reads=[\"messages\"], writes=[\"messages\"])\n",+ "def tool_node(state: State) -> tuple[dict, State]:\n",+ " \"\"\"This runs tools in the graph\n",+ "\n",+ " It takes in an agent action and calls that tool and returns the result.\"\"\"\n",+ " messages = state[\"messages\"]\n",+ " # Based on the continue condition\n",+ " # we know the last message involves a function call\n",+ " last_message = messages[-1]\n",+ " # We construct an ToolInvocation from the function_call\n",+ " tool_input = json.loads(last_message.additional_kwargs[\"function_call\"][\"arguments\"])\n",+ " # We can pass single-arg inputs by value\n",+ " if len(tool_input) == 1 and \"__arg1\" in tool_input:\n",+ " tool_input = next(iter(tool_input.values()))\n",+ " tool_name = last_message.additional_kwargs[\"function_call\"][\"name\"]\n",+ " action = ToolInvocation(\n",+ " tool=tool_name,\n",+ " tool_input=tool_input,\n",+ " )\n",+ " # We call the tool_executor and get back a response\n",+ " response = tool_executor.invoke(action)\n",+ " # We use the response to create a FunctionMessage\n",+ " function_message = FunctionMessage(\n",+ " content=f\"{tool_name} response: {str(response)}\", name=action.tool\n",+ " )\n",+ " # We return a list, because this will get added to the existing list\n",+ " return {\"messages\": [function_message]}, state.append(messages=function_message)\n",+ "\n",+ "\n",+ "@action(reads=[], writes=[])\n",+ "def terminal_step(state: State) -> tuple[dict, State]:\n",+ " \"\"\"Terminal step we have here that does nothing, but it could\"\"\"\n",+ " return {}, state"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "2f467fb7ae6360f9",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# Define the Graph / Application\n",+ "With Burr we need to now construct our application, i.e. graph, by:\n",+ "\n",+ "1. Defining what the actions are and how to transition between them.\n",+ "2. Defining the initial state of the application. In our example this means we need to provide a \"query\" for the agents to work on.\n",+ "\n",+ "Because Burr comes with built in persistence, we can also load a prior execution and continue from \n",+ "any point in its history by specifying a `app_instance_id` and `sequence_number` when building the application."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 15,+ "id": "79b4924965e77be3",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:27:20.323166Z",+ "start_time": "2024-04-14T22:27:20.319966Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# Adjust these if you want to load a prior execution\n",+ "app_instance_id = None\n",+ "sequence_id = None\n",+ "project_name = \"demo:lcel-multi-agent\"\n",+ "\n",+ "# CHANGE THIS IF YOU WANT SOMETHING DIFFERENT!\n",+ "default_query = (\"Fetch the UK's GDP over the past 5 years, then draw a line graph of it. \"\n",+ " \"Once the python code has been written and the graph drawn, the task is complete.\")"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 16,+ "id": "d8d69620528ea842",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:27:24.193962Z",+ "start_time": "2024-04-14T22:27:24.188457Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [],+ "source": [+ "# Determine initial state and entry point\n",+ "def default_state_and_entry_point(query: str = None) -> tuple[dict, str]:\n",+ " \"\"\"Sets the default state & entry point\n",+ " :param query: the query for the agents to work on.\n",+ " :return:\n",+ " \"\"\"\n",+ " return (\n",+ " dict(\n",+ " messages=[\n",+ " HumanMessage(\n",+ " content=query\n",+ " )\n",+ " ],\n",+ " sender=None,\n",+ " ),\n",+ " \"researcher\",\n",+ " )\n",+ "\n",+ "if app_instance_id:\n",+ " tracker = burr_tclient.LocalTrackingClient(project_name)\n",+ " persisted_state = tracker.load(\"demo\", app_id=app_instance_id, sequence_no=sequence_id)\n",+ " if not persisted_state:\n",+ " print(f\"Warning: No persisted state found for app_id {app_instance_id}.\")\n",+ " initial_state, entry_point = default_state_and_entry_point(default_query)\n",+ " else:\n",+ " initial_state = persisted_state[\"state\"]\n",+ " # for now we need to manually deserialize LangChain messages into LangChain Objects\n",+ " from langchain_core import messages\n",+ "\n",+ " initial_state = initial_state.update(\n",+ " messages=messages.messages_from_dict(persisted_state[\"state\"][\"messages\"])\n",+ " )\n",+ " entry_point = persisted_state[\"position\"]\n",+ "else:\n",+ " initial_state, entry_point = default_state_and_entry_point(default_query)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 17,+ "id": "5812de2d0cdc8f21",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:28:23.019998Z",+ "start_time": "2024-04-14T22:28:22.190999Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "data": {+ "image/svg+xml": [+ "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n",+ "<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\"\n",+ " \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\">\n",+ "<!-- Generated by graphviz version 9.0.0 (20230911.1827)\n",+ " -->\n",+ "<!-- Pages: 1 -->\n",+ "<svg width=\"1275pt\" height=\"194pt\"\n",+ " viewBox=\"0.00 0.00 1275.03 193.50\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n",+ "<g id=\"graph0\" class=\"graph\" transform=\"scale(1 1) rotate(0) translate(4 189.5)\">\n",+ "<polygon fill=\"white\" stroke=\"none\" points=\"-4,4 -4,-189.5 1271.03,-189.5 1271.03,4 -4,4\"/>\n",+ "<!-- researcher -->\n",+ "<g id=\"node1\" class=\"node\">\n",+ "<title>researcher</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M577.28,-185.5C577.28,-185.5 529.78,-185.5 529.78,-185.5 523.78,-185.5 517.78,-179.5 517.78,-173.5 517.78,-173.5 517.78,-161.5 517.78,-161.5 517.78,-155.5 523.78,-149.5 529.78,-149.5 529.78,-149.5 577.28,-149.5 577.28,-149.5 583.28,-149.5 589.28,-155.5 589.28,-161.5 589.28,-161.5 589.28,-173.5 589.28,-173.5 589.28,-179.5 583.28,-185.5 577.28,-185.5\"/>\n",+ "<text text-anchor=\"middle\" x=\"553.53\" y=\"-162.45\" font-family=\"Times,serif\" font-size=\"14.00\">researcher</text>\n",+ "</g>\n",+ "<!-- charter -->\n",+ "<g id=\"node2\" class=\"node\">\n",+ "<title>charter</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M568.53,-118.5C568.53,-118.5 538.53,-118.5 538.53,-118.5 532.53,-118.5 526.53,-112.5 526.53,-106.5 526.53,-106.5 526.53,-94.5 526.53,-94.5 526.53,-88.5 532.53,-82.5 538.53,-82.5 538.53,-82.5 568.53,-82.5 568.53,-82.5 574.53,-82.5 580.53,-88.5 580.53,-94.5 580.53,-94.5 580.53,-106.5 580.53,-106.5 580.53,-112.5 574.53,-118.5 568.53,-118.5\"/>\n",+ "<text text-anchor=\"middle\" x=\"553.53\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">charter</text>\n",+ "</g>\n",+ "<!-- researcher->charter -->\n",+ "<g id=\"edge3\" class=\"edge\">\n",+ "<title>researcher->charter</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M547.47,-149.08C546.9,-143.25 546.68,-136.59 546.82,-130.14\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"550.3,-130.66 547.38,-120.48 543.31,-130.26 550.3,-130.66\"/>\n",+ "</g>\n",+ "<!-- call_tool -->\n",+ "<g id=\"node3\" class=\"node\">\n",+ "<title>call_tool</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M343.16,-36C343.16,-36 303.91,-36 303.91,-36 297.91,-36 291.91,-30 291.91,-24 291.91,-24 291.91,-12 291.91,-12 291.91,-6 297.91,0 303.91,0 303.91,0 343.16,0 343.16,0 349.16,0 355.16,-6 355.16,-12 355.16,-12 355.16,-24 355.16,-24 355.16,-30 349.16,-36 343.16,-36\"/>\n",+ "<text text-anchor=\"middle\" x=\"323.53\" y=\"-12.95\" font-family=\"Times,serif\" font-size=\"14.00\">call_tool</text>\n",+ "</g>\n",+ "<!-- researcher->call_tool -->\n",+ "<g id=\"edge1\" class=\"edge\">\n",+ "<title>researcher->call_tool</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M517.56,-166.04C402.52,-164.19 49.16,-155.53 15.28,-118.5 -61.94,-34.09 178.25,-21 280.13,-19.19\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"280.09,-22.69 290.04,-19.04 279.99,-15.69 280.09,-22.69\"/>\n",+ "<text text-anchor=\"middle\" x=\"150.16\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">'function_call' in messages[-1].additional_kwargs</text>\n",+ "</g>\n",+ "<!-- terminal -->\n",+ "<g id=\"node4\" class=\"node\">\n",+ "<title>terminal</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M952.41,-36C952.41,-36 914.66,-36 914.66,-36 908.66,-36 902.66,-30 902.66,-24 902.66,-24 902.66,-12 902.66,-12 902.66,-6 908.66,0 914.66,0 914.66,0 952.41,0 952.41,0 958.41,0 964.41,-6 964.41,-12 964.41,-12 964.41,-24 964.41,-24 964.41,-30 958.41,-36 952.41,-36\"/>\n",+ "<text text-anchor=\"middle\" x=\"933.53\" y=\"-12.95\" font-family=\"Times,serif\" font-size=\"14.00\">terminal</text>\n",+ "</g>\n",+ "<!-- researcher->terminal -->\n",+ "<g id=\"edge2\" class=\"edge\">\n",+ "<title>researcher->terminal</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M589.57,-164.95C693.21,-159.65 988.38,-138.49 1046.53,-67.5 1068.62,-40.54 1016.57,-28.24 975.97,-22.87\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"976.47,-19.4 966.13,-21.68 975.63,-26.35 976.47,-19.4\"/>\n",+ "<text text-anchor=\"middle\" x=\"1147.78\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">'FINAL ANSWER' in messages[-1].content</text>\n",+ "</g>\n",+ "<!-- charter->researcher -->\n",+ "<g id=\"edge6\" class=\"edge\">\n",+ "<title>charter->researcher</title>\n",+ "<path fill=\"none\" stroke=\"black\" d=\"M559.59,-118.97C560.17,-124.8 560.38,-131.46 560.24,-137.92\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"556.76,-137.38 559.68,-147.57 563.75,-137.79 556.76,-137.38\"/>\n",+ "</g>\n",+ "<!-- charter->call_tool -->\n",+ "<g id=\"edge4\" class=\"edge\">\n",+ "<title>charter->call_tool</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M526.36,-95.61C469.3,-87.41 342.07,-68.98 340.28,-67.5 334.11,-62.37 330.21,-54.85 327.75,-47.26\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"331.21,-46.69 325.43,-37.82 324.41,-48.36 331.21,-46.69\"/>\n",+ "<text text-anchor=\"middle\" x=\"475.16\" y=\"-54.2\" font-family=\"Times,serif\" font-size=\"14.00\">'function_call' in messages[-1].additional_kwargs</text>\n",+ "</g>\n",+ "<!-- charter->terminal -->\n",+ "<g id=\"edge5\" class=\"edge\">\n",+ "<title>charter->terminal</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M580.79,-97.62C622.06,-94.28 702.55,-85.88 768.53,-67.5 786.86,-62.39 789.99,-57.03 808.03,-51 835.28,-41.89 866.59,-33.9 891.12,-28.19\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"891.78,-31.63 900.74,-25.98 890.22,-24.8 891.78,-31.63\"/>\n",+ "<text text-anchor=\"middle\" x=\"927.78\" y=\"-54.2\" font-family=\"Times,serif\" font-size=\"14.00\">'FINAL ANSWER' in messages[-1].content</text>\n",+ "</g>\n",+ "<!-- call_tool->researcher -->\n",+ "<g id=\"edge7\" class=\"edge\">\n",+ "<title>call_tool->researcher</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M320.76,-36.09C320,-45.83 320.5,-57.96 325.53,-67.5 343.19,-101 359.97,-101.46 393.78,-118.5 429.75,-136.63 473.8,-149.23 506.52,-156.95\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"505.59,-160.33 516.12,-159.15 507.15,-153.51 505.59,-160.33\"/>\n",+ "<text text-anchor=\"middle\" x=\"456.41\" y=\"-95.45\" font-family=\"Times,serif\" font-size=\"14.00\">sender == 'Researcher'</text>\n",+ "</g>\n",+ "<!-- call_tool->charter -->\n",+ "<g id=\"edge8\" class=\"edge\">\n",+ "<title>call_tool->charter</title>\n",+ "<path fill=\"none\" stroke=\"black\" stroke-dasharray=\"5,2\" d=\"M355.41,-20.22C426.44,-23.25 592.82,-32.31 609.53,-51 620.18,-62.91 607.31,-74.68 591.24,-83.64\"/>\n",+ "<polygon fill=\"black\" stroke=\"black\" points=\"589.68,-80.51 582.35,-88.15 592.85,-86.75 589.68,-80.51\"/>\n",+ "<text text-anchor=\"middle\" x=\"689.28\" y=\"-54.2\" font-family=\"Times,serif\" font-size=\"14.00\">sender == 'Chart Generator'</text>\n",+ "</g>\n",+ "</g>\n",+ "</svg>\n"+ ],+ "text/plain": [+ "<graphviz.graphs.Digraph at 0x10be69150>"+ ]+ },+ "execution_count": 17,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "# Build the application \n",+ "def build_application(state: dict, entry_point: str):\n",+ " _app = (\n",+ " core.ApplicationBuilder()\n",+ " .with_state(**state)\n",+ " .with_actions(\n",+ " researcher=research_node,\n",+ " charter=chart_node,\n",+ " call_tool=tool_node,\n",+ " terminal=terminal_step,\n",+ " )\n",+ " .with_transitions(\n",+ " (\"researcher\", \"call_tool\", expr(\"'function_call' in messages[-1].additional_kwargs\")),\n",+ " (\"researcher\", \"terminal\", expr(\"'FINAL ANSWER' in messages[-1].content\")),\n",+ " (\"researcher\", \"charter\", default),\n",+ " (\"charter\", \"call_tool\", expr(\"'function_call' in messages[-1].additional_kwargs\")),\n",+ " (\"charter\", \"terminal\", expr(\"'FINAL ANSWER' in messages[-1].content\")),\n",+ " (\"charter\", \"researcher\", default),\n",+ " (\"call_tool\", \"researcher\", expr(\"sender == 'Researcher'\")),\n",+ " (\"call_tool\", \"charter\", expr(\"sender == 'Chart Generator'\")),\n",+ " )\n",+ " .with_entrypoint(entry_point)\n",+ " .with_tracker(project=project_name)\n",+ " .build()\n",+ " )\n",+ " return _app\n",+ "app = build_application(initial_state, entry_point)\n",+ "app.visualize(\n",+ " output_file_path=\"statemachine\", include_conditions=True, format=\"png\"\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "b05e65c77dcc38b5",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "source": [+ "# open up the Burr UI to trace the execution\n",+ "In another terminal run:\n",+ "```bash\n",+ "burr\n",+ "```\n",+ "and then open up the browser to [http://localhost:7241](http://localhost:7241) to see the execution of the application when you exercise `.run()` below."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 22,+ "id": "9d0b8a14d4614069",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:30:27.699594Z",+ "start_time": "2024-04-14T22:30:27.696685Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "data": {+ "image/png": "iVBORw0KGgoAAAANSUhEUgAAA1sAAAHWCAYAAACBjZMqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAACFN0lEQVR4nOzdd1xW5f/H8dd9szeiIioO3NtyozlKBc2G2rCysmGlaWW2vm2tX1lZplZq5qrUcqTtVNwL98g9cQuIyN7c5/eHSZJoYMC5gffz8fBh97kvznkfuBI+XNe5LothGAYiIiIiIiJSqKxmBxARERERESmNVGyJiIiIiIgUARVbIiIiIiIiRUDFloiIiIiISBFQsSUiIiIiIlIEVGyJiIiIiIgUARVbIiIiIiIiRUDFloiIiIiISBFQsSUiIiIiIlIEVGyJiIjkw8qVK7FYLMyfP9/sKCIiUkKo2BIRKQQjRozAYrEQExOT5/tNmjShS5cuOa+PHTuGxWLh448/ztXOMAyeeuopLBYLI0aM+Nfrpqen89lnn3HTTTdRrlw5nJ2dqVKlCnfccQffffcd2dnZV1zz0h8nJycqVKhA+/btee211zhx4sQV579UYFz+MbVq1eLhhx/m6NGj+frcZGZmMn78eFq3bo2Xlxeenp60bt2a8ePHk5mZma9zFKfZs2czduxY067/z6+Tg4MD1atXp0+fPuzYsaNIrvn+++/z448/5rv95fku//PBBx9c8+N69uxJuXLliIqKuuK9+Ph4KleuTNu2bbHZbAW9BRERu+RodgAREbnIMAyefvppJk+ezJtvvvmvxda5c+fo2bMnW7duJTQ0lDfeeAM/Pz8iIyNZunQpDzzwAIcPH+bNN9/M9XH3338/t956KzabjQsXLrB582bGjh3LuHHjmDp1Kvfdd98V13r22Wdp3bo1mZmZbNu2jcmTJ/Pbb7+xa9cuqlSpctWMycnJ9OrVi1WrVnHbbbfxyCOPYLVaWbRoEc899xwLFizgt99+w8PD47o+Z0Vh9uzZ7N69m2HDhpma49LXKTs7m3379jFx4kT++OMPNmzYwA033FCo13r//fe5++676d27d74/pnv37jz88MO5jt14443X/JgJEybQpEkTnn/+eWbPnp3rvddee42YmBgWLVqE1arfBYtIKWGIiMh/9vbbbxuAce7cuTzfb9y4sdG5c+ec1xEREQZgjB49OufYkCFDDMB4/fXX83XN0NBQw2q1Gj/88EOe72/evNmYOXPmNa95ybFjx4x69eoZzs7Oxo4dO3KOr1ixwgCMefPm5Wo/fvx4AzDef//9a2Z88sknDcD47LPPrnjv888/NwBj0KBB1zxHYbPZbEZKSspV3+/Vq5dRo0aNK45f7XNR2K72dfr5558NwHjyyScL/ZoeHh7GgAED8t0eMIYMGXJd1/rwww8NwFi8eHHOsU2bNhlWq9V4+eWXr+ucBZWammpkZ2cXy7VEpGzTr45EROzAc889xxdffMGrr77K//3f//1r+/DwcBYvXsyTTz5J375982zTqlUr+vfvn6/r16hRgxkzZpCRkcFHH330r+1vueUWACIiIq7a5tSpU0ydOpVbbrmFoUOHXvH+kCFDuPnmm5kyZQqnTp0CLk63vPnmm69oa7PZqFq1KnfffXeuY2PHjqVx48a4urpSqVIlnnrqKS5cuJDrY2vWrMltt93G4sWLadWqFW5ubnz55Zd5Zu7SpQu//fYbx48fz5kaV7NmzSuyvPfeewQGBuLq6krXrl05fPjwFefauHEjPXr0wMfHB3d3dzp37sy6deuu+vn6N//8nP/000/06tWLKlWq4OLiQu3atXn33XdzTR0FOHToEHfddRcBAQG4uroSGBjIfffdR3x8PHBxSmBycjJff/11zj0/8sgj+cqUmppKWlpage5j+PDhNGvWjKeffpq0tDSys7MZNGgQNWrU4O233wZg//793H333fj5+eHq6kqrVq34+eefc50nNjaWF198kaZNm+Lp6Ym3tzc9e/Zk586dudpdmgr7/fff88Ybb1C1alXc3d1JSEggMzOTkSNHUrduXVxdXSlfvjw33XQTYWFhBbonEZGr0TRCERGTPf/884wfP55XXnmF999/P18f88svvwDw4IMPFlqO4OBgateuna8fNI8cOQJA+fLlr9rmjz/+IDs7+4qpZpd7+OGHWbFiBYsWLWLgwIH069ePESNGEBkZSUBAQE67tWvXcubMmVxTHJ966ilmzJjBo48+yrPPPktERASff/4527dvZ926dTg5OeW0PXDgAPfffz9PPfUUTzzxBPXr188zz+uvv058fDynTp3i008/BcDT0zNXmw8++ACr1cqLL75IfHw8H330Ef3792fjxo05bZYvX07Pnj1p2bIlb7/9NlarlenTp3PLLbewZs0a2rRpc9XPydX883M+Y8YMPD09GT58OJ6enixfvpy33nqLhIQERo8eDUBGRgahoaGkp6fzzDPPEBAQwOnTp/n111+Ji4vDx8eHb7/9loEDB9KmTRuefPJJAGrXrv2veWbMmMGECRMwDIOGDRvyxhtv8MADD/zrxzk6OjJ58mTat2/Pu+++i7+/P9u2bWPRokW4u7uzZ88eOnToQNWqVfnf//6Hh4cHc+fOpXfv3vzwww/06dMHgKNHj/Ljjz9yzz33EBQURFRUFF9++SWdO3dm7969V0xvfffdd3F2dubFF18kPT0dZ2dnRowYwahRo3LuPyEhgS1btrBt2za6d++e/y+OiMjVmD20JiJSGlzvNMIaNWoYgPHSSy8V6Hp9+vQxACMuLi7X8dTUVOPcuXM5fy5cuHDFNfOaRnjJnXfeaQBGfHy8YRh/T52bNm2ace7cOePMmTPGb7/9ZtSsWdOwWCzG5s2br3quYcOGGYCxffv2q7bZtm2bARjDhw83DMMwDhw4kOe0w6efftrw9PTMmf63Zs0aAzBmzZqVq92iRYuuOH7pc7xo0aKr5rjcv00jbNiwoZGenp5zfNy4cQZg7Nq1yzCMi9MU69ata4SGhho2my2nXUpKihEUFGR07979mte/9HUaOXKkce7cOSMyMtJYuXKlceONNxpAzrTRvKZCPvXUU4a7u7uRlpZmGIZhbN++PV9THws6jbB9+/bG2LFjjZ9++smYOHGi0aRJEwMwJkyYkO9zDB061HBycjI8PT2N+++/P+d4165djaZNm+bcg2Fc/Jy2b9/eqFu3bs6xtLS0K6YCRkREGC4uLsY777yTc+zS161WrVpXfM6aN29u9OrVK9+ZRUQKStMIRURMdGlVtnr16hXo4xISEoArR10mTZpExYoVc/7cdNNNBTrvpfMlJibmOv7YY49RsWJFqlSpQq9evXKmnbVq1eqq57p0Di8vr6u2ufTepfupV68eN9xwA3PmzMlpk52dzfz587n99ttxc3MDYN68efj4+NC9e3diYmJy/rRs2RJPT09WrFiR6zpBQUGEhobm99NwTY8++ijOzs45rzt27AiQszrjjh07OHToEA888ADnz5/PyZacnEzXrl1ZvXp1vlbbe/vtt6lYsSIBAQF06dKFI0eO8OGHH+ZMG730uYCLn+uYmBg6duxISkoK+/fvB8DHxweAxYsXk5KSUij3D7Bu3Tqee+457rjjDgYNGsTWrVtp0qQJr732Gqmpqfk6x3vvvUf58uWxWq05o4ixsbEsX76ce++9N+eeYmJiOH/+PKGhoRw6dIjTp08D4OLikrOQRnZ2NufPn8fT05P69euzbdu2K643YMCAXJ8zAF9fX/bs2cOhQ4f+y6dDROSqNI1QRKSYWCyWK4698sor/P777zz11FP4+vrmeibpWi4VKUlJSTk/UAPcddddNGnSBIAXXnjhiud3/k1SUlKu81/y1ltv0bFjRxwcHKhQoQINGzbE0fHa30IuneOfhdvl8irI+vXrx2uvvcbp06epWrUqK1euJDo6mn79+uW0OXToEPHx8fj7++d53ujo6Fyvg4KCrpm1IKpXr57rdbly5QBynhW79IP7gAEDrnqO+Pj4nI+7mieffJJ77rkHq9WKr68vjRs3xsXFJef9PXv28MYbb7B8+fKcYvXy88PF+x4+fDhjxoxh1qxZdOzYkTvuuIMHH3wwV7/5r5ydnRk6dGhO4ZWfIt/b25v69esTExNDpUqVADh8+DCGYfDmm29esYrmJdHR0VStWhWbzca4ceOYMGECERERufp6XtNb8+oD77zzDnfeeSf16tWjSZMm9OjRg4ceeohmzZrl99ZFRK5JxZaISCFwdXUFuOpv9VNSUnLaXM7T05M//viDTp060b9/f7y9vQkJCfnX6zVo0ACA3bt306FDh5zj1apVo1q1asDFIuBq+35dze7du/H398fb2zvX8aZNm9KtW7cCnathw4YA/Pnnn1ddqvzPP/8EoFGjRjnH+vXrx6uvvsq8efMYNmwYc+fOxcfHhx49euS0sdls+Pv7M2vWrDzPW7FixVyv/zmi8V84ODjkedwwjJxsAKNHj77qff9zRDIvdevWvernPC4ujs6dO+Pt7c0777xD7dq1cXV1Zdu2bbzyyiu5Rs4++eQTHnnkEX766SeWLFnCs88+y6hRo9iwYQOBgYH/miO/LvW72NjY6z7HpdwvvvjiVUci69SpA1xcrv7NN9/kscce491338XPzw+r1cqwYcPyHDnMqw906tSJI0eO5HxupkyZwqeffsqkSZMYOHDgdd+HiMglKrZERApBjRo1gIsLMVz6ofOSlJQUTp48edUiqnz58ixZsoQOHTrQt29fwsLCCA4Ovub1brvtNj744ANmzZqVq9j6L8LDwzly5EihLbrRs2dPHBwc+Pbbb6+6SMY333yDo6NjrkIqKCiINm3aMGfOHIYOHcqCBQvo3bt3rlGd2rVrs3TpUjp06FCohRTkPQJZEJcWl/D29i5wgZpfK1eu5Pz58yxYsIBOnTrlHL/a6pBNmzaladOmvPHGG6xfv54OHTowadKknJUv/+s9w9/TKP9Z6BZErVq1AHBycvrXz938+fO5+eabmTp1aq7jcXFxVKhQId/X9PPz49FHH+XRRx8lKSmJTp06MWLECBVbIlIo9MyWiEgh6Nq1K87OzkycOPGK36pPnjyZrKwsevbsedWPr1q1KmFhYXh4eNCrVy927dp1zet16NCB7t27M3nyZH766ac821waacmP48eP88gjj+Ds7MxLL72U74+7lmrVqvHoo4+ydOlSJk6ceMX7kyZNYvny5Tz++ONXjLD069ePDRs2MG3aNGJiYnJNIQS49957yc7O5t13373ivFlZWcTFxV13bg8Pj5xpeNejZcuW1K5dm48//jhnWublzp07d93nvuTS6NrlX+OMjAwmTJiQq11CQgJZWVm5jjVt2hSr1Up6enrOMQ8Pj3x/zvLKn5iYyNixY6lQoQItW7bM721cwd/fny5duvDll19y9uzZa17bwcHhij4+b968nGe68uP8+fO5Xnt6elKnTp1cnxsRkf9CI1siIoXA39+ft956izfeeINOnTpxxx134O7uzvr16/nuu+8ICQnh9ttvv+Y56taty+LFi+nSpQuhoaGsXbs25zf9eZk5cyY9evSgd+/e9OzZk27dulGuXDkiIyNZunQpq1evzrPA27ZtGzNnzsRmsxEXF8fmzZv54YcfsFgsfPvtt4X6vMqnn37K/v37efrpp1m0aFHOCNbixYv56aef6Ny5M5988skVH3fvvffy4osv8uKLL+Ln53fFKEfnzp156qmnGDVqFDt27CAkJAQnJycOHTrEvHnzGDduXL6ff/unli1bMmfOHIYPH07r1q3x9PT816/d5axWK1OmTKFnz540btyYRx99lKpVq3L69GlWrFiBt7d3ztL916t9+/aUK1eOAQMG8Oyzz+Z87f5ZfCxfvpyhQ4dyzz33UK9ePbKysvj2229xcHDgrrvuynXPS5cuZcyYMVSpUoWgoCDatm2b57W/+OILfvzxR26//XaqV6/O2bNnmTZtGidOnODbb7/NtXjI9fjiiy+46aabaNq0KU888QS1atUiKiqK8PBwTp06lbOP1m233cY777zDo48+Svv27dm1axezZs265v8z/9SoUSO6dOlCy5Yt8fPzY8uWLcyfPz/PfeFERK6LmUshioiUNjNnzjTatWtneHh4GC4uLkaDBg2MkSNH5lrG2jCuvQz7mjVrDDc3NyMoKMg4ffr0Na+XmppqjB071ggODja8vb0NR0dHIyAgwLjtttuMWbNmGVlZWVdc89IfR0dHw8/Pz2jbtq3x6quvGsePH7/i/JeWzf63pcOvJT093fj000+Nli1bGh4eHoa7u7vRokULY+zYsUZGRsZVP65Dhw4GYAwcOPCqbSZPnmy0bNnScHNzM7y8vIymTZsaL7/8snHmzJmcNjVq1CjQ8t5JSUnGAw88YPj6+uYsz28YV/9cXPq8Tp8+Pdfx7du3G3379jXKly9vuLi4GDVq1DDuvfdeY9myZde8fn6W6DcMw1i3bp3Rrl07w83NzahSpYrx8ssvG4sXLzYAY8WKFYZhGMbRo0eNxx57zKhdu7bh6upq+Pn5GTfffLOxdOnSXOfav3+/0alTJ8PNzc0ArrkM/JIlS4zu3bsbAQEBhpOTk+Hr62uEhIT8633lpXPnzkbjxo2vOH7kyBHj4YcfzrlG1apVjdtuu82YP39+Tpu0tDTjhRdeMCpXrmy4ubkZHTp0MMLDw43OnTvn2mbhWn34//7v/4w2bdoYvr6+hpubm9GgQQPjvffeu2a/FBEpCIthFGCeiYiIiIiIiOSLntkSEREREREpAiq2REREREREioCKLRERERERkSKgYktERERERKQIqNgSEREREREpAiq2REREREREioA2Nc4Hm83GmTNn8PLywmKxmB1HRERERERMYhgGiYmJVKlSBav12mNXKrby4cyZM1SrVs3sGCIiIiIiYidOnjxJYGDgNduo2MoHLy8v4OIn1Nvb2+Q0kJmZyZIlSwgJCcHJycnsOCIFov4rJZn6r5Rk6r9SktlT/01ISKBatWo5NcK1qNjKh0tTB729ve2m2HJ3d8fb29v0ziZSUOq/UpKp/0pJpv4rJZk99t/8PF6kBTJERERERESKgIotERERERGRIqBiS0REREREpAio2BIRERERESkCKrZERERERESKgIotERERERGRIqBiS0REREREpAio2BIRERERESkCKrZERERERESKgIotERERERGxW9k2g40RsWyNsbAxIpZsm2F2pHxzNDuAiIiIiIhIXhbtPsvIX/ZyNj4NcOCbQ1uo7OPK27c3okeTymbH+1ca2RIREREREbuzaPdZBs/c9leh9bfI+DQGz9zGot1nTUqWfyq2RERERETErmTbDEb+spe8JgxeOjbyl712P6VQxZaIiIiIiNiVTRGxV4xoXc4AzsansSkitvhCXQcVWyIiIiIiYleiE69eaF1PO7Oo2BIREREREbvi7+VaqO3MomJLRERERETsSpsgPyr7XL2QsgCVfVxpE+RXfKGug4otERERERGxKw5WC2/f3ijP9yx//f327Y1wsFrybGMvtM+WiIiIiIjYHW9XpzyPB5SgfbZUbImIiIiIiF0xDIOPFh8A4KF21Qlt5M+SNRsJ6diW4Dr+dj+idYmKLRERERERsSthe6PYcTIONycHnulal3KuDpzfZ9A2yK/EFFqgZ7ZERERERMSOZNsMPllyEIBHO9S0+xUHr0XFloiIiIiI2I2fd57mQFQi3q6OPNWpttlx/hMVWyIiIiIiYhcysmyMCbs4qjWoS2183PNeJKOkULElIiIiIiJ2Yc6Wk5yMTaWCpwuPtK9pdpz/TMWWiIiIiIiYLjUjm8+WHQLg2a51cHcu+Wv5qdgSERERERHTzVh/jOjEdALLuXFf6+pmxykUKrZERERERMRU8amZTFp1BIDnu9XD2bF0lCmm3sXEiRNp1qwZ3t7eeHt7ExwczB9//JHz/uTJk+nSpQve3t5YLBbi4uKuOEdsbCz9+/fH29sbX19fHn/8cZKSknK1+fPPP+nYsSOurq5Uq1aNjz76qKhvTURERERE8umr1UeJT82kXiVPet9Y1ew4hcbUYiswMJAPPviArVu3smXLFm655RbuvPNO9uzZA0BKSgo9evTgtddeu+o5+vfvz549ewgLC+PXX39l9erVPPnkkznvJyQkEBISQo0aNdi6dSujR49mxIgRTJ48ucjvT0REREREru1cYjrT1kUA8EJI/RK1afG/MfWps9tvvz3X6/fee4+JEyeyYcMGGjduzLBhwwBYuXJlnh+/b98+Fi1axObNm2nVqhUAn332Gbfeeisff/wxVapUYdasWWRkZDBt2jScnZ1p3LgxO3bsYMyYMbmKMhERERERKX5frDhMSkY2zav5EtKoktlxCpXdLPGRnZ3NvHnzSE5OJjg4OF8fEx4ejq+vb06hBdCtWzesVisbN26kT58+hIeH06lTJ5ydnXPahIaG8uGHH3LhwgXKlSt3xXnT09NJT0/PeZ2QkABAZmYmmZmZ13uLheZSBnvIIlJQ6r9Skqn/Skmm/iv26HRcKrM2HgdgeNfaZGVl5dnOnvpvQTKYXmzt2rWL4OBg0tLS8PT0ZOHChTRq1ChfHxsZGYm/v3+uY46Ojvj5+REZGZnTJigoKFebSpUq5byXV7E1atQoRo4cecXxJUuW4O7unq9sxSEsLMzsCCLXTf1XSjL1XynJ1H/Fnsw6bCUz20o9HxtxBzby+4Frt7eH/puSkpLvtqYXW/Xr12fHjh3Ex8czf/58BgwYwKpVq/JdcBWFV199leHDh+e8TkhIoFq1aoSEhODt7W1arksyMzMJCwuje/fuODmV7F21pexR/5WSTP1XSjL1X7E3h6KT2LJhPQDv9WvHDdV8r9rWnvrvpVlv+WF6seXs7EydOnUAaNmyJZs3b2bcuHF8+eWX//qxAQEBREdH5zqWlZVFbGwsAQEBOW2ioqJytbn0+lKbf3JxccHFxeWK405OTqZ/cS9nb3lECkL9V0oy9V8pydR/xV58tuIoNgNCGlWida2K+foYe+i/Bbm+3S1gb7PZcj0vdS3BwcHExcWxdevWnGPLly/HZrPRtm3bnDarV6/ONbcyLCyM+vXr5zmFUEREREREitafp+L4Y3ckFgu8GFrf7DhFxtRi69VXX2X16tUcO3aMXbt28eqrr7Jy5Ur69+8PXHymaseOHRw+fBi4+HzXjh07iI2NBaBhw4b06NGDJ554gk2bNrFu3TqGDh3KfffdR5UqVQB44IEHcHZ25vHHH2fPnj3MmTOHcePG5ZomKCIiIiIixWf04osPZ/W5oSr1KnmZnKbomDqNMDo6mocffpizZ8/i4+NDs2bNWLx4Md27dwdg0qRJuRaq6NSpEwDTp0/nkUceAWDWrFkMHTqUrl27YrVaueuuuxg/fnzOx/j4+LBkyRKGDBlCy5YtqVChAm+99ZaWfRcRERERMcH6IzGsORSDk4OF57vXMztOkTK12Jo6deo13x8xYgQjRoy4Zhs/Pz9mz559zTbNmjVjzZo1BY0nIiIiIiKFyDCMnFGt+9tUp5qf/az0XRTs7pktEREREREpnZbui2b7iThcnawMvbmO2XGKnIotEREREREpcjabwcd/jWo92iEIf29XkxMVPRVbIiIiIiJS5H7eeYYDUYl4uToyqFNts+MUCxVbIiIiIiJSpDKybIwJOwjAoM618XEvG3u9qdgSEREREZEiNXfLSU7EplDB04VHO9Q0O06xUbElIiIiIiJFJjUjm/HLDgHwzC11cHc2dUH0YqViS0REREREiszX4ceITkwnsJwb97epbnacYqViS0REREREikRCWiYTVx4BYFi3ejg7lq3yo2zdrYiIiIiIFJuvVh8lPjWTuv6e9Lmxqtlxip2KLRERERERKXTnEtOZujYCgBdC6uNgtZicqPip2BIRERERkUI3YeVhUjKyaR7oQ2jjSmbHMYWKLRERERERKVSnLqQwa8MJAF4KbYDFUvZGtUDFloiIiIiIFLJxSw+RkW2jfe3y3FS3gtlxTKNiS0RERERECs3h6CR+2HYKgBdD65ucxlwqtkREREREpNCMCTuAzYDujSrRono5s+OYSsWWiIiIiIgUil2n4vl9VyQWC7wYUrZHtUDFloiIiIiIFJKPFu8HoPcNVakf4GVyGvOp2BIRERERkf8s/Mh51hyKwdFq4flu9cyOYxdUbImIiIiIyH9iGAaj/xrVur9NdaqXdzc5kX1QsSUiIiIiIv/Jsn3RbDsRh6uTlWduqWN2HLuhYktERERERK6bzWbw8ZIDADzSPgh/b1eTE9kPFVsiIiIiInLdfvnzDPsjE/FydWRQ51pmx7ErKrZEREREROS6ZGbbGBN2EICnOtXC193Z5ET2RcWWiIiIiIhcl7lbTnL8fAoVPJ15tEOQ2XHsjootEREREREpsLTMbMYvOwTA0Jvr4OHiaHIi+6NiS0RERERECuzr9ceISkinqq8b97etbnYcu6RiS0RERERECiQhLZOJq44AMKxbXVwcHUxOZJ9UbImIiIiISIFMWX2UuJRM6vh70rdFoNlx7JaKLRERERERybeYpHSmrI0A4IXu9XCwWkxOZL9UbImIiIiISL5NWHGElIxsmgX60KNJgNlx7JqKLRERERERyZfTcanM3HAcgJdC62OxaFTrWlRsiYiIiIhIvoxbepCMbBvtavlxU50KZsexeyq2RERERETkXx05l8T8racAeLlHA41q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",+ "text/plain": [+ "<Figure size 1000x500 with 1 Axes>"+ ]+ },+ "metadata": {},+ "output_type": "display_data"+ }+ ],+ "source": [+ "# this will run until completion.\n",+ "last_action, last_result, last_state = app2.run(halt_after=[\"terminal\"])"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "c2880bdfee354b7",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:30:48.865592Z",+ "start_time": "2024-04-14T22:30:48.861637Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ },+ "scrolled": true+ },+ "outputs": [],+ "source": [+ "pprint.pprint(last_state)"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "dedde58d-f684-49d9-81a3-df52e75c447d",+ "metadata": {},+ "source": [+ "# Change the Query!\n",+ "Right now we provide the starting query as state. So we just create a new application by adjusting \n",+ "the initial state we provide."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 23,+ "id": "8883f456-2217-4802-be0f-3e14cc1475bd",+ "metadata": {},+ "outputs": [],+ "source": [+ "# Let's change the query\n",+ "initial_state, entry_point = default_state_and_entry_point(\"Fetch the USA's GDP over the past 5 years, then draw a line graph of it. \"\n",+ " \"Once the python code has been written and the graph drawn, the task is complete.\")\n",+ "app2 = build_application(initial_state, entry_point)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 27,+ "id": "7173415dbbb0b554",+ "metadata": {+ "ExecuteTime": {+ "end_time": "2024-04-14T22:29:47.695377Z",+ "start_time": "2024-04-14T22:28:41.193974Z"+ },+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "data": {+ "image/png": "iVBORw0KGgoAAAANSUhEUgAAA2QAAAHWCAYAAAAYdUqfAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8g+/7EAAAACXBIWXMAAA9hAAAPYQGoP6dpAAB4WklEQVR4nO3dd3gU5d7G8XvTCykEEgIkkAAiVXqzIB4gURHFioBIV5AcBaxYKJaXY0FFRTioBKQIWLChQAQEkR5ACE2Q0CQBQkghPdl5/8DsYU2ABJNMyvdzXblkZ56Z+c3yEPfeeeYZi2EYhgAAAAAAZc7B7AIAAAAAoKoikAEAAACASQhkAAAAAGASAhkAAAAAmIRABgAAAAAmIZABAAAAgEkIZAAAAABgEgIZAAAAAJiEQAYAAAAAJiGQAQBQBiwWiyIiIswuAwBQzhDIAKAUTJo0SRaLRQkJCYWub9Gihbp162a37MyZM3riiSfUpEkTubu7KyAgQB07dtSzzz6r8+fPF7qfDz/8UBaLRZ06dbqqOr/77jv17t1btWrVkouLi/z8/NS1a1dNnTpVKSkpdm1DQkJksVhksVjk4OAgX19ftWzZUo888og2b95c6P7z2+dvU6dOHYWFhennn38uco3ff/+9br31VtWoUUNubm5q3LixnnrqKZ09e/aqzrk0bdiwQZMmTVJSUpJpNVz892SxWBQQEKCbbrpJS5cuLZXjLVy4UO+++26R23fr1s2uvvyfW2+99bLb/ec//5HFYtGKFSsKXX/77bfLx8dHJ0+eLE75AGA6J7MLAABIiYmJat++vVJSUjR06FA1adJEZ8+e1a5duzRjxgyNGjVK1apVK7DdggULFBISoi1btujQoUNq1KhRkY5ntVo1bNgwzZkzRy1bttRjjz2m4OBgpaamauPGjXrxxRf1ww8/aNWqVXbbtW7dWk8++aQkKTU1Vfv27dPnn3+ujz76SGPHjtXbb79d4Fg9e/bUww8/LMMwFBsbqw8//FD/+te/tGzZMt12222XrfOpp57S1KlT1apVKz377LPy8/PT9u3b9cEHH2jRokVatWqVrr322iKdc1nYsGGDJk+erMGDB8vX19e0Oi7+ezp58qT++9//6p577tGMGTM0cuTIEj3WwoULFRMTozFjxhR5m6CgIE2ZMsVuWZ06dS67zZNPPqmFCxfqscceU0xMjNzd3W3rPv/8c/3444+aPn36FfcDAOWOAQAocRMnTjQkGWfOnCl0ffPmzY2bb77Z9vqNN94wJBm//vprgbbJyclGRkZGgeWHDx82JBlfffWV4e/vb0yaNKnI9U2ZMsWQZIwdO9awWq0F1p88edL4z3/+Y7esfv36Rq9evQq0TU9PN/r06WNIMj788EO7dZKM0aNH2y3btWuXIckICwu7bI0LFy40JBl9+/Y1cnNz7dZt3rzZ8PDwMFq2bGnk5ORcdj8l7fz585dc9+abbxqSjNjY2ALrCnsvSkNhf09xcXGGp6en0bhx4xI/Xq9evYz69esXuf3NN99sNG/e/KqOtXHjRsPBwcEYP368bVlKSopRp04do3PnzkZeXt5V7bc48vLyCv33CABXiyGLAFAO/PHHH3J0dFTnzp0LrPP29pabm1uB5QsWLFD16tXVq1cv3XfffVqwYEGRjpWenq7XX39dzZs315tvvimLxVKgTe3atfXss88WaX/u7u6aN2+e/Pz89Nprr8kwjMu2b9mypWrWrKnY2NjLtps8ebKqV6+uWbNmydHR0W5d/lDO3bt364svvpAkRUREqFq1akpPTy+wr379+ikwMFB5eXm2ZT/++KNuuukmeXp6ysvLS7169dKePXvsths8eLCqVaumP/74Q7fffru8vLw0YMCAQuudNGmSnn76aUlSaGiobSjekSNH7Np9/fXXatGihVxdXdW8eXMtX768wL7+/PNPDR06VLVq1bK1mz179mXfr8sJDAxU06ZNbe/5rl27NHjwYDVo0EBubm4KDAzU0KFDCwwDTU1N1ZgxYxQSEiJXV1cFBASoZ8+e2r59u6QLww+XLVumo0eP2s43JCSkSDXl5uZecijupXTu3FkjR47UW2+9pb1790qSXnzxRZ0+fVqzZs2Sg4ODkpKSNGbMGAUHB8vV1VWNGjXS66+/LqvVarevt956S9dff71q1Kghd3d3tWvXztaXLpZ/79+CBQvUvHlzubq62v7OFi1apHbt2snLy0ve3t5q2bKlpk2bVqxzAgACGQCUA/Xr11deXp7mzZtX5G0WLFige+65Ry4uLurXr58OHjyorVu3XnG79evXKykpSf369SsQdK5WtWrVdPfdd+vPP/+0fVC+lHPnzuncuXOqUaPGJdscPHhQBw4c0F133SVvb+9C2zz88MOSLtxj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+vbta2uTP7nDvHnzFBgYWGC/Tk72/2t0dXW9bHgsjkvds5d/BTS/toceekiDBg0qtO111113xePUrFnzsu/5Aw88oA0bNujpp59W69atVa1aNVmtVt166612k1888MADtmeYrVy5Um+++aZef/11ffXVV1d8ZEFxBAcHS7oQFP8Jq9Wqnj176plnnil0fePGjSVJv/zyi+6880517dpVH374oWrXri1nZ2dFRkZq4cKFBba7+GpavoCAAO3cuVMrVqzQjz/+qB9//FGRkZF6+OGHNXfu3H90HgCqFgIZAJSC+vXrS5IOHDhg+7CZLz09XcePH79saMrXoEEDVa9eXXFxcbZlCxYsUEBAgKZPn16g/VdffaWlS5dq5syZhX6IlKSbbrpJPj4+WrRokcaPH18iYeP8+fNaunSpgoODbWHqn8gPpF9//bWmTZtW6NDFTz/9VJJ0xx132C1/4IEHNG3aNKWkpGjx4sUKCQmxm70yf8hgQEBAsYPilRQ2Y2Vx+Pv7y8vLS3l5eSVeW75z585p1apVmjx5siZMmGBbnn/l8O9q166txx57TI899phOnz6ttm3b6rXXXrMFsn96zpJsV90ungDlajRs2FDnz5+/4nv35Zdfys3NTStWrJCrq6tteWRkZLGO5+Liot69e6t3796yWq167LHH9N///lcvvfRSkZ8JCAAMWQSAUtC9e3e5uLhoxowZBabbnjVrlnJzc+2uMGzevFlpaWkF9rNlyxadPXvW9vDjjIwMffXVV7rjjjt03333FfiJiIhQamqqbcheYTw8PPTMM88oJiZGzz33XKHT1Be27FIyMjI0cOBAJSYm6oUXXiiRD+iSNGHCBJ07d04jR44scF9cdHS0Xn/9dbVo0aLArId9+/ZVVlaW5s6dq+XLl+uBBx6wWx8eHi5vb2/93//9X6Ez+505c+aqa/b09JQkJSUlXdX2jo6Ouvfee/Xll1/arjiWVG0XH0Mq+Hf899kR8/LyCgzfCwgIUJ06dZSVlWVb5unpWegwv8KkpKTYbZtfx6uvvirpwt/NP/HAAw9o48aNWrFiRYF1SUlJys3NlXThPbBYLHb96siRI/r666+LfKy/31/p4OBgu3r593MEgMvhChkAlIKAgABNmDBBL774orp27ao777xTHh4e2rBhgz777DOFhYWpd+/etvbz5s3TggULdPfd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19dXYWFhOnfuXEnXBwAAAFzS+axcDZ69Vb8eOitPF0fNHdJRNzSqaXZZQJEVOZC9/fbbSktLs73esGGDJkyYoJdeeklLlizR8ePH9corr5RKkQAAAMDfJWfkaOAnm7XlSKK83Jw0b3gndWpQw+yygGIpciDbs2ePrr/+etvrL774Qj179tQLL7yge+65R1OnTtV3331XKkUCAAAAFzuXlq0BH2/SjmNJ8nF31sLhndW2XnWzywKKrciBLDU1VTVq/O8bh/Xr16t79+62182bN9fJkydLtjoAAADgbxLOZ6nfR5sU82eKani66LMRndUyyMfssoCrUuRAVrduXe3bt0+SdP78ef322292V8zOnj17yWeUAQAAACXhVEqmHpy1SfvjU+Xv5apFj3RWszreZpcFXLUiT3t///33a8yYMXr++ef1ww8/KDAwUJ07d7at37Ztm6699tpSKRIAAAA4mZSh/h9t0pGz6art46aFIzortKan2WUB/0iRA9mECRP0559/6vHHH1dgYKDmz58vR0dH2/rPPvtMvXv3LpUiAQAAULUdT0xXv4826cS5DAVVd9dnIzor2I/RWaj4ihzI3N3d9emnn15y/Zo1a0qkIAAAAOBisQlp6v/RJsUlZyqkhocWjOisur7uZpcFlIgiBzIAAACgrB08lar+H2/WmdQsNfT31MIRnVXL283ssoASU+RAVr16dVkslgLLfXx81LhxYz311FPq2bNniRYHAACAqmtfXIoe+nizzqZlq0mgl+YP76Sa1VzNLgsoUUUOZO+++26hy5OSkhQdHa077rhDX3zxBfeRAQAA4B/bfSJZA2dvVlJ6jlrU9da8oZ1U3dPF7LKAElfkQDZo0KDLrm/durWmTJlCIAMAAMA/sv3YOQ2avUWpmblqHeyruUM7ysfd2eyygFJR5OeQXckdd9yh/fv3l9TuAAAAUAVtiU3UwI83KzUzVx1D/DR/eCfCGCq1EpvUIysrSy4uXEYGAADA1fn1UIKGz92mjJw8Xd+whj4e1F4eLsxBh8qtxHr4J598otatW5fU7gAAAFCFrDlwWo/Oi1Z2rlU3N/bXfwe2k5uz45U3BCq4IgeycePGFbo8OTlZ27dv1++//65169aVWGEAAACoGlbuiVfEwh3KzrOqR9Namj6gjVydCGOoGoocyHbs2FHocm9vb/Xs2VNfffWV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",+ "text/plain": [+ "<Figure size 1000x500 with 1 Axes>"+ ]+ },+ "metadata": {},+ "output_type": "display_data"+ }+ ],+ "source": [+ "# this will run until completion.\n",+ "last_action, last_result, last_state = app2.run(halt_after=[\"terminal\"])"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 28,+ "id": "54543e628379f27a",+ "metadata": {+ "collapsed": false,+ "jupyter": {+ "outputs_hidden": false+ }+ },+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "{'messages': [HumanMessage(content=\"Fetch the USA's GDP over the past 5 years, then draw a line graph of it. Once the python code has been written and the graph drawn, the task is complete.\"), HumanMessage(content='', additional_kwargs={'function_call': {'arguments': '{\"query\":\"USA GDP by year for the past 5 years\"}', 'name': 'tavily_search_results_json'}}, name='Researcher'), FunctionMessage(content='tavily_search_results_json response: [{\\'url\\': \\'https://usafacts.org/data/topics/economy/economic-indicators/gdp/gross-domestic-product/\\', \\'content\\': \\'Data Adjustments\\\\nIs the economy growing?\\\\nRelated Metrics\\\\nAnnual percent change in real GDP\\\\n5.7%\\\\n2021\\\\nAnnual percent change in real GDP\\\\n5.7%\\\\n2021\\\\nExplore Gross domestic product\\\\nInteract with the data\\\\nData Adjustments\\\\nState Display\\\\nOur nation, in numbers\\\\nUSAFacts is a not-for-profit, nonpartisan civic initiative making government data easy for all Americans to access and understand.\\\\n • Check your spelling\\\\n• Try other search terms\\\\n• Use fewer words\\\\nGross domestic product\\\\nGross domestic product\\\\nGross domestic product (GDP) is the value of all goods and services produced in the US. All topics\\\\nExplore articles, data and trends by topic\\\\nAbout\\\\nWhat makes USAFacts different\\\\nWe frequently add data and we\\\\\\'re interested in what would be useful to people. Newsletter\\\\nData delivered to your inbox\\\\nKeep up with the latest data and most popular content. But only the official BEA inflation-adjusted \"real GDP\" value is used to calculate annual percent change in GDP and therefore how well the economy is doing.\\'}, {\\'url\\': \\'https://www.bea.gov/data/gdp/gross-domestic-product\\', \\'content\\': \\'Q3 2023. +4.9%. Real gross domestic product (GDP) increased at an annual rate of 3.4 percent in the fourth quarter of 2023, according to the \"third\" estimate. In the third quarter, real GDP increased 4.9 percent. The increase in the fourth quarter primarily reflected increases in consumer spending, state and local government spending ...\\'}, {\\'url\\': \\'https://www.statista.com/statistics/188105/annual-gdp-of-the-united-states-since-1990/\\', \\'content\\': \\'Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\\\xa0Mio. facts.\\\\n What is GDP?\\\\nGDP and national debt\\\\nGross domestic product of the United States from 1990 to 2022\\\\n(in billion current U.S. dollars )\\\\nAdditional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nJanuary 2023\\\\nUnited States\\\\n1990 to 2022\\\\nOther statistics on the topicService sector of the U.S.\\\\nEconomy\\\\nU.S. real GDP growth by quarter Q1 2013- Statistics on\\\\n\"\\\\nGDP of the U.S.\\\\n\"\\\\nOther statistics that may interest you GDP of the U.S.\\\\nOverview\\\\nGDP by sector and industry\\\\nGDP by state\\\\nGDP by metropolitan area\\\\nInternational comparison\\\\nFurther related statistics\\\\nFurther Content: You might find this interesting as well\\\\nStatistics\\\\nTopics Q3 2023\\\\nEconomy\\\\nU.S. real GDP growth rate 1990-2022\\\\nEconomy\\\\nCountries with the largest gross domestic product (GDP) per capita 2022\\\\nEconomy\\\\nCountries with the largest gross domestic product (GDP) 2022\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nU.S. annual GDP 1990-2022\\\\n\\'}, {\\'url\\': \\'https://www.macrotrends.net/global-metrics/countries/USA/united-states/gdp-gross-domestic-product\\', \\'content\\': \"U.S. gdp for 2021 was $23,315.08B, a 10.71% increase from 2020. U.S. gdp for 2020 was $21,060.47B, a 1.5% decline from 2019. U.S. gdp for 2019 was $21,380.98B, a 4.13% increase from 2018. GDP at purchaser\\'s prices is the sum of gross value added by all resident producers in the economy plus any product taxes and minus any subsidies not included ...\"}, {\\'url\\': \\'https://www.thebalancemoney.com/us-gdp-by-year-3305543\\', \\'content\\': \"U.S. GDP by Year, Compared to Recessions and Events\\\\nThe Strange Ups and Downs of the U.S. Economy Since 1929\\\\nThe Balance / Julie Bang\\\\nU.S. gross domestic product (GDP) by year is a good overview of economic growth in the United States. Rebasing changes the reference year (or base year) for the real (chained dollar and quantity index) estimates and price indexes and expresses GDP and other NIPA aggregates in terms of the prices of one year. You can compare the GDP by year to fiscal and monetary policies to get a complete picture of what works and what doesn\\'t in the U.S. economy.\\\\n Real GDP is important because without canceling out the effects of inflation, the GDP could appear to grow, when really all that\\'s happened is an increase in prices.\\\\n Key Takeaways\\\\nTypes of GDP\\\\nThe\\\\xa0Bureau of Economic Analysis\\\\xa0compiles the data.\"}]', name='tavily_search_results_json'), HumanMessage(content=\"The search results provided do not seem to contain the explicit annual GDP values for the United States over the past 5 years that we need to create a line graph. Given this, I'll perform another search to try and find these specific GDP figures for the years 2018, 2019, 2020, 2021, and 2022. Let's proceed with that.\", additional_kwargs={'function_call': {'arguments': '{\"query\":\"USA GDP 2018 2019 2020 2021 2022\"}', 'name': 'tavily_search_results_json'}}, name='Researcher'), FunctionMessage(content='tavily_search_results_json response: [{\\'url\\': \\'https://www.statista.com/topics/772/gdp/\\', \\'content\\': \\'U.S. gross domestic product contributions 2000-2021, by sector\\\\nValue added to gross domestic product across economic sectors in the United States from 2000 to 2021 (as a share of GDP)\\\\nU.S. change in real value added to GDP 2022, by industry\\\\nChange in real value added to the gross domestic product of the United States in 2022, by industry\\\\nU.S. change in value added to real GDP 2012-2022, by industry\\\\nTen year percentage change in value added to the real gross domestic product of the United States between 2012 and 2022, by industry\\\\nU.S. value added to GDP by manufacturing industry 2000-2022\\\\nValue added to the gross domestic product by the manufacturing industry in the United States from 2000 to 2022 (in trillion U.S. dollars)\\\\nTech GDP as a percent of total GDP in the U.S. 2017-2022\\\\nTech sector as a percentage of total gross domestic product (GDP) in the United States from 2017 to 2022\\\\nU.S. digital economy value added to GDP 2021, by industry\\\\nValue added to the total economy (GDP) by the digital economy in the United States in 2021, by industry (in million U.S. dollars)\\\\n U.S. value added to GDP by construction industry 2000-2022\\\\nValue added to gross domestic product by the construction industry in the United States from 2000 to 2022 (in billion U.S. dollars)\\\\nGDP by state\\\\nGDP by state\\\\nU.S. gross domestic product 2022, by state\\\\nGross domestic product of the United States in 2022, by state (in billion current U.S. dollars)\\\\nU.S. real gross domestic product 2022, by state\\\\nReal gross domestic product (GDP) of the United States in 2022, by state (in billion chained 2017 U.S. dollars)\\\\nU.S. real GDP growth 2022, by state\\\\nPercent change in the real gross domestic product of the United States in 2022, by state\\\\nU.S. real GDP of California 2000-2022\\\\nReal gross domestic product of California in the United States from 2000 to 2022 (in billion U.S. dollars)\\\\n U.S. real value added to GDP in Florida, by industry\\\\nReal value added to the gross domestic product of Florida in the United States in 2022, by industry (in billion chained 2017 U.S. dollars)\\\\nGDP by metropolitan area\\\\nGDP by metropolitan area\\\\nU.S. metro areas - ranked by Gross Metropolitan Product (GMP) 2021\\\\nForecasted Gross Metropolitan Product (GMP) of the United States in 2021, by metropolitan area (in billion current U.S. dollars)\\\\nU.S. real GDP 2021, by metro area\\\\nReal gross domestic product of the United States in 2021, by metropolitan area (in million chained 2012 U.S. dollars)\\\\nU.S. real GDP annual percent change 2021, by metro area\\\\nAnnual percent change in the real GDP of the United States in 2021, by metropolitan area\\\\nU.S. real GDP per capita 2021, by metro area\\\\nPer capita real gross domestic product of the United States in 2021, by metropolitan area (in chained 2012 U.S. dollars)\\\\n U.S. gross value added to GDP 2022, by sector\\\\nGross value added to the gross domestic product in the United States from 1990 to 2022, by sector (in billion U.S. dollars)\\\\nU.S. budget balance and forecast as a percentage of GDP 2000-2033\\\\nBudget balance and forecast of the United States government from 2000 to 2033 (as a percentage of GDP)\\\\nGDP by sector and industry\\\\nGDP by sector and industry\\\\nU.S. real value added to GDP 1990-2022, by sector\\\\nReal gross value added to the gross domestic product of the United States from 1990 to 2022, by sector (in billion chained 2017 U.S. dollars)\\\\n The 20 countries with the largest gross domestic product (GDP) per capita in 2022 (in U.S. dollars)\\\\nGDP growth in the leading industrial and emerging countries 2nd quarter 2023\\\\nGrowth of the real gross domestic product (GDP) in the leading industrial and emerging countries from 2nd quarter 2021 to 2nd quarter 2023 (compared to the previous quarter)\\\\nRelated topics\\\\nRecommended\\\\nReport on the topic\\\\nKey figures\\\\nThe most important key figures provide you with a compact summary of the topic of \"GDP of the United States\" and take you straight to the corresponding statistics.\\\\n\\'}, {\\'url\\': \\'https://www.statista.com/statistics/188105/annual-gdp-of-the-united-states-since-1990/\\', \\'content\\': \\'Industry Overview\\\\nDigital & Trend reports\\\\nOverview and forecasts on trending topics\\\\nIndustry & Market reports\\\\nIndustry and market insights and forecasts\\\\nCompanies & Products reports\\\\nKey figures and rankings about companies and products\\\\nConsumer & Brand reports\\\\nConsumer and brand insights and preferences in various industries\\\\nPolitics & Society reports\\\\nDetailed information about political and social topics\\\\nCountry & Region reports\\\\nAll key figures about countries and regions\\\\nMarket forecast and expert KPIs for 1000+ markets in 190+ countries & territories\\\\nInsights on consumer attitudes and behavior worldwide\\\\nBusiness information on 100m+ public and private companies\\\\nExplore Company Insights\\\\nDetailed information for 39,000+ online stores and marketplaces\\\\nDirectly accessible data for 170 industries from 150+ countries\\\\nand over 1\\\\xa0Mio. facts.\\\\n What is GDP?\\\\nGDP and national debt\\\\nGross domestic product of the United States from 1990 to 2022\\\\n(in billion current U.S. dollars )\\\\nAdditional Information\\\\nShow sources information\\\\nShow publisher information\\\\nUse Ask Statista Research Service\\\\nJanuary 2023\\\\nUnited States\\\\n1990 to 2022\\\\nOther statistics on the topicService sector of the U.S.\\\\nEconomy\\\\nU.S. real GDP growth by quarter Q1 2013- Statistics on\\\\n\"\\\\nGDP of the U.S.\\\\n\"\\\\nOther statistics that may interest you GDP of the U.S.\\\\nOverview\\\\nGDP by sector and industry\\\\nGDP by state\\\\nGDP by metropolitan area\\\\nInternational comparison\\\\nFurther related statistics\\\\nFurther Content: You might find this interesting as well\\\\nStatistics\\\\nTopics Q3 2023\\\\nEconomy\\\\nU.S. real GDP growth rate 1990-2022\\\\nEconomy\\\\nCountries with the largest gross domestic product (GDP) per capita 2022\\\\nEconomy\\\\nCountries with the largest gross domestic product (GDP) 2022\\\\n Transforming data into design:\\\\nStatista Content & Design\\\\nStrategy and business building for the data-driven economy:\\\\nU.S. annual GDP 1990-2022\\\\n\\'}, {\\'url\\': \\'https://tradingeconomics.com/united-states/gdp\\', \\'content\\': \\'The Gross Domestic Product (GDP) in the United States was worth 25439.70 billion US dollars in 2022, according to official data from the World Bank. The GDP value of the United States represents 10.91 percent of the world economy. This page provides - United States GDP - actual values, historical data, forecast, chart, statistics, economic calendar and news.\\'}, {\\'url\\': \\'https://www.bea.gov/data/gdp/gross-domestic-product\\', \\'content\\': \\'Q3 2023. +4.9%. Real gross domestic product (GDP) increased at an annual rate of 3.4 percent in the fourth quarter of 2023, according to the \"third\" estimate. In the third quarter, real GDP increased 4.9 percent. The increase in the fourth quarter primarily reflected increases in consumer spending, state and local government spending ...\\'}, {\\'url\\': \\'https://www.macrotrends.net/global-metrics/countries/USA/united-states/gdp-gross-domestic-product\\', \\'content\\': \"U.S. gdp for 2022 was $25,462.70B, a 9.21% increase from 2021. U.S. gdp for 2021 was $23,315.08B, a 10.71% increase from 2020. U.S. gdp for 2020 was $21,060.47B, a 1.5% decline from 2019. U.S. gdp for 2019 was $21,380.98B, a 4.13% increase from 2018. GDP at purchaser\\'s prices is the sum of gross value added by all resident producers in the ...\"}]', name='tavily_search_results_json'), HumanMessage(content=\"From the search results, we have the GDP figures for the United States for the years 2018 to 2022. Here are the values:\\n\\n- 2018: $21,380.98 billion\\n- 2019: $21,060.47 billion (a 1.5% decline from 2018)\\n- 2020: $21,380.98 billion (approximately equal to 2018 as there is no explicit value given for 2020; the 1.5% decline from 2019 would indicate it's the same as 2018)\\n- 2021: $23,315.08 billion\\n- 2022: $25,462.70 billion\\n\\nWith these values, we can generate a line graph using Python. Here is a sample code using matplotlib to create the line graph:\\n\\n```python\\nimport matplotlib.pyplot as plt\\n\\n# GDP values in billions of dollars\\nyears = ['2018', '2019', '2020', '2021', '2022']\\ngdp_values = [21380.98, 21060.47, 21380.98, 23315.08, 25462.70]\\n\\nplt.figure(figsize=(10, 5))\\nplt.plot(years, gdp_values, marker='o')\\nplt.title('USA GDP Over the Past 5 Years')\\nplt.xlabel('Year')\\nplt.ylabel('GDP in Billion USD')\\nplt.grid(True)\\nplt.show()\\n```\\n\\nRunning this code will generate a line graph depicting the GDP of the United States from 2018 to 2022.\", name='Researcher'), HumanMessage(content='', additional_kwargs={'function_call': {'arguments': '{\"code\":\"import matplotlib.pyplot as plt\\\\n\\\\n# GDP values in billions of dollars\\\\nyears = [\\'2018\\', \\'2019\\', \\'2020\\', \\'2021\\', \\'2022\\']\\\\ngdp_values = [21380.98, 21060.47, 21380.98, 23315.08, 25462.70]\\\\n\\\\nplt.figure(figsize=(10, 5))\\\\nplt.plot(years, gdp_values, marker=\\'o\\')\\\\nplt.title(\\'USA GDP Over the Past 5 Years\\')\\\\nplt.xlabel(\\'Year\\')\\\\nplt.ylabel(\\'GDP in Billion USD\\')\\\\nplt.grid(True)\\\\nplt.show()\\\\n\"}', 'name': 'python_repl'}}, name='Chart Generator'), FunctionMessage(content=\"python_repl response: Succesfully executed:\\n```python\\nimport matplotlib.pyplot as plt\\n\\n# GDP values in billions of dollars\\nyears = ['2018', '2019', '2020', '2021', '2022']\\ngdp_values = [21380.98, 21060.47, 21380.98, 23315.08, 25462.70]\\n\\nplt.figure(figsize=(10, 5))\\nplt.plot(years, gdp_values, marker='o')\\nplt.title('USA GDP Over the Past 5 Years')\\nplt.xlabel('Year')\\nplt.ylabel('GDP in Billion USD')\\nplt.grid(True)\\nplt.show()\\n\\n```\\nStdout: \", name='python_repl'), HumanMessage(content='The line graph depicting the GDP of the United States from 2018 to 2022 has been successfully created. \\n\\nFINAL ANSWER:\\n\\nThe task is now complete.', name='Chart Generator')], 'sender': 'Chart Generator', '__SEQUENCE_ID': 8, '__PRIOR_STEP': 'terminal'}\n"+ ]+ }+ ],+ "source": [+ "pprint.pprint(last_state)"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "7e15b805-4feb-4541-8d2f-5075368bb293",+ "metadata": {},+ "outputs": [],+ "source": []+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": "Python 3 (ipykernel)",+ "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.10.4"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 5+}diff --git a/examples/multi-agent-collaboration/lcel/requirements.txt b/examples/multi-agent-collaboration/lcel/requirements.txtnew file mode 100644index 00000000..6a5b84b5--- /dev/null+++ b/examples/multi-agent-collaboration/lcel/requirements.txt@@ -0,0 +1,5 @@+burr[start]+langchain-community+langchain-core+langchain-experimental+openaidiff --git a/examples/multi-agent-collaboration/statemachine.png b/examples/multi-agent-collaboration/lcel/statemachine.pngsimilarity index 100%rename from examples/multi-agent-collaboration/statemachine.pngrename to examples/multi-agent-collaboration/lcel/statemachine.pngdiff --git a/examples/multi-agent-collaboration/requirements.txt b/examples/multi-agent-collaboration/requirements.txtindex 5c9d0fad..149171c8 100644--- a/examples/multi-agent-collaboration/requirements.txt+++ b/examples/multi-agent-collaboration/requirements.txt@@ -1,7 +1,6 @@-burr+burr[start]langchain-communitylangchain-corelangchain-experimental-langgraphopenaisf-hamilton[visualization]