合同与报价助手

要解决什么问题

销售与运营里，合同、报价单往往要在 PandaDoc 里走完创建、指定签署人、审批与状态跟踪；若每次都在网页控制台点选，和本地开发环境（例如 Claude Code）是割裂的。本技能通过 Composio MCP 把 PandaDoc 的文档工作流接到对话式终端里：上传 PDF/DOCX/RTF、配置收件人角色与签署顺序、查文档元数据与完成状态，而不必离开当前工作流。

核心能力与用法

技能暴露一组以 PANDADOC_* 为前缀的工具，覆盖常见闭环：

• 从文件创建文档：PANDADOC_CREATE_DOCUMENT_FROM_FILE，需提供 name、recipients（email、role 如 signer/approver/cc、signing_order 等），文件可走上传对象（含 s3key）或公网 HTTPS url 二选一。
• 查详情与状态：PANDADOC_GET_DOCUMENT_DETAILS，用文档 ID（如 BhVzRcxH9Z2LgfPPGXFUqa）拉取收件人、字段、标签、定价等元数据，便于汇报或对账。
• 联系人：PANDADOC_CREATE_OR_UPDATE_CONTACT 按 email 做 upsert，适合在发文档前同步客户信息。
• 文件夹：创建、列出、移动文档（PANDADOC_CREATE_FOLDER / LIST / MOVE），用 UUID 定位目标目录。
• Webhook：PANDADOC_CREATE_WEBHOOK 订阅 document_state_changed、recipient_completed 等事件，把状态变化推到自有 API。
• 模板：PANDADOC_CREATE_TEMPLATE 可从 PDF 或结构化 content 块生成可复用模板。

典型用法是用自然语言描述收件人与文件，由 Agent 选工具并填参；OAuth 在首次连接 PandaDoc 账户时完成，部分能力（电子签、模板、Webhook）取决于工作区套餐。

边界与注意点

• 同一文档内每个收件人的 role 必须唯一（不能两个都是 signer，需区分如 signer_2）。
• 若任意收件人设置了 signing_order，则所有人都要设置，否则 API 报错。
• 建文档时 file 与 url 不能同时传；URL 须公网可访问。
• 联系人不能通过 upsert 直接改 email，需新建并自行处理旧记录。
• 移动文档到文件夹前应先 LIST 拿到文件夹 UUID；Webhook 的 triggers 名称须与 PandaDoc API 完全一致。