Куда только уже этот ChatGPT не прикрутили с момента его появления. Возможно я изобрету велосипед, но мне показалось удобным сделать бота в Телеграм, который бы поддерживал голосовой ввод и управлял моим календарем в Google.
Итак, что мы будем делать?
Создадим нейро-сотрудника на моей платформе
Зарегистрируем Телеграм-бот и подключим его к нашему сотруднику
Напишем API для интеграция с Google календарем
Дадим функцию нашему сотруднику для работы с API
Шаг №1: Создаем нейро-сотрудника
Дабы не нарушать правила хабра я не буду писать название платформы по созданию нейро-сотрудников и дам только сам системный промпт на базе которого будет работать наш бот:
Цель:
Помогать пользователю вести его Google календарь.
Роль:йр
Ты - женщина.
Тебя зовут - Жанна
Ты работаешь в должности - Личный секретарь
Твоя задача помогать управлять календарем Google используя функцию "google_calendar".
Поведение:
Для твоей работы необходим ID календаря, который ты будешь передавать в функцию "google_calendar". ID календаря может быть предоставлен и в виде Email адреса. Без него ты не можешь отвечать ни на какие вопросы пользователя.
При показе запланированных событий после названия события указывай его "event_id".
Перед удалением событий запроси согласие пользователя на удаление событий и после подтверждения запусти "google_calendar" на удаление событий по интервалу дат или по списку "event_id".
Не используй в ответах никакие эмоджи, кроме: "✅" и "?️".
Возможно пока не очень ясны некоторые инструкции в промпте, но позже вы все поймете, а пока важно отметить что промпт очень небольшой и по сути всем полностью будет управлять интеллект ChatGPT.
Шаг №2: Регистрируем Telegram-bot и прикручиваем его к нашему нейро-сотруднику
Тут все очень просто:
Зайдите в вашем Телеграме в бот @BotFather
Выберите в меню бота /newbot и следуйте указаниям
После регистрации бота скопируйте токен бота, он нужен для интеграции с нашим нейро-сотрудником
Шаг №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 вполне хватает на управление календарем.
Что можно еще попробовать?
Разбиение сложных задач на подзадачи
Помощь с распределением задач
Ежедневное уведомление о важных делах на сегодня/неделю/месяц
Просить бота фокусировать внимание пользователя на важных событиях и говорить об этом при постановке задач
Дать боту Яндекс.Календарь и предлагать в начале выбрать с каким календарем работать
Сам бот можно протестировать тут.
Идеи и вопросы пишите мне в телеграм.
