mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-28 03:00:29 -04:00
9a6a6fdacb
* improvement(docs): updated script to copy over icons, cleanup unnecessary pages * updated script with auto-icon generation * ignore translations, only icons changed * updated images * updated i18n.lock * updated images
297 lines
9.9 KiB
Plaintext
297 lines
9.9 KiB
Plaintext
---
|
||
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 的元数据 |
|
||
|
||
## 注意事项
|
||
|
||
- 类别：`tools`
|
||
- 类型：`microsoft_planner`
|