Registre des compétences
Opérations métierCompétences publiques

Point of Sale

Opérations complètes de point de vente pour agents IA — enregistrer les ventes, traiter les paiements (espèces/carte/M-Pesa/QR), gérer les paniers, fidélité, factures électroniques, reçus, shifts et remboursements. 38 outils, 22 standards de factures électroniques, 24 langues.

Ce que cette compétence enseigne

Un guide réutilisable pour un type de travail spécifique.

Un serveur MCP indique à un agent quelles actions sont disponibles. Une compétence ajoute le jugement autour de ces actions : comment reconnaître la tâche, quelle séquence suivre, quoi éviter, et comment décider que le résultat est complet.

Orchestrez les opérations de point de vente — enregistrez les ventes, traitez les paiements (espèces/carte/argent mobile/QR), gérez les paniers, appliquez des remises, gérez la fidélité, générez des factures électroniques et reçus, gérez les shifts, et traitez les remboursements. Utilisez-le lors du traitement d'une vente, du scan de codes-barres, de la prise de paiements, de l'application de remises, du contrôle de la fidélité…

Architecture

Comment Point of Sale guide un agent ADK-Rust.

La compétence reste lisible et portable car elle contient des instructions plutôt que des identifiants de service ou des données métier. ADK-Rust la fournit à l'agent, l'agent choisit dans sa limite d'outil examinée, et le serveur MCP connecté exécute l'opération authentifiée.

01

Requête utilisateur

L'agent reçoit un objectif exprimé en langage courant.

02

Compétence Point of Sale

Correspond à l'intention, fournit le guide de décision, et restreint la limite d'outil.

03

Agent ADK-Rust

Planifie le flux de travail et diffuse chaque étape significative via le runtime.

04

mcp-pos

Exécute des opérations authentifiées contre le système propriétaire de la capacité.

05

Résultat vérifié

Les règles de complétion de la compétence façonnent les preuves retournées à l'utilisateur.

Instructions portables : SKILL.md · Limite de capacité : mcp-pos · Outils autorisés : 39

Guide de décision

Comment l'agent transforme une requête en action appropriée.

Ces routes proviennent directement des instructions de la compétence. Elles aident le modèle à reconnaître l'intention et à sélectionner un outil ou un flux de travail ciblé au lieu d'improviser sur toute la surface de capacité.

01

"nouvelle vente", "démarrer transaction" ?

cart_create

02

"scanner", "ajouter article", "code-barres" ?

barcode_lookup

03

"remise", "promo" ?

cart_apply_discount

04

"payer", "caisse", "espèces", "carte", "mpesa" ?

payment_process

05

"QR", "scanner pour payer" ?

payment_qr_generate

06

"paiement partagé", "part espèces part carte" ?

split_tender

07

"fidélité", "points" ?

loyalty_check / loyalty_redeem

08

"reçu" ?

receipt_generate / receipt_bilingual

Flux de travail éprouvés

Séquences répétables pour des résultats utiles.

Un flux de travail regroupe plusieurs appels d'outils en une tâche que l'utilisateur reconnaît réellement. La compétence explique la séquence et le résultat attendu tandis qu'ADK-Rust diffuse la progression de l'agent via le runtime partagé.

014 appels

Vente Standard

Scanner → payer → reçu

024 appels

Argent Mobile

QR → M-Pesa → reçu

035 appels

Paiement Fractionné

Espèces + carte combinés

041 appels

Clôture de Shift

Rapprochement espèces + variance

052 appels

Remboursement

Autorisation → retour

06With appels

Sans

Avec

Limite d'outil

La compétence peut utiliser 39 outils documentés.

Cette liste blanche est déclarée par la compétence. Elle maintient l'agent concentré sur les actions nécessaires pour ce travail tandis que mcp-pos conserve la responsabilité de l'authentification, de la validation et du système connecté.

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

Règles de travail

Ce que l'agent doit faire.

  • Toujours créer un panier (cart_create) avant d'ajouter des articles
  • Vérifiez que le paiement ≥ total du panier avant de finaliser
  • Signez chaque reçu (receipt_sign) pour conformité fiscale
  • Vérifiez l'autorisation de rôle pour annulations, remboursements, modifications de prix
  • Vérifiez l'âge pour produits restreints (alcool, tabac)

Limites opérationnelles

Ce que l'agent doit éviter.

  • Ne traitez pas de paiement sans afficher d'abord le total du panier
  • Ne faites pas d'annulation sans autorisation du superviseur
  • Ne sautez pas la signature du reçu (trace d'audit fiscal)
  • N'autorisez pas la modification de prix sans code de raison
  • Ne traitez pas de remboursement sans référence au reçu original

Installer et connecter

Ajoutez la compétence à côté de la capacité qu'elle attend.

Installez le dépôt où votre chargeur de compétences ADK-Rust peut le découvrir, connectez mcp-pos, et confirmez que les outils déclarés sont disponibles avant de demander à l'agent d'utiliser le flux de travail.

Installer la compétence
git clone https://github.com/zavora-ai/skill-point-of-sale.git \
  ~/.skills/skills/point-of-sale
Forme de chargement 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 déclaration de compatibilité du dépôt : Nécessite un serveur mcp-pos connecté. Supporte 22 standards de factures électroniques, 24 langues, plus de 20 fournisseurs de paiement QR.

Documentation officielle

Lisez le package complet de la compétence.

Le dépôt reste la référence pour ses instructions exactes, exemples, scripts d'aide, ressources, exigences MCP, licence et mises à jour ultérieures.

Enregistrement source

Métadonnées du dépôt pour cette entrée de compétence.

Voir le dépôt public ↗
Licence
Apache-2.0
Outils autorisés
39
Références
3
Révision
e5f546271caf
Mis à jour
31 mai 2026