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

فصل أدوات عن وكيل

POST https://api.echonova.ai/v1/agents/{agentId}/tools/detach

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

Headers

Authorization string مطلوب

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

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

agentId string مطلوب

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

متن الطلب

application/json

toolIds array of string مطلوب

معرّفات أدوات مساحة العمل، من 1 إلى 20، كما تعرضها `GET /v1/agents/{agentId}/tools`.

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

POST /v1/agents/{agentId}/tools/detach

curl -X POST "https://api.echonova.ai/v1/agents/{agentId}/tools/detach" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toolIds":["6654a1b2c3d4e5f6a7b8c9d0"]}'

{
  "data": {
    "system": [
      {
        "key": "web_search",
        "name": "Web search",
        "enabled": true
      }
    ],
    "attached": [
      {
        "id": "6654a1b2c3d4e5f6a7b8c9d0",
        "name": "CRM lookup",
        "type": "webhook",
        "description": "Looks up a customer by phone number."
      }
    ]
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}