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

Đang mở
  • Có gì không ổn?
#115 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
python
Lĩnh vực
backend-api-design, distributed-systems, testing

Hướng nghiên cứu

Bắt đầu bằng cách xem xét các sample hiện có trong 07.Workflow và các ví dụ của repository về multi-agent routing, concurrent workflow, MCP và tracing. Xác nhận với các maintainer về ngôn ngữ và vị trí được ưu tiên trước khi triển khai. Được xem là hoàn tất khi sample và các test thể hiện single admission, durable resume, xử lý kết quả không rõ ràng mà không replay, retry tường minh đối với lỗi đã biết và sự phân biệt evidence đã nêu.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
Jupyter Notebook
Star
390
Fork
150
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của microsoft/Agent-Framework-Samples

Tất cả issue của microsoft/Agent-Framework-Samples

Issue tương tự

Thêm issue về Backend & API Design

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.