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

قائمة الوكلاء

GET /v1/agents يُرجع قائمة مُصفحة بهويات وكلاء الجهاز المسجلين تحت المستأجر المصادق عليه. يمكن تصفية النتائج حسب نوع الوكيل، والحالة، ومستوى الثقة. تُرجع الوكلاء بترتيب زمني عكسي (الأحدث أولاً).

المصادقة

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

الاستجابة

object[]
مصفوفة من كائنات هوية الوكيل. يحتوي كل كائن على سجل الوكيل الكامل بما في ذلك agent_id، agent_type، display_name، status، trust_level، trust_score, scopes, public_key, key_id, metadata, delegation_depth، created_at، و updated_at.
integer
العدد الإجمالي للوكلاء المطابقين لمعايير التصفية، عبر جميع الصفحات.

مثال

التفويضات

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

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

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

agent_type
enum<string>

تصفية حسب نوع الوكيل

الخيارات المتاحة:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
status
enum<string>

تصفية حسب حالة الوكيل

الخيارات المتاحة:
active,
suspended,
revoked
trust_level
string
limit
integer

الحد الأقصى لعدد الوكلاء المراد إرجاعهم

النطاق المطلوب: 1 <= x <= 100
offset
integer

عدد الوكلاء لتخطي

النطاق المطلوب: x >= 0

الاستجابة

قائمة الوكلاء المقسمة على صفحات

items
object[]
total
integer