added

README.md

@@ -1,13 +1,105 @@
+# 🧑‍💻 Intelligent Customer Support Agent with LangGraph 🤖
+
+## 📚 Project Overview
+
+This repository presents an intelligent customer support agent powered by LangGraph—a robust tool designed for building intricate workflows with language models. The agent is programmed to classify customer queries, evaluate sentiment, and deliver suitable responses or escalate inquiries when necessary. In this version, the agent leverages the **browser-use** library to consult online resources and uses a Gradio interface for testing.
+
+## 💡 Purpose
+
+Efficient and accurate customer support is essential in today’s competitive business landscape. By automating initial customer interactions, response times can be significantly shortened, thereby enhancing customer satisfaction. This project demonstrates how advanced language models combined with a graph-based workflow can be used to create an effective and scalable support system capable of handling diverse customer concerns.
+
+## 🛠 Core Components
+
+- **State Management:** Utilizes `TypedDict` to track and manage the state of each customer interaction.
+- **Query Categorization:** Classifies queries into categories such as Technical, Billing, or General.
+- **Sentiment Analysis:** Assesses the emotional tone of customer queries.
+- **Response Generation:** Constructs responses based on query category and sentiment.
+- **Escalation Protocol:** Automatically escalates queries with negative sentiment to a human agent.
+- **Browser-Based Assistance:** Employs the **browser-use** library to consult online sources for informed, up-to-date responses.
+- **Workflow Graph:** Leverages LangGraph to build an adaptable and extendable workflow.
+
+## 📝 How It Works
+
+1. **Setup:** Install the necessary libraries and prepare the Python environment.
+2. **State Design:** Create a structure to store query data (category, sentiment, response).
+3. **Node Functions:** Define functions for categorization, sentiment analysis, and generating responses.
+4. **Graph Design:** Use `StateGraph` to establish the workflow, incorporating nodes and edges for the complete support process.
+5. **Routing Logic:** Conditionally route the query based on its category and sentiment.
+6. **Graph Compilation:** Compile the workflow into an executable application.
+7. **Execution:** Process customer queries through the workflow and present results via the Gradio UI.
+
+## 📊 Workflow Diagram
+
+The following diagram illustrates the workflow of the customer support agent—from query categorization and sentiment analysis to routing and escalation:
+
+![Customer Support Workflow](image.jpg)
+
+## 📊 Browser Use
+
+![Customer Support Workflow](agent_history.gif)
+
+## ✅ Project Summary
+
+This project showcases the versatility and power of LangGraph in creating AI-driven workflows. By merging natural language processing with graph-based techniques and augmenting capabilities with browser-based data fetching, we’ve built a customer support agent capable of efficiently addressing a wide range of queries. The system is easily extendable and can be integrated into existing support pipelines or databases.
+
 ---
-title: CustomerSupportAgent
-emoji: 📊
-colorFrom: indigo
-colorTo: gray
-sdk: gradio
-sdk_version: 5.13.0
-app_file: app.py
-pinned: false
-short_description: This presents an intelligent customer support agent.
----
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## 🚀 Getting Started
+
+Follow these steps to set up the project and run the customer support agent application.
+
+### 1. Clone the Repository
+
+Clone this repository to your local machine:
+
+```bash
+git clone https://github.com/alphatechlogics/LangGraphAgent.git
+cd LangGraphAgent
+```
+
+### 2. Create a Virtual Environment
+
+We recommend using uv to set up your Python environment:
+
+```bash
+uv venv --python 3.11
+source .venv/bin/activate
+```
+
+Note: The prompt should now show your virtual environment (e.g., (LangGraphAgent)).
+
+### 3. Activate the Virtual Environment
+
+```bash
+source venv/bin/activate
+```
+
+### 4. Install Required Dependencies
+
+Install the necessary packages. We use uv pip to ensure packages are installed within the virtual environment:
+
+```bash
+uv pip install langgraph langchain_openai gradio
+uv pip install --pre browser-use
+playwright install
+```
+
+### 5. Set Up Your OpenAI API Key
+
+Create a .env file in the project root directory and add your OpenAI API key. This is required to interact with the OpenAI models:
+
+```makefile
+OPENAI_API_KEY=your_openai_api_key_here
+```
+
+### 6. Run the Application
+
+After installing the dependencies and setting up the .env file, you can run the application:
+
+```bash
+python customer_support_gradio.py
+```
+
+### 7. Access the App
+
+Once the app is running, open your browser and navigate to the URL shown in the terminal (typically `http://127.0.0.1:7860`) to interact with the customer support agent.

requirements.txt

