技能注册表
业务运营公共技能

Point of Sale

面向 AI 代理的完整 POS 操作 — 结账销售,处理支付(现金/卡/M-Pesa/二维码),管理购物车、忠诚度、电子发票、收据、班次和退款。38 个工具,支持 22 种电子发票标准,24 种语言。

此技能教授的内容

针对特定工作类型的可复用操作手册。

MCP 服务器告诉代理可用的操作。技能为这些操作添加判断:如何识别任务,遵循哪个顺序,避免什么,以及如何判断结果已完成。

协调销售点操作 — 结算销售,处理支付(现金/卡/移动支付/二维码),管理购物车,应用折扣,处理忠诚度,生成电子发票和收据,管理班次,处理退款。适用于处理销售、扫描条码、收款、应用折扣、检查忠诚度等。

架构

Point of Sale 如何指导 ADK-Rust 代理。

技能保持可读和可移植,因为它包含说明而非服务凭证或业务数据。ADK-Rust 将其提供给代理,代理从审核过的工具边界中选择,连接的 MCP 服务器执行经过身份验证的操作。

01

用户请求

代理接收以普通语言表达的目标。

02

Point of Sale 技能

匹配意图,提供决策指南,并缩小工具边界。

03

ADK-Rust 代理

规划工作流,并通过运行时流式传输每个关键步骤。

04

mcp-pos

对拥有该能力的系统执行经过身份验证的操作。

05

已验证结果

技能的完成规则决定返回给用户的证据。

可移植的说明: SKILL.md · 能力边界: mcp-pos · 允许的工具: 39

决策指南

代理如何将请求转化为正确操作。

这些路由直接来自技能说明。它们帮助模型识别意图并选择专注的工具或工作流,而不是在整个能力范围内即兴发挥。

01

“新销售”、“开始交易”?

cart_create

02

“扫描”、“添加商品”、“条码”?

barcode_lookup

03

“折扣”、“促销”?

cart_apply_discount

04

“支付”、“结账”、“现金”、“卡”、“mpesa”?

payment_process

05

“二维码”、“扫码支付”?

payment_qr_generate

06

“分开支付”、“部分现金部分卡”?

split_tender

07

“忠诚度”、“积分”?

loyalty_check / loyalty_redeem

08

“收据”?

receipt_generate / receipt_bilingual

经过验证的工作流

可重复的序列以实现有用结果。

工作流将多个工具调用组合成用户实际识别的任务。技能解释顺序和预期结果,而 ADK-Rust 通过共享运行时实时传输代理的进度。

014 次调用

标准销售

扫描 → 支付 → 收据

024 次调用

移动支付

二维码 → M-Pesa → 收据

035 次调用

分账支付

现金 + 卡组合支付

041 次调用

班次结算

现金对账 + 差异

052 次调用

退款

授权 → 退货

06With 次调用

工具边界

技能可能使用 39 个已记录工具。

此允许列表由技能声明。它使代理专注于完成此任务所需的操作,而 mcp-pos 保留身份验证、验证和连接系统的责任。

product_register
cart_create
cart_add_item
cart_remove_item
cart_apply_discount
cart_get
barcode_lookup
payment_process
payment_qr_generate
split_tender
multi_currency_checkout
ebt_snap_pay
meal_voucher
fiscal_config
einvoice_generate
receipt_generate
receipt_sign
receipt_bilingual
cart_void
price_override
cart_suspend
cart_recall
suspended_list
receipt_reprint
role_set_limits
authorize_check
age_verify
shift_open
shift_close
daily_summary
loyalty_check
loyalty_redeem
us_tax_lookup
tip_calculate
tip_add
env_levy_add
tax_category_set
buyer_identify
refund

工作规则

代理应做什么。

  • 添加商品前必须先创建购物车
  • 完成前确认支付金额≥购物车总额
  • 每张收据必须签名(receipt_sign)以符合法规
  • 作废、退款、价格覆盖需检查角色权限
  • 限制产品(酒精、烟草)需年龄验证

操作边界

代理应避免什么。

  • 支付前必须先显示购物车总额
  • 作废需主管授权
  • 不得跳过收据签名(财务审计轨迹)
  • 价格覆盖需提供原因代码
  • 退款需提供原始收据参考

安装并连接

将技能添加到其预期能力旁边。

安装仓库,使您的 ADK-Rust 技能加载器能发现它,连接 mcp-pos,并确认声明的工具可用后,再让代理使用工作流。

安装技能
git clone https://github.com/zavora-ai/skill-point-of-sale.git \
  ~/.skills/skills/point-of-sale
ADK-Rust 加载形态
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("point-of-sale").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

仓库的兼容性声明:需要连接 mcp-pos 服务器。支持 22 种电子发票标准,24 种语言,20+ 二维码支付提供商。

源记录

此技能条目的仓库元数据。

查看公共仓库 ↗
许可证
Apache-2.0
允许的工具
39
参考文献
3
修订
e5f546271caf
已更新
2026年5月31日