---
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 和 count 的元数据 |

### `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 和 count 的元数据 |

### `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 的元数据 |
