Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Python: [Feature]: Crypto Payroll Agent — end-to-end sample with on-chain batch payments

Aperta
  • Qualcosa non va?
#8,881 0 commenti 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@eavanvalkenburg ci sta già lavorando.

Dal 30/9/2026.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

agents middleware python
Description
What problem does it solve?

The current sample set covers travel planning, content generation, M365, RAG, and workflows — but no sample demonstrates an agent handling irreversible financial operations with real side effects. Developers building payment or fintech agents don't have a reference for guardrail patterns (spend ceilings, recipient caps, confirmation gates) on actions that move real value.

What would the expected behavior be?

A self-contained sample in python/samples/05-end-to-end/crypto_payroll_agent/ where an AI agent accepts a natural-language payroll instruction (e.g. "Pay Alice 50 USDC and Bob 30 USDC on Base"), resolves it into structured recipient/amount data, calls a payment gateway's REST API to build the unsigned transaction, signs locally, broadcasts, and confirms settlement — all through MAF tool functions.

The sample would include:

  • 3–4 tool functions (estimate batch cost, get token info, execute batch, check transaction)
  • A guardrail callback enforcing recipient count ≤ 200, address format validation, and a configurable MAX_BATCH_USD spending ceiling
  • README with setup, walkthrough, and on-chain proof transactions from verification
  • Tests runnable without a funded wallet (mocked gateway responses)

The payment gateway used would be Spraay Protocol (gateway.spraay.app), operated by Plagtech LLC — my company. The gateway charges a 0.3% protocol fee on batches and $0.02 per API call. These fees would be documented in the sample README. The gateway is the only Spraay-specific dependency; the agent architecture, tool patterns, and guardrail approach are framework-general.

Are there any alternatives you've considered?

The sample could also fit in microsoft/Agent-Framework-Samples under 09.Cases/ if that's a better home for third-party integration demos.

Prior art

I've contributed similar payment-agent samples to other frameworks:

Questions for maintainers
  1. Is python/samples/05-end-to-end/ the right location?
  2. Any preference on LLM provider the sample should target (GitHub Models, Azure OpenAI, OpenAI)?
  3. Should tools use @tool or @kernel_function? I'll match whichever convention the existing samples follow.
Code Sample
from agent_framework import Agent

# Tool functions would call the Spraay gateway REST API
# Example: estimate a batch payment
@tool
async def estimate_batch(token: str, recipients: list[str], amounts: list[str]) -> str:
    """Estimate gas and fees for a batch payment on Base."""
    response = await httpx.AsyncClient().post(
        "https://gateway.spraay.app/api/v1/batch/estimate",
        json={"token": token, "recipients": recipients, "amounts": amounts}
    )
    return response.json()

agent = Agent(
    client=...,  # Azure OpenAI or GitHub Models
    name="PayrollAgent",
    instructions="You are a payroll agent that executes batch crypto payments on Base.",
    tools=[estimate_batch, execute_batch, get_token_info, check_transaction],
)
Language/SDK

Python

Lingua principale
Python
Stelle
13.6k
Fork
2.3k
Merge medio
1g 15h
PR unite (30g)
438

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di microsoft/agent-framework

Tutte le issue di microsoft/agent-framework

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.