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

تسجيل وكيل

POST /v1/agents يسجل هوية وكيل آلي جديدة للمستأجر المصادق عليه. تنشئ المنصة زوج مفاتيح Ed25519 للوكيل، وتخصص معرف وكيل متوافق مع MAIP، وتسجل المفتاح الأولي في دفتر سجل تاريخ المفاتيح. تبدأ الوكلاء المسجلون حديثًا بحالة active ودرجة ثقة أولية تبلغ 0.500.
يعتمد عدد الوكلاء الذين يمكنك تسجيلهم على خطة الفوترة الخاصة بك. إذا كنت تجاوز حد خطتك، تُرجع واجهة برمجة التطبيقات 402 Payment Required. اتصل بالمبيعات لحدود وكيل مستوى المؤسسة.

المصادقة

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

الاستجابة

string
المفتاح الأساسي UUID الداخلي.
string
معرف وكيل متوافق مع MAIP بالتنسيق maip:<tenant8>:<ulid>. استخدم هذه القيمة في جميع استدعاءات API اللاحقة التي تشير إلى هذا الوكيل.
string
معرف UUID للمستأجر المالك.
string
نوع الوكيل المسجل.
string
اسم الوكيل المقروء بشريًا.
string
وصف الوكيل، إذا تم توفيره.
string
مستوى الثقة الأولي. يبدأ الوكلاء المسجلون حديثًا عند "authenticated".
number
درجة الثقة الرقمية (0.0 إلى 1.0). يبدأ الوكلاء المسجلون حديثًا عند 0.500.
string
حالة دورة حياة الوكيل. دائمًا "active" عند الإنشاء.
string
مفتاح Ed25519 العام المشفر بـ Base64url الذي تم إنشاؤه لهذا الوكيل. قم بتخزين هذا بأمان للتحقق من التوقيع.
string
معرف فريد لمفتاح توقيع الوكيل. مشار إليه في الإيصالات و الشهادات.
string[]
النطاقات الفعالة المخصصة للوكيل.
object
كائن البيانات الوصفية، إذا تم توفيره.
number
عمق سلسلة التفويض الحالي. دائمًا 0 للوكلاء المسجلين مباشرة. الحد الأقصى للعمق هو 8 لكل بروتوكول MAIP.
string
معرف UUID للمستخدم الذي سجل الوكيل، إذا تم المصادقة عبر رمز المستخدم.
string
طابع زمني للانتهاء، إذا تم تعيينه.
string
طابع زمني لإنشاء ISO 8601.
string
طابع زمني لآخر تحديث ISO 8601.

مثال

التفويضات

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

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

الجسم

application/json
display_name
string
مطلوب

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

Maximum string length: 256
agent_type
enum<string>

تصنيف الوكيل

الخيارات المتاحة:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
description
string

وصف نصي حر لغرض الوكيل

expires_at
string<date-time> | null
metadata
any

بيانات وصفية عشوائية على شكل مفتاح-قيمة

scopes
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>