تجريبي
واجهة الوكلاء الصوتيين
تصفّح التوثيق
الوكلاء الصوتيون
الوكيل المخزّن يحمل الشخصية والصوت والتحية وإعدادات المكالمة، فتُسمّي كل مكالمة معرّفًا بدل إعادة تركيب الإعدادات. الواجهة مقيدة بالمالك: GET /v1/agents تعرض وكلاءك، وPATCH وDELETE يعملان على /v1/agents/{agent_id}.
POST /v1/agents
namestringاسم الوكيل، من ١ إلى ٨٠ حرفًا.
system_promptstringشخصية الوكيل الكاملة — من هو وكيف يتحدث.
first_messagestring?تُنطق حرفيًا في أول دور للوكيل.
voice_idstring?معرّف صوت من GET /v1/voices يتحدث به الوكيل.
settingsobject?إعدادات الوكيل: كشف الدور، والصبر، وmax_duration_seconds (١٠–٣٦٠٠)، والتسجيل، والتعليقات الصوتية.
| الحقل | النوع | ملاحظات |
|---|---|---|
| name | string | اسم الوكيل، من ١ إلى ٨٠ حرفًا. |
| system_prompt | string | شخصية الوكيل الكاملة — من هو وكيف يتحدث. |
| first_message | string? | تُنطق حرفيًا في أول دور للوكيل. |
| voice_id | string? | معرّف صوت من GET /v1/voices يتحدث به الوكيل. |
| settings | object? | إعدادات الوكيل: كشف الدور، والصبر، وmax_duration_seconds (١٠–٣٦٠٠)، والتسجيل، والتعليقات الصوتية. |
GET /v1/agents
PATCH /v1/agents/{agent_id}
DELETE /v1/agents/{agent_id}
curl -X POST https://api.sawtakarabi.ai/v1/agents \ -H "Authorization: Bearer $SAWTAK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "أم العجلان", "system_prompt": "أنت راوية حكايات…", "voice_id": "<voice_id>"}'