crewAI/docs

Email Processing System with CrewAI

A smart email processing system that uses CrewAI to analyze Gmail messages and automatically generate appropriate responses based on context and history.

Quick Start

# Install required packages
pip install crewai 'crewai[tools]'
pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

Example Usage

from email_analysis_crew import EmailAnalysisCrew
from response_crew import ResponseCrew
from gmail_tool import GmailTool

# Initialize Gmail connection
gmail = GmailTool()
gmail.authenticate()

# Create analysis crew
analysis_crew = EmailAnalysisCrew(
    gmail_tool=gmail,
    config={
        "check_similar_threads": True,
        "analyze_sender_history": True
    }
)

# Process new emails
new_emails = gmail.get_new_emails()
for email in new_emails:
    # Analyze email and decide on response
    analysis = analysis_crew.analyze_email(email)

    # If analysis determines response is needed
    if analysis["response_needed"]:
        # Create new crew for response generation
        response_crew = ResponseCrew(
            email_context=analysis,
            gmail_tool=gmail
        )

        # Generate and send response
        response = response_crew.generate_response()
        gmail.send_response(response)

How It Works

1. Email Analysis

   • System connects to Gmail
   • Retrieves new emails
   • Analyzes email context and history
   • Checks for similar threads
   • Researches sender and company

2. Response Decision The analysis crew decides whether to respond based on:

   • Email urgency
   • Sender relationship
   • Previous interactions
   • Business context
   • Similar thread history

3. Response Generation If a response is needed:

   • New response crew is created
   • Analyzes email context
   • Generates appropriate response
   • Reviews for tone and content
   • Sends through Gmail

Setup Instructions

1. Install Dependencies

   pip install crewai 'crewai[tools]'
   pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib
   

2. Gmail Setup

   • Visit Google Cloud Console
   • Create new project
   • Enable Gmail API
   • Create OAuth credentials
   • Download as credentials.json

3. Configure Authentication

   from gmail_tool import GmailTool
   
   gmail = GmailTool()
   gmail.authenticate()  # Opens browser for auth
   

Configuration

# Analysis configuration
config = {
    "check_similar_threads": True,    # Look for similar conversations
    "analyze_sender_history": True,   # Check previous interactions
    "research_company": True,         # Research sender's company
    "priority_threshold": 0.7         # Threshold for response
}

# Create crews
analysis_crew = EmailAnalysisCrew(
    gmail_tool=gmail,
    config=config
)

response_crew = ResponseCrew(
    email_context=analysis,
    gmail_tool=gmail
)

Components

• EmailAnalysisCrew: Analyzes emails and makes response decisions
• ResponseCrew: Generates appropriate responses
• GmailTool: Handles Gmail integration
• EmailTool: Provides email processing utilities

Error Handling

The system includes handling for:

• Gmail API connection issues
• Authentication errors
• Rate limiting
• Invalid email formats

Contributing

1. Fork the repository
2. Create feature branch
3. Submit pull request

License

MIT License