الوكلاء والإصدارات
أنشئ دورًا وعدّل مسودّته وانشر إصدارًا يمكنك مراجعته.
مسودة وتشغيل وإيقاف مؤقّت
ينشئ الوكيل الجديد مسودّة أولية ولا يبدأ التنفيذ. حفظ المسودّة لا ينشرها. يفحص التحقّق الشروط المهيّأة، ثم ينشئ النشر إصدارًا ثابتًا ويجعله الإصدار النشط.
اقرأ draft_version قبل التعديل أو النشر. يتسبّب الإصدار القديم في تعارض بدلًا من الكتابة فوق عمل شخص آخر. يتحكّم الإيقاف والاستئناف في حالة الوكيل دون حذف سجلّ إصداراته.
نقاط الوصول
| Method | Path | Scope |
|---|---|---|
| GET | /v1/agents | read |
| POST | /v1/agents | write |
| GET | /v1/agents/{id} | read |
| GET | /v1/agents/{id}/draft | read |
| PATCH | /v1/agents/{id}/draft | write |
| POST | /v1/agents/{id}/draft/validate | read |
| POST | /v1/agents/{id}/publish | write |
| GET | /v1/agents/{id}/revisions | read |
| POST | /v1/agents/{id}/pause | write |
| POST | /v1/agents/{id}/resume | write |
أنشئ مسودّة باسم واضح
يعيد إنشاء الوكيل 201 ومسودّة أولية قابلة للتعديل، ولا يشغّل التنفيذ. اختر اسمًا يصف المهمة، ثم اضبط المسودّة في مساحة عملك.
curl -X POST "$MUWKL_BASE_URL/v1/agents" \
-H "Authorization: Bearer $MUWKL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $AGENT_REQUEST_ID" \
-d '{"name":"Customer care"}'تحقّق قبل النشر
أرسل POST إلى draft/validate بصلاحية read وكائن JSON فارغ. هذه عملية قراءة ولا تحتاج إلى Idempotency-Key. قد تتضمّن استجابة 200 القيمة valid: false. راجع failures وvalidation_scope؛ اجتياز الفحوص المنفّذة لا يفعّل التنفيذ أو القناة.
curl -X POST "$MUWKL_BASE_URL/v1/agents/$AGENT_ID/draft/validate" \
-H "Authorization: Bearer $MUWKL_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'اقرأ المسودّة الحالية
اقرأ المسودّة قبل تعديلها. يمثّل configuration المسودّة المحفوظة وقد لا يجتاز التحقّق من النشر بعد. استخدم رقم الإصدار المسترجع للتعديل التالي.
curl "$MUWKL_BASE_URL/v1/agents/$AGENT_ID/draft" \
-H "Authorization: Bearer $MUWKL_API_KEY"راجع سجلّ الإصدارات
تُعرض الإصدارات بترتيب تنازلي. القيمة الافتراضية لـ limit هي 25 والنطاق من 1 إلى 100. استخدم before كمؤشّر حصري لرقم الإصدار؛ تكون next_cursor فارغة في الصفحة غير المكتملة. سجلّ الإعداد ونتائج التنفيذ سجلات مختلفة.
واجهت صعوبة؟ تواصل معنا