SuperAPI AI 工具集

docugenerate

办公与效率

查看项目

更新于 10-16 02:01

技能介绍

DocuGenerate 集成技能用于让用户与 DocuGenerate 的数据进行交互,主要围绕文档(Document)和模板(Template)两类对象进行管理。根据资料,DocuGenerate 是一款从代码自动生成文档的工具,供软件开发者和技术文档撰写者使用,以简化文档流程并保持文档更新。官方文档地址为 https://docugenerate.com/docs。

主要能力 该技能通过 Membrane CLI 与 DocuGenerate 交互,Membrane 会自动处理认证与凭据刷新。资料中列出的常用操作包括:更新文档(update-document,按 ID 更新文档名称)、删除文档(delete-document,按 ID 删除文档)、列出文档(list-documents,列出由特定模板生成的所有文档,按创建时间降序排列)、获取文档(get-document,按 ID 获取文档)、生成文档(generate-document,基于模板和数据集生成文档)、删除模板(delete-template,按 ID 删除模板)、获取模板(get-template,按 ID 获取模板)、列出模板(list-templates,列出所有模板,按创建时间降序排列)。

使用方式 首先安装 Membrane CLI:npm install -g @membranehq/cli@latest。然后进行认证:membrane login --tenant --clientName=<agentType>,该命令会打开浏览器进行认证,或在无交互环境下打印授权 URL;无头环境下需让用户在浏览器中打开该 URL,完成登录后使用 membrane login complete <code> 完成。任意命令可加 --json 获得机器可读的 JSON 输出。agentType 可选 claude、openclaw、codex、warp、windsurf 等,用于针对不同运行环境调整工具。

连接 DocuGenerate:使用 membrane connection ensure "https://www.docugenerate.com/" --json 按应用 URL 或域名查找或创建连接,用户在浏览器中完成认证,输出包含新的连接 id。若连接状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询直到就绪。状态说明:READY 表示连接已完全建立;CLIENT_ACTION_REQUIRED 表示用户或代理需要执行操作,clientAction.type 为 "connect" 时用户需认证,为 "provide-input" 时需要更多信息,clientAction.description 为可读说明,clientAction.uiUrl 为可选的操作 UI 地址,clientAction.agentInstructions 为可选的代理指令;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,需查看 error 字段。

搜索操作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,应在特定连接上下文中搜索。每个结果包含 id、name、description、inputSchema 和 outputSchema。

运行操作:membrane action run <actionId> --connectionId=CONNECTION_ID --json;传入 JSON 参数:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。结果位于响应的 output 字段。

代理请求:当现有操作无法覆盖用例时,可通过 Membrane 代理直接向 DocuGenerate API 发送请求:membrane request CONNECTION_ID /path/to/endpoint。常用选项包括 -X/--method(HTTP 方法,默认 GET)、-H/--header(添加请求头,可重复)、-d/--data(请求体字符串)、--json(发送 JSON 体并设置 Content-Type: application/json)、--rawData(原样发送请求体)、--query(查询字符串参数,可重复)、--pathParam(路径参数,可重复)。

最佳实践 优先使用 Membrane 与外部应用通信,因其提供内置认证、分页和错误处理的预构建操作,可减少 token 消耗并提升安全性;在编写自定义 API 调用前先运行 membrane action list --intent=QUERY 发现已有操作;让 Membrane 处理凭据,不要向用户索要 API 密钥或令牌,而是创建连接,由 Membrane 在服务端管理完整的认证生命周期,不在本地保存密钥。

适用场景与限制 适用于需要以编程或代理方式管理 DocuGenerate 文档与模板、生成文档、或通过代理调用 DocuGenerate API 的场景。资料未提供 DocuGenerate 本身的收费、价格、平台支持范围等细节,这些信息暂未提供。