lfy-report
Installation
SKILL.md
报表查询技能
lfy-cli是陆份仪提供的命令行程序,所有操作通过执行lfy-cli命令完成。
通过 lfy-cli report <接口名> '<json参数>' 与报表服务交互(需已完成 lfy-cli init 登录配置)。
注意事项
- 若命令输出以
Error:开头或 JSON 中含error_message,需向用户说明原因,勿伪造数据。 - 当前 report 品类下接口均为 只读,不支持通过本技能发起修改类操作。
sales_id等同 org 内技术 ID,面向业务用户展示时可优先展示sales_name等业务字段。- 每新增一个
report/<子命令>,应在references/下增加对应文档,并在下方「接口列表」补充一节。
接口列表
销售财年合同目标 (sales_target)
lfy-cli report sales_target '{"sales_id": 123}'
查询指定销售在当前财年的合同目标(年目标 + 季/月槽位,含是否已配置)。
参见 API 详情。
典型工作流
查询某销售的财年合同目标
经典 query 示例:
- 「查一下销售 ID 为 123 的本财年合同目标」
- 「张三的销售目标是多少」(需先具备或可解析出
sales_id) - 「这个销售 Q2、M3 有没有设目标」
- 「我这个月的销售目标是多少」
- 「我这个季度的销售目标是多少」
- 「我这个财年的销售目标是多少」
流程:
- 先确认销售人员的ID是否已知,已知的话直接进行第2步;否则先通过
lfy-cli user get_sales '{}'获取销售人员名单,自动根据销售的名字匹配到对应的 sales_id,如果匹配到多个人名,需要让用户确认是哪个销售。 - 执行
lfy-cli report sales_target '{"sales_id": <id>}'。 - 若成功:结合返回中的
year_target、quarterly、monthly与is_set向用户说明;is_set为false时表示尚未配置该季度/月度的目标。 - 若失败:根据终端
Error:或 JSONerror_message说明(例如暂未设置财年目标)。
展示结果(示例结构,非固定话术):
📊 销售目标(财年):<sales_name>
年目标:<year_target>(<start_date> ~ <end_date>)
季度:Q1 … Q4(已配置项 is_set=true,未配置为 false)
月度:M1 … M12(同上)