Skip to main content

​
Outlook

ShanoneのOutlook連携は、メール・カレンダー/スケジューリング・連絡先・ToDoタスクに加えて、他の連携ではあまり扱われないMicrosoft Graph管理機能(メールルール、デルタ同期、優先受信トレイ、会議室予約)まで含む134個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにOutlook関連の作業を依頼(例: 「デザインチームとの次の会議を探して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Microsoftアカウントを許可する

Shanoneに操作させたいメールボックスとカレンダーについて、MicrosoftのOAuth同意画面を承認します。
3

リクエストを再実行する

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

​
利用可能なツール

ShanoneはOutlook向けに134個のツールを、以下のカテゴリに整理して提供しています。
outlook_list_mail_folders, outlook_list_messages, outlook_get_message, outlook_search_messages, outlook_send_mail, outlook_create_draft, outlook_reply_to_message, outlook_mark_as_read, outlook_delete_message, outlook_move_message, outlook_copy_message, outlook_forward_message, outlook_update_message, outlook_create_mail_folder, outlook_update_mail_folder, outlook_delete_mail_folder, outlook_move_mail_folder, outlook_copy_mail_folder, outlook_list_child_folders, outlook_create_child_folder, outlook_batch_move_messages, outlook_batch_update_messages, outlook_batch_delete_messages, outlook_query_messages, outlook_query_messages_in_folder, outlook_search_messages_kql, outlook_search_all_mailboxes, outlook_get_mail_tips, outlook_get_message_mime, outlook_send_mime_message, outlook_get_mail_delta
outlook_list_calendars, outlook_get_calendar, outlook_create_calendar, outlook_list_calendar_groups, outlook_get_calendar_group, outlook_create_calendar_group, outlook_delete_calendar_group, outlook_list_calendars_in_group, outlook_create_calendar_in_group, outlook_delete_calendar_from_group, outlook_list_calendar_permissions, outlook_get_calendar_permission, outlook_create_calendar_permission, outlook_delete_calendar_permission, outlook_list_events, outlook_get_event, outlook_create_event, outlook_update_event, outlook_delete_event, outlook_list_calendar_view, outlook_search_events, outlook_accept_event, outlook_decline_event, outlook_tentatively_accept_event, outlook_forward_event, outlook_create_recurring_event, outlook_list_event_instances, outlook_update_event_instance, outlook_get_calendar_delta
outlook_find_meeting_times, outlook_get_schedule, outlook_list_room_lists, outlook_get_room_list, outlook_list_rooms_in_list, outlook_get_room_schedule, outlook_find_available_rooms, outlook_list_places, outlook_get_place, outlook_list_workspaces, outlook_search_places, outlook_list_reminders, outlook_dismiss_reminder, outlook_snooze_reminder
outlook_list_contacts, outlook_get_contact, outlook_create_contact, outlook_update_contact, outlook_delete_contact, outlook_search_contacts, outlook_list_contact_folders, outlook_get_contact_folder, outlook_create_contact_folder, outlook_update_contact_folder, outlook_delete_contact_folder, outlook_list_contacts_in_folder, outlook_create_contact_in_folder, outlook_move_contact_to_folder, outlook_get_contact_photo, outlook_update_contact_photo, outlook_delete_contact_photo, outlook_get_contacts_delta
outlook_list_todo_lists, outlook_get_todo_list, outlook_create_todo_list, outlook_update_todo_list, outlook_delete_todo_list, outlook_list_todo_tasks, outlook_get_todo_task, outlook_create_todo_task, outlook_update_todo_task, outlook_delete_todo_task, outlook_complete_todo_task
outlook_list_attachments, outlook_get_attachment, outlook_add_attachment, outlook_delete_attachment, outlook_upload_large_attachment, outlook_list_event_attachments, outlook_get_event_attachment, outlook_add_event_attachment, outlook_delete_event_attachment
outlook_list_rules, outlook_create_rule, outlook_delete_rule, outlook_list_categories, outlook_get_category, outlook_create_category, outlook_delete_category, outlook_add_message_categories, outlook_remove_message_categories, outlook_get_focused_inbox_overrides, outlook_create_focused_inbox_override, outlook_delete_focused_inbox_override
outlook_get_mailbox_settings, outlook_update_mailbox_settings, outlook_set_automatic_replies, outlook_list_extensions, outlook_get_extension, outlook_create_extension, outlook_delete_extension, outlook_list_linked_resources, outlook_create_linked_resource, outlook_delete_linked_resource

​
よくあるユースケース

会議のスケジューリング

outlook_find_meeting_timesで参加者全員の空き時間を探し、イベントを作成する

受信トレイのトリアージ

未読メールを検索し、スレッドを要約して返信案をレビュー用に作成する

会議室の予約

新しいイベントのために空いている会議室を探して予約する

タスクの追跡

会議のアクションアイテムを期限付きのOutlook ToDoタスクに変換する

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

outlook_send_mailのshanone_get_tool_schemaで正確なペイロード形式を確認してください——宛先はフラットな文字列ではなくネストされたオブジェクト({"emailAddress": {"address": "..."}})です。
デルタトークンは長期間使われないと期限切れになります。トークンなしでデルタツールを呼び出して同期を再開し、以降の呼び出し用に新しい@odata.deltaLinkを保存してください。
まずoutlook_list_event_instancesで対象インスタンスのIDを探し、シリーズ全体を対象とするoutlook_update_eventではなくoutlook_update_event_instanceを使ってください。
会議室の空き状況は、その会議室リスト/メールボックスがMicrosoft 365上でリソースメールボックスとして実際にプロビジョニングされているかに依存します。まずoutlook_list_room_listsで該当の会議室リストが存在するか確認してください。