from googleapiclient.discovery import build from datetime import datetime, timedelta from utils.auth import authenticate_google_services class GoogleCalendar_Agent: def __init__(self, creds=None, timezone="Asia/Taipei"): if not creds: creds = authenticate_google_services() self.service = build("calendar", "v3", credentials=creds) self.timezone = timezone def list_events(self, n: int=5, queries=None) -> str: now = datetime.utcnow().isoformat() + 'Z' events_result = self.service.events().list( calendarId='primary', timeMin=now, maxResults=n, singleEvents=True, orderBy='startTime' ).execute() events = events_result.get('items', []) if not events: return "🔕 找不到即將到來的行事曆事件。" output = "📅 您接下來的行事曆事件如下：\n" for event in events: start = event['start'].get('dateTime', event['start'].get('date')) summary = event.get('summary', 'No title') output += f"• {summary} at {start}\n" return output def create_event(self, summary: str, start_time: str, end_time: str, location: str = None, description: str = None, attendees: list = None, reminder_minutes: int = None) -> str: event = { 'summary': summary, 'start': {'dateTime': start_time, 'timeZone': self.timezone}, 'end': {'dateTime': end_time, 'timeZone': self.timezone} } if location: event['location'] = location if description: event['description'] = description if attendees: event['attendees'] = [{'email': email} for email in attendees] if reminder_minutes: event['reminders'] = { 'useDefault': False, 'overrides': [{'method': 'popup', 'minutes': reminder_minutes}] } try: created_event = self.service.events().insert( calendarId='primary', sendUpdates='all', body=event ).execute() return f"""✅ 已成功建立事件：\n標題 : {summary}\n開始時間 : {start_time}\n結束時間 : {end_time}\n地點 : {location or '無'}\n說明 : {description or '無'}\n參與者 : {', '.join(attendees) if attendees else '無'}\n提醒時間 : {reminder_minutes if reminder_minutes is not None else '使用預設提醒'}\n時區 : {self.timezone}\n事件連結 : {created_event.get('htmlLink')}""" except Exception as e: return f"❌ 建立事件失敗，以下是錯誤訊息（英文）: {e}" def find_event(self, query: str,) -> list: now = datetime.utcnow().isoformat() + 'Z' events_result = self.service.events().list( calendarId='primary', timeMin=now, singleEvents=True, orderBy='startTime', q=query ).execute() return events_result.get('items', []) def update_event(self, query: str, new_summary=None, new_location=None, new_description=None, new_start=None, new_end=None, new_attendees=None, reminder_minutes=None): events = self.find_event(query) if not events: return f"❌ 找不到包含「{query}」的事件" if all(arg is None for arg in [ new_summary, new_location, new_description, new_start, new_end, new_attendees, reminder_minutes ]): return f"⚠️ 沒有指定任何要更新的欄位，未執行更新。" for event in events: event_id = event['id'] try: if new_summary: event['summary'] = new_summary if new_location: event['location'] = new_location if new_description: event['description'] = new_description if new_attendees: event['attendees'] = [{'email': email} for email in new_attendees] if reminder_minutes: event['reminders'] = { 'useDefault': False, 'overrides': [{'method': 'popup', 'minutes': reminder_minutes}] } if new_start or new_end: event['start']['dateTime'] = new_start event['end']['dateTime'] = new_end event['start']['timeZone'] = 'Asia/Taipei' event['end']['timeZone'] = 'Asia/Taipei' updated_event = self.service.events().update( calendarId='primary', eventId=event_id, sendUpdates='all', body=event ).execute() return f"✅ 已成功更新事件：{updated_event['summary']}" except Exception as e: return f"❌ 更新事件失敗，以下是錯誤訊息（英文）: {e}" def delete_event(self, query: str): now = datetime.utcnow().isoformat() + 'Z' event_results = self.find_event(query) if len(event_results) == 0: return f"❌ 找不到包含「{query}」的事件" for event in event_results: target_id = event["id"] try: self.service.events().delete( calendarId='primary', eventId=target_id, sendUpdates='all' ).execute() return f"🗑️ 已刪除事件：{event['summary']}（ID: {target_id}）" except Exception as e: return f"❌ 刪除事件失敗（ID: {target_id}），以下是錯誤訊息（英文）: {e}" def get_event_details(self, query: str): events = self.find_event(query) if not events: return f"❌ 找不到符合 '{query}' 的事件！" event = events[0] summary = event.get('summary', 'No Title') start_time = event['start'].get('dateTime', event['start'].get('date')) end_time = event['end'].get('dateTime', event['end'].get('date')) formatted_string = f"事件: {summary}\n開始時間: {start_time}\n結束時間: {end_time}" attendees = event.get('attendees', []) emails = [attendee.get('email') for attendee in attendees if attendee.get('email')] if emails: formatted_string += f"\n參與者: {', '.join(emails)}" else: formatted_string += "\n無參與者" return formatted_string def get_all_tools(self): LLM_tools = [] LLM_tools.append({ "name": "create_Calendar_event", "description": "Create a new Google Calendar event by specifying summary, start time, and end time, and optionally location, description, attendees, and reminder.", "parameters": { "type": "object", "properties": { "summary": { "type": "string", "description": "Title or summary of the event (e.g., 'Lunch with Alice')" }, "start_time": { "type": "string", "format": "date-time", "description": "Start time of the event in ISO format (e.g., '2025-07-01T14:00:00')" }, "end_time": { "type": "string", "format": "date-time", "description": "End time of the event in ISO format (e.g., '2025-07-01T15:00:00')" }, "location": { "type": "string", "description": "Location of the event (e.g., 'Taipei 101')" }, "description": { "type": "string", "description": "Detailed description of the event" }, "attendees": { "type": "array", "items": {"type": "string"}, "description": "List of email addresses to invite to the event" }, "reminder_minutes": { "type": "integer", "description": "Number of minutes before the event to trigger a popup reminder" } }, "required": ["summary", "start_time", "end_time"] }, }) LLM_tools.append({ "name": "list_Calendar_events", "description": "List your upcoming Google Calendar events.", "parameters": { "type": "object", "properties": { "n": { "type": "integer", "default": 5, "description": "Number of upcoming events to list (default: 5)" } } } }) LLM_tools.append({ "name": "update_Calendar_event", "description": "Update a Google Calendar event using a keyword query to find it. You can update summary, location, description, start/end time, attendees, or reminders.", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Keyword to find the event to update (e.g., 'meeting with Bob')" }, "new_summary": { "type": "string", "description": "New summary/title for the event" }, "new_location": { "type": "string", "description": "New location for the event" }, "new_description": { "type": "string", "description": "New description for the event" }, "new_start": { "type": "string", "format": "date-time", "description": "New start time in ISO format" }, "new_end": { "type": "string", "format": "date-time", "description": "New end time in ISO format" }, "new_attendees": { "type": "array", "items": {"type": "string"}, "description": "New list of attendees (email addresses)" }, "reminder_minutes": { "type": "integer", "description": "Updated popup reminder time in minutes" } }, "required": ["query"] } }) LLM_tools.append({ "name": "delete_Calendar_event", "description": "Delete a Google Calendar event using a keyword query to find it.", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Keyword to find the event to delete (e.g., 'meeting with Bob')" } }, "required": ["query"] } }) LLM_tools.append({ "name": "get_event_details", "description": "Find the attendee email addresses and the summary of a specific event, based on a keyword.", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Keyword to find the event and extract attendees and summary of that event." } }, "required": ["query"] } }) return LLM_tools