A Langgraph system for streamlining client interactions, ensuring every customer receives a quick and accurate response. 🌟
In today's fast-paced environment, customers demand quick, accurate, and personalized responses—expectations that can overwhelm traditional support teams. Managing large volumes of emails, categorizing them, crafting appropriate replies, and ensuring quality consumes significant time and resources, often leading to delays or errors, which can harm customer satisfaction.
Customer Support Email Automation is an AI solution designed to enhance customer communication for businesses. Leveraging a Langgraph-driven workflow, multiple AI agents collaborate to efficiently manage, categorize, and respond to customer emails. The system also implements RAG (Retrieval-Augmented Generation) technology to deliver accurate responses to any business or product-related questions.
- Continuously monitors the agency's Gmail inbox
- Categorizes emails into 'customer complaint,' 'product inquiry,' 'customer feedback,' or 'unrelated'
- Automatically handles irrelevant emails to maintain efficiency
- Quickly drafts emails for customer complaints and feedback using Langgraph
- Utilizes RAG techniques to answer product/service related questions accurately
- Creates personalized email content tailored to each customer's needs
- Automatically checks email quality, formatting, and relevance
- Ensures every response meets high standards before reaching the client
- Email Monitoring: The system constantly checks for new emails in the agency's Gmail inbox using the Gmail API.
- Email Categorization: AI agents sort each email into predefined categories.
- Response Generation:
- For complaints or feedback: The system quickly drafts a tailored email response.
- For service/product questions: The system uses RAG to retrieve accurate information from agency documents and generates a response.
- Quality Assurance: Each draft email undergoes AI quality and formatting checks.
- Sending: Approved emails are sent to the client promptly, ensuring timely communication.
This is the detailed flow of the system:
- Langchain & Langgraph: for developing AI agents workflow.
- Langserve: simplify API development & deployment (using FastAPI).
- Groq and Gemini APIs: for LLMs access.
- Google Gmail API
- Python 3.7+
- Groq api key
- Google Gemini api key (for embeddings)
- Gmail API credentials
- Necessary Python libraries (listed in
requirements.txt
)
-
Clone the repository:
git clone https://github.com/kaymen99/langgraph-email-automation.git cd langgraph-email-automation
-
Create and activate a virtual environment:
python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
-
Install the required packages:
pip install -r requirements.txt
-
Set up environment variables:
Create a
.env
file in the root directory of the project and add your GMAIL address, we are using the Groq llama-3.1-70b model and the Google gemini embedding model so you must also get API keys to access them:MY_EMAIL=your_email@gmail.com GROQ_API_KEY=your_groq_api_key GOOGLE_API_KEY=your_gemini_api_key
-
Ensure Gmail API is enabled:
Follow this guide to enable Gmail API and obtain your credentials.
-
Start the workflow:
python main.py
The application will start checking for new emails, categorizing them, synthesizing queries, drafting responses, and verifying email quality.
-
Deploy as API: you can deploy the workflow as an API using Langserve and FastAPI by running the command below:
python deploy_api.py
The workflow api will be running on
localhost:8000
, you can consult the API docs on/docs
and you can use the langsergve playground (on the route/playground
) to test it out.
You can customize the behavior of each agent by modifying the corresponding methods in the Nodes
class or the agents prompt prompts
located in the src
directory.
You can also add your own agency data into the data
folder, then you must create your own vector store by running (update first the data path):
python create_index.py
Contributions are welcome! Please open an issue or submit a pull request for any changes.
If you have any questions or suggestions, feel free to contact me at aymenMir1001@gmail.com
.