通过智能体向客户发送报价
有 MCP 访问权限的智能体可以把估算推进成商务报价：发布版本，给客户一个链接，并查看客户是否已答复。如何生成令牌并连接智能体，见MCP：连接智能体。每次调用都计入 MCP 额度：每个工作区每月 100 次调用。
| 步骤 | 工具 | 令牌 |
|---|---|---|
| 发布版本 | publish_estimate_version | 读取并创建估算草稿 |
| 创建客户链接 | create_share_link | 读取并创建估算草稿 |
| 获取批准状态 | get_approval_status | 任意，「只读」即可 |
需要什么
需要什么 章节- 有写入权限的令牌，用于发布版本和创建链接。
- 在项目中有可以编辑估算的角色。观察者会收到
forbidden拒绝。 - 令牌所属工作区里的估算。任何估算都行：智能体创建的，或在应用中建好的。
发布版本
发布版本 章节可以这样要求：「发布估算 网站改版，并给客户一个链接」。智能体把当前草稿发布为下一个版本，并得到版本号和发布时间。版本在应用中的显示与手动发布相同，之后不再改变：估算版本与对比。
- 用同一个幂等密钥重复请求，会返回同一个版本。
- 没有密钥时，每次调用都会创建新版本。
- MCP 额度用完后，智能体会收到
quota_exceeded回复，其中有重置日期。
创建客户链接
创建客户链接 章节智能体为已发布的版本创建链接。默认是开放链接：任何拿到地址的人都能看到页面。可以设置链接的有效期，不设置则永久有效。客户看到什么，见客户看到什么。客户在页面上自己下载 PDF 和 XLSX 文件，智能体不提供这些文件。
开放链接的地址只显示一次，就在创建时。智能体把它交给你，丢失的地址无法找回：请在应用中撤销该链接，再创建新的。
带密码的链接
带密码的链接 章节如果给智能体传了密码，创建的链接就受保护：客户先输入密码，才能打开报告。访问方式在创建时确定，之后不能更改。
- 密码至少 8 个字符。更短的会被
invalid_params回复拒绝，不会创建链接。 - 密码不会出现在回复里，也不会写入调用日志。密码由智能体或你转交给客户，最好单独发一条消息。
- 带密码链接的地址，智能体每次都会在回复里拿到，重复请求时也一样。
- 链接标签可以由智能体设置，只有你能看到。
重复请求链接
重复请求链接 章节每个版本只有一个有效链接。如果已经有了，智能体不会创建也不会撤销任何东西：回复中 share_already_active 为 true，新请求里的密码和批准人不会生效。
- 开放链接不返回地址，创建时已经显示过。
- 带密码的链接会返回地址，不返回密码。
- 已经发给客户的链接，智能体不会撤销。要替换它，请在应用中撤销链接：通过链接分享估算给客户。
批准人
批准人 章节只有指定了批准人，客户才能批准估算。智能体可以随链接一起传入：批准人的姓名和邮箱。批准人只会指定给新链接，回复中 recipient_set 为 true。
如果指定失败，链接仍已创建，recipient_set 为 false，提示会要求你在应用中指定批准人：客户批准估算。姓名和邮箱不会出现在回复里，也不会写入调用日志。
批准状态
批准状态 章节智能体传入创建回复里的链接标识。对于在应用中创建的链接，标识在 list_estimate_versions 返回的版本里。回复包含：
- 批准的状态；
- 客户何时答复；
- 链接被打开了多少次，最近一次是何时。
批准人的姓名、邮箱和公司，以及客户答复的文字，都不会交给智能体。状态与链接编辑器里的状态一一对应：
| 回复中的状态 | 应用中的状态 |
|---|---|
approval_disabled | 未设置收件人 |
awaiting_response | 等待回复 |
approved | 已批准 |
changes_requested | 要求修改 |
expired_offer | 报价已过期 |
expired_link | 链接已过期 |
revoked | 链接已撤销 |
superseded | 已有更新的版本 |
带密码链接的打开次数可能一下子增加 2：页面和输入密码后的报告是分别计数的。
智能体不做什么
智能体不做什么 章节- 不撤销链接，也不更改链接的密码和有效期。
- 不更改也不删除批准人。
- 不向客户发送验证码和提醒。
撤销链接，以及更改密码、有效期和批准人，都在应用中完成。