Wcloud Clawork

Showing 25 of 147 from the live probe.

• Initialize Product Operation Log

  为一次新的上新创建操作记录（在上新大师端开一条日志），返回 operationLogId。每次开始一个全新上新任务的第一步必须先调它一次——它是唯一建行点，除它之外没有任何工具会替你建行；之后这次上新的所有工具调用都把返回的 operationLogId 原样带上，所有内容才会写进同一条记录。不先调它，后续上新工具会因缺少 operationLogId 直接报错「操作记录尚未准备好」。

• Query Leads

  查询当前商家的客户线索列表（只读，支持关键词/状态过滤与分页），用于后续导出表格等。

• Create Platform Task

  在平台创建一个异步任务（如驱动本地采集），返回 taskId，不阻塞。内部使用。

• Get Platform Task Result

  读取平台异步任务的状态与结果（pending/running/succeeded/failed）。内部使用。

• Query Business Metrics

  查询当前企业真实经营数据：支持本月至今、近 7/30/90 天、近 6 个自然月、年初至今和自定义日期；返回成交总额、订单数、支付订单数、商品销售件数、客单价、退款率及对比周期，并附站点固定口径经营快照。可按站点名称筛选，只读。

• Query Task Deliverables

  查询当前用户在智能体（公众号/上新/智绘/智写/光影/种草/多客星图/数据/办公专家）产生的任务成果，按创建时间倒序；可按专家、类型（article/image/video/file/note）、状态、标题关键词、时间范围筛选。返回每条成果的 id、标题、类型、状态、封面与媒体地址、完成时间；列表不含正文，需要全文时用 get_task_deliverable 按 id 查详情。只读。

• Get Task Deliverable

  按 id 查看单条智能体任务成果：返回正文纯文本预览、封面与媒体地址、属性、下载信息。id 来自 query_task_deliverables 的返回。只读；公众号完整排版 HTML 由成果页面展示，不进入普通模型上下文。

• Get Task Deliverable Content

  供成果库页面读取单条成果完整正文与媒体。客户端内部工具；智能体不要调用。只读。

• Query Deliverable Leads

  按多客星图任务成果 id 查询该成果关联的完整线索明细，支持分页和筛选。关联的询盘 id 由服务端从成果中校验并解析，调用方不需要也不能自行指定。只读。

• Delete Task Deliverables

  批量删除智能体任务成果（软删，最多 200 条）。仅在用户明确要求删除成果时调用。入参 ids 为 query_task_deliverables 返回的成果 id 列表；删除的是成果库副本，不影响让对应专家重新生成。

• Query Lead Funnel

  查询当前企业真实线索数据：本月新增与上月同期、累计转化漏斗、意向分布、渠道和客户统计。商户级，只读。

• Query Content Trend

  查询当前企业近 7 个自然日的真实内容产出趋势，并说明平台文章、商品和外部内容来源是否完整。商户级，只读。

• Submit Data Report

  把数据分析结论存档为一份「数据报表」成果（写入成果库，可在任务成果页查看/删除）。回答完数据问题、用户要求存档或生成报表时调用：title 点明主题，detailText 放完整 markdown 正文，可选 period/metrics 标注统计周期与核心指标。

• List Sites

  列出当前商家在平台的站点（含商城/门户/海外站，只读）。每个站点含 id、name、siteType（mall 商城站才需要运费模板）、defaultLanguage（站点默认语言码，发布时系统自动并入翻译、无需用户勾选）、supportedLanguages（该站支持语言=可勾选的翻译语种范围，如 ["zh","en","ja"]）。用于“提交到哪个站点的商品管理、翻译成哪些语言”等需要先确认目标站点与语种的场景。

• Check Product Exists

  上架前查重：查当前商城里是否已存在同名/相似商品（按名称模糊匹配，只读）。返回 {exists, total, matches:[{id,name,status}]}。上新创建商品前先调它；若已存在应提醒商家、由其决定是否仍要新建。需先用 list_sites 确认目标站点(siteId)。

