Даём нейро-сотруднику на ChatGPT управлять календарем Google через Telegram бот

Куда только уже этот ChatGPT не прикрутили с момента его появления. Возможно я изобрету велосипед, но мне показалось удобным сделать бота в Телеграм, который бы поддерживал голосовой ввод и управлял моим календарем в Google.

Итак, что мы будем делать?

1. Создадим нейро-сотрудника на моей платформе

2. Зарегистрируем Телеграм-бот и подключим его к нашему сотруднику

3. Напишем API для интеграция с Google календарем

4. Дадим функцию нашему сотруднику для работы с API

Шаг №1: Создаем нейро-сотрудника

Дабы не нарушать правила хабра я не буду писать название платформы по созданию нейро-сотрудников и дам только сам системный промпт на базе которого будет работать наш бот:

Цель: Помогать пользователю вести его Google календарь. Роль:йр Ты - женщина. Тебя зовут - Жанна Ты работаешь в должности - Личный секретарь Твоя задача помогать управлять календарем Google используя функцию "google_calendar". Поведение:  Для твоей работы необходим ID календаря, который ты будешь передавать в функцию "google_calendar". ID календаря может быть предоставлен и в виде Email адреса. Без него ты не можешь отвечать ни на какие вопросы пользователя. При показе запланированных событий после названия события указывай его "event_id". Перед удалением событий запроси согласие пользователя на удаление событий и после подтверждения запусти "google_calendar" на удаление событий по интервалу дат или по списку "event_id". Не используй в ответах никакие эмоджи, кроме: "✅" и "?️". 

Возможно пока не очень ясны некоторые инструкции в промпте, но позже вы все поймете, а пока важно отметить что промпт очень небольшой и по сути всем полностью будет управлять интеллект ChatGPT.

Шаг №2: Регистрируем Telegram-bot и прикручиваем его к нашему нейро-сотруднику

Тут все очень просто:

1. Зайдите в вашем Телеграме в бот @BotFather

2. Выберите в меню бота /newbot и следуйте указаниям

3. После регистрации бота скопируйте токен бота, он нужен для интеграции с нашим нейро-сотрудником

Шаг №3: Напишем API для интеграция с Google календарем

Для получения необходимого файла с ключами ‘credentials.json‘ доступа прочитайте статью: «Настройка синхронизации google calendar с web приложением».

Вот класс, описывающий интеграцию с Google Calendar API:

from __future__ import print_function import datetime import googleapiclient from google.oauth2 import service_account from googleapiclient.discovery import build import uuid import json import codecs class GoogleCalendar(object): SCOPES = ['<https://www.googleapis.com/auth/calendar>'] CREDS_FILE = 'credentials.json'  def __init__(self, calendarId):     credentials = service_account.Credentials.from_service_account_file(CREDS_FILE, scopes=GoogleCalendar.SCOPES)     self.service = googleapiclient.discovery.build('calendar', 'v3', credentials=credentials)     self.calendarId = calendarId   def create_event(self, event):     e = self.service.events().insert(calendarId=self.calendarId,                                      body=event).execute()     print('Event created: %s' % (e.get('id')))     return e   def get_events_list(self, start_date=None, end_date=None):          now = datetime.datetime.utcnow().isoformat() + 'Z'     if start_date is None and end_date is None:         events_result = self.service.events().list(calendarId=self.calendarId,                                                    timeMin=now,                                                    maxResults=100, singleEvents=True,                                                    orderBy='startTime').execute()     else:         events_result = self.service.events().list(calendarId=self.calendarId,                                                    timeMin=start_date,                                                    timeMax=end_date,                                                    singleEvents=True).execute()     events = events_result.get('items', [])     if not events:         print('No upcoming events found.')         return json.dumps('No upcoming events found.')     events_list = self.encode_events_list(events)     return events_list  def encode_events_list(self, events):     events_list = []     for event in events:         start = event['start'].get('dateTime', event['start'].get('date'))         end = event['end'].get('endTime', event['end'].get('date'))         events_list.append({             'event_id' : event['id'],             'event_summary' : event['summary'],             'event_start' : start,             'event_end' : end,         })     return events_list       def update_event(self, event_id, updated_event):     current_event = self.service.events().get(calendarId=self.calendarId,                                               eventId=event_id).execute()     updated_title = updated_event.get('summary', current_event['summary'])     updated_start = updated_event.get('start', current_event['start'])     updated_end = updated_event.get('end', current_event['end'])     updated_event = {         'summary': updated_title,         'start': updated_start,         'end': updated_end     }     event = self.service.events().update(calendarId=self.calendarId,                                          eventId=event_id,                                          body=updated_event).execute()     print('Event updated: %s' % event.get('id'))     return json.dumps('Event updated.')   def delete_event(self, event_id):     res = self.service.events().delete(calendarId=self.calendarId,                                  eventId=event_id).execute()     print('Event deleted: %s' % event_id)     return json.dumps('Event deleted.')  def delete_events_in_range(self, start_date, end_date):     events_result = self.service.events().list(calendarId=self.calendarId,                                                timeMin=start_date,                                                timeMax=end_date,                                                singleEvents=True).execute()     events = events_result.get('items', [])     for event in events:         self.delete_event(event['id'])     events_list = self.encode_events_list(events)     return json.dumps('Events deleted.')  

