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

إنشاء وكيل

POST https://api.echonova.ai/v1/agents

تُنشئ وكيلًا نشطًا في مساحة العمل الخاصة بهذا المفتاح، باسم وتعليمات و1 إلى 4 أصوات ونموذج لغة. ليس للوكيل قناة بعد، لذلك لا يستقبل مكالمات حتى تربطه بقناة. أرسل `Idempotency-Key` لإعادة المحاولة بأمان. مجانًا. يحتاج المفتاح إلى النطاق `agents:write`.

Headers

Authorization string مطلوب

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

Idempotency-Key string اختياري

اختياري. كرّر المفتاح نفسه خلال 24 ساعة لإعادة المحاولة بأمان: تعود النتيجة الأولى، ولا يُنشأ شيء مرتين. الطلب الجديد يحتاج إلى مفتاح جديد.

متن الطلب

application/json

name string مطلوب

اسم الوكيل.

من 1 إلى 100 حرفًا
description string اختياري

الغرض من الوكيل.

حتى 500 حرفًا
systemPrompt string مطلوب

التعليمات التي يتبعها الوكيل في كل محادثة.

من 1 إلى 8000 حرفًا
firstMessage string اختياري

ما يقوله الوكيل أولًا عند بدء المحادثة.

حتى 500 حرفًا
voices array of objects مطلوب

الأصوات التي يتحدث بها الوكيل، من 1 إلى 4.

llmModel string مطلوب

معرّف نموذج من `GET /v1/llm/models`.

من 1 إلى 100 حرفًا

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

POST /v1/agents

curl -X POST "https://api.echonova.ai/v1/agents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sales assistant","systemPrompt":"You are a friendly sales assistant. Answer in the caller language.","voices":"string","llmModel":"gpt-4o"}'

{
  "data": {
    "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"
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}