المطورون / الوكلاء

ضبط بحث قاعدة معرفة الوكيل

PATCH https://api.echonova.ai/v1/agents/{agentId}/rag

تفعّل الإجابة من قاعدة المعرفة أو توقفها، وتضبط عدد المقاطع التي يقرؤها ومدى قربها من السؤال. الحقول التي تتركها تحتفظ بقيمتها. مجانًا. يحتاج المفتاح إلى النطاق `agents:write`.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

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

agentId string مطلوب

معرّف الوكيل كما أعادته `GET /v1/agents`.

متن الطلب

application/json

enabled boolean مطلوب

هل يجيب الوكيل من قاعدة معرفته.

topK integer اختياري

عدد مقاطع المعرفة التي تُقرأ لكل إجابة.

من 1 إلى 20
minSimilarity number اختياري

مدى قرب المقطع من السؤال ليُستخدم، من 0 إلى 1.

من 0 إلى 1

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

PATCH /v1/agents/{agentId}/rag

curl -X PATCH "https://api.echonova.ai/v1/agents/{agentId}/rag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true}'

{
  "data": {
    "enabled": true,
    "topK": 5,
    "minSimilarity": 0.3
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}