А вот сам код API на базе Flask:

from flask import Flask, Response, render_template, redirect, url_for, request, session, jsonify from flask_cors import CORS from flask import send_from_directory  import google.calendar # !!! это наш класс, описанный в блоке выше  app = Flask(__name__) app.static_folder = 'static' CORS(app)  def GetJsonFromRequest(request):     data = request.get_json(force=True)     if type(data) is not dict:         data = request.get_json()         data = json.loads(data)     return data  @app.route('/api/v1.0/google_calendar', methods=['POST']) def google_calendar():     data = GetJsonFromRequest(request)     try:         calendar = google.calendar.GoogleCalendar(data['calendarId'])         if data['action'] == '+':             res = calendar.create_event(data['event'])         if data['action'] == '?':             res = calendar.get_events_list(data['start_date'], data['end_date'])         if data['action'] == '-':             if data['start_date'] is None:                 res = calendar.delete_event(data['event_id'])             else:                 res = calendar.delete_events_in_range(data['start_date'], data['end_date'])         if data['action'] == '.':             res = calendar.update_event(data['event_id'], data['event'])         print('[END - google_calendar res]', res)         return res     except Exception as e:         print('[END - google_calendar ERROR]', str(e))         return 'Error'  if __name__ == "__main__":     app.run(debug=False, host='0.0.0.0', port=5000)

Шаг №4: Напишем функцию для связи ChatGPT и нашего Google Calendar API

Для вызова функций в ChatGPT нам нужно дать описание всех переменных функции и сам код функции.

Вот описание параметров нашей функции:

{     "name": "google_calendar",     "description": "Управление календарем Google",     "parameters": {         "type": "object",         "properties": {             "calendarId": {                 "type": "string",                 "description": "ID календаря",             },             "action": {                 "type": "string",                 "enum": ["+", "?", '-', '.'],                 "description": "Тип действия. `+` - означает добавление события. `?` - означает получение всех событий календаря.. `-` - удалить событие в календаре. `.` - редактировать событие в календаре.",             },             "event_ids": {                 "type": "string",                 "description": "Список ID событый в календаре в формате json: ```[{\\"event_id\\": \\"3lsvlor3hjlgpgmv7er7e5juov\\"}]```. Передается при типах действия `-` или '.'",             },             "events": {                 "type": "string",                 "description": "Список событий в формате json: ```[{\\"summary\\": \\"test event\\", \\"description\\": \\"some info\\", \\"start\\": {\\"dateTime\\": \\"2024-09-04T03:00:00+03:00\\"}, \\"end\\": {\\"dateTime\\": \\"2024-09-04T05:30:00+03:00\\"}}]```. Передается при типах действия `+` или '.'",             },             "start_date": {                 "type": "string",                 "description": "Дата начала периода в формате `2024-09-04T03:00:00+03:00`. Передается при типах действия `?` или '-'",             },             "end_date": {                 "type": "string",                 "description": "Дата окончания периода в формате `2024-09-04T03:00:00+03:00`. Передается при типах действия `?` или '-'",             },         },         "required": ["calendarId", "action"],     }, }, 

