---
title: Microsoft Planner
description: Microsoft Plannerでタスク、プラン、バケットを管理する
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="microsoft_planner"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Microsoft Planner](https://www.microsoft.com/en-us/microsoft-365/planner)は、ボード、タスク、バケットを使用してチームが視覚的に作業を整理するのに役立つタスク管理ツールです。Microsoft 365と統合されており、チームプロジェクトの管理、責任の割り当て、進捗状況の追跡を簡単で直感的に行う方法を提供します。

Microsoft Plannerでは、次のことができます：

- **タスクの作成と管理**: 期日、優先順位、担当者を設定した新しいタスクを追加
- **バケットでの整理**: チームのワークフローを反映するために、フェーズ、ステータス、カテゴリごとにタスクをグループ化
- **プロジェクトステータスの可視化**: ボード、チャート、フィルターを使用して作業負荷を監視し、進捗状況を追跡
- **Microsoft 365との統合**: Teams、Outlook、その他のMicrosoftツールとタスクをシームレスに接続

Simでは、Microsoft Planner統合により、エージェントがワークフローの一部としてプログラムでタスクを作成、読み取り、管理することができます。エージェントは受信リクエストに基づいて新しいタスクを生成し、意思決定を促進するためにタスクの詳細を取得し、プロジェクト全体のステータスを追跡することができます—すべて人間の介入なしに。クライアントのオンボーディング、内部プロジェクトの追跡、フォローアップタスクの生成のためのワークフローを構築する場合でも、Microsoft PlannerとSimを統合することで、エージェントは作業を調整し、タスク作成を自動化し、チームの連携を維持するための構造化された方法を提供します。
{/* MANUAL-CONTENT-END */}

## 使用手順

Microsoft Plannerをワークフローに統合します。タスク、プラン、バケット、およびチェックリストや参照を含むタスクの詳細を管理します。

## ツール

### `microsoft_planner_read_task`

Microsoft Plannerからタスクを読み取る - すべてのユーザータスクまたは特定のプランからすべてのタスクを取得

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `planId` | string | いいえ | タスクを取得するプランのID（提供されない場合、すべてのユーザータスクを取得） |
| `taskId` | string | いいえ | 取得するタスクのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | タスクが正常に取得されたかどうか |
| `tasks` | array | フィルタリングされたプロパティを持つタスクオブジェクトの配列 |
| `metadata` | object | planId、userId、planUrlを含むメタデータ |

### `microsoft_planner_create_task`

Microsoft Plannerで新しいタスクを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `planId` | string | はい | タスクが作成されるプランのID |
| `title` | string | はい | タスクのタイトル |
| `description` | string | いいえ | タスクの説明 |
| `dueDateTime` | string | いいえ | タスクの期限日時（ISO 8601形式） |
| `assigneeUserId` | string | いいえ | タスクを割り当てるユーザーID |
| `bucketId` | string | いいえ | タスクを配置するバケットID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | タスクが正常に作成されたかどうか |
| `task` | object | すべてのプロパティを持つ作成されたタスクオブジェクト |
| `metadata` | object | planId、taskId、taskUrlを含むメタデータ |

### `microsoft_planner_update_task`

Microsoft Plannerでタスクを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | はい | 更新するタスクのID |
| `etag` | string | はい | 更新するタスクからのETag値（If-Matchヘッダー） |
| `title` | string | いいえ | タスクの新しいタイトル |
| `bucketId` | string | いいえ | タスクを移動するバケットID |
| `dueDateTime` | string | いいえ | タスクの期限日時（ISO 8601形式） |
| `startDateTime` | string | いいえ | タスクの開始日時（ISO 8601形式） |
| `percentComplete` | number | いいえ | タスク完了の割合（0-100） |
| `priority` | number | いいえ | タスクの優先度（0-10） |
| `assigneeUserId` | string | いいえ | タスクを割り当てるユーザーID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | タスクが正常に更新されたかどうか |
| `message` | string | タスクが更新された際の成功メッセージ |
| `task` | object | すべてのプロパティを持つ更新されたタスクオブジェクト |
| `taskId` | string | 更新されたタスクのID |
| `etag` | string | 更新後の新しいETag - 後続の操作に使用します |
| `metadata` | object | taskId、planId、taskUrlを含むメタデータ |

### `microsoft_planner_delete_task`

Microsoft Plannerからタスクを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | はい | 削除するタスクのID |
| `etag` | string | はい | 削除するタスクのETag値（If-Matchヘッダー） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | タスクが正常に削除されたかどうか |
| `deleted` | boolean | 削除の確認 |
| `metadata` | object | 追加のメタデータ |

### `microsoft_planner_list_plans`

現在のユーザーと共有されているすべてのプランを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | プランが正常に取得されたかどうか |
| `plans` | array | 現在のユーザーと共有されているプランオブジェクトの配列 |
| `metadata` | object | userIdと数を含むメタデータ |

### `microsoft_planner_read_plan`

特定のMicrosoft Plannerプランの詳細を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `planId` | string | はい | 取得するプランのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | プランが正常に取得されたかどうか |
| `plan` | object | すべてのプロパティを持つプランオブジェクト |
| `metadata` | object | planIdとplanUrlを含むメタデータ |

### `microsoft_planner_list_buckets`

Microsoft Plannerプラン内のすべてのバケットを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `planId` | string | はい | プランのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | バケットが正常に取得されたかどうか |
| `buckets` | array | バケットオブジェクトの配列 |
| `metadata` | object | planIdと数を含むメタデータ |

### `microsoft_planner_read_bucket`

特定のバケットの詳細を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `bucketId` | string | はい | 取得するバケットのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | バケットが正常に取得されたかどうか |
| `bucket` | object | すべてのプロパティを持つバケットオブジェクト |
| `metadata` | object | bucketIdとplanIdを含むメタデータ |

### `microsoft_planner_create_bucket`

Microsoft Plannerプランに新しいバケットを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `planId` | string | はい | バケットが作成されるプランのID |
| `name` | string | はい | バケットの名前 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | バケットが正常に作成されたかどうか |
| `bucket` | object | すべてのプロパティを持つ作成されたバケットオブジェクト |
| `metadata` | object | bucketIdとplanIdを含むメタデータ |

### `microsoft_planner_update_bucket`

Microsoft Plannerのバケットを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `bucketId` | string | はい | 更新するバケットのID |
| `name` | string | いいえ | バケットの新しい名前 |
| `etag` | string | はい | 更新するバケットからのETag値（If-Matchヘッダー） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | バケットが正常に更新されたかどうか |
| `bucket` | object | すべてのプロパティを持つ更新されたバケットオブジェクト |
| `metadata` | object | bucketIdとplanIdを含むメタデータ |

### `microsoft_planner_delete_bucket`

Microsoft Plannerからバケットを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `bucketId` | string | はい | 削除するバケットのID |
| `etag` | string | はい | 削除するバケットからのETag値（If-Matchヘッダー） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | バケットが正常に削除されたかどうか |
| `deleted` | boolean | 削除の確認 |
| `metadata` | object | 追加のメタデータ |

### `microsoft_planner_get_task_details`

チェックリストや参照を含むタスクの詳細情報を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | はい | タスクのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | タスクの詳細が正常に取得されたかどうか |
| `taskDetails` | object | 説明、チェックリスト、参照を含むタスクの詳細 |
| `etag` | string | このタスク詳細のETag値 - 更新操作に使用します |
| `metadata` | object | taskIdを含むメタデータ |

### `microsoft_planner_update_task_details`

Microsoft Plannerでタスクの詳細（説明、チェックリスト項目、参照）を更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `taskId` | string | はい | タスクのID |
| `etag` | string | はい | 更新するタスク詳細からのETag値（If-Matchヘッダー） |
| `description` | string | いいえ | タスクの説明 |
| `checklist` | object | いいえ | JSONオブジェクトとしてのチェックリスト項目 |
| `references` | object | いいえ | JSONオブジェクトとしての参照 |
| `previewType` | string | いいえ | プレビュータイプ：automatic、noPreview、checklist、description、またはreference |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | タスクの詳細が正常に更新されたかどうか |
| `taskDetails` | object | すべてのプロパティを持つ更新されたタスク詳細オブジェクト |
| `metadata` | object | taskIdを含むメタデータ |
