> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook

> メール、カレンダー、連絡先、タスクの管理 — Microsoft 365のメッセージング & スケジューリング機能全体

# Outlook

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

## はじめに

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

  <Step title="Microsoftアカウントを許可する">
    Shanoneに操作させたいメールボックスとカレンダーについて、MicrosoftのOAuth同意画面を承認します。
  </Step>

  <Step title="リクエストを再実行する">
    接続が完了すると、`outlook_*`ツールに対する`shanone_execute_tool`呼び出しが成功するようになります。
  </Step>
</Steps>

## 利用可能なツール

ShanoneはOutlook向けに**134個のツール**を、以下のカテゴリに整理して提供しています。

<AccordionGroup>
  <Accordion title="メール & フォルダ">
    `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`
  </Accordion>

  <Accordion title="カレンダー & イベント">
    `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`
  </Accordion>

  <Accordion title="スケジューリング & 会議室">
    `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`
  </Accordion>

  <Accordion title="連絡先">
    `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`
  </Accordion>

  <Accordion title="ToDoタスク">
    `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`
  </Accordion>

  <Accordion title="添付ファイル">
    `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`
  </Accordion>

  <Accordion title="ルール、カテゴリ & 優先受信トレイ">
    `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`
  </Accordion>

  <Accordion title="メールボックス設定 & 拡張機能">
    `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`
  </Accordion>
</AccordionGroup>

## よくあるユースケース

<CardGroup cols={2}>
  <Card title="会議のスケジューリング" icon="calendar">
    `outlook_find_meeting_times`で参加者全員の空き時間を探し、イベントを作成する
  </Card>

  <Card title="受信トレイのトリアージ" icon="inbox">
    未読メールを検索し、スレッドを要約して返信案をレビュー用に作成する
  </Card>

  <Card title="会議室の予約" icon="door-open">
    新しいイベントのために空いている会議室を探して予約する
  </Card>

  <Card title="タスクの追跡" icon="check-square">
    会議のアクションアイテムを期限付きのOutlook ToDoタスクに変換する
  </Card>
</CardGroup>

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

<AccordionGroup>
  <Accordion title="outlook_send_mailが宛先が無効というエラーで失敗する">
    `outlook_send_mail`の`shanone_get_tool_schema`で正確なペイロード形式を確認してください——宛先はフラットな文字列ではなくネストされたオブジェクト(`{"emailAddress": {"address": "..."}}`)です。
  </Accordion>

  <Accordion title="outlook_get_mail_deltaやoutlook_get_calendar_deltaが再同期が必要というエラーを返す">
    デルタトークンは長期間使われないと期限切れになります。トークンなしでデルタツールを呼び出して同期を再開し、以降の呼び出し用に新しい`@odata.deltaLink`を保存してください。
  </Accordion>

  <Accordion title="outlook_create_recurring_eventで作成した定期予定の個別インスタンスを更新できない">
    まず`outlook_list_event_instances`で対象インスタンスのIDを探し、シリーズ全体を対象とする`outlook_update_event`ではなく`outlook_update_event_instance`を使ってください。
  </Accordion>

  <Accordion title="outlook_find_available_roomsが結果を返さない">
    会議室の空き状況は、その会議室リスト/メールボックスがMicrosoft 365上でリソースメールボックスとして実際にプロビジョニングされているかに依存します。まず`outlook_list_room_lists`で該当の会議室リストが存在するか確認してください。
  </Accordion>
</AccordionGroup>