@@ -0,0 +1,293 @@
+aiofiles==23.2.1
+aiohappyeyeballs==2.4.4
+aiohttp==3.11.11
+aiosignal==1.3.2
+altair==5.5.0
+annotated-types==0.7.0
+antlr4-python3-runtime==4.9.3
+anyio==4.7.0
+apturl==0.5.2
+asgiref==3.5.0
+async-timeout==4.0.3
+attrs==24.3.0
+backoff==2.2.1
+bcrypt==4.2.1
+beautifulsoup4==4.12.3
+blinker==1.4
+Brlapi==0.8.3
+build==1.2.2.post1
+cachetools==5.5.0
+certifi==2020.6.20
+cffi==1.17.1
+chardet==4.0.0
+charset-normalizer==3.4.1
+chroma-hnswlib==0.7.3
+chromadb==0.4.14
+click==8.0.3
+colorama==0.4.4
+coloredlogs==15.0.1
+command-not-found==0.3
+contourpy==1.3.1
+cryptography==44.0.0
+cupshelpers==1.0
+cycler==0.12.1
+dataclasses-json==0.6.7
+dbus-python==1.2.18
+defer==1.0.6
+Deprecated==1.2.15
+distro==1.7.0
+distro-info==1.1+ubuntu0.2
+duplicity==0.8.21
+durationpy==0.9
+effdet==0.4.1
+emoji==2.14.0
+et_xmlfile==2.0.0
+eval_type_backport==0.2.2
+exceptiongroup==1.2.2
+fastapi==0.115.6
+fasteners==0.14.1
+ffmpy==0.5.0
+filelock==3.16.1
+filetype==1.2.0
+flatbuffers==24.12.23
+fonttools==4.55.3
+frozenlist==1.5.0
+fsspec==2024.12.0
+future==0.18.2
+gitdb==4.0.12
+GitPython==3.1.44
+google-api-core==2.24.0
+google-auth==2.37.0
+google-cloud-vision==3.9.0
+googleapis-common-protos==1.66.0
+gradio==5.12.0
+gradio_client==1.5.4
+greenlet==3.1.1
+grpcio==1.68.1
+grpcio-status==1.68.1
+gyp==0.1
+h11==0.13.0
+html5lib==1.1
+httpcore==1.0.7
+httplib2==0.20.2
+httptools==0.6.4
+httpx==0.28.1
+httpx-sse==0.4.0
+huggingface-hub==0.27.0
+humanfriendly==10.0
+idna==3.3
+importlib_metadata==8.5.0
+importlib_resources==6.4.5
+iopath==0.1.10
+jeepney==0.7.1
+Jinja2==3.1.5
+jiter==0.8.2
+joblib==1.4.2
+jq==1.8.0
+jsonpatch==1.33
+jsonpath-python==1.0.6
+jsonpointer==3.0.0
+jsonschema==4.23.0
+jsonschema-specifications==2024.10.1
+keyring==23.5.0
+kiwisolver==1.4.8
+kubernetes==31.0.0
+langchain==0.3.13
+langchain-chroma==0.1.4
+langchain-community==0.3.13
+langchain-core==0.3.28
+langchain-openai==0.2.14
+langchain-text-splitters==0.3.4
+langdetect==1.0.9
+langgraph==0.2.63
+langgraph-checkpoint==2.0.10
+langgraph-sdk==0.1.51
+langsmith==0.2.6
+language-selector==0.1
+launchpadlib==1.10.16
+layoutparser==0.3.4
+lazr.restfulclient==0.14.4
+lazr.uri==1.0.6
+lockfile==0.12.2
+louis==3.20.0
+lxml==5.3.0
+macaroonbakery==1.3.1
+Mako==1.1.3
+Markdown==3.7
+markdown-it-py==3.0.0
+MarkupSafe==2.0.1
+marshmallow==3.23.2
+matplotlib==3.10.0
+mdurl==0.1.2
+mmh3==5.0.1
+monotonic==1.6
+more-itertools==8.10.0
+mpmath==1.3.0
+msgpack==1.1.0
+multidict==6.1.0
+mypy-extensions==1.0.0
+narwhals==1.22.0
+nest-asyncio==1.6.0
+netifaces==0.11.0
+networkx==3.4.2
+nltk==3.9.1
+numpy==1.26.4
+nvidia-cublas-cu12==12.4.5.8
+nvidia-cuda-cupti-cu12==12.4.127
+nvidia-cuda-nvrtc-cu12==12.4.127
+nvidia-cuda-runtime-cu12==12.4.127
+nvidia-cudnn-cu12==9.1.0.70
+nvidia-cufft-cu12==11.2.1.3
+nvidia-curand-cu12==10.3.5.147
+nvidia-cusolver-cu12==11.6.1.9
+nvidia-cusparse-cu12==12.3.1.170
+nvidia-nccl-cu12==2.21.5
+nvidia-nvjitlink-cu12==12.4.127
+nvidia-nvtx-cu12==12.4.127
+oauthlib==3.2.2
+olefile==0.46
+omegaconf==2.3.0
+onnx==1.17.0
+onnxruntime==1.20.1
+openai==1.58.1
+opencv-python==4.10.0.84
+openpyxl==3.1.5
+opentelemetry-api==1.29.0
+opentelemetry-exporter-otlp-proto-common==1.29.0
+opentelemetry-exporter-otlp-proto-grpc==1.29.0
+opentelemetry-instrumentation==0.50b0
+opentelemetry-instrumentation-asgi==0.50b0
+opentelemetry-instrumentation-fastapi==0.50b0
+opentelemetry-proto==1.29.0
+opentelemetry-sdk==1.29.0
+opentelemetry-semantic-conventions==0.50b0
+opentelemetry-util-http==0.50b0
+orjson==3.10.12
+overrides==7.7.0
+packaging==24.2
+pandas==2.2.3
+paramiko==2.9.3
+pdf2image==1.17.0
+pdfminer.six==20231228
+pdfplumber==0.11.4
+pexpect==4.8.0
+pi_heif==0.21.0
+pikepdf==9.4.2
+pillow==11.0.0
+portalocker==3.0.0
+posthog==3.7.4
+propcache==0.2.1
+proto-plus==1.25.0
+protobuf==5.29.2
+psutil==6.1.1
+ptyprocess==0.7.0
+pulsar-client==3.5.0
+pyarrow==19.0.0
+pyasn1==0.6.1
+pyasn1_modules==0.4.1
+pycairo==1.20.1
+pycocotools==2.0.8
+pycparser==2.22
+pycups==2.0.1
+pydantic==2.9.2
+pydantic-settings==2.7.0
+pydantic_core==2.23.4
+pydeck==0.9.1
+pydub==0.25.1
+Pygments==2.18.0
+PyGObject==3.42.1
+PyJWT==2.3.0
+pymacaroons==0.13.0
+PyMuPDF==1.25.1
+PyNaCl==1.5.0
+pypandoc==1.14
+pyparsing==2.4.7
+pypdf==5.1.0
+PyPDF2==3.0.1
+pypdfium2==4.30.1
+PyPika==0.48.9
+pyproject_hooks==1.2.0
+pyRFC3339==1.1
+python-apt==2.4.0+ubuntu4
+python-dateutil==2.9.0.post0
+python-debian==0.1.43+ubuntu1.1
+python-docx==1.1.2
+python-dotenv==1.0.1
+python-iso639==2024.10.22
+python-magic==0.4.27
+python-multipart==0.0.20
+python-oxmsg==0.0.1
+python-pptx==1.0.2
+pytz==2022.1
+pyxdg==0.27
+PyYAML==6.0.2
+RapidFuzz==3.11.0
+referencing==0.36.0
+regex==2024.11.6
+reportlab==3.6.8
+requests==2.32.3
+requests-oauthlib==2.0.0
+requests-toolbelt==1.0.0
+rich==13.9.4
+rpds-py==0.22.3
+rsa==4.9
+ruff==0.9.2
+safehttpx==0.1.6
+safetensors==0.4.5
+scipy==1.14.1
+screen-resolution-extra==0.0.0
+SecretStorage==3.3.1
+semantic-version==2.10.0
+shellingham==1.5.4
+six==1.16.0
+smmap==5.0.2
+sniffio==1.3.1
+soupsieve==2.6
+SQLAlchemy==2.0.36
+starlette==0.41.3
+streamlit==1.41.1
+sympy==1.13.1
+systemd-python==234
+tenacity==9.0.0
+tiktoken==0.8.0
+timm==1.0.12
+tokenizers==0.21.0
+toml==0.10.2
+tomli==2.2.1
+tomlkit==0.13.2
+torch==2.5.1
+torchvision==0.20.1
+tornado==6.4.2
+tqdm==4.67.1
+transformers==4.47.1
+triton==3.1.0
+typer==0.15.1
+typing-inspect==0.9.0
+typing_extensions==4.12.2
+tzdata==2024.2
+ubuntu-drivers-common==0.0.0
+ubuntu-pro-client==8001
+ufw==0.36.1
+unattended-upgrades==0.1
+unstructured==0.16.11
+unstructured-client==0.28.1
+unstructured-inference==0.8.1
+unstructured.pytesseract==0.3.13
+urllib3==1.26.5
+usb-creator==0.3.7
+uvicorn==0.34.0
+uvloop==0.21.0
+wadllib==1.3.6
+watchdog==6.0.0
+watchfiles==1.0.3
+webencodings==0.5.1
+websocket-client==1.8.0
+websockets==14.1
+wrapt==1.17.0
+wsproto==1.0.0
+xdg==5
+xkit==0.0.0
+xlrd==2.0.1
+XlsxWriter==3.2.0
+yarl==1.18.3
+zipp==3.21.0