跳转到内容

通过智能体换算货币与复制项目

有 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估算的货币不在汇率货币对中

已发布的版本和客户链接保持不变。估算中的货币详见货币与汇率。

转换为 EUR 后的草稿「在线预约网站开发」:顶部货币为 EUR,各行单价 60.00,估算金额 €12,082.00

智能体通过 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 的作用与换算货币时相同:带着它重复请求不会再创建第二个副本。

工作区的项目列表:第一行是副本「示例科技有限公司 (副本 1)」,状态为进行中,下面是原项目和另外两个项目

复制什么、不复制什么

复制什么、不复制什么 章节

副本包含:

  • 项目设置:图标、标签、点数刻度、周期和时区;
  • 草稿和已发布的估算:每份在副本中都是新的草稿,并带有「通过 MCP 创建」的标记。

副本不包含:

  • 成员:副本中只有你一个成员;
  • 任务;
  • 项目的描述和日期;
  • 已归档的估算;
  • 估算版本:副本没有历史;
  • 客户链接和客户数据。

应用里的「复制项目」按钮的行为不同,例如它会带上项目描述。详见项目副本。

谁可以操作

谁可以操作 章节

两个操作都需要有写入权限的令牌。有权编辑项目估算的人可以换算货币。同时是工作区所有者的项目负责人可以复制项目。否则智能体会收到拒绝,不会有任何改动。

智能体不做的事

智能体不做的事 章节
  • 不更改已发布和已归档估算的货币,也不改动已发布的版本。
  • 不复制成员、任务、描述、日期、版本、链接和客户数据。
  • 没有 confirm 为 true 就不重新计算金额,也不创建副本。