Skip to main content

​
Google Calendar

ShanoneのGoogle Calendar連携は、標準的なカレンダー/イベント管理に加えて、他の連携ではあまり提供されない高度なスマートスケジューリング機能(空き時間検索、イベントの一括作成、ミーティング時間の提案)まで含む49個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにCalendar関連の作業を依頼(例: 「今週Alexと30分空いている時間を見つけて」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Googleアカウントを許可する

Shanoneに操作させたいカレンダーについて、GoogleのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、google_calendar_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはGoogle Calendar向けに49個のツールを、以下のカテゴリに整理して提供しています。
google_calendar_list_calendars, google_calendar_get_calendar, google_calendar_create_calendar, google_calendar_delete_calendar, google_calendar_update_calendar, google_calendar_patch_calendar, google_calendar_clear_calendar, google_calendar_transfer_calendar_ownership, google_calendar_get_calendar_list_entry, google_calendar_add_calendar_to_list, google_calendar_update_calendar_list_entry, google_calendar_patch_calendar_list_entry, google_calendar_remove_calendar_from_list, google_calendar_watch_calendar_list
google_calendar_list_events, google_calendar_get_event, google_calendar_search_events, google_calendar_create_event, google_calendar_quick_add_event, google_calendar_update_event, google_calendar_delete_event, google_calendar_move_event, google_calendar_patch_event, google_calendar_import_event, google_calendar_get_event_instances, google_calendar_watch_events
google_calendar_list_acl_rules, google_calendar_get_acl_rule, google_calendar_share_calendar, google_calendar_update_acl_rule, google_calendar_patch_acl_rule, google_calendar_revoke_acl_rule, google_calendar_watch_acl
google_calendar_get_colors, google_calendar_get_setting, google_calendar_list_settings, google_calendar_watch_settings, google_calendar_stop_channel
google_calendar_batch_create_events, google_calendar_list_events_from_all_calendars, google_calendar_find_free_slots, google_calendar_get_current_datetime, google_calendar_respond_to_event, google_calendar_remove_attendee, google_calendar_suggest_meeting_times, google_calendar_duplicate_event
google_calendar_get_free_busy, google_calendar_get_upcoming_events, google_calendar_get_todays_events

​
よくあるユースケース

ミーティングスケジューリング

複数のカレンダーから空き時間を見つけ、参加者付きのイベントを一度の操作で作成する

日次/週次ブリーフィング

今日または今週のイベントを取得し、誰かのスケジュールを要約する

出欠管理

招待に返信したり、代理で参加者をイベントから削除する

カレンダー共有 & ガバナンス

同僚とカレンダーを共有したり、ACLルールを監査して誰がアクセス権を持っているか確認する

​
トラブルシューティング

shanone_get_tool_schemaでsendUpdatesの挙動を確認してください——通知は呼び出しごとのオプトイン設定であり、デフォルトの挙動はカレンダーによって異なる場合があります。
関連するすべてのカレンダーIDを明示的に渡すか、まずgoogle_calendar_list_events_from_all_calendarsを使って接続中のアカウントが実際にどのカレンダーを閲覧できるか確認してください。
プッシュ通知チャンネルには有効期限があります。チャンネルが永続的だと想定せず、古いチャンネルに対してgoogle_calendar_stop_channelを呼び、新たにwatch_*を発行してください。