الانتقال إلى المحتوى الرئيسي
POST
تعليق الوكيل

تعليق وكيل

POST /v1/agents/{agentID}/suspend يعلق هوية وكيل آلي، مما يمنعه فورًا من إنشاء جلسات جديدة، أو استدعاء الأدوات، أو تنفيذ أي عمليات مصادقة. التعليق قابل للعكس - يمكن إعادة تنشيط الوكيل عن طريق تحديث حالته مرة أخرى إلى "active" عبر نقطة نهاية التحديث. يتم حظر جميع الجلسات النشطة التابعة للوكيل المعلق بشكل فعال على مستوى التحكم في الوصول. ستفشل رموز الجلسة الموجودة في فحوصات النطاق حتى يتم إعادة تنشيط الوكيل.
التعليق هو الاستجابة الأولى الموصى بها لسلوك الوكيل الشاذ. استخدم إلغاء فقط عندما يكون دائمًا إلغاء التكليف مطلوب.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.

الاستجابة

string
الحالة المحدثة، دائمًا "suspended" عند النجاح.
string
معرف وكيل MAIP الذي تم تعليقه.

مثال


إعادة تنشيط وكيل معلق

لاستعادة وكيل معلق إلى حالة نشطة، استخدم نقطة النهاية PATCH /v1/agents/:

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

معلمات المسار

agentId
string<uuid>
مطلوب

معرف الوكيل

الجسم

application/json
reason
string
مطلوب

سبب التعليق المقروء بشريًا

الاستجابة

تم تعليق الوكيل

id
string<uuid>
agent_type
enum<string>
الخيارات المتاحة:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
الخيارات المتاحة:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
النطاق المطلوب: 0 <= x <= 1
public_key
string

المفتاح العام المشفر بـ Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>