Registro de skills
Operações de negóciosSkills públicas

Point of Sale

Operações completas de PDV para agentes de IA — registrar vendas, processar pagamentos (dinheiro/cartão/M-Pesa/QR), gerenciar carrinhos, fidelidade, e-notas fiscais, recibos, turnos e reembolsos. 38 ferramentas, 22 padrões de e-nota, 24 idiomas.

O que esta skill ensina

Um roteiro reutilizável para um tipo específico de trabalho.

Um servidor MCP informa a um agente quais ações estão disponíveis. Uma skill adiciona o julgamento em torno dessas ações: como reconhecer o trabalho, qual sequência seguir, o que evitar e como decidir que o resultado está completo.

Orquestre operações de ponto de venda — registre vendas, processe pagamentos (dinheiro/cartão/dinheiro móvel/QR), gerencie carrinhos, aplique descontos, administre programas de fidelidade, gere e-faturas e recibos, gerencie turnos e processe reembolsos. Use ao processar uma venda, escanear códigos de barras, receber pagamentos, aplicar descontos, verificar fidelidade…

Arquitetura

Como Point of Sale orienta um agente ADK-Rust.

A skill permanece legível e portátil porque contém instruções em vez de credenciais de serviço ou dados de negócio. O ADK-Rust a fornece ao agente, o agente escolhe dentro do limite de ferramentas revisado e o servidor MCP conectado executa a operação autenticada.

01

Solicitação do usuário

O agente recebe um objetivo expresso em linguagem comum.

02

Habilidade Point of Sale

Corresponde à intenção, fornece o guia de decisão e restringe o limite da ferramenta.

03

Agente ADK-Rust

Planeja o fluxo de trabalho e transmite cada passo significativo pelo runtime.

04

mcp-pos

Executa operações autenticadas contra o sistema que possui a capacidade.

05

Resultado verificado

As regras de conclusão da skill moldam as evidências retornadas ao usuário.

Instruções portáteis: SKILL.md · Limite de capacidade: mcp-pos · Ferramentas permitidas: 39

Guia de decisão

Como o agente transforma uma solicitação na ação correta.

Essas rotas vêm diretamente das instruções da skill. Elas ajudam o modelo a reconhecer a intenção e selecionar uma ferramenta ou fluxo de trabalho focado em vez de improvisar por toda a superfície da capacidade.

01

"nova venda", "iniciar transação"?

cart_create

02

"escaneie", "adicionar item", "código de barras"?

barcode_lookup

03

"desconto", "promoção"?

cart_apply_discount

04

"pagar", "finalizar compra", "dinheiro", "cartão", "mpesa"?

payment_process

05

"QR", "escaneie para pagar"?

payment_qr_generate

06

"pagamento dividido", "parte dinheiro parte cartão"?

split_tender

07

"fidelidade", "pontos"?

loyalty_check / loyalty_redeem

08

"recibo"?

receipt_generate / receipt_bilingual

Fluxos de trabalho comprovados

Sequências repetíveis para resultados úteis.

Um fluxo de trabalho une várias chamadas de ferramentas em uma tarefa que o usuário realmente reconhece. A skill explica a sequência e o resultado pretendido enquanto o ADK-Rust transmite o progresso do agente pelo runtime compartilhado.

014 chamadas

Venda Padrão

Escanear → pagar → recibo

024 chamadas

Dinheiro Móvel

QR → M-Pesa → recibo

035 chamadas

Pagamento Dividido

Dinheiro + cartão combinados

041 chamadas

Fechamento de Turno

Conciliação de caixa + variação

052 chamadas

Reembolso

Autorização → devolução

06With chamadas

Sem

Com

Limite da ferramenta

A skill pode usar 39 ferramentas documentadas.

Esta lista de permissões é declarada pela skill. Ela mantém o agente focado nas ações necessárias para este trabalho enquanto mcp-pos mantém a responsabilidade pela autenticação, validação e 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

Regras de trabalho

O que o agente deve fazer.

  • Sempre crie carrinho (cart_create) antes de adicionar itens
  • Verifique se o pagamento é ≥ total do carrinho antes de concluir
  • Assine todo recibo (receipt_sign) para conformidade fiscal
  • Cheque autorização de função para cancelamentos, reembolsos, alterações de preço
  • Verifique idade para produtos restritos (álcool, tabaco)

Limites operacionais

O que o agente deve evitar.

  • Não processe pagamento sem mostrar o total do carrinho primeiro
  • Não cancele sem autorização do supervisor
  • Não pule a assinatura do recibo (rastro fiscal)
  • Não permita alteração de preço sem código de motivo
  • Não processe reembolso sem referência do recibo original

Instalar e conectar

Adicione a skill ao lado da capacidade que ela espera.

Instale o repositório onde seu carregador de skills ADK-Rust possa descobri-lo, conecte mcp-pos e confirme que as ferramentas declaradas estão disponíveis antes de pedir ao agente para usar o fluxo de trabalho.

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

A declaração de compatibilidade do repositório: Requer servidor mcp-pos conectado. Suporta 22 padrões de e-fatura, 24 idiomas, mais de 20 provedores de pagamento QR.

Documentação oficial

Leia o pacote completo da skill.

O repositório permanece autoritativo para suas instruções exatas, exemplos, scripts auxiliares, recursos, requisitos MCP, licença e atualizações posteriores.

Registro da fonte

Metadados do repositório para esta entrada da skill.

Ver repositório público ↗
Licença
Apache-2.0
Ferramentas permitidas
39
Referências
3
Revisão
e5f546271caf
Atualizado
31 de mai. de 2026