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

عرض جولة اختبار

GET https://api.echonova.ai/v1/agents/{agentId}/test-runs/{testRunId}

تعيد جولة اختبار واحدة للوكيل مع حالتها والمحادثة حتى الآن. يظل الاختبار المكتوب مسبقًا `running` إلى أن يُجاب عن كل رسالة، ثم يصبح `passed` أو `failed` أو `incomplete`. يحتاج المفتاح إلى النطاق `agents:read`.

Headers

Authorization string مطلوب

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

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

agentId string مطلوب

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

testRunId string مطلوب

معرّف الاختبار كما أعادته `GET /v1/agents/{agentId}/test-runs`.

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

GET /v1/agents/{agentId}/test-runs/{testRunId}

curl "https://api.echonova.ai/v1/agents/{agentId}/test-runs/{testRunId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "6655a1b2c3d4e5f6a7b8c9d0",
    "kind": "chat",
    "status": "passed",
    "startedAt": "2026-11-03T10:00:00.000Z",
    "endedAt": "2026-11-03T10:01:00.000Z",
    "latencyMs": 800,
    "replyP50Ms": 700,
    "replyP95Ms": 1200,
    "turns": 4,
    "toolsTriggered": 1,
    "toolsTotal": 2,
    "plannedTurns": 2,
    "messages": [
      {
        "id": "6652a1b2c3d4e5f6a7b8c9d0",
        "direction": "inbound",
        "sender": "customer",
        "text": "How much is the Pro plan?",
        "createdAt": "2026-11-02T10:00:01.000Z"
      }
    ]
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}