Microsoft Planner
在 Microsoft Planner 中管理任务、计划和桶
Microsoft Planner 是一款任务管理工具,可通过看板、任务和分组帮助团队以可视化方式组织工作。它与 Microsoft 365 集成,提供了一种简单直观的方式来管理团队项目、分配职责并跟踪进度。
使用 Microsoft Planner,您可以:
- 创建和管理任务:添加具有截止日期、优先级和分配用户的新任务
- 使用分组进行组织:按阶段、状态或类别对任务进行分组,以反映团队的工作流程
- 可视化项目状态:使用看板、图表和筛选器监控工作负载并跟踪进度
- 与 Microsoft 365 保持集成:无缝连接任务与 Teams、Outlook 和其他 Microsoft 工具
在 Sim 中,Microsoft Planner 集成允许您的代理以编程方式创建、读取和管理任务,作为其工作流程的一部分。代理可以根据传入请求生成新任务,检索任务详细信息以推动决策,并跨项目跟踪状态——这一切都无需人工干预。无论您是在为客户入职、内部项目跟踪还是后续任务生成构建工作流程,将 Microsoft Planner 与 Sim 集成为您的代理提供了一种结构化的方式来协调工作、自动创建任务并保持团队一致。
将 Microsoft Planner 集成到工作流程中。管理任务、计划、桶以及任务详情,包括检查清单和参考。
从 Microsoft Planner 读取任务——获取所有用户任务或特定计划中的所有任务
| 参数 | 类型 | 是否必需 | 描述 |
|---|
planId | string | 否 | 要获取任务的计划 ID(如果未提供,则获取所有用户任务) |
taskId | string | 否 | 要获取的任务 ID |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功检索到任务 |
tasks | array | 包含筛选属性的任务对象数组 |
metadata | object | 包括 planId、userId 和 planUrl 的元数据 |
在 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 中的任务
| 参数 | 类型 | 是否必需 | 描述 |
|---|
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 中删除任务
| 参数 | 类型 | 是否必需 | 描述 |
|---|
taskId | string | 是 | 要删除的任务 ID |
etag | string | 是 | 要删除任务的 ETag 值(If-Match 头) |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功删除任务 |
deleted | boolean | 删除确认 |
metadata | object | 附加元数据 |
列出与当前用户共享的所有计划
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功检索到计划 |
plans | array | 与当前用户共享的计划对象数组 |
metadata | object | 包括 userId 和 count 的元数据 |
获取特定 Microsoft Planner 计划的详细信息
| 参数 | 类型 | 是否必需 | 描述 |
|---|
planId | string | 是 | 要检索的计划 ID |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功检索到计划 |
plan | object | 包含所有属性的计划对象 |
metadata | object | 包括 planId 和 planUrl 的元数据 |
列出 Microsoft Planner 计划中的所有桶
| 参数 | 类型 | 是否必需 | 描述 |
|---|
planId | string | 是 | 计划的 ID |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功检索到桶 |
buckets | array | 桶对象的数组 |
metadata | object | 包括 planId 和 count 的元数据 |
获取特定桶的详细信息
| 参数 | 类型 | 是否必需 | 描述 |
|---|
bucketId | string | 是 | 要检索的桶的 ID |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功检索到桶 |
bucket | object | 包含所有属性的桶对象 |
metadata | object | 包括 bucketId 和 planId 的元数据 |
在 Microsoft Planner 计划中创建一个新桶
| 参数 | 类型 | 是否必需 | 描述 |
|---|
planId | string | 是 | 要创建桶的计划 ID |
name | string | 是 | 桶的名称 |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功创建了桶 |
bucket | object | 包含所有属性的已创建桶对象 |
metadata | object | 包括 bucketId 和 planId 的元数据 |
更新 Microsoft Planner 中的一个桶
| 参数 | 类型 | 是否必需 | 描述 |
|---|
bucketId | string | 是 | 要更新的桶的 ID |
name | string | 否 | 桶的新名称 |
etag | string | 是 | 要更新的桶的 ETag 值(If-Match 头) |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功更新了桶 |
bucket | object | 包含所有属性的已更新桶对象 |
metadata | object | 包括 bucketId 和 planId 的元数据 |
从 Microsoft Planner 中删除一个桶
| 参数 | 类型 | 是否必需 | 描述 |
|---|
bucketId | string | 是 | 要删除的桶的 ID |
etag | string | 是 | 要删除的桶的 ETag 值(If-Match 头) |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功删除了桶 |
deleted | boolean | 删除确认 |
metadata | object | 其他元数据 |
获取有关任务的详细信息,包括检查清单和引用
| 参数 | 类型 | 是否必需 | 描述 |
|---|
taskId | string | 是 | 任务的 ID |
| 参数 | 类型 | 描述 |
|---|
success | boolean | 是否成功检索到任务详情 |
taskDetails | object | 包括描述、检查清单和引用的任务详情 |
etag | string | 此任务详情的 ETag 值 - 用于更新操作 |
metadata | object | 包括 taskId 的元数据 |
更新 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 的元数据 |
- 类别:
tools
- 类型:
microsoft_planner