技能介绍

要解决什么问题

在 YonSuite 里查销售、采购、库存或档案，通常要登录 Web、点菜单、导出 Excel，再交给分析工具。Agent 对话里若只有泛泛的「帮我看下这个月采购」，没有稳定的数据入口，口径和字段也容易对不上。

本技能把 YonSuite 业务数据封装成 MCP 工具：在支持 MCP 的 Agent 里直接调用 mcp_yonsuite_query_*，拿结构化结果（records + summary），字段已做中文映射，汇总场景下税额会自动算好。

核心能力与用法

工具面覆盖常见主数据与单据查询：

订单与履约：mcp_yonsuite_query_sale_orders（日期筛选、汇总/明细）、采购订单、生产订单
主数据：物料、客户、供应商档案
运营数据：库存现存量、待办、商机列表
兜底：mcp_yonsuite_ys_api 做通用 API 调用

典型链路是「先收窄再拉数」：用客户/物料名称或日期范围过滤，汇总模式（is_sum=true）看全貌，再决定是否拉明细。要做决策级分析时，技能文档建议先加载 data-analysis，按指标契约 → MCP 取数 → 分离计算与解释 → 图表与 decision-brief 输出的顺序走；报告可走 HTML 模板或配合 cyber-ppt。

采购分析等完整工作流在 references/purchase-analysis-workflow.md 里有说明（取数口径、图表选型、压力测试）。

边界与注意点

查询务必带日期或名称条件，避免全量拉取；query_current_stock 用 sku / 仓库维度，不要用 product_id。
query_production_orders 的日期过滤在客户端侧，数据量大时要留意性能。
ys_api 里部分 get_*_detail 需要内部数字 ID，不接受订单编码（如 PO260709-0001）；明细查询存在已知限制，结果里物料名可能为空。
适用：YonSuite 业务数据查询与分析出报告。不适用：系统权限配置、非 YonSuite 平台、纯总账/凭证类财务查询、YS-Agent 项目自身操作。