Registro de skills
Operaciones empresarialesSkills públicas

Point of Sale

Operaciones completas de punto de venta para agentes de IA — registrar ventas, procesar pagos (efectivo/tarjeta/M-Pesa/QR), gestionar carritos, lealtad, facturas electrónicas, recibos, turnos y reembolsos. 38 herramientas, 22 estándares de factura electrónica, 24 idiomas.

Qué enseña esta habilidad

Un manual reutilizable para un tipo específico de trabajo.

Un servidor MCP indica a un agente qué acciones están disponibles. Una habilidad añade el juicio alrededor de esas acciones: cómo reconocer el trabajo, qué secuencia seguir, qué evitar y cómo decidir que el resultado está completo.

Orquesta operaciones de punto de venta: registra ventas, procesa pagos (efectivo/tarjeta/dinero móvil/QR), administra carritos, aplica descuentos, maneja lealtad, genera facturas electrónicas y recibos, administra turnos y procesa reembolsos. Úsalo al procesar una venta, escanear códigos de barras, recibir pagos, aplicar descuentos, verificar lealtad…

Arquitectura

Cómo Point of Sale guía a un agente ADK-Rust.

La habilidad se mantiene legible y portátil porque contiene instrucciones en lugar de credenciales de servicio o datos de negocio. ADK-Rust la suministra al agente, el agente elige dentro de su límite de herramientas revisado y el servidor MCP conectado realiza la operación autenticada.

01

Solicitud del usuario

El agente recibe un objetivo expresado en lenguaje común.

02

Habilidad Point of Sale

Coincide con la intención, suministra la guía de decisiones y limita el límite de herramientas.

03

Agente ADK-Rust

Planifica el flujo de trabajo y transmite cada paso significativo a través del entorno de ejecución.

04

mcp-pos

Ejecuta operaciones autenticadas contra el sistema que posee la capacidad.

05

Resultado verificado

Las reglas de finalización de la habilidad moldean la evidencia devuelta al usuario.

Instrucciones portátiles: SKILL.md · Límite de capacidad: mcp-pos · Herramientas permitidas: 39

Guía de decisiones

Cómo el agente convierte una solicitud en la acción correcta.

Estas rutas provienen directamente de las instrucciones de la habilidad. Ayudan al modelo a reconocer la intención y seleccionar una herramienta o flujo de trabajo enfocado en lugar de improvisar en toda la superficie de capacidad.

01

"nueva venta", "iniciar transacción"?

cart_create

02

"escanear", "agregar artículo", "código de barras"?

barcode_lookup

03

"descuento", "promo"?

cart_apply_discount

04

"pagar", "cobrar", "efectivo", "tarjeta", "mpesa"?

payment_process

05

"QR", "escanea para pagar"?

payment_qr_generate

06

"pago dividido", "parte efectivo parte tarjeta"?

split_tender

07

"lealtad", "puntos"?

loyalty_check / loyalty_redeem

08

"recibo"?

receipt_generate / receipt_bilingual

Flujos de trabajo probados

Secuencias repetibles para resultados útiles.

Un flujo de trabajo une varias llamadas a herramientas en una tarea que el usuario realmente reconoce. La habilidad explica la secuencia y el resultado esperado mientras ADK-Rust transmite el progreso del agente a través del entorno de ejecución compartido.

014 llamadas

Venta Estándar

Escanear → pagar → recibo

024 llamadas

Dinero Móvil

QR → M-Pesa → recibo

035 llamadas

Pago Dividido

Efectivo + tarjeta combinado

041 llamadas

Cierre de Turno

Conciliación de efectivo + variación

052 llamadas

Reembolso

Autorización → devolución

06With llamadas

Sin

Con

Límite de herramienta

La habilidad puede usar 39 herramientas documentadas.

Esta lista blanca es declarada por la habilidad. Mantiene al agente enfocado en las acciones necesarias para este trabajo mientras mcp-pos retiene la responsabilidad de autenticación, validación y el sistema conectado.

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

Reglas de trabajo

Qué debe hacer el agente.

  • Siempre crear carrito antes de añadir artículos
  • Verificar que el pago sea ≥ total del carrito antes de completar
  • Firmar cada recibo (receipt_sign) para cumplimiento fiscal
  • Verificar autorización de rol para anulaciones, reembolsos, sobreescrituras de precio
  • Verificar edad para productos restringidos (alcohol, tabaco)

Límites operativos

Qué debe evitar el agente.

  • No procesar pago sin mostrar total del carrito primero
  • No anular sin autorización de supervisor
  • No omitir firma de recibo (registro fiscal)
  • No permitir sobreescritura de precio sin código de motivo
  • No procesar reembolso sin referencia al recibo original

Instalar y conectar

Agrega la habilidad junto a la capacidad que espera.

Instala el repositorio donde tu cargador de habilidades ADK-Rust pueda descubrirlo, conecta mcp-pos y confirma que las herramientas declaradas están disponibles antes de pedir al agente que use el flujo de trabajo.

Instalar la habilidad
git clone https://github.com/zavora-ai/skill-point-of-sale.git \
  ~/.skills/skills/point-of-sale
Forma de carga 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()?;

La declaración de compatibilidad del repositorio: Requiere conexión al servidor mcp-pos. Soporta 22 estándares de factura electrónica, 24 idiomas, más de 20 proveedores de pago QR.

Documentación oficial

Lee el paquete completo de la habilidad.

El repositorio sigue siendo la autoridad para sus instrucciones exactas, ejemplos, scripts auxiliares, recursos, requisitos MCP, licencia y actualizaciones posteriores.

Registro de origen

Metadatos del repositorio para esta entrada de habilidad.

Ver repositorio público ↗
Licencia
Apache-2.0
Herramientas permitidas
39
Referencias
3
Revisión
e5f546271caf
Actualizado
31 may 2026