跳转到内容

通过智能体管理工作区设置

有 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」。点数刻度见点数与刻度,默认货币见货币与汇率。

工作区设置的「估算」标签页,「新估算的默认值」区块:智能体设置的时薪 600 和缓冲 15%

要把 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 就不保存设置。