الانتقال إلى المحتوى الرئيسي
PATCH
تحديث الوكيل

تحديث وكيل

PATCH /v1/agents/{agentID} يحدث الحقول القابلة للتغيير في هوية وكيل جهاز موجود. يتم تعديل الحقول المقدمة في نص الطلب فقط؛ تظل جميع الحقول الأخرى دون تغيير. يجب توفير حقل واحد على الأقل.
لتغيير نطاقات الوكيل، استخدم نظام التفويض أو أعد تسجيل الوكيل. لا يمكن تعديل النطاقات مباشرة من خلال نقطة النهاية هذه للحفاظ على مسار تدقيق تغييرات النطاق.

المصادقة

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

نص الطلب

جميع الحقول اختيارية، ولكن يجب توفير حقل واحد على الأقل.

الاستجابة

يعرض كائن هوية الوكيل المحدث بالكامل.
string
المفتاح الأساسي UUID الداخلي.
string
معرف وكيل متوافق مع MAIP.
string
اسم العرض المحدث.
string
الوصف المحدث.
object
كائن البيانات الوصفية المحدث.
string
حالة دورة الحياة الحالية بعد التحديث.
string
طابع زمني ISO 8601 يعكس التحديث.

مثال

التفويضات

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

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

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

agentId
string<uuid>
مطلوب

معرف الوكيل

الجسم

application/json
description
string | null
display_name
string | null
Maximum string length: 256
metadata
any
status
string | null

الاستجابة

تم تحديث الوكيل

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>