google-calendar-automation

Google Calendar の自動化

使用する場面

• すでに設定済みの連携を通じて、カレンダー、スケジュール、イベントの詳細を確認します。
• 明示的に許可されたイベントの作成、編集、キャンセル、招待への返信を準備または実行します。
• 認証済みアカウントがアクセスできる空き状況のみを使って、空いている可能性のある時間帯を探します。

前提条件と制限事項

このスキルに含まれるのは手順のみです。OAuth ヘルパー、Python クライアント、サーバー、トークンストアは同梱されていません。利用可能な認証済みコネクターまたはプロジェクト所有の Calendar クライアントを見つけ、実際のツールスキーマを確認してください。特定のアカウント種別、コマンド、認証フロー、通知フラグ、自動トークン更新を前提としないでください。連携が設定されていない場合は、下書きを提示して、設定が不足していることを説明してください。コマンドを捏造したり、内容が変わりうる外部スクリプトを取得したりしないでください。

別途許可されている場合は、連携に既存の同意フローを通じて認証してください。チャットでパスワード、Cookie、OAuth シークレット、トークン値を要求したり、繰り返したりしないでください。必要最小限の権限を使用してください。タスクの範囲外のカレンダーを調べたり、参加者の詳細を無関係なサービスにコピーしたりしないでください。

ワークフロー

1. アカウント、カレンダー ID、指定された日付範囲、IANA タイムゾーン、操作を確認します。書き込みを行う前に、曖昧な相対日付や夏時間の変更を解決します。
2. 関連するカレンダーまたはイベントを、結果数を制限して読み込みます。イベント ID、繰り返しのインスタンス ID、タイムゾーン情報を保持し、終日イベントと時間指定イベントを区別します。
3. 提案するタイトル、開始・終了時刻、説明、場所、参加者、通知の動作を準備します。実際の連携がサポートするフィールドのみを使用してください。
4. 書き込みを行う場合は、具体的な変更と通知への影響について許可を確認します。空き状況の確認依頼は、イベントの作成や参加者への通知を許可するものではありません。キャンセルを実行する前に、削除の対象範囲と繰り返しの範囲を提示してください。
5. 承認された操作を一度だけ実行します。タイムアウトした場合は、重複作成を防ぐため、再試行する前にイベントの状態を読み取ってください。カレンダーへのアクセス範囲を自動的に広げたり、別のアカウントに切り替えたりしないでください。
6. 許可されている場合は、結果のイベントを読み戻します。確認できた状態、イベント ID、タイムゾーン、通知が要求されたかどうかを報告します。プロバイダーが通知の配信状況や最終状態を確認できない場合は、その不確実性を明示してください。

例

ユーザー：「来週火曜日の午後に、Europe/Rome で30分空いている時間があるか、仕事用カレンダーを確認してください。」

アシスタント：火曜日の日付を特定し、明示的に選択されたカレンダーについて、許可された範囲の空き状況を確認して、候補となる時間帯を提示します。依頼された場合にのみ、イベントの下書きを作成します。イベントの作成、参加者の追加、招待の送信には、それぞれの操作に対する許可が必要です。

制限事項

• 空き状況、スコープ、アカウントポリシー、API 機能は、設定済みの連携によって異なります。
• 空き状況を確認できない場合、その参加者が空いている証拠にはなりません。
• このスキルをインストールしても、ランタイムや実際のプロバイダー操作が同梱されるわけではありません。
• 該当する操作への許可なしに、イベントを作成、更新、キャンセルしたり、イベントに返信したりしないでください。