• Get Product Meta

  取上架/配文所需的商品元数据：该店铺的【商品分类树】（含 id——上架必须从中选分类）+【可填属性】（id/名称/类型/可选值，传给"生成商品文案"让它自动填属性值）+ 标签（可选）。上架(创建商品)或写商品文案前先调它拿到真实的分类/属性/标签 id，绝不要自己编造。需先用 list_sites 确认目标店铺(siteId)。

• Get Shipping Templates

  列出该店铺可用的【运费模板】（含 id 与名称，只读，仅启用中的）。商城站点上架商品需要选运费模板：先用本能力取到模板，再配合"展示可选项"让客户选一个，用所选模板的真实 id 作为上架的 shippingTemplateId；客户不选则平台按免运费处理。需先用 list_sites 确认目标店铺(siteId)。

• Create Product Category

  为指定站点新建一个顶级商品分类（缺分类时快捷创建，免客户跳后台）。传站点与分类名，成功返回新建的分类（含真实 id，可直接用于上架）。

• Publish Product

  把商品内容提交到站点的商品管理：创建商品 + 提交审核（高危·不可逆，执行前会请商家确认）。提交成功后仍需在商品管理审核通过，商品才可售卖。前置：先 list_sites 选店(siteId)、get_product_meta 拿真实分类 id、check_product_exists 查重。images 至少 1 张 https 图（第 1 张作主图）；每张图可为纯 URL，也可为 {url, alt} 带逐图 alt 描述（来自配文 imageAlts·按图顺序，利于 SEO/AI 搜索）；categoryIds 必须来自 get_product_meta、不可编造；skus 每个含售价 price 与库存 stock。商城站点可传 shippingTemplateId（运费模板 id，须来自 get_shipping_templates 的真实 id，不可编造）；不传则平台按免运费处理。

• Identify Product

  AI 识别商品主体：根据商品图判断这是什么商品，返回 {primary:{name,confidence,description}, alternatives, candidates}。它只提供待确认的商品名称候选；客户确认名称后，风格、场景、图片比例、卖点和生成描述必须由 Agent 结合客户商品描述自主生成。上新「弄清商品」时用（客户给了图就调它）；调过它后无需再单独调「整理可选风格」。imageUrls=商品图 https 链接（1~5 张）——只能传真实存在的 https 图片地址（如链接抓取/素材库/客户发来的图片链接），绝不能编造地址；客户在对话里直接上传的图片没有现成 https 地址，必须先调 host_product_image 把它托管成 https 地址、再用返回的地址调本能力；只有 host_product_image 报「没有检测到上传的图片」（客户没传图）时才不调本能力、自己看图识别后继续。

• Submit Identify Subject

  提交「商品识别」任务（耗时较长，返回任务ID后由系统自动轮询续跑）。内部使用。

• Get Identify Subject Task

  读取「商品识别」任务的状态与结果（pending/succeeded/failed）。内部使用。

• Recommend Products

  AI 推荐相关具体商品：客户只给了宽泛商品名（无图）时调它，返回 {recommendations:[4~6个 {name,description,styleName,styleId?,sceneNames,scenes}], styles, sceneGroups, videoTemplates, copywritingStyles}——推荐的具体商品（含可直接用的描述/风格/场景预选）+ 完整目录（供改选）。把推荐摆给客户挑：选中某个 → 商品名/描述/风格/场景都有了；不选 → 用客户原名继续、风格场景手选或自动匹配。recommendations 为空时直接用原名继续。调过它后无需再单独调「整理可选风格」。

• Submit Recommend Products

  提交「相关商品推荐」生成任务（耗时较长，返回任务ID后用 get_recommend_products_task 轮询结果）。客户只给了宽泛商品名（无图）时用。

• Get Recommend Products Task

  读取「相关商品推荐」生成任务的状态与结果（pending/running/succeeded/failed；succeeded 时 result 含 recommendations + 风格/场景目录）。