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

مقارنة الوكلاء

GET https://api.echonova.ai/v1/agents/compare

تعيد من 2 إلى 4 وكلاء جنبًا إلى جنب، ولكل وكيل أرقامه للأيام الثلاثين الأخيرة. يحتاج المفتاح إلى النطاق `agents:read`.

Headers

Authorization string مطلوب

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

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

ids string مطلوب

من 2 إلى 4 معرّفات وكلاء مختلفة، مفصولة بفواصل.

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

GET /v1/agents/compare

curl "https://api.echonova.ai/v1/agents/compare?ids=6650a1b2c3d4e5f6a7b8c9d0%2C6650a1b2c3d4e5f6a7b8c9d1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "agents": [
      {
        "id": "6650a1b2c3d4e5f6a7b8c9d0",
        "name": "Sales assistant",
        "description": "Answers questions about plans and prices.",
        "status": "active",
        "voice": {
          "id": "6640a1b2c3d4e5f6a7b8c9d0",
          "name": "Huda"
        },
        "dialect": "emirati",
        "llm": {
          "provider": "openai",
          "model": "gpt-4o"
        },
        "channelsCount": 2,
        "sessionsCount": 128,
        "updatedAt": "2026-11-01T10:00:00.000Z",
        "firstMessage": "Hello, how can I help you today?",
        "systemPrompt": "You are a friendly sales assistant for EchoNova.",
        "settings": {
          "recordCalls": true,
          "normalizeNumbers": true
        },
        "knowledgeCount": 3,
        "toolsCount": 2,
        "createdAt": "2026-10-01T10:00:00.000Z"
      }
    ],
    "overview": {
      "6650a1b2c3d4e5f6a7b8c9d0": {
        "voiceCalls": 42,
        "textConversations": 86,
        "uniqueCustomers": 97,
        "resolvedPct": 81,
        "avgCallDurationSeconds": 95,
        "creditsUsedThisMonth": 1200,
        "replyP50Ms": 850,
        "replyP95Ms": 1900
      },
      "6650a1b2c3d4e5f6a7b8c9d1": {
        "voiceCalls": 10,
        "textConversations": 12,
        "uniqueCustomers": 20,
        "resolvedPct": 70,
        "avgCallDurationSeconds": 80,
        "creditsUsedThisMonth": 300,
        "replyP50Ms": 900,
        "replyP95Ms": null
      }
    }
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}