יחידה SKILL-REPLAY · SYSTM Daily Public Lab
סקיל בדיקת Replay לפעולת סוכן
Daily Public Lab · 2026-09-14סקיל לשימוש חוזר עם קלט ופלט יציבים, fixtures ובדיקות שמכסות execute, reuse-receipt, reconcile וחסימה.
תוכן10
מה מקבלים
סקיל לשימוש חוזר עם קלט ופלט יציבים, fixtures ובדיקות שמכסות execute, reuse-receipt, reconcile וחסימה.
כלל ההחלטה
operation_id חדש עם payload_hash תקין מסווג execute. מזהה קיים עם אותו hash וקבלה קודמת מסווג reuse-receipt; hash שונה נחסם; מצב unknown מסווג reconcile ואינו מאשר retry אוטומטי.
מה הכלי אינו עושה
הוא אינו מבצע פעולות חיצוניות ואינו מבטיח exactly-once. ההחלטה מתייחסת רק למעטפה וליומן שסופקו.
מקורות ראשיים
- OpenAI Agents SDK — Models — Tool execution and attribution; Model retries — ללא תאריך פרסום מוצג; נבדק 2026-09-14.
- OpenAI Agents SDK — Sessions — Make custom persistence atomic and idempotent — ללא תאריך פרסום מוצג; נבדק 2026-09-14.
- IETF / RFC Editor — RFC 9110: HTTP Semantics — Idempotent Methods — פורסם 2022-06; נבדק 2026-09-14.
- Amazon Web Services — Making retries safe with idempotent APIs — פורסם 2021-01-15; נבדק 2026-09-14.
המפרט
- הרצה
- Node.js, מקומית וללא רשת או מודל
- קלט
- action-envelope.json ויומן קבלות JSON
- פלט
- execute / reuse-receipt / reconcile / block
- מגבלה
- שער החלטה מקומי; לא הבטחת exactly-once ולא ביצוע הפעולה
שלוש הדקות הראשונות
1
מורידים ובודקיםפותחים את הקובץ המצורף ומריצים את בדיקת ה-smoke ואת דוגמת המעטפה.
node test/smoke.mjs
node bin/idempotency-check.mjs fixtures/action-envelope.json fixtures/receipts-empty.json2
מקבעים זהות פעולהיוצרים operation_id יציב ונגזרת payload_hash קנונית לפני ניסיון הביצוע הראשון.
3
מכבדים את ההחלטהמבצעים רק ב-execute, מחזירים קבלה ב-reuse-receipt, מיישבים reconcile ועוצרים ב-block.
פקודת התחלה
node test/smoke.mjs
node bin/idempotency-check.mjs fixtures/action-envelope.json fixtures/receipts-empty.jsonגבול הבדיקה
הפלט הוא החלטה מקומית לפי המעטפה ויומן הקבלות שסופקו. הכלי אינו מבצע, שולח, מעדכן, מוחק או מחייב.
קבצים להורדה
איפה זה נכנס אצלנו
החבילה מספקת שער מקומי לפני פעולה בעלת תופעת לוואי. היא מסווגת retry לפי מזהה, hash וקבלה שמורה בלי לטעון לתאימות רשמית או להבטחת exactly-once.