А вот сам код функции:

def google_calendar(arguments):      import requests     import json data = {     "sa_data" : None,     "calendarId" : arguments['calendarId'],     "action" : arguments['action'],     'start_date' : None,     'end_date' : None, } if 'start_date' in arguments.keys():     data['start_date'] = arguments['start_date'] if 'end_date' in arguments.keys():     data['end_date'] = arguments['end_date']  if arguments['action'] == '?':     response = requests.post('https://___АДРЕС_АПИ_СЕРВИСА___/api/v1.0/google_calendar', data=json.dumps(data))     return response.text else:     responses = []     if arguments['action'] == '+' or arguments['action'] == '.':         if 'events' in arguments.keys():             events = json.loads(arguments['events'])             for i in range(len(events)):                 e = events[i]                 data['event'] = e                 if 'event_ids' in arguments.keys():                     event_ids = json.loads(arguments['event_ids'])                     data['event_id'] = event_ids[i]                 response = requests.post('https://___АДРЕС_АПИ_СЕРВИСА___/api/v1.0/google_calendar', data=json.dumps(data))                 responses.append(response.text)     if arguments['action'] == '-':         if 'event_ids' in arguments.keys():             event_ids = json.loads(arguments['event_ids'])             for i in range(len(event_ids)):                 data['event_id'] = event_ids[i]['event_id']                 response = requests.post('https://___АДРЕС_АПИ_СЕРВИСА___/api/v1.0/google_calendar', data=json.dumps(data))                 responses.append(response.text)         if 'start_date' in arguments.keys():             response = requests.post('https://___АДРЕС_АПИ_СЕРВИСА___/api/v1.0/google_calendar', data=json.dumps(data))             responses.append(response.text)     return json.dumps(str(responses))  

Тестирование бота

Поскольку в промпте у нашего нейро-сотрудника есть такая инструкция:

Поведение: 1. Для твоей работы необходим ID календаря, который ты будешь передавать в функцию "google_calendar". ID календаря может быть предоставлен и в виде Email адреса. Без него ты не можешь отвечать ни на какие вопросы пользователя. 

При старте общения с нашим ботом мы видим следующий диалог:

Если мы укажем наш ID календаря, то бот ответит примерно так:

Давайте для примера запланируем отпуск в Рио в нашем боте. Для начала спросим:

Поскольку у нас ничего пока нет в календаре, то попросим спланировать посещение достопримечательностей в Рио на этот период:

Посмотрим теперь в наш календарь Google:

Отлично! Получилось! Давайте немного посложнее попросим бота:

Как мы видим бот спросил подтверждение при удалении события из календаря, это было в его инструкции:

Поведение: ... 3. Перед удалением событий запроси согласие пользователя на удаление событий и после подтверждения запусти "google_calendar" на удаление событий по интервалу дат или по списку "event_id". ... 

Проверяем календарь и видим, что событие было удалено:

Думаю идею вы уже уловили. Бота можно просить корректировать название событий, переносить события на нужную дату и время и т.д.

Да, и самое важное — боту можно отправлять голосовые и он так же будет помогать вам вести Google календарь.

Итоги

В целом мозгов у ChatGPT 4 вполне хватает на управление календарем.

Что можно еще попробовать?

1. Разбиение сложных задач на подзадачи

2. Помощь с распределением задач

3. Ежедневное уведомление о важных делах на сегодня/неделю/месяц

4. Просить бота фокусировать внимание пользователя на важных событиях и говорить об этом при постановке задач

5. Дать боту Яндекс.Календарь и предлагать в начале выбрать с каким календарем работать

Сам бот можно протестировать тут.

Идеи и вопросы пишите мне в телеграм.