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

الحصول على وكيل

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

المصادقة

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

الاستجابة

string
المفتاح الأساسي UUID الداخلي.
string
معرف وكيل متوافق مع MAIP.
string
معرف UUID للمستأجر المالك.
string
تصنيف نوع الوكيل.
string
اسم الوكيل المقروء بشريًا.
string
وصف الوكيل.
string
مستوى التسلسل الهرمي للثقة. أحد الخيارات التالية: "platform_root"، "verified_org"، "verified_individual", "authenticated", "self_asserted", "anonymous".
number
درجة الثقة الرقمية بين 0.0 و 1.0. يتم تعديلها بمرور الوقت بناءً على الوكيل السلوك، واكتشاف الشذوذ، وتاريخ الشهادات.
string
حالة دورة الحياة الحالية: "active"، "suspended"، أو "revoked".
string
مفتاح Ed25519 العام المشفر بـ Base64url لهذا الوكيل.
string
معرف مفتاح فريد للتحقق من توقيع الإيصال والشهادة.
string[]
نطاقات الأذونات المعينة بتنسيق resource:action.
object
بيانات تعريف عشوائية مرفقة بالوكيل.
string
إذا تم إنشاء هذا الوكيل عن طريق التفويض، معرف MAIP للوكيل الأصل.
number
الموضع في سلسلة التفويض (0 = الجذر، الحد الأقصى 8).
string
معرف UUID للمستخدم الذي سجل الوكيل، إن أمكن.
string
طابع زمني ISO 8601 إذا تم وضع علامة على مفتاح الوكيل بأنه مخترق.
string
طابع زمني للانتهاء التلقائي، إذا تم تكوينه.
string
طابع زمني لإنشاء ISO 8601.
string
طابع زمني لآخر تحديث ISO 8601.

مثال

التفويضات

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

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

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

agentId
string<uuid>
مطلوب

معرف الوكيل

الاستجابة

تفاصيل الوكيل

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>