通过智能体管理工作区设置
有 MCP 访问权限的智能体可以显示你工作区的估算设置,并修改它们:时薪、点数刻度、默认货币。保存之前,智能体会先给出「修改前与修改后」的预览,只有你确认后才会写入。如何生成令牌并连接智能体,见MCP:连接智能体。每次调用都计入 MCP 额度:每个工作区每月 100 次调用。
| 步骤 | 工具 | 令牌 |
|---|---|---|
| 读取设置 | get_workspace_settings | 任意,「只读」即可 |
| 更改设置 | update_workspace_settings | 读取并创建估算草稿 |
读取设置
读取设置 章节可以这样要求:「显示工作区设置和我的项目的估算」。智能体会返回:
- 工作区的默认货币;
- 工作区中明确设置的值(
overrides):值为空表示使用 Dead Point 的标准值; - 新估算实际使用的值(
effective):工作量单位、点数刻度、时薪或每月团队成本; - 每个团队的点数刻度。
如果指明项目,回复里还会列出它的估算:每份估算的名称、状态、货币、工作量单位、刻度,以及时薪或团队成本。金额以字符串形式返回,例如「3500」。联系人、收款信息和工作区成员,智能体拿不到。
更改设置
更改设置 章节需要有写入权限的令牌。可以这样要求:「把时薪设为 3500,刻度用斐波那契」。智能体可以修改:
| 字段 | 设置的内容 |
|---|---|
hour_rate | 按小时计的新估算的 时薪 |
team_cost_per_month | 每月的 团队成本 |
buffer_percent | 缓冲,% |
rounding_scale | 金额的小数位数,0 到 6 的整数 |
estimate_type | 所有团队的点数刻度:not_in_use、linear、fibonacci、exponential 或 t_shirt |
default_currency_code | 默认货币,三个字母的代码,例如 USD |
work_hours_per_day | 每天的工作小时数 |
work_days | 以数字表示的每周工作日 |
cycle_days | 周期长度,单位为天 |
时薪、团队成本和缓冲以字符串传递,例如「3500」。点数刻度见点数与刻度,默认货币见货币与汇率。
要把 hour_rate、team_cost_per_month、buffer_percent 或 rounding_scale 恢复为 Dead Point 的标准值,智能体把它们的名称放进 reset_fields。reset_fields 里出现其他名称,或取值超出允许范围,智能体会收到 invalid_params 回复,并附有允许取值的提示。
预览与确认
预览与确认 章节第一次调用 update_workspace_settings 不会保存任何内容。回复里包含:
applied等于false;changes列出字段:原来是什么(before),将变成什么(after);affected_teams显示有多少个团队的点数刻度会改变。
智能体把预览给你看。确认无误后,请确认:智能体再次调用并把 confirm 设为 true,设置随即保存,applied 变为 true。在你确认之前,应用里不会有任何改动。
- 如果值与当前值相同,
changes为空,没有需要保存的内容。 - 幂等密钥(
idempotency_key)只和confirm为true的调用一起传递。用同一个密钥重复请求,会返回第一次的结果,不会重复保存。在预览中用过的密钥,到确认时会得到idempotency_conflict回复。 - MCP 额度用完后,智能体会收到
quota_exceeded回复,其中有重置日期。
已有估算
已有估算 章节新设置只对新估算生效。已经创建的估算不会重新计算:草稿和已发布的版本保持原样。
谁可以更改设置
谁可以更改设置 章节设置由所有者和管理员更改。如果令牌由其他角色的用户生成,智能体会收到 forbidden 拒绝,设置保持不变。工作区的任何令牌都可以读取设置;项目的估算,只有在你有权查看该项目估算时,智能体才能拿到。
应用里的规则相同:所有者和管理员在「工作区设置」中更改设置,其他人看到的字段是只读的,并有提示「只有所有者和管理员可以更改设置」。
智能体不做的事
智能体不做的事 章节- 不重新计算已有估算,也不改动已发布的版本。
- 不修改收款信息、联系人、成员和角色。
- 没有
confirm为true就不保存设置。