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

Sample proposal: reliable multi-agent handoffs with checkpoints and safe retries

Aperta
  • Qualcosa non va?
#115 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
python
Ambito
backend-api-design, distributed-systems, testing

Direzione di ricerca

Inizia esaminando gli esempi esistenti in 07.Workflow e gli esempi del repository relativi a multi-agent routing, concurrent workflow, MCP e tracing. Conferma con i maintainer il linguaggio e la posizione preferiti prima dell'implementazione. Il lavoro è completato quando l'esempio e i test dimostrano single admission, durable resume, la gestione dei risultati ambigui senza replay, un retry esplicito per i fallimenti noti e la distinzione dell'evidence indicata.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Why

The repository already demonstrates multi-agent routing, concurrent workflows, MCP, and tracing. A useful production-oriented addition would cover a harder failure mode: a worker completes an external action, but its response is lost. A coordinator that treats this as an ordinary failure can retry the handoff and duplicate the action.

Proposed sample

Add a small, provider-neutral multi-agent workflow (under 07.Workflow, or another maintainer-preferred location) with a coordinator, two competing workers, a mock destination, and a reliability-sidecar boundary:

  1. The coordinator derives a stable workflow/action key and writes a shared checkpoint before handoff.
  2. Two workers race to claim the same duplicate-sensitive action; atomic admission allows only one to execute it.
  3. The sample injects a timeout after the mock destination records the result but before the worker returns.
  4. Recovery treats the result as ambiguous, reads back the destination, records evidence, and resumes without replaying the action.
  5. A verifier advances the checkpoint only after evidence is present and reports the proof scope honestly.

The output/tests should show:

  • two contenders, one admitted execution, and one destination record;
  • restart/resume from a durable checkpoint;
  • no automatic retry of an ambiguous result;
  • a retry only after an explicit known-failure policy; and
  • the distinction between caller-reported evidence and independently verified proof.

Portability

The sample could define a minimal ReliabilityBackend protocol (claim/admit, checkpoint, transition, status) with a deterministic local adapter for tests. A remote MCP adapter would be optional, so the pattern is not tied to a vendor. Agent Enhancer Utilities is one free, no-auth reference implementation, but the sample would remain runnable without it and document the semantics rather than a product.

No real email, ticket, payment, or other external side effect is needed; a counted mock sink makes the invariant testable.

If this fits the samples roadmap, I can prepare a focused PR after guidance on preferred language (Python, .NET, or both) and placement. I will not open one before maintainer confirmation.

Lingua principale
Jupyter Notebook
Stelle
385
Fork
150
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

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-Samples

Tutte le issue di microsoft/Agent-Framework-Samples

Issue simili

Altre issue su Backend & API Design

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.