通过智能体换算货币与复制项目
有 MCP 访问权限的智能体可以把项目中的估算换算为其他货币,也可以复制整个项目。两个操作都先给出预览,只有你确认后才会写入。如何生成令牌并连接智能体,见MCP:连接智能体。每次调用都计入 MCP 额度:每个工作区每月 100 次调用。
| 任务 | 工具 | 令牌 |
|---|---|---|
| 把项目的估算换算为其他货币 | change_project_currency | 读取并创建估算草稿 |
| 复制项目 | copy_project | 读取并创建估算草稿 |
智能体通过 project_id 找到项目,它是项目列表中的标识符。
换算为其他货币
换算为其他货币 章节可以这样要求:「把示例网站项目的估算换算为 USD,1 USD = 80 RUB」。智能体调用 change_project_currency,传入 project_id 和 target_currency(三个字母的代码,例如 USD)。它会重新计算时薪、团队成本、固定费用,以及两种情景的合计。
只有草稿会更换货币。项目中的其他估算智能体会跳过,它们连同原因进入 skipped:
| 原因 | 含义 |
|---|---|
published | 估算已发布 |
archived | 估算已归档 |
already_in_target | 估算已经使用目标货币 |
currency_not_in_rate_pair | 估算的货币不在汇率货币对中 |
已发布的版本和客户链接保持不变。估算中的货币详见货币与汇率。
设置汇率
设置汇率 章节智能体通过 rate 字段传递汇率:{ base: "USD", quote: "RUB", value: 80 } 表示 1 USD = 80 RUB。货币对的顺序不限,但其中必须包含估算当前的货币和 target_currency。value 是大于零的数。
也可以不指定汇率。这时智能体使用工作区的参考汇率:回复中标记为 reference,并给出来源和汇率日期。你指定的汇率会标记为 custom。
货币对不合适时,智能体会收到 invalid_params 回复。提示里说明了汇率的写法,并列出项目中估算草稿所用的货币。
预览与确认
预览与确认 章节第一次调用不会保存任何内容。回复里包含:
applied等于false;- 每份估算的汇率(货币对、乘数、来源),以及「修改前」(
before)和「修改后」(after)的金额:时薪或团队成本、固定费用、工作量费用和每种情景的合计; skipped列出被跳过的估算及原因。
智能体把预览给你看。金额无误后,请确认:智能体再次调用并把 confirm 设为 true,所有草稿在一个事务中完成换算。之后无法恢复原货币,只能按新汇率重新换算。
- 幂等密钥(
idempotency_key)只和confirm为true的调用一起传递。用同一个密钥重复请求,会返回第一次的结果,不会再次重新计算金额。 - MCP 额度用完后,智能体会收到
quota_exceeded回复,其中有重置日期。
复制项目
复制项目 章节可以这样要求:「复制示例网站项目」。智能体调用 copy_project,传入 project_id。副本的名称会自动取,例如「示例网站 (副本 1)」。
第一次调用只给出计划,不会创建任何内容。回复里包含:
applied等于false;project_name:将创建的副本的名称;estimates_to_copy:会进入副本的估算(标识符和名称);skipped:不会进入副本的估算,原因为archived;not_copied:不会进入副本的成员(participants)、任务(issues)和有效的客户链接(active_shares)各有多少。
你确认后,智能体再次调用并把 confirm 设为 true。副本在一个事务中创建,回复里 applied 等于 true,并给出新副本的 project_id、project_name 以及 estimates_copied,即已复制的估算数量。idempotency_key 的作用与换算货币时相同:带着它重复请求不会再创建第二个副本。
复制什么、不复制什么
复制什么、不复制什么 章节副本包含:
- 项目设置:图标、标签、点数刻度、周期和时区;
- 草稿和已发布的估算:每份在副本中都是新的草稿,并带有「通过 MCP 创建」的标记。
副本不包含:
- 成员:副本中只有你一个成员;
- 任务;
- 项目的描述和日期;
- 已归档的估算;
- 估算版本:副本没有历史;
- 客户链接和客户数据。
应用里的「复制项目」按钮的行为不同,例如它会带上项目描述。详见项目副本。
谁可以操作
谁可以操作 章节两个操作都需要有写入权限的令牌。有权编辑项目估算的人可以换算货币。同时是工作区所有者的项目负责人可以复制项目。否则智能体会收到拒绝,不会有任何改动。
智能体不做的事
智能体不做的事 章节- 不更改已发布和已归档估算的货币,也不改动已发布的版本。
- 不复制成员、任务、描述、日期、版本、链接和客户数据。
- 没有
confirm为true就不重新计算金额,也不创建副本。