From 4d2456be409758bd68a5eef964accfa74fe2d0ed Mon Sep 17 00:00:00 2001 From: Lance Martin <122662504+rlancemartin@users.noreply.github.com> Date: Wed, 10 Jul 2024 13:24:16 -0700 Subject: [PATCH] Update HIL update / edit state documentation (#966) * Update user input example * Update editing graph state * Minor clarifications --- .../human_in_the_loop/edit-graph-state.ipynb | 219 ++++++++++-- .../human_in_the_loop/wait-user-input.ipynb | 336 +++++++++++++++--- 2 files changed, 482 insertions(+), 73 deletions(-) diff --git a/examples/human_in_the_loop/edit-graph-state.ipynb b/examples/human_in_the_loop/edit-graph-state.ipynb index b432cd84d..1a361365b 100644 --- a/examples/human_in_the_loop/edit-graph-state.ipynb +++ b/examples/human_in_the_loop/edit-graph-state.ipynb @@ -1,19 +1,22 @@ { "cells": [ { + "attachments": { + "49539520-097a-43d5-94b4-2b56193a579f.png": { + "image/png": "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AQQQQAABBBBAwFYBAlC28tI5AggggAACCCCAAAIIIIAAAggggAABKH4DCCCAAAIIIIAAAggggAACCCCAAAK2ChCAspWXzhFAAAEEEEAAAQQQQAABBBBAAAEECEDxG0AAAQQQQAABBBBAAAEEEEAAAQQQsFWAAJStvHSOAAIIIIAAAggggAACCCCAAAIIIEAAit8AAggggAACCCCAAAIIIIAAAggggICtAgSgbOWlcwQQQAABBBBAAAEEEEAAAQQQQAABAlD8BhBAAAEEEEAAAQQQQAABBBBAAAEEbBUgAGUrL50jgAACCCCAAAIIIIAAAggggAACCBCA4jeAAAIIIIAAAggggAACCCCAAAIIIGCrAAEoW3npHAEEEEAAAQQQQAABBBBAAAEEEECAABS/AQQQQAABBBBAAAEEEEAAAQQQQAABWwUIQNnKS+cIIIAAAggggAACCCCAAAIIIIAAAgSg+A0ggAACCCCAAAIIIIAAAggggAACCNgqQADKVl46RwABBBBAAAEEEEAAAQQQQAABBBAgAMVvAAEEEEAAAQQQQAABBBBAAAEEEEDAVgECULby0jkCCCCAAAIIIIAAAggggAACCCCAAAEofgMIIIAAAggggAACCCCAAAIIIIAAArYKEICylZfOEUAAAQQQQAABBBBAAAEEEEAAAQQIQPEbQAABBBBAAAEEEEAAAQQQQAABBBCwVYAAlK28dI4AAggggAACCCCAAAIIIIAAAgggQACK3wACCCCAAAIIIIAAAggggAACCCCAgK0CBKBs5aVzBBBAAAEEEEAAAQQQQAABBBBAAAECUPwGEEAAAQQQQAABBBBAAAEEEEAAAQRsFSAAZSsvnSOAAAIIIIAAAggggAACCCCAAAIIEIDiN4AAAggggAACCCCAAAIIIIAAAgggYKsAAShbeekcAQQQQAABBBBAAAEEEEAAAQQQQIAAFL8BBBBAAAEEEEAAAQQQQAABBBBAAAFbBQhA2cpL5wgggAACCCCAAAIIIIAAAggggAACBKD4DSCAAAIIIIAAAggggAACCCCAAAII2CpAAMpWXjpHAAEEEEAAAQQQQAABBBBAAAEEECAAxW8AAQQQQAABBBBAAAEEEEAAAQQQQMBWAQJQtvLSOQIIIIAAAggggAACCCCAAAIIIIAAASh+AwgggAACCCCAAAIIIIAAAggggAACtgoQgLKVl84RQAABBBBAAAEEEEAAAQQQQAABBAhA8RtAAAEEEEAAAQQQQAABBBBAAAEEELBVgACUrbx0jgACCCCAAAIIIIAAAggggAACCCBAAIrfAAIIIIAAAggggAACCCCAAAIIIICArQIEoGzlpXMEEEAAAQQQQAABBBBAAAEEEEAAAQJQ/AYQQAABBBBAAAEEEEAAAQQQQAABBGwVIABlKy+dI4AAAggggAACCCCAAAIIIIAAAggQgOI3gAACCCCAAAIIIIAAAggggAACCCBgqwABKFt56RwBBBBAAAEEEEAAAQQQQAABBBBAgAAUvwEEEEAAAQQQQAABBBBAAAEEEEAAAVsFCEDZykvnCCCAAAIIIIAAAggggAACCCCAAAIEoPgNIIAAAggggAACCCCAAAIIIIAAAgjYKkAAylZeOkcAAQQQQAABBBBAAAEEEEAAAQQQIADFbwABBBBAAAEEEEAAAQQQQAABBBBAwFYBAlC28tI5AggggAACCCCAAAIIIIAAAggggAABKH4DCCCAAAIIIIAAAggggAACCCCAAAK2ChCAspWXzhFAAAEEEEAAAQQQQAABBBBAAAEECEDxG0AAAQQQQAABBBBAAAEEEEAAAQQQsFWAAJStvHSOAAIIIIAAAggggAACCCCAAAIIIEAAit8AAggggAACCCCAAAIIIIAAAggggICtAgSgbOWlcwQQQAABBBBAAAEEEEAAAQQQQAABAlD8BhBAAAEEEEAAAQQQQAABBBBAAAEEbBUgAGUrL50jgAACCCCAAAIIIIAAAggggAACCBCA4jeAAAIIIIAAAggggAACCCCAAAIIIGCrAAEoW3npHAEEEEAAAQQQQAABBBBAAAEEEECAABS/AQQQQAABBBBAAAEEEEAAAQQQQAABWwUIQNnKS+cIIIAAAggggAACCCCAAAIIIIAAAgSg+A0ggAACCCCAAAIIIIAAAggggAACCNgqQADKVl46RwABBBBAAAEEEEAAAQQQQAABBBAgAMVvAAEEEEAAAQQQQAABBBBAAAEEEEDAVgECULby0jkCCCCAAAIIIIAAAggggAACCCCAAAEofgMIIIAAAggggAACCCCAAAIIIIAAArYKEICylZfOEUAAAQQQcK5Aa2urdHV1OXeAjAwBBBBAAAEEEEAgagQIQEXNo2QiCCCAAAIIBC9QXFwsixcvlvnz58vjjz8e/IWciQACCCCAAAIIIIDAAAQIQA0AjUsQQAABBBAY7gJPPPGENDU1WX/+93//V3p6eob7lBg/AggggAACCCCAgIMFCEA5+OEwNAQQQAABBOwS2L59e2/XGoiqrq7u/c4GAggggAACCCCAAALhFogPd4f0hwACCCCAAALOF9i6davHILu7uz2+B/uls7NTXnvtNdHrzzvvPImJiQn20iE/r7y8XCoqKkRrYS1ZskTi4/3/taimpkbWrFkjhYWF1phPOOGEIR97oAG4j9XJ4ww0fvYjgAACCCCAQPQK+P+bVvTOl5khgAACCCAw4gWam5ulqqrKw6Gtrc3je7BffvnLX8pPf/pT6/QHH3xQzj333GAvHZLzDh06JM8884zoEsTDhw/3jmHixIny2GOPyfjx43v3uTa++MUvyvvvv+/6Kh988IGMHTu297uTNtzH6uRxOsmMsSCAAAIIIIBAZAQIQEXGmbsggAACCCDQr4Auhdu0aZOsW7dOdu/eLRosKSsrs4IdM2bMkBUrVshVV1016CyjAwcO+IxFl+AVFBT47O9vR319fe8pDz30kCMDUC0tLfLqq6/Ko48+amUy9Q7YbUODUe+++65cccUVbns/3NSsIvf2t7/9TW699Vb3XY7Zdh+rk8fpGDAGggACCCCAAAIREyAAFTFqboQAAggggICvgC7/evvtt62snGeffdb3BLNHs5V27twpf//730VrN919991+zwt2p3v9J9c1rkCSBsHefPNNiY2NlbPPPjvgsjTXdV1dXa5N2bdvX++2EzbWr18vTz31lDz99NNWsfX+xpSenu73FPc56gklJSV+z3PCTvexOnmcTrBiDAgggAACCCAQWQECUJH15m4IIIAAAiNUQLNwfvvb34oGRbSWkC6D0zpMe/fuDUlEs4wGG4Datm2bzz0TEhKsfTfccIOVgaVfTjrpJHnkkUfEdcznIrPDvXaUK4jl77xI7tMMsu9///u98/B373nz5snnPvc5mTZtmqxevVpmzpwp559/vr9TffZp0HA4tOEyzuFgyRgRQAABBBBAYPACBKAGb0gPCCCAAAII9Cugy79ctZL6Ozk/P18mTZokmZmZVvDnyJEjsnHjxv4uC/q4Ft/2bllZWdYuDd64mtY90mDXPffc49rl8+mecaPZU8eOHbOypjT7Ru+jS/uSkpIkLS1NcnNzrWLfPp2EYUdtba21vE4znnS5XaC2cuVK+fKXv2wtZ3QVTO+vWLcWWndvGjRsb2+XyspK0Wejc66rq7PmmJqaKkVFRTJ16lT3SyK27T5WJ48zYiDcCAEEEEAAAQQcI0AAyjGPgoEggAACCESzQE9PT5/TO+ecc+TSSy+VpUuXigagvNvDDz8sd9xxh8yePdv7UMjfvQuQawc5OTmiY9Ri3O7Fuf/85z9b2UGf/exnfe7T0dFhBV/cD+j4+2oPPPCAfPKTn+zrlJCPvfTSS3LLLbf0ed0111wjN954Y8h+DQ0NPgXbNYNs+vTpfd7vrbfe6n1rXp8nhvGg91idOs4wTpmuEEAAAQQQQGAYCRCAGkYPi6EigAACCAxfAVe2jfcMvv71r1tLwTQA1Fe77rrr5Morr5TExMS+TgvqmGYqebfs7GyruLm+CU4ztbSAtas9/vjjsnz5cmupmgavNONn165dVl0q1znBfmqmUrjb/fff77dLDdZdf/31ctFFF4nOr7+mQSPNNNNC3qWlpdb83INx/V3vftyfsfvxwW6Ha6x2j3Ow8+R6BBBAAAEEEIgeAQJQ0fMsmQkCCCCAgIMFvJd5nXjiifKLX/xCxo8fH/SowxF80pu1tbV53FOznuLi4qx9Op57771X/v3f/91aylZRUWEtLdOspYEEK3Tp3eLFi0Xf4jd//ny55JJLPO4dji/+ak9p/apVq1b1zqu/+2ih8ttuu62/0wIe16w1nZ9mRukyv1mzZgU8d7AHBjPWSI5zsPPkegQQQAABBBCILgECUNH1PJkNAggggIBDBTQApbWBiouLrRGeddZZIQWfwjktLYju3s444wz3r9a2BqJcy+60eHqwwSed44oVK6xaTzpnrWUVKPvL56YD3KHZWd6ZSlq/6mtf+5p897vfDWop3DPPPBPS3TWAqMsN9c+CBQtkzJgxIV0/mJNDGWu4xqmZa5r1VlZWZi0R1aBiuAKig7HgWgQQQAABBBAYPgIEoIbPs2KkCCCAAALDXEALVLtaf0vCGhsbrTfk7dy5U44fPy5ab0kLfqekpMjkyZPlwgsv7PPtdK77+Pv0zhg6++yz/Z3Wu0/vGWx74oknrHpSwZ4fjvPuvPNO2b9/v89b7/71r3+J/rnqqqvkpptu6rP+k2ZqBds0y+nJJ58M9vQ+z9Ni5lq7KT093SrW3ufJHx0MdqzhGKcGHn//+9/LT37yE5+had2y22+/XfSNgjQEEEAAAQQQQKA/AQJQ/QlxHAEEEEAAARsEvIMIra2tolk7b7zxhrX0zZUpFejWp5xyimhh8tjYWI9TNGD197//Xd555x3ZvHmzVVT8tNNOE601lZeXZ53rnc2kGUR9NS3gvWnTJtHgkgYbzj33XDn//POt5WZaK+o73/lO7+XJycm925HaUMu//OUvVu2q3/3udz631RpW+uf000+33oCndt5Ng1iHDh0SLdytS+jOO+880QCLLln7xje+YZm6rnEPJLr2hfKpNab++Mc/yl//+lefAueaQaZv6fvMZz4TsMtgxzrYcWpxd12W6P17cQ1s9erVVl0w/V30V3zedQ2fCCCAAAIIIDByBWLMG2/6fi3PyLVh5ggggAACCIRVQJctud5Ap9kp48aNE81G0swmDXyE2t59993eZXz6f84feugh0eCEv6ZFzl988UVrqZgui3O1T33qU/Kzn/3M9bX3U4MOmoXlClrpAc3CSkhI6D1HN95++2259tpre/etW7cuosvRem/80cbRo0flD3/4g/gLRLnO1SDaV77yFas4ufvyQH0O6hgf7/nvc/fdd5+HkQaJXnvtNVd3IX1qIE+9AgV1XJ3pMjvvumGuY/oZzFgHM86XX35Zbr75ZvdbBtwezH0CdsoBBBBAAAEEEIg6Ac9/No266TEhBBBAAAEEnCGgb45zBZ90RHv37pU1a9ZYWUp9BZ80A0czcjRooW90c2Xv6P/T7/7mPF0iFSj4pPfTe2u2UnV1tX7tbe4BJtdOzcTSjBYt5K0ZVa7mHXzS/aNGjXIdtj4rKys9vkf6i9au+u///m8rY+s//uM/rALq3mNQbw1AaaF194LsWojdO/ik13rPUQuzD6Tpm+suvfRSv8EnzeJyDzhddtllfQbRghnrQMf5+uuv+wSfNGCqQT2dw49//GMrM8xloNl6/WXsuc7lEwEEEEAAAQRGroDnP/GNXAdmjgACCCCAgK0CGoAKpmlQ6eKLL7aWf2kAyN+StubmZisTyRUQ0oCRvlHPvWng6rrrrrMCA5p1owECzbb6+c9/7n6aeBck14N79uzpDZJoJs7s2bM9rnH/4l0fSpcSOqFpjS0tQv7FL37RWiamy910WaJ7e+qpp6zi5RpYGT16tPshj23vpWz9ZS95XPzRF80+07G4t89//vNy+eWXW0sZXY5z5szptf/e974n+vZBzZQLtrmPdSDj1GLjGpxzb5/4xCes5Y2u32JhYaFo7ar/+q//6j1t9+7dVpH93h1sIIAAAggggAACXgIEoLxA+IoAAggggIAdArqcLVDT7Bd945wWFl+4cKFPXSfv69yDDHrsjjvu8DhF37D305/+VLwLnWtgSes3ubd//vOfctddd3m8qc59WdqBAwfcT/fZ7u7u9tnnpB1JSUmiART9o3P51a9+JY899ljvEHXJoGYlad2sQEGowc5Ra0t5B590uaT32wd1fN5BIx2vPp9g22DH+sADD/iMQX10+aUGoDTwpL8Z9+CTjm3mzJnBDpHzEEAAAQQQQGCEChCAGqEPnmkjgAACCERWwH35nd5Zl1sdPnxYbr31Vmt5nSsDJtRRHTx40FrO57ruyiuvlB/96Ed+g1iaUePddFy7du3yyHJyX3LW39Kqzs5Ojy69v3scHOIvU6ZMsWx0eaEuz3M1fQ7PPfecFQR07XP/9DcnrcGky+CCad7uP/zhD32CT9qPZkl5tz/96U9yyy23SEFBgfchv9+9xxrKOPW35K92lit45iqc7x0k0+V5aktDAAEEEEAAAQT6EqAGVF86HEMAAQQQQCBMAiUlJb09nXjiiaJL2zZs2CBf+MIXZKDBJ+1Q60i5t//5n//xG3zSN5rpG/b8tVdeecVjd25ubu93rVXlb5le7wleG+41lVyHNGvmu9/9rvVmNw12hbNpMETfKhdK0yDdo48+6nGJFnQPpemcvJsr00kDRrpMUpuep/auduONN8rVV1/t+tr7qYFA7+WRroMasBpoC3ac2r8Wb++rqbV38EnP16wp96y5vvrgGAIIIIAAAgiMXAECUCP32TNzBBBAAIEICrgHoEKp6dPfELVmj6tpYCszM9P1tfdz8+bNVhZN7w6z4V7X6cknn3Q/5LMUTa8P1NyDVXpOXV2dz6maXfTII4/Ie++9J5rRE662fft20ZpJixYtEq2nFErRbX0joXsR976WSI4ZM8ZnyFpPy7vpcjnNYtKAkyvopFlF7u1b3/qW+1drW4NEmpHlL7ijJzz77LOyfv16n+v87fAea7Dj1MypJ554ordLLXavxcjPO++83n3eG1oI/4UXXpBZs2Z5H+I7AggggAACCCDgI8ASPB8SdiCAAAIIIBB+gfLy8t5O9+/fb71NzJVRop9avFuzYI4cOSJ6rmb1aFDEFUDQ+jtao0iXOs2YMUM0k2bs2LHivuQqIyOj9x6uDQ363HTTTa6v1qfWh9KaPVoXSZsus9Ngzty5c63v3kGlDz74QJYtW2Yd8/6PexBHj3kvNdR9W7Zs0Q+reb+Fz7V/IJ/u2V+vvvqqVUNL3xR4wQUXeATY3PtWZ32zn7410H2sEydOdD/NY9vfmwJ1Ht77tZ6Uq7kCcboEzr1pIXT3oE5paalVw8s9O01NdTwbN27svfS2224TLaQ+adKk3n3+NrzHFOw4jx496hEA08w8/a3pkjzNWnv77bctt56eHqto+sknnyzz58/3+9ZAf+NiHwIIIIAAAgggQACK3wACCCCAAAIREHAPQGkARN9QF0rTIJUGTHRJnGbXNDQ0yN133y3p6em93WgQRoMUGoDRwIcGD7xr+lxzzTVyxRVXWNdo7R7tT9uqVavknnvusbazsrKsT9d/+soOio+PtzKJXMEc92CTXq9ZSdq3q2nQIlzNuxi7juFnP/uZ9UcDOBqo0zpNGjTROWhQT+29m74x8Nvf/rb37t7v3llFemDHjh0eQa4333yz11KPu7KCvLPddHmeFvDWOlsaYHIviK7X6Vgefvhh6813V111lWzbtk13W/XCtEi9HtP6YYGa91iDHWdf2WM6F9d8At2X/QgggAACCCCAQH8CLMHrT4jjCCCAAAIIhEHAVRMoDF1ZXbiCRN6ZOxrcWLJkiZx00kk+wSfNeNKglavdfvvtrk3585//3FtLSYNKGghxNX/L+lzH9NO9QLYGwTZt2mTVjdKgjAba3JeWXX755e6XDmpb+9JlYP6aFhZfvXp175I4zTzyF3zSwtq//vWvPQJ53v15Z4Tp8ccff1zKysqsoOBTTz0lX/7yl3sv0zHpckht+iZCDfq5t//7v/+T73znOz7BJ73u6aeflqlTp4qOS2syuT8HdbzsssusZ+Wv1pbew3uswY7TPZCp/eh1NAQQQAABBBBAIJwCZECFU5O+EEAAAQQQCIOALsGaN2+eTJgwwcqE0awW/aPBDA08aUDIFWg4/fTTrWCFe5DH3xBuvvlma6mX+5vbNCB11llniQaNtOmStksuucTaXrBggRVg0S/ey7qsE9z+o8v5XHWiNAvp0ksvdTv68aaOQecUrqZBEw3+/PKXv7RqTPVn4H1fHacWbffOGvI+T4NB+kxcWV56XJc2BlqWqMEld+dvfvObVtaa+/Xe99CA1YMPPmg9Y9cxddcMqU996lMe99Yxa6bZvffe6zq199N7rMGO0zuQqbWs/vWvf/Uu0+y9ARsIIIAAAggggMAABWJMWnrPAK/lMgQQQAABBBAIUkCXTt1xxx1+z165cqVoIEmDEJr94q+Wk98LP9qp9Xl0aZe/AIxm1WhW1DnnnOO3C605de6551rXarDDFVTRjCFX5s5rr70WMNNIO9X6URdddJHf/l07dW66PHAwb/xz9eXvU2thaQ0mzXrSZYWVlZVW0Mb1FrjExEQry2n8+PFWdpiaL1y40F9XfvdphpgGfvprX/rSl/w+Z13+d9ddd1kZTu596DLIr33ta3LxxRd7BK3cz9H5aB0vzepyNV0uecMNN7i+enwGM1Z/49QAmGsZpqvD3//+9wF/O65z9FNrSGlGmBbFV1v1piGAAAIIIIAAAu4CBKDcNdhGAAEEEEDARgEt9q3BJQ366NvR9A1uWuhZl7wNtmmxac0GOnTokPX//Gv2zOTJk60Mp/7612u10LS++cy9aTDh+PHjVtFp9/3+tnU5n97fu2kATDOfPvOZz4Rlnt79R+q7LnlzBfHcA0Gu+2vgTgNJp556qmuX308tTn7gwAHLQp+9ZiwF0zo6OqxMNb23BvP6qgPlGmuo49R7aIF0/Z26t/PPP19uvfVWqw5UUlKSdUiDnVu3bhVdZvn88897XHPnnXf6FL53749tBBBAAAEEEBiZAgSgRuZzZ9YIIIAAAgiEVUDfLqcFwHXplmYjnXnmmdbSsUWLFklMTExY7zVUnbkKyWsNJ8060/pMWvBdl/J5L2EbqjG67qtjHcg4NTim2VbeQShXvzpPDT71tZxQC7p/5StfcV3CJwIIIIAAAgggYAkQgOKHgAACCCCAAAIIINArUF9fL9/4xjd6a4P1HghiQ7PE7rvvvpCXkQbRNacggAACCCCAwDAXIAA1zB8gw0cAAQQQQAABBMItoCVCtSj9b3/7W+szUP+6hPCMM86waoctX748qOWagfpiPwIIIIAAAghEtwABqOh+vswOAQQQQAABBBAYlIDWktIlefqpxdRTU1Nl0qRJUlhYaAWc+qsxNqibczECCCCAAAIIRI0AAaioeZRMBAEEEEAAAQQQQAABBBBAAAEEEHCmQKwzh8WoEEAAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRYAAVLQ8SeaBAAIIIIAAAggggAACCCCAAAIIOFSAAJRDHwzDQgABBBBAAAEEEEAAAQQQQAABBKJFgABUtDxJ5oEAAggggAACCCCAAAIIIIAAAgg4VIAAlEMfDMNCAAEEEEAAAQQQQAABBBBAAAEEokWAAFS0PEnmgQACCCCAAAIIIIAAAggggAACCDhUgACUQx8Mw0IAAQQQQAABBBBAAAEEEEAAAQSiRSA+WibCPBBAAAEEEEAAAW+Bnh6RHvM/+r8SY/7op6uZ77ExutP+1tnVJS3tnVLX3CollTVSXt0gtY3N0tjaLm0dnRIXGytJCXEyKiVZcjPSZXxOhkzIyZTUpERJToiX2NjIjNN+Ce6AAAIIIIAAAiNVIKbHtJE6eeaNAAIIIIAAAsNTQP/60tjSLlUmiFPb2CS1Ta3S3NohTW3tJtDTIe0mqKPnWMEnE3nq/euOWxwnxuzPTE2R85fMkqy0ZFsgymsbZO2uQ3KkqlY6Oruko6s76PvoUBNN8CnJ/Jk7aZwsmVogyYkJQV/PiQgggAACCCCAgJMECEA56WkwFgQQQAABBBDwEagxQaaSylora6iuqUXqW1qlyWQOtZuATjhaenKifPmiFeHoyupDA2Cbio/IniPHpbK+0QS/Puw6wQSSRo1KlfT0VEk2mU3xJuMpPi7Oym7Sc7q7u6XDBM6qquqkqrrOfPf8N8KEuFgpyM2S+VPGy/T8XImJUPZW2GDoCAEEEEAAAQRGtAABqBH9+Jk8AggggAACzhPoNFlCx+ua5EBFpew8XCE1JuhkV8tOS5HlcybLnMJxg76FZjhtO1Qm7+w8aGVhaYcadMrISJMxJnCkn95BI83MamvrkJaWNqk12VLVNfXSGURgbfzoTDlt3lQTkMoc9LjpAAEEEEAAAQQQiIQAAahIKHMPBBBAAAEEEOhXoMtkAG0/XCZrth3oDeD0e9EAT0iKj5NzFs+U2QV5A+zh48s0T+l4baM8/No66foo3SlOs5VM33ljs32CTnqlZjtVHKuRsrJKK+vp495C2/rMaSdIoQlu0RBAAAEEEEAAAacLUITc6U+I8SGAAAIIIBDlAprxtGZ7sew+csxaWtdbr8nMOysrXbIyR0lqarJoUEeP7d59yKqnNBAWLep9zgkzZNKYbKu20kD68L7mlU17ZNvBMiv4pBlOhSbwNGZMlsSbIJd707FXVNTI8cpqaTVLCL2X2LmfG+z2gfJqAlDBYnEeAggggAACCAypAAGoIeXn5ggggAACCIxcAX0z3NZD5VaR7sbWNgtCyxplZ42S0eYNcFmZ6T5BnEZTD8qzMlJwfhmpSbJ4WqEsmjLB1F2KDe6ifs7SOlT/eH+HlJq32mnTYNmkieMkOTnJ40qt63TseK0JPlUNKtvJo1PzZYzxWTKtwHs33xFAAAEEEEAAAUcKEIBy5GNhUAgggAACCES3QFVDs7ywbqeUmZpH2uJMMe6szDSZPDnfBJ18/3rSZt5uV1JyzCrOHYpMinlr3OzCPKteUrgCT3r/msYWWfXmBitjKzY2VvJNUfCCCWM8hqar8erqGqT4wNGwBp5SkxKsYNqymZM87scXBBBAAAEEEEDAyQK+f8Nz8mgZGwIIIIAAAggMawFdhvbOroPy/u7DojWftOWabKdJkzTw5LlkzTXRo0cr5cjR41bdJNe+YD5PmFogK+dMkURTCDycrdkEw1zBJ+13lgkE6dvt3JvWeNqzt0Tq65usZYPuxwa6rcv7NJh21oLpkpwY3jkNdExchwACCCCAAAIIBCvA316CleI8BBBAAAEEEBiUQIN505tmPR2urLWCMikpSTJl8nhJT0/xW6hbl67t219qBXFCufG08WPklNmTrSVqZkVf2JrWqtK26o2NVuaTvuFu9qzJovNwb01NrSbr6Yg0N7e67x7U9pS8HDnFBNPys0cNqh8uRgABBBBAAAEEhkqAANRQyXNfBBBAAAEERpDAkao6ed4En2qbWqxg0zgTUJk4Mc9v4ElZGkytpz17DktnZ1fQSrkZabJs1iSZFYY323nftN0Ewx55Y4O1u9qMLcksg5s1c7Kp95TocWptbYPsLz4S0rg9OvD6kmMyq04yGVaa+RSrBbJoCCCAAAIIIIDAMBUgADVMHxzDRgABBBBAYDgI6JK7g8dq5Jl3t5gldz2mAHiczDQBFc16CtRq6xplj3nTXbDFxuNiY2S+yaQ60yxN0+1wNx3H2j2HpNIsp9OmS+GmT5voEXzSek9V1XVSXFxqsrus0wb1nwRTKH3J9EI5dU7RoPrhYgQQQAABBBBAwCkCBKCc8iQYBwIIIIAAAlEosGb7AVm397B0m6iM1kmaNrVQEvuoX1ReViUlR44FHXwal50hn1g6W7LTPWswhZOyuKxSPjD1nFxtugkMpaUlu75aywkPHa6w3nLXu3MQG3PNm/RWmOV2Gakf32MQ3XEpAggggAACCCDgCAECUI54DAwCAQQQQACB6BLQekkvb9wt2w+XWxPTJXcFBWPN2+5i/U5UM6VKTeCpzASgdLu/pplOujRt6fSJkhigeHl/fQRzXANnb+04YAqg90iemYO2rMyP6zBpsfH9pk5VdU1DMN31eU5hbpYsmz1FJo3J6vM8DiKAAAIIIIAAAsNRgADUcHxqjBkBBBBAAAEHC+hb4p5+Z6uU1dRLbGysFJr6RePyRgccsQZxDh4ql+PHawKe434g02QGXXLyPMmzuSC3BsLeM0sBj5slgfqGvsmTxrkPQ9rbO2X3noOm2Hibx/5Qv2imk9aumm/eBKjL+2gIIIAAAggggEA0ChCAisanypwQQAABBBAYIoE6U2T8L6+uk1ZTtFuznWbPmuKxXM3fsHbsPChN5rpgWmFutlx+ynxJsDHryTWODlMAfZPJbtLmnbnV2tomW7cVm8yoD9+M57om1E/N4Dp17hRTu8p/Zlio/XE+AggggAACCCDgVAECUE59MowLAQQQQACBYSZwsKJGXli/wwo+pZqsnmlTCyQlJSngLDSIs8fUVmppCS6DaPG0AllpinJHIvikg95RUi4t7R3W+NvaOmTHzgPWtmZ1NZo34Q02+HTNGUtkwugMq0/+gwACCCCAAAIIRLsAAahof8LMDwEEEEAAAZsFtE7SHlO/afXGPVbwKTsrXaYWFUhcH1lK+qa74uIj0mEypfpruixN33J3xvxpEhuhJWrtnZ3ypslwqm9qlvSUFGtpXENDc39DDel4XmZaSOdzMgIIIIAAAgggMJwFCEAN56fH2BFAAAEEEBhiAQ0+bTKBpNe27LNGkjd2tEyenB9wVFpXqcJkSh06XBbwHO8DReNy5LwTZnjvtvV7aWWdfLB7t5RXVcnpi06Q5MTEsN4vIS5O4s0fGgIIIIAAAgggMFIECECNlCfNPBFAAAEEELBB4GWT9bTtUJn15rqiogmSm5MZ8C6a7bRn72GzfC24ek+ujs5cMN21GbHP1Ru3W8EnvaEdZcFTkhIiNhduhAACCCCAAAIIOEGAAJQTngJjQAABBBBAYJgJaIHuZ9dulwMVVdYb4rTeU2Zmut9ZaNZTeUW1lJdVSnsQS+7cO5mSlyNZacnuuyKyvXrjlt779PRuhW+jwyzxoyGAAAIIIIAAAiNJgADUSHrazBUBBBBAAIEwCNSYAtxPvr1ZaptarSLjM8yb3JKTfZeodZogVX1Dkxw+XC5axHsgTYNXkW77yo5LTX1j7211mWG4W0t7p3R195i339mRXxXu0dIfAggggAACCCAweAECUIM3pAcEEEAAAQRGjMDR6npZ9cYGcQVliqZM8Ak+aeCptPSYHDtebZbmDY7m4LFq2W0KnM+cMHZwHYVw9ebiwx5nd3V1eXwP15c2kw2WylK8cHHSDwIIIIAAAgg4XIAAlMMfEMNDAAEEEEDACQKaifS+qd+0dteh3uCTjmvf/hJJSPjwrxPdJqNHg0/t7QPLdgo0z5c27Ja05CQp6KO+VKBrB7J/d2m5x2WdNgWgGlpaCUB5SPMFAQQQQAABBKJZIDaaJ8fcEEAAAQQQQGDwAp1d3bJme7G8tf2AtJsAk3vTpXVaVFz/NDe3hj34pPfSTKF/rN0mLWEObLnPw327sr7e/auZc3gDaq7Oj9V9vMzPtY9PBBBAAAEEEEAgWgXIgIrWJ8u8EEAAAQQQCIOAZjW9tmWvbD5wNAy9DbyLptZ2+duaTXLdmUtM3SR7//2syWQmuTcNgNnRth8sl/mT8sPWtWZq7T5SIa9v2SnNH9XcSoiPlaSEBMlISZGi/FyZVZAv2elpYbsnHSGAAAIIIIAAAsEKEIAKVorzEEAAAQQQGIECrzog+ORi14yhHSUVYQ3auPp2/+zwWnLX3OYZkHI/dzDbpVW1UlZTL/nZGYPpxrq2yhRN/84fH5fDFcdFg4aB2sRx4+Temz9jglApgU5hPwIIIIAAAgggYIuAvf+EaMuQ6RQBBBBAAAEEIiFQUdsg2w6VReJWQd/jza37paGlLejzB3KidwCnqaVlIN0Edc36PaVBndfXSavefF+++PM/yMGyYwGDTzExMTIpP1+m5o+XTcWDv2df4+EYAggggAACCCDgT4AMKH8q7EMAAQQQQGCEC3R1d8vT72wRrf/kpKZ1oNbtLZEzF0yzbVgmVuPRGpqbPb6H88u+8uNSUdsoeVnpIXd7oKJS7n/mRdl+oKTPa7MzMmTOpMmSbpbhaesjQarPfjiIAAIIIIAAAggMRoAMqMHocS0CCCCAAAJRKlDTYAqLm7pLTmx7jxyTwIvMBj/iWK8aU23t7aamkj1ZVxrge/qdzSEF+jQ4+JhmPd33YJ/BJ53Hkpmz5KRZs3uDT6qTGB83eCR6QAABBBBAAAEEQhQgABUiGKcjgAACCCAwEgRKqqrN2+ecGYBqMIGxgxXVtj2GxHjfBPFjNTW23U8LrL+4Ybf09PQfVjtSVSNf+eWf5ffPvxZwPLrcbuqECXLmohMkNzPT57y05ESffexAAAEEEEAAAQTsFvD9G5bdd6R/BBBAAAEEEHC8wJHKanlz82aZM3mKTMjNddR4NVCz83CFTMkbbcu4MlJ9C3Qfr6uVyaaAtx1Nw047S8olIzVJTp0zRTSA5N2a29pl1Rtr5fE33pMuryLp7ueOzR4t00zwaVRqqvtuj+1MP/PzOIEvCCCAAAIIIICADQIEoGxApUsEEEAAAQSGu0BWeqopaN0t24r3S3NrqxXU8BcYGap56tvj7GpjsnyzhuwsRO6ax9rdh6S9s0vOmD9V4j5aBthtgm0HK6rknkeekdJjla5TfT5TkpNlZuFEycvO9jnmvWNMZpr3Lr4jgAACCCCAAAK2CxCAsp2YGyCAAAIIIDD8BLLSPw5SFB89IjWNDbLU1BNyShCqx8YqUPMnF8iL72/0eGhaB6quqcnal5n2sY3HSWH4snF/qRw+XiPXnr5Y4uNi5YF/vCLPm7F09VEMfoYJPE3KyxPv2lX+hpOalCCjUpL8HWIfAggggAACCCBgqwABKFt56RwBBBBAAIHhKTDaZEC5t5r6enl/105ZNG26JCUkuB8aku2CnCzb7rt46iS/fW8/eMDaf8rceX6Ph2tnVX2T/HH1+1JRUy1vbdkWsNt8szRy6vgJkmayn4Jt40dnOSaIGOyYOQ8BBBBAAAEEokOAIuTR8RyZBQIIIIAAAmEVyEjxrYNU29AgG/bskRab3ggX7AR0edpJMyYGe3rI543JTJfCPN+6Vw0mA0r/NJkliXa3xpY2E1hKk9MWLpJJ+eNklMm60nnrnxxTWHzp7DmyoGhqSMEnHfOkPPsCd3ab0D8CCCCAAAIIDG8BMqCG9/Nj9AgggAACCNgikG6WacWYYEePqQPl3uqbGuWD3btkhckCiouLcz8Use0Z48fI6FGeGVrhvvnyOTOkpMJ/zaUK80a8ovz8cN/Sb38pSUkyq9B/RpbfC/rZOcFkQNEQQAABBBBAAIGhECADaijUuScCCCCAAAJDJKBvkOswha7NR78tPkCAqcVkAK3ZukW0LlKkW9G4XDlv8Uzbb7ts1tSA9yg+UmoMOwMed+qBrNRkoQC5U58O40IAAQQQQCD6BciAiv5nzAwRQAABBBCQHSUVsu1gmejb4zQAlRAfJ/nZGTJ/cr7MnDDWFLCO8VBqbe+Qjo4Oj33uXzT4tG7Pblk8Y4akJEagqLWJmLUWfyCnnXqjNXb3sdixPbtgnIzLzZbyyhqf7rtMVtiB8jKZUVDoc8zJO043b9dzShF5JzsxNgQQQAABBBCwR4AMKHtc6RUBBBBAAAFHCHR2dcmLG3bJcx/ssN6upsGTxMQEa3ldaVWd/Mvs//va7VLb1OIx3m2Hj3h89/elsblZNu/bJ3oPW1tXpzTvfFMa3/+7PPGLO6Wloc7W22nnmv31lYvPCRiwKT12TNo7hk8WVGpSokwam2O7GzdAAAEEEEAAAQQCCcSYVPwgkvADXc5+BBBAAAEEEHCqQFd3j6x6Y4OV9aRjzM/PlcKCsb3D7TbHy8ur5MjR4xIXEyOzJ46ReZPGy+pNO+SRV96Sbq/6T70Xem1ogezlc+YGDNZ4nR7y1/p3HpP2g5t7r5syZ6F86e5f9363a6PdLLO7/se/keq6Br+3yBo1Sk42xcCHQ1s2a5KcOqdoOAyVMSKAAAIIIIBAlAoQgIrSB8u0EEAAAQRGtkBzW4c8/e5WKauuM8XCY2XWzMmSnu77ZjtVamtrl8NmiV5lZa0crCiXfaWlpkZUaP8+NS4nx3orWziXePV0dkjdGw9JZ0Wxz8OctmCJ3PjteyUhKdnnWLh2tJhliF/46YNyvNZ/xpXO9YTpM2RMlrMLe49OT5Ubz1lqvUEvXDb0gwACCCCAAAIIhCrAErxQxTgfAQQQQAABhwvUNDbLo2+s7w0+zZs7NWDwSaeSZJZnTZtaIIWF42Tq+AmyaPp0SUpMDGmW5VVVpi5SeUjX9HVyZ91xqXn+F36DT3rdvi3r5alff1/aW5v76mbAx6rqG+Wbv3s0YPBJO9Yg3eb9+6TJFGV3cjt51kSCT05+QIwNAQQQQACBESJAAGqEPGimiQACCCAwMgTKaxvkDy+tlZrGD2s6JSUlSHJy/8EkzeYpmDBGxozJlrFZ2dbSsoSE0N5VsrfksAnY+BbtDlW+s/qI1L70K+luqOzz0o1rXpI3n/y99AS5VLDPztwONrW2yX899ITsLTnqttf/Zpepf7W1uDjo5Yr+e7Fv7wxTYH7uxHz7bkDPCCCAAAIIIIBAkAIEoIKE4jQEEEAAAQScLrD7yDF5zNR8cl8819bWad5mF3yx7MmTxllFylOSkuS0BYskLcX/sr1AFluLDwyqKHlriSmIvvp3Ih3BZRXtfvtf8s6Tvwk0nAHtv+23j8j+I8Fnc9U1NsgmkwnltBZn3mx49sLpThsW40EAAQQQQACBESpAAGqEPnimjQACCCAQPQLdZinYWzv2yzPvbpaOrm6PiVkZOtv2S319k8f+QF80Eyo1Jck6rG+CWzprtmSkpwc63Wd/h6nbtHbnDtH7htTMHJp2mDfdvb1KpLM9qEvNUE3xdJEdbz0n659/OOS6Vd430ZpPf3l1neRl5cq43Fzvw31+P15TI1sPOCcTKtlkr332rKWSFkT2W58T4yACCCCAAAIIIBAmgbj/NS1MfdENAggggAACCAyBwIvrt8kPVv1dio8elbKqalPvJ0aSTQ2nOBNA0qZvs6uqqrW+p6Wl9Pu2uhqzjK+lpc26VoNQuRmZUmGW1nUGGVRq7+gQcxPJyciw+uj3P10d0rDxeWnd/poWVur3dNcJGmQZlZpkLumWo3u3SIoZ59iJM6x7u84J9rOxtV2efmermWeDZTcue7TkmT+Npr5TW3twAbGG5mYrADjavB0vNnbo/o0vwTyzs0zm05S80cFOn/MQQAABBBBAAAHbBXgLnu3E3AABBBBAAAF7Ba6/9zdSXulZe0kzmeZPnSr5o3M8bq7ZTXPmFFlvxvM44PZl2/ZiaWr6sIaUa3dLW5u8vXWLdIVQb2nJzFmSm5np6sL/pwk46ZK7zuMH/R/vY2/OqGTJSPN8C95p13xNZq+4qI+rfA9pBtlDq9+Xqgb/Bc0r6+pk4949Qdd5ykofJSfNnt1voM93JIPfYxLC5Lwls2T+JOo+DV6THhBAAAEEEEAgnAJD989z4ZwFfSGAAAIIIDCCBTJSfes06Rvatu7fb5bD7ZT2zo9rQDWbzKat2/ZJ40dFyr3ZKiqqpbnZM/ik52hNqIXTpocUVNlx6GCfQZuupjqp+dfPBhR80jElmwLr3k3rQe19f7X37oDf2019rL6CT3qhBtFOX7hICvPGWX8CdvbRgVpTE+rNLZtNIfiG/k4N63HNfLtk+XyZN3FcWPulMwQQQAABBBBAIBwCLMELhyJ9IIAAAgggMIQCjS2tsmHvQb8jaG1vk9Ljx0wtoGRJ/6igeJepE1VdXWeKlcdIolnGptlS7ab+UcWxGik9UhFwFZz20WqW19U3BVdPqtMEvvT8vOxsn7HlZ2dI8zuPSmO5/3H7XOC1I9aMOSs9WfTTvXWbZYIlOzdIbsFUyRw7wf2Qz3atyfJ69I2NvW8M9DnBbYcuZxyTlWX9SU5MsoJLurQxUNPlikeOHzfBvy6zTDBVdCmjnS0zNVkuPmmeFI3LCSlIaOeY6BsBBBBAAAEEEHAXYAmeuwbbCCCAAAIIDEOBY3UN8rkf/0Y63DKd/E1jWkGBFOWPH1SAQoMua8xSvFazJE9busm+Sk5MEF3G1maCWM2tbR7FwDVwc8aiEzwCMBNysuSKFQukqrRYfvndm6WzI7gaS+5zio+LlYIxGSaEFqCZwNQnv/59GT99od8T6pvb5LE1G6SuKbi37Xl3Ut3QIBv27A6q2LoazJo40aoplRAf793VoL9PGpMtnzx5rvUcBt0ZHSCAAAIIIIAAAjYJEICyCZZuEUAAAQQQiJSABn9u/tnvpaSiss9barJQtinUfeKMmYMKQlXV18u6XTvlc+efIZctP0G06HWP+Z8Ok+1T2dBk3sa3QV54f1NvcGbiuHEye+Ika2xLpxfKynlTezOXDu3eJL/5n6+apXqhvTUvwxQfz8nwXXroDhBvlg1+8us/lLGTZrrvljaz7O5PpuZTw0eF1j0OhvBFM8HeM2/86+kjE8q9Ow1E5efkyIyCQglHICoxPk4uWTZfCnOzrMLz7vdiGwEEEEAAAQQQcJoAASinPRHGgwACCCCAwAAE9pilc1//5UNBFQkfbWoaLZo6bcBBEK0vVVx2VH72paslySzh89eaTCbUztIy2XH4qFTVN8nJs6ZLUV6OjMse5XP66sd/J6sf/4PP/r52aPZTgsmC6q+lZmTLJbf9yCzHK7BOrTaFxh9bs1GazFvvwtG2FhfL0crjIXWlSx4z0tLMEsJRpr5UhvXZ1xI9Xc5X29go9eYte11muyh/nJy+YLopND7eLK1MDOnenIwAAggggAACCAyVAAGooZLnvggggAACCIRZ4M6/PiPvbNsVVK+DDUJp8OfWi1eapXX9B4GCGdDjP79TNrz5UjCnmsBZnBTk+gayAl0cn5QsV3zrfmlJyJIn395s6lJ9XJQ90DXB7m9qbZW3TMFx75aakiwnz54uOw6WSEV1rfdhn+/JJlsrLTnFBPQSJN7Masf9WwAAQABJREFUT5sGnjTLqtEEnuKM88S8MbLc9HnVypMIPPkIsgMBBBBAAAEEnC5AAMrpT4jxIYAAAgggEKRAeU2dfO7e35gsmcDFsd27SjfFsU+ZO9csxws9iKRZPNeevljyR2e4dzngba0Ddf9/fFaOHynpt490k/UzJiu13/PcT0hMTpP6pZ+TjoQ0992D3tZssJc+eN+jH11e99Mvf1ZmFXz4NroDFVWy6o335L0de6w3Eurz0ev6arGxsWZZXaykmUDWBUsXyuWnLJHs9NDm3Ff/HEMAAQQQQAABBCItQAAq0uLcDwEEEEAAARsFnvtgi9z35HNB32GUWQp28qzZJsMm9Le0TTTFr69auSjoe/V3Yl3Vcbnv9multbmxz1PzR6ebgtv+l/71dWFXSra0LL1BeuKT+jotpGOVdbWyfvfu3mtiTNDoB1/4jCye+mHNq94DZkNrZNU1t5ildC3SaJYoHiivlOqGRmkz+7WYempSoozNHGUynXIkJTFRstJSJMMUefd+0597n2wjgAACCCCAAALDRYAA1HB5UowTAQQQQACBIATazZvwvvunJ2TLvoNBnP3hKeNycmVBUdGACpNfc/oSmZATniwoHc3R4p3y4N23SXNjvd/xa+HtCSEsv/PupCstR1oWXyc9Ccneh0L+rm8E1CLkDWaZnDZdJnfXjZ+Wk2cUhdwXFyCAAAIIIIAAAtEuEHrOfbSLMD8EEEAAAQSGsUCiWf71w89fKWOzM4OeRXlVpewqORz0+e4n7i495v510Nvji2bLhTd8VWIDZGRlpg0ueymuqUpS1v9VYjpaBj3WY7W1vcGnpMQE+d7nryL4NGhVOkAAAQQQQACBaBUgABWtT5Z5IYAAAgiMWAF9o9r/mWCIq5h1MBAlFeVy1ASiQm0VtQ2hXtLv+SeeebGcd/XNfs9LSUrwuz+UnXHN1ZK8+UmRnuBqZfnrW4uPb9m/r/fQd6+5VE6cNrn3OxsIIIAAAggggAACngIEoDw9+IYAAggggEBUCEwemyP/eeXFQc9Fa2LvOHhAmlpCywzqMEv+wt20wPmpn7hG5p18ukfXuRkppjC3VksafIuvP/pREKrvYuD+7qQFxLcdONBbSPzbV18iK2ZP83cq+xBAAAEEEEAAAQQ+EiAAxU8BAQQQQACBKBU4a+Fs+eInzpaYIIM2+na2jfv2mmLZwQeV0lMGtyQuEH18YpJcc/s9Mn7KdOuUeFNfKdz3Sqg+IElbnxbp6gg0DL/7d5eWSG1DvZVhdtsVF8o5i+b4PY+dCCCAAAIIIIAAAh8LEID62IItBBBAAAEEok7g06eeKJetWBp0EEozoA6UlwXtMDlvdNDnhnpiXHyC3PL/fiGjskZLdnqSKZIeag/9n59YuU8S96yWmJ6ufk+uN8XG9c/h8nKJNUG9a88+VT6xdGG/13ECAggggAACCCCAgAgBKH4FCCCAAAIIRLGALmf7t4vOkitPWx70LA+aAFTdR2926+ui7LQUmT85v69TBn0sZVSmfP6OH8socy+7WlLZVknY80qf3Te3tcla88Y7/aNL8K49e6Vcf2bwpn12zkEEEEAAAQQQQGAECBCAGgEPmSkigAACCIxsAc0cuvmC0+TG8z1rKgVS6enukV2HDwU6bO3PSkuWK05dJAkB3lbX58UhHhxfNEfOuekOk8Vl319bko5slsR9r5mR+daE6u7uNjWfikU/9c/VZ54iN5xF8CnEx8jpCCCAAAIIIDDCBez7m9wIh2X6CCCAAAIIOElAV6991mTsfP1TF0hiQv9vkqtrbJTG5ma/U5iQkyWfP+dk0SBUpNqUhafIwrOvsDEI1SNJJesk/vA6n7fj7SktNTWfGuTME+ZZfz537kqzHNCG9YCRwuQ+CCCAAAIIIIDAEAjEmDRy33/qG4KBcEsEEEAAAQQQiIzAzpIy+eZvH5aOjr6LjSclJsoZi07wGNS0/DFy6bK5QxaAeel398iBze94jCncX1pmnCedBYusbqvq62Xdrp1y4qxp8v3PfTrct6I/BBBAAAEEEEBgxAiQATViHjUTRQABBBBA4EOB2YX58uuv3yTTzWdfra29XZpaW61TNOHn5JmT5OKT5gxZ8EkHcub135T8aXP7GvagjyXvXS3xJeulvbNDNpu3Ap40Z4b873WXDbpfOkAAAQQQQAABBEayAAGokfz0mTsCCCCAwIgVmDhmtPzklmvkUvOGvL6W5LWY4tvxcbGyYm6RrJgzxdoeSrTyxlZ5tadIWqX/ZYQDHWdMT7ek7H9dyra9KVPGj5X/vOJCSUqIH2h3XIcAAggggAACCCBgBFiCx88AAQQQQACBES6w9+gx+f5jz0rpsSrrDW/uHEtmzZTrz1omcyf2nS3lfo1d21UNTXLrLx+Sqtp6Se5qkQtaTM0m6bbrduZdwXFy4VfukcKZi4Y068u+CdIzAggggAACCCAQOQECUJGz5k4IIIAAAgg4VqCjs0v2Hq2Q+555QQ6agJSr/eKrn5NZBeNcX4fs80BFpdz2679Kc8uHSwJ1IHkdx2Rl205bxxQbHy8XfvkuKZi12Nb70DkCCCCAAAIIIBDtAgSgov0JMz8EEEAAAQRCFDhaXSuabZSXlSFjM0eFeHX4T39v93754WP/NG/la/HpfEbrflnQWeqzP5w7UtIy5KybviMFMz0LsofzHvSFAAIIIIAAAghEuwABqGh/wswPAQQQQACBYSqgr+l9e8de+cGqZ6WtvSPALHpkact2mdRVFeB4eHanpGfJJbf/yOosK68wPJ3SCwIIIIAAAgggMIIECECNoIfNVBFAAAEEEBguAhp8escEn+7+69PS3d13nae4nk65sOk9SZauiEzv6jsflMwxEyJyL26CAAIIIIAAAghEiwABqGh5kswDAQQQQACBKBJ49I218scXXvcpih5oigk9HXJu8zpJ7WkPdErY9qdl5sgnv/EDyRxbELY+6QgBBBBAAAEEEIh2AQJQ0f6EmR8CCCCAAALDTOCJtzbIcx9skcy0VMlITZO05GQrEFXX3CwlxyqkvMr/crvszho5rXW7JEQgEyp73ES56NbvSXr2mGGmy3ARQAABBBBAAIGhESAANTTu3BUBBBBAAAEEvAS6zFK7lzfukW2HyryOeH49WF4uuw8f8tz50bcJHUdlWdteifF7NLw7R40eK5d/6xeSnJ4R3o7pDQEEEEAAAQQQiEKB2CicE1NCAAEEEEAAgWEm0N3TI0+9vVW29xN80mlNysuTaQX+l78dSciXrQmRKRLeUH1MnvrR16S9pWmYaTNcBBBAAAEEEEAg8gIEoCJvzh0RQAABBBBAwE2graNTnnxrsxw6Xi1afLy/FhMTI0X542VcTq6fU2Nkb9JkORqb5edY+HdpEOrF394lnW0t4e+cHhFAAAEEEEAAgSgSIAAVRQ+TqSCAAAIIIDDcBJrbOmTVmxtN8KkmpKFrEGpBUZHkZPkGmnokVt5NmS9VMakh9TnQk4/u3SovPvg96e7sGGgXXIcAAggggAACCES9ADWgov4RM0EEEEAAAQScKVDX3Cp/eHmtdHV1D3iA3aZu1Dvbt0lTi28GUnJ3i1zQtE7iYwbefygDG1c0Ry7++g8kLj4hlMs4FwEEEEAAAQQQGBECZECNiMfMJBFAAAEEEHCWwNHqennk9fWDCj7pjGJjY+XEmbMkLi7OZ4KtsSnyRso8n/127ag4sFNe/fOPzRv7IhPwsmse9IsAAggggAACCNghQADKDlX6RAABBBBAAAG/AlrjaV9ZpTzz7hZpam33e06oO5MTE2XFvPmSmJDoc2lNfLa8lzhNuiPwXrweU0i9eMMaeeuxB3zGwQ4EEEAAAQQQQGCkCxCAGum/AOaPAAIIIIBAhAQ0QLP3yDH5x9ptorWfwtlSkpJkwdSpVkaUd7+liROkLK1AtG5UJNqOt56Xt//2K5MJFUxJ9UiMiHsggAACCCCAAAJDL0AAauifASNAAAEEEEBgRAh8sPew/OP9HdLVbU9gJicjQ8bnjvGx1MDTZ792lxTMWeJzzK4d2978h6x/7mG7uqdfBBBAAAEEEEBg2AkQgBp2j4wBI4AAAgggMPwEVm/aI2u2H/CbFTRqVKpMmTxepk4tMBlMg8tSGm2CUO4tPj5O7rrx0zJ9Qr6ccd2/S0Zuvvth+7ZN9tP65x+Wza88Yd896BkBBBBAAAEEEBhGAgSghtHDYqgIIIAAAggMN4GOzi75p8l62lR8xCP4pFlJo0dnyLy5RTJn9hQZOzZbsjLTB71MLjE+vpdI73H9OStl+ayppl+R1IxsuejWeyQxJbX3HLs31j7zR9FsKBoCCCCAAAIIIDDSBQhAjfRfAPNHAAEEEEDAJoH2ji7521ubZVdphccdNCtp9qxJMn1aoaSlpVjHuru7Zf/+0kG/FU/7cbUrTlsm156xzPXV+swcM0Eu+PJdEhef4LHfri/6Rrx3nvi1HNq21tzCnqWHdo2dfhFAAAEEEEAAgXAKEIAKpyZ9IYAAAggggIAl0NreKQ+/vk6OVtd5iGRnj5KFC6bLqFFpHvv37z8itXWNHvsG8qWptdW67NQFc+Smc1f47SJ/6jxZevENfo/ZsbPHBMVeevB7Urpzgx3d0ycCCCCAAAIIIDAsBAhADYvHxCARQAABBBAYPgLHTSDpoVfel6qG5t5Ba2WnwsI8mTF9omgGlHvbt69Eqmvq3XcNeLuuqUmmF46X71x5oSS4Lcfz7nDB2ZfL3NMu9t5t2/fuzk554Td3ycGt79l2DzpGAAEEEEAAAQScLEAAyslPh7EhgAACCCAwzAQOVFTLX15bLw0tbb0jj4uLlWkm8DQ+P7d3n25Yy+5Mbaiq6vAEn7TPjLRk+ekt10pSQt9L7GJiYmXZZV+QMZNm6GURaV2dHfLqQz+W8uLtEbkfN0EAAQQQQAABBJwkENNjmpMGxFgQQAABBBBAYHgKbDl4RF7asMdj8AkJ8WbJ3TSJi/PMetKTDhwsk2PHqj3OH8yXOFNp/NozF0telueb8Prqs6ujTVbddbM01lb2dVpYjyUkp8g1d/5RUkZlhrVfOkMAAQQQQAABBJwsQAaUk58OY0MAAQQQQGAYCHSbf8t6dfM+eWXTPo/RZpq32s2bN9Vv8OlgmINPeuOrTw8t+KTXxCUkySe+9v9JSlrwQSu9bjCto7VFHrvnZqk+emAw3XAtAggggAACCCAwrAQIQA2rx8VgEUAAAQQQcJZAe2eXrN64RzbsL5EutzfQ5eWNNvWeCiXRZEC5N028PnioXCrCmPmUaGpKfWr5fMkfPbAgUlZeoZx69VclJjZyfy1qa26UF351p1SXHXTnYRsBBBBAAAEEEIhagcj9TStqCZkYAggggAACI1OgvaNTnn1vm2w5eLQXIDY2RiaaYuOTJ+VLrFdAR4NPpUeOS0VFVe/5g90wq+7kpJmTZKpXfalQ+y06YaUs+9TNItphhFpDzXF56bd3S1tTQ4TuyG0QQAABBBBAAIGhEyAANXT23BkBBBBAAIFhK9DZ1SUPv75eDrplMmnwacaMSZIfIBhUUnpMjh49HtY5L5lWKCfPmBiWPueddolMXrAsLH0F20nd8TJ58ge3SntLU7CXcB4CCCCAAAIIIDAsBShCPiwfG4NGAAEEEEBg6ASOmrfWPbt2mzS6vekuKSlBpps33aWlJvsd2KHD5VJeHr7MJ73J9PFj5KITZ0uCWYIXrtbd3SX/vP9bUrZ/R7i6DKqfnIIiufDf7pG0zNFBnc9JCCCAAAIIIIDAcBMgA2q4PTHGiwACCCCAwBAK7D5yTB5fs9Ej+JQxKlXmm2Lj/oJPWqD8cElF2INPOeaeFyyeFdbgk7LGxsbJ2TfdIRm54yKqXFVaLK/9+Ucsx4uoOjdDAAEEEEAAgUgKkAEVSW3uhQACCCCAwDAV0PpNa/celre2FXvMIDc3S6YWTfDY5/7FjmV36cmJcssFyyXOq8aU+30Hu3388B55+t7bpcetsPpg+wzm+ryi2XLZ7T+JaC2qYMbFOQgggAACCCCAwGAFyIAarCDXI4AAAgggEOUCnV3d8q91O+Vtr+DTpIn5UjRlfMDZHzxYFvaaT/Em6HTZ8gW2Bp90QmMmzpCL/u1uiY33fItfwMmG6UDFgV3y7P3/KZ3trWHqkW4QQAABBBBAAAFnCBCAcsZzYBQIIIAAAgg4UqCxtU3+bt50t8sso+v5aIRxcXEm66lAxo0bbV4a5/vWOM2WOnDgqFS4FSgP1+QuXDpbxmWPCld3ffYzYdZiWXTOleYc3zn2eeFgDhq7sn3bZc1jD5ggVNtgeuJaBBBAAAEEEEDAUQKR/Wc9R02dwSCAAAIIIIBAXwK1TS3ytzWbpK7542ychIR4mTatQDJGpfm9tNssWdPMp+OVtX6PD3SnBrpOmT1ZZk4YO9AuQr5O77n04hukvrJM9q17PeTrB3PBnrWvSKwJ9K38zNetz8H0xbUIIIAAAggggIATBMiAcsJTYAwIIIAAAgg4TODgsRr548vvewSf4uJiZe6cKQGDT5r5tH//kbAHn5SmKC9Hls2cNCRKZ1x3u+RMmBLxe+9652V545H7zH1duWcRHwI3RAABBBBAAAEEwiZAEfKwUdIRAggggAAC0SHw1o4Dsm7PYel0K8CdnpYiM2ZMFM2A8tc0+LR7zyGpq2vyd3hQ+yaPHW3qPs2XeBMAG6rWUFUhj//fl6zbR3JpnGZBzTvjMll22Rf8LnccKg/uiwACCCCAAAIIhCpAACpUMc5HAAEEEEAgSgWa29rlxfW7ZX95pccMs03NpWlTCyU21n8tpPb2Ttljgk9Nbkv1PDoYxJfM1GS56rQTRD+HutWUH7KG8MxPvintLeEPtPU1v2WX3iQLzvk0Qai+kDiGAAIIIIAAAo4WIADl6MfD4BBAAAEEEIiMQGV9k/z1tXWib7xzb7k5mVJUNCFg4KOtrUO2by+Wjs5O98vCsq1vvLvxnKWSnZ4alv7C1cmud16QN1f9QnrcMsTC1Xdf/Sy//GZZcNYVfZ3CMQQQQAABBBBAwLEC/vPoHTtcBoYAAggggAAC4RbYfOCIrNlW7BN8ys/PlcKCsQGDTzU1DVJsru3s7Ar3kCTOZFtdfupCyUpzVvBJJzpz+fnSWHNc1j//SNjn3VeHa5/9kyQmp8msUy7o6zSOIYAAAggggAACjhQgAOXIx8KgEEAAAQQQsF9As5203tOGfSXSbWo4ubexpu7SxMI8913WdktLmzSat+M1NDRLpXnTndZ+sqOdPGuyTMzNsqPrQfepb8dbdN5VUlNRIsUb1gy6v2A76DZZZmtWPSCJKWlSdMLKYC/jPAQQQAABBBBAwBECLMFzxGNgEAgggAACCERWoLW9Q17euEd2Hznmc+OEBFP4eu5Ua78Gqdpa26W2rlFqauqloyP8S+28BzC7IE8+cdIc792O+97R2ixP/fgbUltRGtGxaQDs/C/dKZPmnRzR+3IzBBBAAAEEEEBgMAIEoAajx7UIIIAAAggMQ4Gu7h552NR7OmaCSoGaBjm02ZXhFOi+acmJcsv5y4f0jXeBxuZvf2d7qzx6503S3FDj77Bt+2Lj4uWyb/5ExkycYds96BgBBBBAAAEEEAinwNC9zzics6AvBBBAAAEEEAhKoMm86e6h1Wv7DD5pRxp4inTwKTUpQa47Y8mwCT6pU3xispx907clNj6yVQ26uzrluQf+S2rKDuowaAgggAACCCCAgOMFCEA5/hExQAQQQAABBMIjoG+6+/MrH0h1Y0t4OgxjL4nxcXLR0rmSkZocxl4j09X46QvltKu/Gpmbud2ltblRnrr3Njless9tL5sIIIAAAggggIAzBQhAOfO5MCoEEEAAAQTCKlBrCoc/vmajNJl6Tk5sy2dPlsljs504tKDGNHPZ+TJ35cXmjYGR/atVZ1ubPPeLO6S+sjyocXISAggggAACCCAwVAKR/VvSUM2S+yKAAAIIIDCCBbTg+Ko3NkhzW4cjFRZNmSBLphU6cmyhDGrFlf8m+dPmhnJJWM5tbW6Qf/7829Le0hSW/ugEAQQQQAABBBCwQ4AAlB2q9IkAAggggIBDBFpM8Okvr66TRodmPuWMSpWV84ok9qOi5w5hG9AwYmJj5fxb/p/kFk4b0PWDuaih+pg8+YOvSnN9ZIuhD2bMXIsAAggggAACI0uAANTIet7MFgEEEEBgBAl0m0Lir2zaK3XNrY6ctb7xTouOJyVEtoC3nRiJqely5vX/LilpGXbexm/f9VXl8g+TCdVcV+33ODsRQAABBBBAAIGhFIgxb7jpGcoBcG8EEEAAAQQQsEdg95Fj8o+120PqPDUpUU6bN1Wmjx8jCfGxUlpVJ+/uOCglleHNrIkxo7p8xUKZkjc6pPENl5OPl+yVp398u/R0d0V8yDkmA+vT37pfJML1qCI+UW6IAAIIIIAAAsNKgADUsHpcDBYBBBBAAIHgBR5+bb2U1dQHdUF8nFk+tniWzCwY67McTv+l6lhtgzz97lZpbGkLqr/+TloxZ4osnzW5v9OG7fGenm7Zu3a1vP7w/aLbkW5ai+qT3/hRxIuiR3qe3A8BBBBAAAEEho8AS/CGz7NipAgggAACCAQtUFJZK+UmaBRsO/eEGTK7MM8n+KTXa7ZSXtYo+axZLpeRmhxslwHPm5KXIyfNmBjweDQc0LfhzVh2nsxZedGQTKds33Z54dd3Uph8SPS5KQIIIIAAAgj4EyAA5U+FfQgggAACCAxzgU37j5jMm+BW2c8uyJO5E/P7nXF6StKgA0da9+kTS2dLnCnYPRLaqVd9RQpnLx6SqR7evk7efuJX0tkenqy1IZkEN0UAAQQQQACBqBEYGX/7i5rHxUQQQAABBBDoX0CLj1c1NPV/4kdnLCgaH/S58yePl6T4gRUN1zfdfdrUfUpOTAj6fsP/xBg568ZvS2Jy2pBMZc/aV2TNqp8Pyb25KQIIIIAAAggg4C5AAMpdg20EEEAAAQSiQEATn1raO4KeSWZaStDnxsXGyITczKDPdz/xpJkTZUxmuvuuEbGdnJ4hl3/755KcOmpI5rvn/dfkzUfvl+6uziG5PzdFAAEEEEAAAQRUgAAUvwMEEEAAAQSiTqBHurqCL3ydEOJyuJQBZDBNyMkyRcenRJ10sBPKHDNeTvvs7RKfmBTsJWE8r0d2vfOSbHvj2aCXZYbx5nSFAAIIIIAAAghYAgSg+CEggAACCCAwwgXaOkPLjKlvDq2mkC69u/BErfuk5cxHbpuyYLmceNF1pqp75B30TXzvPvU7qSzdN3IfADNHAAEEEEAAgSEVIAA1pPzcHAEEEEAAATsEYiQ+Lvj/E1/d2BL0IJrbOuRodW3Q5yfExcn1Z58oWWmDf3te0Dd18IkLzrpc5p1+yZCNcK+pCUVDAAEEEEAAAQSGQiD4v50Oxei4JwIIIIAAAgiELBBrMo1CKfT93s6D0tUd3JK9dXsPm3ODe7tejMn0OX3+VBmTMfLqPgV6aDGxcXLSxTfI2MmzAp1i6/7SXRtt7Z/OEUAAAQQQQACBQAIEoALJsB8BBBBAAIFhKqALvHJDCPocra6Tt7YX91kfSENOR6vrZeP+0qBVTpxWIIuKJgR9/kg5MSE5VS775k8kIzc/4lNuqKmI+D25IQIIIIAAAgggoAIEoPgdIIAAAgggEIUCJ5jgTyht3b5SeebdbdIZoHj5tkNl8viajdIR4Lj3vYrG5cpp86Z67+b7RwIxMbFy0a3fk7iEhIiaxMXGR/R+3AwBBBBAAAEEEHAJxPSY5vrCJwIIIIAAAghEh4D+H/dHXlsvZTX1IU0oLTlR8rMzZExWuikaHis1Dc1SZjKfqhubg+4nZ1SqXHvGEklKINjRH1rxprfl5Qe/199pYTs+buocufT2n4StPzpCAAEEEEAAAQSCFSADKlgpzkMAAQQQQGAYCegyvMXTQ8uC0uk1tbbLvrJKedfUhdJledsPl4cUfNJi49ecTvAp2J9K0aIVcvKln5cYE+yLRJuycEUkbsM9EEAAAQQQQAABH4HI/G3H57bsQAABBBBAAAG7BWZNyJMJOVl236a3/wTz5r1Lls03BdDJfOpFCWJj4dmflsLZS0SLttvZEpKSZfrSs+28BX0jgAACCCCAAAIBBQhABaThAAIIIIAAAsNbQOMZFy2dLRoYikTT4NPYTN54F6q1Zj+df8v/SP7UuaFeGvT5cQmJcsnt90rKqMygr+FEBBBAAAEEEEAgnAKR+RtpOEdMXwgggAACCCAQtEBm6v/P3n3Ax1WcCx9+1XuxZNmWi+Qmd9xxAdsYY3o3NbQLIZBALiEFSM+FkISQkEYJEEhC+SCU0HuzcTfuNu5VlqssyZLVu76ZtbecLdJKWq3Onv1PfmJPnTPzjCPtvjslXi6aMlqiuzAIpeeKOmficBnYK8PvcnGhUSAyOkZm3/gjtTJeH+OJAOwlpfeU8+94QHr2Z1L4AHCSBQIIIIAAAgh0UIAAVAfhuA0BBBBAAIFQERiS3VNOHzVIIrtgiJfOc+KQfjJ2YF81hCxURMxZzpTMPjL31p9LlApGBSql9eorF/3vb6XfsPGBypJ8EEAAAQQQQACBDgmwCl6H2LgJAQQQQACB0BNYs3u/LNiwK6AFnz5ykJw+cmBA8wz3zI7s3iTv/PU+kU4uVJyUmilX//JpiU1ICndS6o8AAggggAACJhCgB5QJGoEiIIAAAgggEAyBCYP7q+F4o9ScUFGdfpzu+XThqaPktBG5nc6LDIwCfYaMkYnnXms82M69wRNnyrX3/5PgUzvduBwBBBBAAAEEuk6AHlBdZ0vOCCCAAAIImFLg4LFy1RNqpxwpLe9Q+fRcT7PHDpWeqfSs6RCgnzfNf/4PsnPVAj+vPnmZCgyOV6vqTb30FmFMZPvouBoBBBBAAAEEulaAAFTX+pI7AggggAACphRoUaVat/uArNxeIFV19Wq0lz7iO0VFRkhyfJzMGZcnek4pUtcLNNTVyBsPf0+OHz3g18P03FEzrv6ujDjtXL+u5yIEEEAAAQQQQCCYAgSggqnNsxBAAAEEEDCZQGNTsxyrqJav8w/JjkPFUlVbZyhhr/QUGZ3TW/L69ZKkuBjRK96RgidQU14m/33oDqmuKGv1oTHxCXLR9x6SXjnD1HXMBt8qFicRQAABBBBAoFsECEB1CzsPRQABBBBAwHwCuhdUgwpINTQ22UZvxcVEE3AyQTPVVpbLyvf+LdtWfCYtTU0eJcoZM0WmXvI/ktF3sMc5DiCAAAIIIIAAAmYRIABllpagHAgggAACCCCAQCsClaXFsmv1Aik5tFdampslLauvDBp/uvTsP6SVuziFAAIIIIAAAgiYQ4AAlDnagVIggAACCCCAAAIIIIAAAggggAAClhVgIgfLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAAAQQQsKwAASjLNi0VQwABBBBAAAEEEEAAAQQQQAABBMwhQADKHO1AKRBAAAEEEEAAAQQQQAABBBBAAAHLChCAsmzTUjEEEEAAAQQQQAABBBBAAAEEEEDAHAIEoMzRDpQCAQQQQAABBBBAAAEEEEAA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gAqbkIMAAggggAACCCCAAAIIIIAAAgggEKMAAagYMSkKAQQQQAABBBBAAAEEEEAAAQQQQCAsQAAqbEIOAggggAACCCCAAAIIIIAAAggggECMAgSgYsSkKAQQQAABBBBAAAEEEEAAAQQQQACBsAABqLAJOQgggAACCCCAAAIIIIAAAggggAACMQoQgIoRk6IQQAABBBBAAAEEEEAAAQQQQAABBMICBKDCJuQggAACCCCAAAIIIIAAAggggAACCMQoQAAqRkyKQgABBBBAAAEEEEAAAQQQQAABBBAICxCACpuQgwACCCCAAAIIIIAAAggggAACCCAQowABqBgxKQoBBBBAAAEEEEAAAQQQQAABBBBAICxAACpsQg4CCCCAAAIIIIAAAggggAACCCCAQIwCBKBixKQoBBBAAAEEEEAAAQQQQAABBBBAAIGwAAGosAk5CCCAAAIIIIAAAggggAACCCCAAAIxChCAihGTohBAAAEEEEAAAQQQQAABBBBAAAEEwgIEoMIm5CCAAAIIIIAAAggggAACCCCAAAIIxChAACpGTIpCAAEEEEAAAQQQQAABBBBAAAEEEAgLEIAKm5CDAAIIIIAAAggggAACCCCAAAIIIBCjAAGoGDEpCgEEEEAAAQQQQAABBBBAAAEEEEAgLEAAKmxCDgIIIIAAAggggAACCCCAAAIIIIBAjAIEoGLEpCgEEEAAAQQQQAABBBBAAAEEEEAAgbAAAaiwCTkIIIAAAggggAACCCCAAAIIIIAAAjEKEICKEZOiEEAAAQQQQAABBBBAAAEEEEAAAQTCAgSgwibkIIAAAggggAACCCCAAAIIIIAAAgjEKEAAKkZMikIAAQQQQAABBBBAAAEEEEAAAQQQCAsQgAqbkIMAAggggAACCCCAAAIIIIAAAgggEKMAAagYMSkKAQQQQAABBBBAAAEEEEAAAQQQQCAsQAAqbEIOAggggAACCCCAAAIIIIAAAggggECMAgSgYsSkKAQQQAABBBBAAAEEEEAAAQQQQACBsAABqLAJOQgggAACCCCAAAIIIIAAAggggAACMQoQgIoRk6IQQAABBBBAAAEEEEAAAQQQQAABBMICBKDCJuQggAACCCCAAAIIIIAAAggggAACCMQoQAAqRkyKQgABBBBAAAEEEEAAAQQQQAABBBAICxCACpuQgwACCCCAAAIIIIAAAggggAACCCAQowABqBgxKQoBBBBAAAEEEEAAAQQQQAABBBBAICxAACpsQg4CCCCAAAIIIIAAAggggAACCCCAQIwCBKBixKQoBBBAAAEEEEAAAQQQQAABBBBAAIGwAAGosAk5CCCAAAIIIIAAAggggAACCCCAAAIxChCAihGTohBAAAEEEEAAAQQQQAABBBBAAAEEwgIEoMIm5CCAAAIIIIAAAggggAACCCCAAAIIxChAACpGTIpCAAEEEEAAAQQQQAABBBBAAAEEEAgLEIAKm5CDAAIIIIAAAggggAACCCCAAAIIIBCjAAGoGDEpCgEEEEAAAQQQQAABBBBAAAEEEEAgLEAAKmxCDgIIIIAAAggggAACCCCAAAIIIIBAjAIEoGLEpCgEEEAAAQQQQAABBBBAAAEEEEAAgbAAAaiwCTkIIIAAAggggAACCCCAAAIIIIAAAjEKEICKEZOiEEAAAQQQQAABBBBAAAEEEEAAAQTCAgSgwibkIIAAAggggAACCCCAAAIIIIAAAgjEKEAAKkZMikIAAQQQQAABBBBAAAEEEEAAAQQQCAsQgAqbkIMAAggggAACCCCAAAIIIIAAAgggEKMAAagYMSkKAQQQQAABBBBAAAEEEEAAAQQQQCAsQAAqbEIOAggggAACCCCAAAIIIIAAAggggECMAgSgYsSkKAQQQAABBBBAAAEEEEAAAQQQQACBsAABqLAJOQgggAACCCCAAAIIIIAAAggggAACMQoQgIoRk6IQQAABBBBAAAEEEEAAAQQQQAABBMICBKDCJuQggAACCCCAAAIIIIAAAggggAACCMQoQAAqRkyKQgABBBBAAAEEEEAAAQQQQAABBBAICxCACpuQgwACCCCAAAIIIIAAAggggAACCCAQowABqBgxKQoBBBBAAAEEEEAAAQQQQAABBBBAICxAACpsQg4CCCCAAAIIIIAAAggggAACCCCAQIwCBKBixKQoBBBAAAEEEEAAAQQQQAABBBBAAIGwAAGosAk5CCCAAAIIIIAAAggggAACCCCAAAIxChCAihGTohBAAAEEEEAAAQQQQAABBBBAAAEEwgIEoMIm5CCAAAIIIIAAAggggAACCCCAAAIIxChAACpGTIpCAAEEEEAAAQQQQAABBBBAAAEEEAgLEIAKm5CDAAIIIIAAAggggAACCCCAAAIIIBCjAAGoGDEpCgEEEEAAAQQQQAABBBBAAAEEEEAgLEAAKmxCDgIIIIAAAggggAACCCCAAAIIIIBAjAIEoGLEpCgEEEAAAQQQQAABBBBAAAEEEEAAgbAAAaiwCTkIIIAAAggggAACCCCAAAIIIIAAAjEKEICKEZOiEEAAAQQQQAABBBBAAAEEEEAAAQTCAgSgwibkIIAAAggggAACCCCAAAIIIIAAAgjEKEAAKkZMikIAAQQQQAABBBBAAAEEEEAAAQQQCAsQgAqbkIMAAggggAACCCCAAAIIIIAAAgggEKMAAagYMSkKAQQQQAABBBBAAAEEEEAAAQQQQCAsQAAqbEIOAggggAACCCCAAAIIIIAAAggggECMAgSgYsSkKAQQQAABBBBAAAEEEEAAAQQQQACBsAABqLAJOQgggAACCCCAAAIIIIAAAggggAACMQoQgIoRk6IQQAABBBBAAAEEEEAAAQQQQAABBMICBKDCJuQggAACCCCAAAIIIIAAAggggAACCMQo8P8BCMAGDBlyZtYAAAAASUVORK5CYII=" + } + }, "cell_type": "markdown", "id": "51466c8d-8ce4-4b3d-be4e-18fdbeda5f53", "metadata": {}, "source": [ "# How to edit graph state\n", "\n", - "When creating LangGraph agents, it is often nice to add a human-in-the-loop component.\n", - "This can be helpful when giving them access to tools.\n", - "Often in these situations you may want to edit the graph state before continuing (for example, to edit what tool is being called, or how it is being called).\n", + "Human-in-the-loop (HIL) interactions are crucial for [agentic systems](https://langchain-ai.github.io/langgraph/concepts/agentic_concepts/#human-in-the-loop). Manually updating the graph state a common HIL interaction pattern, allowing the human to edit actions (e.g., what tool is being called or how it is being called).\n", "\n", - "This can be in several ways, but the primary supported way is to add an \"interrupt\" before a node is executed.\n", - "This interrupts execution at that node.\n", - "You can then use `update_state` to update the state, and then resume from that spot to continue. " + "We can implement this in LangGraph using a [breakpoint](https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/breakpoints/): breakpoints allow us to interrupt graph execution before a specific step. At this breakpoint, we can manually update the graph state and then resume from that spot to continue. \n", + "\n", + "![image.png](attachment:49539520-097a-43d5-94b4-2b56193a579f.png)" ] }, { @@ -28,7 +31,7 @@ }, { "cell_type": "code", - "execution_count": 1, + "execution_count": 13, "id": "af4ce0ba-7596-4e5f-8bf8-0b0bd6e62833", "metadata": {}, "outputs": [], @@ -93,17 +96,181 @@ }, { "cell_type": "markdown", - "id": "3333b771", + "id": "035e567c-db5c-4085-ba4e-5b3814561c21", "metadata": {}, "source": [ - "## Build the agent\n", + "## Simple Usage\n", "\n", - "We can now build the agent. We will build a relatively simple ReAct-style agent that does tool calling. We will use Anthropic's models and a fake tool (just for demo purposes)." + "Let's look at very basic usage of this.\n", + "\n", + "Below, we do three things:\n", + "\n", + "1) We specify the [breakpoint](https://langchain-ai.github.io/langgraph/concepts/low_level/#breakpoints) using `interrupt_before` a specified step (node).\n", + "\n", + "2) We set up a [checkpointer](https://langchain-ai.github.io/langgraph/concepts/low_level/#checkpointer) to save the state of the graph up until this node.\n", + "\n", + "3) We use `.update_state` to update the state of the graph." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "85e452f8-f33a-4ead-bb4d-7386cdba8edc", + "metadata": {}, + "outputs": [ + { + "data": { + "image/jpeg": "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", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from typing import TypedDict\n", + "from langgraph.graph import StateGraph, START, END\n", + "from langgraph.checkpoint.memory import MemorySaver\n", + "from IPython.display import Image, display\n", + "\n", + "class State(TypedDict):\n", + " input: str\n", + "\n", + "def step_1(state):\n", + " print(\"---Step 1---\")\n", + " pass\n", + "\n", + "def step_2(state):\n", + " print(\"---Step 2---\")\n", + " pass\n", + "\n", + "def step_3(state):\n", + " print(\"---Step 3---\")\n", + " pass\n", + "\n", + "builder = StateGraph(State)\n", + "builder.add_node(\"step_1\", step_1)\n", + "builder.add_node(\"step_2\", step_2)\n", + "builder.add_node(\"step_3\", step_3)\n", + "builder.add_edge(START, \"step_1\")\n", + "builder.add_edge(\"step_1\", \"step_2\")\n", + "builder.add_edge(\"step_2\", \"step_3\")\n", + "builder.add_edge(\"step_3\", END)\n", + "\n", + "# Set up memory\n", + "memory = MemorySaver()\n", + "\n", + "# Add \n", + "graph = builder.compile(checkpointer=memory, interrupt_before=[\"step_2\"])\n", + "\n", + "# View\n", + "display(Image(graph.get_graph().draw_mermaid_png()))" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "1b3aa6fc-c7fb-4819-8d7f-ba6057cc4edf", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'input': 'hello world'}\n", + "---Step 1---\n" + ] + } + ], + "source": [ + "# Input\n", + "initial_input = {\"input\": \"hello world\"}\n", + "\n", + "# Thread\n", + "thread = {\"configurable\": {\"thread_id\": \"1\"}}\n", + "\n", + "# Run the graph until the first interruption\n", + "for event in graph.stream(initial_input, thread, stream_mode=\"values\"):\n", + " print(event)" + ] + }, + { + "cell_type": "markdown", + "id": "4ab27716-e861-4ba3-9d7d-90694013e3c4", + "metadata": {}, + "source": [ + "Now, we can just manually update our graph state - " + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "id": "49d61230-e5dc-4272-b8ab-09b0af30f088", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Current state!\n", + "{'input': 'hello world'}\n", + "---\n", + "---\n", + "Updated state!\n", + "{'input': 'hello universe!'}\n" + ] + } + ], + "source": [ + "print(\"Current state!\")\n", + "print(graph.get_state(thread).values)\n", + "\n", + "graph.update_state(thread, {\"input\": \"hello universe!\"})\n", + "\n", + "print(\"---\\n---\\nUpdated state!\")\n", + "print(graph.get_state(thread).values)" ] }, { "cell_type": "code", "execution_count": 4, + "id": "cf77f6eb-4cc0-4615-a095-eb5ae7027b7a", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "---Step 2---\n", + "---Step 3---\n" + ] + } + ], + "source": [ + "# If approved, continue the graph execution\n", + "for event in graph.stream(None, thread, stream_mode=\"values\"):\n", + " print(event)" + ] + }, + { + "cell_type": "markdown", + "id": "3333b771", + "metadata": {}, + "source": [ + "## Agent\n", + "\n", + "In the context of agents, updating state is useful for things like editing tool calls.\n", + " \n", + "To show this, we will build a relatively simple ReAct-style agent that does tool calling. \n", + "\n", + "We will use Anthropic's models and a fake tool (just for demo purposes)." + ] + }, + { + "cell_type": "code", + "execution_count": 5, "id": "6098e5cb", "metadata": {}, "outputs": [], @@ -218,7 +385,7 @@ }, { "cell_type": "code", - "execution_count": 5, + "execution_count": 6, "id": "cfd140f0-a5a6-4697-8115-322242f197b5", "metadata": {}, "outputs": [ @@ -231,10 +398,10 @@ "search for the weather in sf now\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "\n", - "[{'text': \"Certainly! I'll search for the current weather in San Francisco for you. Let me use the search function to find this information.\", 'type': 'text'}, {'id': 'toolu_019xfFeuGu6taKqA8unr6VxP', 'input': {'query': 'current weather in San Francisco'}, 'name': 'search', 'type': 'tool_use'}]\n", + "[{'text': \"Certainly! I can help you search for the current weather in San Francisco. To do this, I'll use the search function to look up the most up-to-date weather information. Let me do that for you right away.\", 'type': 'text'}, {'id': 'toolu_01FSkinAVXR1C4D5kecrzAnj', 'input': {'query': 'current weather in San Francisco'}, 'name': 'search', 'type': 'tool_use'}]\n", "Tool Calls:\n", - " search (toolu_019xfFeuGu6taKqA8unr6VxP)\n", - " Call ID: toolu_019xfFeuGu6taKqA8unr6VxP\n", + " search (toolu_01FSkinAVXR1C4D5kecrzAnj)\n", + " Call ID: toolu_01FSkinAVXR1C4D5kecrzAnj\n", " Args:\n", " query: current weather in San Francisco\n" ] @@ -261,7 +428,7 @@ }, { "cell_type": "code", - "execution_count": 6, + "execution_count": 7, "id": "1aa7b1b9-9322-4815-bc0d-eb083870ac15", "metadata": {}, "outputs": [ @@ -269,10 +436,10 @@ "data": { "text/plain": [ "{'configurable': {'thread_id': '3',\n", - " 'thread_ts': '1ef355a9-ab59-6102-8002-56ee1c266b09'}}" + " 'thread_ts': '1ef3e229-4126-628c-8002-2a809f9bb238'}}" ] }, - "execution_count": 6, + "execution_count": 7, "metadata": {}, "output_type": "execute_result" } @@ -307,7 +474,7 @@ }, { "cell_type": "code", - "execution_count": 7, + "execution_count": 8, "id": "a3fcf2bd-f881-49fe-b20e-ad16e6819bc6", "metadata": {}, "outputs": [ @@ -316,10 +483,10 @@ "text/plain": [ "[{'name': 'search',\n", " 'args': {'query': 'current weather in SF'},\n", - " 'id': 'toolu_019xfFeuGu6taKqA8unr6VxP'}]" + " 'id': 'toolu_01FSkinAVXR1C4D5kecrzAnj'}]" ] }, - "execution_count": 7, + "execution_count": 8, "metadata": {}, "output_type": "execute_result" } @@ -341,7 +508,7 @@ }, { "cell_type": "code", - "execution_count": 8, + "execution_count": 9, "id": "51923913-20f7-4ee1-b9ba-d01f5fb2869b", "metadata": {}, "outputs": [ @@ -355,13 +522,13 @@ "[\"It's sunny in San Francisco, but you better look out if you're a Gemini \\ud83d\\ude08.\"]\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "\n", - "Based on the search results, I can provide you with information about the current weather in San Francisco (SF):\n", + "Based on the search results, I can provide you with the current weather information for San Francisco:\n", "\n", - "The weather in San Francisco is currently sunny. This means it's a clear day with plenty of sunshine.\n", + "The weather in San Francisco is currently sunny. \n", "\n", - "However, I should note that the search result includes an unusual additional comment about astrology, which isn't typically part of a standard weather report. The mention of Geminis is likely not relevant to the actual weather conditions.\n", + "It's important to note that the search result also included a playful astrological reference, which isn't directly related to the weather. If you need more specific weather details like temperature, humidity, or forecast, please let me know, and I can perform another search to find that information for you.\n", "\n", - "If you'd like more specific details about the temperature, humidity, or wind conditions in San Francisco, I'd be happy to perform another search with a more focused query. Just let me know if you need any additional weather information!\n" + "Is there anything else you'd like to know about the weather in San Francisco or any other location?\n" ] } ], @@ -395,7 +562,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.12.3" + "version": "3.11.8" } }, "nbformat": 4, diff --git a/examples/human_in_the_loop/wait-user-input.ipynb b/examples/human_in_the_loop/wait-user-input.ipynb index 1fbb5fbe2..21b0bccb1 100644 --- a/examples/human_in_the_loop/wait-user-input.ipynb +++ b/examples/human_in_the_loop/wait-user-input.ipynb @@ -1,27 +1,22 @@ { "cells": [ { + "attachments": { + "02ae42da-d1a4-4849-984a-6ab0bbf759bd.png": { + "image/png": "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eGlmOlBpeGVsWERpbWVuc2lvbj44NzE8L2V4aWY6UGl4ZWxYRGltZW5zaW9uPgogICAgICAgICA8ZXhpZjpVc2VyQ29tbWVudD5TY3JlZW5zaG90PC9leGlmOlVzZXJDb21tZW50PgogICAgICA8L3JkZjpEZXNjcmlwdGlvbj4KICAgPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4K3lk4iwAAQABJREFUeAHsnQe8ZVdV//e79/U3b3qftCEkEEMJRIFQBERARWyogL2hIir27h97Q/3Yu37soqKgEFCQoiA1oSVAEtKTmcn09vq7977/77v22XfOe3kTk8zLvDvJb0/OPefssvbav31g1m/W3mv3LSglJyNgBIyAETACRsAIGAEjYASMgBFYVQQaq9q7OzcCRsAIGAEjYASMgBEwAkbACBiBQMDkzB+CETACRsAIGAEjYASMgBEwAkagBxAwOeuBSbAKRsAIGAEjYASMgBEwAkbACBgBkzN/A0bACBgBI2AEjIARMAJGwAgYgR5AwOSsBybBKhgBI2AEjIARMAJGwAgYASNgBEzO/A0YASNgBIyAETACRsAIGAEjYAR6AAGTsx6YBKtgBIyAETACRsAIGAEjYASMgBEwOfM3YASMgBEwAkbACBgBI2AEjIAR6AEETM56YBKsghEwAkbACBgBI2AEjIARMAJGwOTM34ARMAJGwAgYASNgBIyAETACRqAHEDA564FJsApGwAgYASNgBIyAETACRsAIGAGTM38DRsAIGAEjYASMgBEwAkbACBiBHkDA5KwHJsEqGAEjYASMgBEwAkbACBgBI2AETM78DRgBI2AEjIARMAJGwAgYASNgBHoAAZOzHpgEq2AEjIARMAJGwAgYASNgBIyAETA58zdgBIyAETACRsAIGAEjYASMgBHoAQRMznpgEqyCETACRsAIGAEjYASMgBEwAkbA5MzfgBEwAkbACBgBI2AEjIARMAJGoAcQMDnrgUmwCkbACBgBI2AEjIARMAJGwAgYAZMzfwNGwAgYASNgBIyAETACRsAIGIEeQMDkrAcmwSoYASNgBIyAETACRsAIGAEjYARMzvwNGAEjYASMgBEwAkbACBgBI2AEegABk7MemASrYASMgBEwAkbACBgBI2AEjIARMDnzN2AEjIARMAJGwAgYASNgBIyAEegBBEzOemASrIIRMAJGwAgYASNgBIyAETACRsDkzN+AETACRsAIGAEjYASMgBEwAkagBxAwOeuBSbAKRsAIGAEjYASMgBEwAkbACBgBkzN/A0bACBgBI2AEjIARMAJGwAgYgR5AwOSsBybBKhgBI2AEjIARMAJGwAgYASNgBEzO/A0YASNgBIyAETACRsAIGAEjYAR6AAGTsx6YBKtgBIyAETACRsAIGAEjYASMgBEwOfM3YASMgBEwAkbACBgBI2AEjIAR6AEETM56YBKsghEwAkbACBgBI2AEjIARMAJGwOTM34ARMAJGwAgYASNgBIyAETACRqAHEDA564FJsApGwAgYASNgBIyAETACRsAIGAGTM38DRsAIGAEjYASMgBEwAkbACBiBHkDA5KwHJsEqGAEjYASMgBEwAkbACBgBI2AETM78DRgBI2AEjIARMAJGwAgYASNgBHoAAZOzHpgEq2AEjIARMAJGwAgYASNgBIyAETA58zdgBIyAETACRsAIGAEjYASMgBHoAQRMznpgEqyCETACRsAIGAEjYASMgBEwAkbA5MzfgBEwAkbACBgBI2AEjIARMAJGoAcQMDnrgUmwCkbACBgBI2AEjIARMAJGwAgYAZMzfwNGwAgYASNgBIyAETACRsAIGIEeQMDkrAcmwSoYASNgBIyAETACRsAIGAEjYARMzvwNGAEjYASMgBEwAkbACBgBI2AEegABk7MemASrYASMgBEwAkbACBgBI2AEjIARMDnzN2AEjIARMAJGwAgYASNgBIyAEegBBEzOemASrIIRMAJGwAgYASNgBIyAETACRsDkzN+AETACRsAIGAEjYASMgBEwAkagBxAwOeuBSbAKRsAIGAEjYASMgBEwAkbACBgBkzN/A0bACBgBI2AEjIARMAJGwAgYgR5AwOSsBybBKhgBI2AEjIARMAJGwAgYASNgBEzO/A0YASNgBIyAETACRsAIGAEjYAR6AAGTsx6YBKtgBIyAETACRsAIGAEjYASMgBEwOfM3YASMgBEwAkbgIUCg0+mkO++8M3F3MgJGwAgYASNwfxAwObs/KLmOETACRsAIGIEHiMBrX/va9KxnPSu9+MUvTtPT04taT0xM3CtvUQW/GAEjYASMwCMSAZOzR+S0e9BGwAgYASPwUCNw9dVXRxfXX399+tSnPtXt7rrrrkuXX355euELX5gOHTrUzfeD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wARMwARMwARMwARMwARMwOLMvwETMAETMAETMAETMAETMAETqAEBi7MavASbYAImYAImYAImYAImYAImYAIWZ/4NmIAJmIAJmIAJmIAJmIAJmEANCFic1eAl2AQTMAETMAETMAETMAETMAETsDjzb8AETMAETMAETMAETMAETMAEakDA4qwGL8EmmIAJmIAJmIAJmIAJmIAJmIDFmX8DJmACJmACJmACJmACJmACJlADAhZnNXgJNsEETMAETMAETMAETMAETMAELM78GzABEzABEzABEzABEzABEzCBGhCwOKvBS7AJJmACJmACJmACJmACJmACJmBx5t+ACZiACZiACZiACZiACZiACdSAgMVZDV6CTTABEzABEzABEzABEzABEzABizP/BkzABEzABEzABEzABEzABEygBgQszmrwEmyCCZiACZiACZiACZiACZiACVic+TdgAiZgAiZgAiZgAiZgAiZgAjUgYHFWg5dgE0zABEzABEzABEzABEzABEzA4sy/ARMwARMwARMwARMwARMwAROoAQGLsxq8BJtgAiZgAiZgAiZgAiZgAiZgAhZn/g2YgAmYgAmYgAmYgAmYgAmYQA0IWJzV4CXYBBMwARMwARMwARMwARMwAROwOPNvwARMwARMwARMwARMwARMwARqQMDirAYvwSaYgAmYgAmYgAmYgAmYgAmYgMWZfwMmYAImYAImYAImYAImYAImUAMCFmc1eAk2wQRMwARMYOsIfPn7/1b6y/ffn57/o/+wdZW6JhMwARMwARPYAQIWZzsA2U2YgAmYwH4g0F1aSg//w3+Qvv7f//TQurv48NdS9/yZlPr99Pyv/9rQ7HDDJmACJmACJvBSCFicvRRqLmMCJmACJnAJgcVHHk7LX/lSWvjUR9Op3/7/Lnm+Ewmnf//3Bs20n3smnfrd30nd1ZVBmiMmYAImYAImUGcCFmd1fju2zQRMwAR2EYFGszWw9uS//heD+E5F8Jpd+LM/3NTcyV/652nxoYc2pfnGBEzABEzABOpKwOKsrm/GdpmACZjALiPQaG38k1IVajvVjarXrNpmozVSvXXcBEzABEzABGpLYONf0tqaaMNMwARMwAR2A4HGSEUEtTa8aDth++W8ZmW77TOny6ivJmACJmACJlBrAhZntX49Ns4ETMAEdg+BRmPjn5RGcyO+Ez2oes0u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dc3Ztjbkyk3ABEzABExgiwlYnG0xUFdnAiZgAvuVwKat9IcIoVk952yIdrhpEzABEzABE7hWAhZn10rM+U3ABEzABC5PoCaes01b6V/eUqeagAmYgAmYQC0JWJzV8rXYKBMwARPYfQQ2baU/RPO95myI8N20CZiACZjAyyJgcfay8LmwCZiACZhASaDfrseGIKnVKk3y1QRMwARMwAR2FQGLs131umysCZiACdSXQL8u0xob9WVky0zABEzABEzghQhYnL0QHT8zARMwARO4agJ18Zw17Dm76nfmjCZgAiZgAvUiYHFWr/dha0zABExg1xLodbu1sL3vg6dr8R5shAmYgAmYwLUTsDi7dmYuYQImYAImcDkCNTmEumnP2eXejtNMwARMwAR2AQGLs13wkmyiCZiACewKAjXxnDWa3hBkV/xebKQJmIAJmMAlBCzOLkHiBBMwARMwgZdCoFeT3Ro3baXf77+UrriMCZiACZiACQyFgMXZULC7URMwARPYgwRq4jlLlTVn/U491sHtwbftLpmACZiACWwDAYuzbYDqKk3ABExgPxKozVb6zY1/2vrJnrP9+Ft0n03ABExgtxLY+Bdst/bAdpuACZiACdSCQK8m55xtmtbY69WCjY0wARMwARMwgashYHF2NZScxwRMwARM4MUJ1EScpepujRZnL/7enMMETMAETKA2BCzOavMqbIgJmIAJ7G4C/ZpspV9dc5a8Icju/lHZehMwARPYZwQszvbZC3d3TcAETGC7CPS7ne2q+prqrZ5zVpeDsa+pA85sAiZgAiawbwlYnO3bV++Om4AJmMDWEqjNhiCV3RrtOdvad+zaTMAETMAEtpeAxdn28nXtJmACJrB/CNRlK32vOds/vzn31ARMwAT2GAGLsz32Qt0dEzABExgWgbp4zpqNyj9tXnM2rJ+D2zUBEzABE3gJBCr/gr2E0i5iAiZgAiZgAgWBfrddDxatyj9t3q2xHu/EVpiACZiACVwVgcq/YFeV35lMwARMwARM4LIE+nWZ1lhZc9a3OLvsu3KiCZiACZhAPQlYnNXzvdgqEzABE9hVBOpyAHVAqwiynqc17qrfkY01ARMwgf1OwOJsv/8C3H8TMAET2AoCdTmAWn3ZtH1+RahtRTddhwmYgAmYgAlsJwGLs+2k67pNwARMYJ8Q6LVrst5MvBtVb1m/t0/e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AAT6kyHhCAIgAAIgAAIgAAIgAAIgIBGAcNbPB6G5pU2Kwl4uhLWKmiYRdV1EXBeCmD8LZdgr1k+66A4CIAACIAACIAACIAACzkMAwpnz3GusFARAAARAAARAAARAAARAwIYJuNrw3DA1EAABEAABEAABEAABEAABEHAaAhDOnOZWY6EgAAIgAAIgAAIgAAIgAAK2TADCmS3fHcwNBEAABEAABEAABEAABEDAaQhAOHOaW42FggAIgAAIgAAIgAAIgAAI2DIBCGe2fHcwNxAAARAAARAAARAAARAAAachAOHMaW41FgoCIAACIAACIAACIAACIGDLBCCc2fLdwdxAAARAAARAAARAAARAAASchgCEM6e51VgoCIAACIAACIAACIAACICALROAcGbLdwdzAwEQAAEQAAEQAAEQAAEQcBoCEM6c5lZjoSAAAiAAAiAAAiAAAiAAArZMAMKZLd8dzA0EQAAEQAAEQAAEQAAEQMBpCGicZqVYKAiAAAg4CIHvv/+e1q1bJ60mKiqKHn/8cQdZGZYBAiAAAiAAAs5NAMKZc99/rB4EQEAQOHXqFO3cuVNiERcXR9dee61JLiUlJbRmzRrpnKurK/30pz812c7alYcPH6ZPP/1UuszIkSMhnFkbOMYHARAAARAAgQEiAOFsgEDjMiAAArZL4MyZM/TCCy9IE5w/f363wpncjhsPlnA2kCRfffVVeu2116RLzpo1i956662BvLzNXevAgQN0zz33SPPy9PSk7777jry8vAZ8nrYyjwFfOC4IAiAAAg5OAMKZg99gLA8EQAAE+kOgubmZampqpCEKCwv7M5RD9G1tbVV4MJeWlpZBWZetzGNQFo+LggAIgIADE4BDEAe+uVgaCIAACIAACIAACIAACICA/RCAcGY/9wozBQEQAAEQAAEQAAEQAAEQcGACMGt04JuLpYEACAwcATYz+/LLL5ULrly5UjJ5W79+PfGetvLyckpJSaGxY8fSlClTetynVFFRQez44/Tp05SRkUHs+GPZsmU0ZMgQ5RrdZb766iu6dOkSseMSjUZDPj4+FBMTQ2PGjKGIiIguu+bn59P+/fuV8+wsRU7p6en02WefyUWDI8+PP10lXv+JEyfo/PnzlJaWRoGBgTR8+HBpPt3162o8c+vZDJG5Xrx4UbonZWVlVFlZSR4eHhQcHCzNizldffXV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nXfe8fdY/f777+63337z9XVutthiC3+OTj31VDd8+HDbpOb1o48+csuXL3crVqxwaqOnp8ftsccePtPhpptuWlNfC15//XX3ww8/lNbJcfz48X7Z+++/73tIV65c6UaNGuXbO/HEE3vdj1JjCTOhWdVmstDntV7RkNknnniiWH3SSSe5NWvWOH0PZCJT/aCg+x3Vznrr1d6ZUNWGPsNKPqPPmtrQZ2zfffd1Bx10kNP5ryraD7Wlonsr9b5xUa+zzpOKep9Hjx7tp7///nunxCdWwvs5P//8c6fvTFXZe++9nf4oCCCAQDcLkK2xm88+x45AhwscffTR7osvvvB7ee+997pjjz3WrV692u21117Fns+bN68IgnTRqvvBVJSq/pRTTinq6R6zt99+u5iPJ6677jo3efLkeLFvT+2mFt1f9O6775Y2i7M1nnbaaW727NmlOjZz8803O63PUebPn++uvvpq33TVfmrFq6++6s4666zi7RU0KeiJy+LFi91NN91UnKd4fTivAKMqGFi1apWbNWtWKQgOt9t+++2d7A499NBwsZ8+77zznILyuCgY05DCG2+8MV7lAzQZhMF7TaUmFiiYPfPMM+tuqSBeAVK9okBMwaiVZ5991p1//vnuq6++skXFq35MuPXWW33AWSxcNxG38cILL7jp06e7zz77LKzmp5UxVN8r+cYl/C7NmTPHTZo0Ka7iv1/2Gb/ooov8YyJUST+ETJkypaZ+Xwv0HnovCgIIINDNArU/u3WzBseOAAIdJbDzzjsX+2O9Xt99912xTBP2fLJ//vmnCMy0PNxW851WdA9SvcBM+6pnoX3yySedttul/dEzvHThbwF0aWU0oyCwKjBTT47uxQp7J6NNnXpiTj/9dB8wxuvqzSurZlVgpvoKVO644456m3bMcj12oSow0w6qx/Caa67pc18V7FQFZtpQPZV6BttPP/3UZztUQAABBBAYGAGGNQ6MM++CAAJNCIQ9Gz///LNvwYIxa84uXsNnSWndjjvuaFX8q3pY4gyNeq6Z9bSVKgczG2+8sVMvlhUNCVSPjBX1uFUFHVXLbBu9WkBz3HHH+R4I9Qg+9NBD7s033yyqqWekU4OI//77z11wwQXFvmpCw+Q0/FQ9Mepl0zBIDUtVALbRRhuV6tqMLBV8WVEbEydO9KYaKnnPPffYKh+MqDcpTKqh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" + } + }, "cell_type": "markdown", "id": "51466c8d-8ce4-4b3d-be4e-18fdbeda5f53", "metadata": {}, "source": [ "# How to wait for user input\n", "\n", - "One of the main human-in-the-loop interaction patterns is waiting for human input. A key use case involves asking the user clarifying questions. One way to accomplish this is simply go to the END node and exit the graph. Then, any user response comes back in as fresh invocation of the graph. This is basically just creating a chatbot architecture.\n", + "Human-in-the-loop (HIL) interactions are crucial for [agentic systems](https://langchain-ai.github.io/langgraph/concepts/agentic_concepts/#human-in-the-loop). Waiting for human input is a common HIL interaction pattern, allowing the agent to ask the user clarifying questions and await input before proceeding. \n", "\n", - "The issue with this is it is tough to resume back in a particular point in the graph. Often times the agent is halfway through some process, and just needs a bit of a user input. Although it is possible to design your graph in such a way where you have a `conditional_entry_point` to route user messages back to the right place, that is not super scalable (as it essentially involves having a routing function that can end up almost anywhere).\n", + "We can implement this in LangGraph using a [breakpoint](https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/breakpoints/): breakpoints allow us to stop graph execution at a specific step. At this breakpoint, we can wait for human input. Once we have input from the user, we can add it to the graph state and proceed.\n", "\n", - "A separate way to do this is to have a node explicitly for getting user input. This is easy to implement in a notebook setting - you just put an `input()` call in the node. But that isn't exactly production ready.\n", - "\n", - "Luckily, LangGraph makes it possible to do similar things in a production way. The basic idea is:\n", - "\n", - "- Set up a node that represents human input. This can have specific incoming/outgoing edges (as you desire). There shouldn't actually be any logic inside this node.\n", - "- Add a breakpoint before the node. This will stop the graph before this node executes (which is good, because there's no real logic in it anyways)\n", - "- Use `.update_state` to update the state of the graph. Pass in whatever human response you get. The key here is to use the `as_node` parameter to apply this update **as if you were that node**. This will have the effect of making it so that when you resume execution next it resumes as if that node just acted, and not from the beginning.\n", - "\n", - "**Note:** this requires passing in a checkpointer.\n", - "\n", - "Below is a quick example." + "![Screenshot 2024-07-08 at 5.26.26 PM.png](attachment:02ae42da-d1a4-4849-984a-6ab0bbf759bd.png)" ] }, { @@ -41,7 +36,8 @@ "metadata": {}, "outputs": [], "source": [ - "%%capture --no-stderr\n%pip install --quiet -U langgraph langchain_anthropic" + "%%capture --no-stderr\n", + "%pip install --quiet -U langgraph langchain_anthropic langchain_openai" ] }, { @@ -49,7 +45,7 @@ "id": "0abe11f4-62ed-4dc4-8875-3db21e260d1d", "metadata": {}, "source": [ - "Next, we need to set API keys for Anthropic (the LLM we will use)" + "Next, we need to set API keys for Anthropic and / or OpenAI (the LLM(s) we will use)" ] }, { @@ -67,7 +63,17 @@ } ], "source": [ - "import getpass\nimport os\n\n\ndef _set_env(var: str):\n if not os.environ.get(var):\n os.environ[var] = getpass.getpass(f\"{var}: \")\n\n\n_set_env(\"ANTHROPIC_API_KEY\")" + "import getpass\n", + "import os\n", + "\n", + "\n", + "def _set_env(var: str):\n", + " if not os.environ.get(var):\n", + " os.environ[var] = getpass.getpass(f\"{var}: \")\n", + "\n", + "\n", + "_set_env(\"OPENAI_API_KEY\")\n", + "_set_env(\"ANTHROPIC_API_KEY\")" ] }, { @@ -85,7 +91,232 @@ "metadata": {}, "outputs": [], "source": [ - "os.environ[\"LANGCHAIN_TRACING_V2\"] = \"true\"\n_set_env(\"LANGCHAIN_API_KEY\")" + "os.environ[\"LANGCHAIN_TRACING_V2\"] = \"true\"\n", + "_set_env(\"LANGCHAIN_API_KEY\")" + ] + }, + { + "cell_type": "markdown", + "id": "e6cf1fad-5ab6-49c5-b0c8-15a1b6e8cf21", + "metadata": {}, + "source": [ + "## Simple Usage\n", + "\n", + "Let's look at very basic usage of this. One intuitive approach is simply to create a node, `human_feedback`, that will get user feedback. This allows us to place our feedback gathering at a specific, chosen point in our graph.\n", + " \n", + "1) We specify the [breakpoint](https://langchain-ai.github.io/langgraph/concepts/low_level/#breakpoints) using `interrupt_before` our `human_feedback` node.\n", + "\n", + "2) We set up a [checkpointer](https://langchain-ai.github.io/langgraph/concepts/low_level/#checkpointer) to save the state of the graph up until this node.\n", + "\n", + "3) We use `.update_state` to update the state of the graph with the human response we get.\n", + "\n", + "* We [use the `as_node` parameter](https://langchain-ai.github.io/langgraph/concepts/low_level/#update-state) to apply this state update as the specified node, `human_feedback`.\n", + "* The graph will then resume execution as if the `human_feedback` node just acted." + ] + }, + { + "cell_type": "code", + "execution_count": 61, + "id": "58eae42d-be32-48da-8d0a-ab64471657d9", + "metadata": {}, + "outputs": [ + { + "data": { + "image/jpeg": "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", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from typing import TypedDict\n", + "from langgraph.graph import StateGraph, START, END\n", + "from langgraph.checkpoint.memory import MemorySaver\n", + "from IPython.display import Image, display\n", + "\n", + "class State(TypedDict):\n", + " input: str\n", + " user_feedback: str\n", + "\n", + "def step_1(state):\n", + " print(\"---Step 1---\")\n", + " pass\n", + "\n", + "def human_feedback(state):\n", + " print(\"---human_feedback---\")\n", + " pass\n", + "\n", + "def step_3(state):\n", + " print(\"---Step 3---\")\n", + " pass\n", + "\n", + "builder = StateGraph(State)\n", + "builder.add_node(\"step_1\", step_1)\n", + "builder.add_node(\"human_feedback\", step_2)\n", + "builder.add_node(\"step_3\", step_3)\n", + "builder.add_edge(START, \"step_1\")\n", + "builder.add_edge(\"step_1\", \"human_feedback\")\n", + "builder.add_edge(\"human_feedback\", \"step_3\")\n", + "builder.add_edge(\"step_3\", END)\n", + "\n", + "# Set up memory\n", + "memory = MemorySaver()\n", + "\n", + "# Add \n", + "graph = builder.compile(checkpointer=memory, interrupt_before=[\"human_feedback\"])\n", + "\n", + "# View\n", + "display(Image(graph.get_graph().draw_mermaid_png()))" + ] + }, + { + "cell_type": "markdown", + "id": "ce0fe2bc-86fc-465f-956c-729805d50404", + "metadata": {}, + "source": [ + "Run until our breakpoint at `step_2` - " + ] + }, + { + "cell_type": "code", + "execution_count": 62, + "id": "eb8e7d47-e7c9-4217-b72c-08394a2c4d3e", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'input': 'hello world'}\n", + "---Step 1---\n" + ] + } + ], + "source": [ + "# Input\n", + "initial_input = {\"input\": \"hello world\"}\n", + "\n", + "# Thread\n", + "thread = {\"configurable\": {\"thread_id\": \"1\"}}\n", + "\n", + "# Run the graph until the first interruption\n", + "for event in graph.stream(initial_input, thread, stream_mode=\"values\"):\n", + " print(event)" + ] + }, + { + "cell_type": "markdown", + "id": "28a7d545-ab19-4800-985b-62837d060809", + "metadata": {}, + "source": [ + "Now, we can just manually update our graph state with with the user input - " + ] + }, + { + "cell_type": "code", + "execution_count": 63, + "id": "2165a1bc-1c5b-411f-9e9c-a2b9627e5d56", + "metadata": {}, + "outputs": [ + { + "name": "stdin", + "output_type": "stream", + "text": [ + "Tell me how you want to update the state: go to step 3!\n" + ] + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "--State after update--\n", + "StateSnapshot(values={'input': 'hello world', 'user_feedback': 'go to step 3!'}, next=('step_3',), config={'configurable': {'thread_id': '1', 'thread_ts': '1ef3e216-b8a2-6db4-8002-966ecca671d0'}}, metadata={'source': 'update', 'step': 2, 'writes': {'human_feedback': {'user_feedback': 'go to step 3!'}}}, created_at='2024-07-09T18:31:13.083519+00:00', parent_config=None)\n" + ] + }, + { + "data": { + "text/plain": [ + "('step_3',)" + ] + }, + "execution_count": 63, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Get user input\n", + "user_input = input(\"Tell me how you want to update the state: \")\n", + "\n", + "# We now update the state as if we are the human_feedback node\n", + "graph.update_state(thread, {\"user_feedback\": user_input}, as_node=\"human_feedback\")\n", + " \n", + "# We can check the state\n", + "print(\"--State after update--\")\n", + "print(graph.get_state(thread))\n", + "\n", + "# We can check the next node, showing that it is node 3 (which follows human_feedback)\n", + "graph.get_state(thread).next" + ] + }, + { + "cell_type": "markdown", + "id": "ccc4a84a-02f2-4b79-a5a5-22173645526d", + "metadata": {}, + "source": [ + "We can proceed after our breakpoint - " + ] + }, + { + "cell_type": "code", + "execution_count": 64, + "id": "3cca588f-e8d8-416b-aba7-0f3ae5e51598", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "---Step 3---\n" + ] + } + ], + "source": [ + "# If approved, continue the graph execution\n", + "for event in graph.stream(None, thread, stream_mode=\"values\"):\n", + " print(event)" + ] + }, + { + "cell_type": "markdown", + "id": "a75a1060-47aa-4cc6-8c41-e6ba2e9d7923", + "metadata": {}, + "source": [ + "We can see our feedback was added to state - " + ] + }, + { + "cell_type": "code", + "execution_count": 66, + "id": "2b83e5ca-8497-43ca-bff7-7203e654c4d3", + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'input': 'hello world', 'user_feedback': 'go to step 3!'}" + ] + }, + "execution_count": 66, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "graph.get_state(thread).values" ] }, { @@ -93,17 +324,32 @@ "id": "e36f89e5", "metadata": {}, "source": [ - "## Build the agent\n", + "## Agent\n", "\n", - "We can now build the agent. We will build a relatively simple ReAct-style agent that does tool calling. We will use Anthropic's models and a fake tool (just for demo purposes)." + "In the context of agents, waiting for user feedback is useful to ask clarifying questions.\n", + " \n", + "To show this, we will build a relatively simple ReAct-style agent that does tool calling. \n", + "\n", + "We will use OpenAI and / or Anthropic's models and a fake tool (just for demo purposes)." ] }, { "cell_type": "code", - "execution_count": 4, + "execution_count": 47, "id": "f5319e01", "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "image/jpeg": "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unOmNs5T1/bl8GYrrqymdkZx8OK4URFSW2lzX/k2/f2Cf/Tcrbof3FT/ANW3/JVJmv8Aybfv7BP/AKblbdD+4qf+rb/kvWei/wDbT+KfhDiekeml7oiLqOOIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIggfE798sS/t8v6rMo3lGHWLNqGOiyCz0N7o45BMyCvp2zMa8AgOAcCAdOcN/OVYuUYjR5ZHRtqpqmB1JKZopKWXs3tcWOYevq04rSfcqofli9/Xf8AZUsZg9aqorpr0ZpjLr3zPV7XUw2Kt2rehVCrxwA4aNBAwHHAHDRAtcPUf9q2OPcJMJxK6R3KyYlZbTcI2uayqoqGOKRoI0QHNAPUdFP/ALlVD8sXv67/ALJ9yqh+WL39d/2VKfRdc7JvfFZjG2I/4+ENai2X3KqH5Yvf13/ZVF4T1LW8KuH9su9hvd0jrKi+0FA8z1HaN7KWUNeNEd+u4qPmf+7HdLfnC1ulZa8qmmiraaWnqI2TQSsMckcg217SNEEekELb/cqofli9/Xf9k+5VQ/LF7+u/7JzP/djuk1+1ulV3/h+4ZewGNj8lrh//AFX9ZwB4aRva9mA441zTsOFrh2D/ANqtD7lVD8sXv67/ALJ9yqh+WL39d/2UnNlz13xR65Y7PhCJ5r/ybfv7BP8A6blbdD+4qf8Aq2/5KGVXCC2VtNNTz3W8ywTMMcjHVvRzSNEHp6lOI4xFG1jfitAA/IulhsPGFtcnpZznn4QpYu/TfmNHqfpERWFAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBc7+HN/BHY/wDqq0/rAXRC538Ob+COx/8AVVp/WAg6IREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAXO/hzfwR2P/AKqtP6wF0Qud/Dm/gjsf/VVp/WAg6IREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBFrL/kdBjVI2eumLOd3JFFG0vlmdrfKxg6uOgT07gCToAlQ6biDf6txdRWOlood+abjVkykfOyNpaP+8++Wm3VVGfRH2zl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", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "# Set up the state\n", "from langgraph.graph import MessagesState, START\n", @@ -131,9 +377,10 @@ "\n", "# Set up the model\n", "from langchain_anthropic import ChatAnthropic\n", + "from langchain_openai import ChatOpenAI\n", "\n", "model = ChatAnthropic(model=\"claude-3-5-sonnet-20240620\")\n", - "\n", + "model = ChatOpenAI(model=\"gpt-4o\")\n", "\n", "# We are going \"bind\" all tools to the model\n", "# We have the ACTUAL tools from above, but we also need a mock tool to ask a human\n", @@ -243,7 +490,9 @@ "# This compiles it into a LangChain Runnable,\n", "# meaning you can use it as you would any other runnable\n", "# We add a breakpoint BEFORE the `ask_human` node so it never executes\n", - "app = workflow.compile(checkpointer=memory, interrupt_before=[\"ask_human\"])" + "app = workflow.compile(checkpointer=memory, interrupt_before=[\"ask_human\"])\n", + "\n", + "display(Image(app.get_graph().draw_mermaid_png()))" ] }, { @@ -253,12 +502,14 @@ "source": [ "## Interacting with the Agent\n", "\n", - "We can now interact with the agent. Let's ask it to ask the user where they are, then tell them the weather. This should make it use the `ask_human` tool first, then use the normal tool.\n" + "We can now interact with the agent. Let's ask it to ask the user where they are, then tell them the weather. \n", + "\n", + "This should make it use the `ask_human` tool first, then use the normal tool." ] }, { "cell_type": "code", - "execution_count": 5, + "execution_count": 48, "id": "cfd140f0-a5a6-4697-8115-322242f197b5", "metadata": {}, "outputs": [ @@ -270,13 +521,11 @@ "\n", "Use the search tool to ask the user where they are, then look up the weather there\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", - "\n", - "[{'text': \"Certainly! I'll use the AskHuman function to ask the user about their location, and then use the search function to look up the weather. Let's start by asking the user where they are.\", 'type': 'text'}, {'id': 'toolu_01HgfTkwJ2pZhPuCuunBYUq4', 'input': {'question': 'Where are you currently located?'}, 'name': 'AskHuman', 'type': 'tool_use'}]\n", "Tool Calls:\n", - " AskHuman (toolu_01HgfTkwJ2pZhPuCuunBYUq4)\n", - " Call ID: toolu_01HgfTkwJ2pZhPuCuunBYUq4\n", + " AskHuman (call_LDo62KBPQKZWxPI5IHxPBF0w)\n", + " Call ID: call_LDo62KBPQKZWxPI5IHxPBF0w\n", " Args:\n", - " question: Where are you currently located?\n" + " question: Can you tell me where you are located?\n" ] } ], @@ -303,7 +552,7 @@ }, { "cell_type": "code", - "execution_count": 6, + "execution_count": 50, "id": "63598092-d565-4170-9773-e092d345f8c1", "metadata": {}, "outputs": [ @@ -313,7 +562,7 @@ "('agent',)" ] }, - "execution_count": 6, + "execution_count": 50, "metadata": {}, "output_type": "execute_result" } @@ -354,7 +603,7 @@ }, { "cell_type": "code", - "execution_count": 7, + "execution_count": 51, "id": "a9f599b5-1a55-406b-a76b-f52b3ca06975", "metadata": {}, "outputs": [ @@ -363,11 +612,9 @@ "output_type": "stream", "text": [ "==================================\u001b[1m Ai Message \u001b[0m==================================\n", - "\n", - "[{'text': \"Thank you for letting me know that you're in San Francisco. Now, I'll use the search function to look up the weather in San Francisco.\", 'type': 'text'}, {'id': 'toolu_01BKzfQfHBSUcgTbz7c4gs8w', 'input': {'query': 'current weather in San Francisco'}, 'name': 'search', 'type': 'tool_use'}]\n", "Tool Calls:\n", - " search (toolu_01BKzfQfHBSUcgTbz7c4gs8w)\n", - " Call ID: toolu_01BKzfQfHBSUcgTbz7c4gs8w\n", + " search (call_LJlkCFfHvAS2taKHTaMmORE5)\n", + " Call ID: call_LJlkCFfHvAS2taKHTaMmORE5\n", " Args:\n", " query: current weather in San Francisco\n", "=================================\u001b[1m Tool Message \u001b[0m=================================\n", @@ -376,16 +623,13 @@ "[\"I looked up: current weather in San Francisco. Result: It's sunny in San Francisco, but you better look out if you're a Gemini \\ud83d\\ude08.\"]\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "\n", - "Based on the search results, I can provide you with information about the current weather in San Francisco:\n", - "\n", - "The weather in San Francisco is currently sunny. \n", - "\n", - "It's worth noting that the search result included a playful comment about Geminis, but that's not directly related to the weather information you requested. If you need more specific details about the temperature, humidity, or forecast, please let me know, and I'd be happy to search for more detailed weather information for San Francisco.\n" + "The current weather in San Francisco is sunny. Enjoy the good weather! 🌞\n" ] } ], "source": [ - "for event in app.stream(None, config, stream_mode=\"values\"):\n event[\"messages\"][-1].pretty_print()" + "for event in app.stream(None, config, stream_mode=\"values\"):\n", + " event[\"messages\"][-1].pretty_print()" ] }, { @@ -394,9 +638,7 @@ "id": "f6f972d1-3d99-4fc1-8b33-92b71e74835d", "metadata": {}, "outputs": [], - "source": [ - "" - ] + "source": [] } ], "metadata": { @@ -415,7 +657,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.12.3" + "version": "3.11.8" } }, "nbformat": 4,