وكلاء الذكاء الاصطناعي
وكلاء الذكاء الاصطناعي في DYPAI مواطنون من الدرجة الأولى في خلفيتك. يندمجون في نظام سير العمل نفسه ككل شيء آخر، ويستدعون endpoints الموجودة كـ أدوات، ويتذكّرون المحادثات، ويبثون الردود إلى واجهتك، ويعملون مع DYPAI Managed AI و OpenAI و Anthropic أو Gemini — بالتبادل.
لا إعداد إضافي
الوكلاء مجرد نوع عقدة. أسقط واحداً في سير عمل واختر مزوّداً ونموذجاً وأرفق أدوات اختيارياً واكشفه كـ endpoint. مع DYPAI Managed AI لا تحتاج حتى مفتاح API — هو الافتراضي دون إعداد. تتحدث واجهتك إلى الوكيل بخطاف useChat من SDK.
ما الذي يميّز وكلاء DYPAI
الأدوات = endpoints لديك
أي endpoint معلَّم كأداة يصبح قابلاً للاستدعاء من الوكيل. أعد استخدام الكود نفسه الذي يشغّل واجهتك.
مستقل عن النموذج
استخدم DYPAI Managed AI دون مفتاح API، أو أحضر مفاتيح OpenAI و Anthropic و Gemini. بدّل بتغيير حقل واحد — دون إعادة كتابة كود.
ذاكرة مضمّنة
ذاكرة لكل جلسة أو لكل مستخدم، مخزَّنة في قاعدة بيانات مشروعك. لا حاجة لقاعدة متجهات خارجية للدردشة البسيطة.
بث جاهز للاستخدام
يعرض خطاف useChat() في SDK الردود الجزئية أثناء وصولها. وصّل وشغّل.
كيف يعمل الوكيل
استقبال رسالة
ترسل واجهتك رسالة مستخدم إلى endpoint وكيل عبر SDK.
تحميل الذاكرة (اختياري)
إذا كانت الذاكرة مفعّلة، تُحمَّل الرسائل السابقة للجلسة أو المستخدم تلقائياً.
التفكير والقرار
يقرأ LLM توجيه النظام وسجل المحادثة والأدوات المتاحة. يقرر ما إذا كان يجيب مباشرة أو يستدعي أداة.
استدعاء الأدوات إن لزم
عندما يريد الوكيل بيانات أو تنفيذ إجراء، يستدعي إحدى endpoints أدواتك. تُعاد النتيجة إلى المحادثة.
التكرار حتى الانتهاء
تعمل الحلقة حتى max_iterations مرة (الافتراضي 5). يمكن لكل تكرار أن يتضمن استدعاء أداة آخر أو إجابة نهائية.
الإرجاع والحفظ
يُرجع الرد النهائي إلى واجهتك. إذا كانت الذاكرة مفعّلة، تُحفظ المحادثة تلقائياً.
مثال سريع
إليك الحد الأدنى لإعداد مساعد دردشة يمكنه الاستعلام عن جدول tasks. يستخدم المسار السعيد DYPAI Managed AI، فلا مفتاح API لإضافته.
1. أنشئ endpoint أداة
ابنِ endpoint عادياً اسمه list_tasks يُرجع مهاماً من قاعدة بياناتك. في رأس endpoint، فعّل مفتاح Tool واكتب وصفاً قصيراً للوكيل:
"Lists all tasks for the current user. Returns an array of
{id, title, done, due_date}."
2. أنشئ endpoint الوكيل
أنشئ endpoint بعقدة AI Agent واحدة:
| الحقل | القيمة |
|---|---|
| Provider | DYPAI Managed |
| Model | gpt-5-nano |
| System prompt | You are a helpful task assistant. Use the tools available to answer questions about the user's tasks. |
| Tools | Select list_tasks |
| Memory | Per User |
تريد استخدام مفتاحك بدلاً من ذلك؟
تفضّل BYOK؟ أضف مفتاح OpenAI / Anthropic / Gemini تحت Credentials، اضبط المزوّد عليه، واختر بيانات الاعتماد في عقدة الوكيل. تدفع بعد ذلك للمزوّد مباشرة — راجع النماذج والمزوّدون.
3. استدعِه من واجهتك
import { useChat } from '@dypai-ai/client-sdk/react'
function ChatBox() {
const { messages, sendMessage, isLoading } = useChat('task_assistant')
return (
<div>
{messages.map((m, i) => (
<div key={i}>{m.role}: {m.content}</div>
))}
<button onClick={() => sendMessage('What tasks are due this week?')}>
Ask
</button>
</div>
)
}
هذا كل شيء. سيستدعي الوكيل list_tasks ويقرأ النتائج ويجيب بلغة طبيعية — مع البث إلى الواجهة.
الذكاء الاصطناعي المدار يُقاس كأرصدة ذكاء اصطناعي
عندما تستخدم DYPAI Managed AI، يُفوتر استخدام رموز الوكيل كـ أرصدة ذكاء اصطناعي (الوحدة نفسها التي تشغّل البناء والتعديل). تبقى تطبيقاتك المنشورة مباشرة بغض النظر عن رصيد الأرصدة. راجع أرصدة الذكاء الاصطناعي والذكاء الاصطناعي المدار للتفاصيل.
بناء الوكلاء من بيئة التطوير
يمكن إعداد كل ما سبق عبر MCP بدلاً من ذلك. أخبر مساعد الذكاء الاصطناعي فقط:
"Create a chat assistant that can list and create tasks. Use Gemini 2.5 Flash. Turn the
list_tasksandcreate_taskendpoints into tools and attach them to the agent."
سيضبط بيانات الاعتماد ويعلّم endpoints كأدوات وينشئ endpoint الوكيل ويختبره من البداية إلى النهاية.
إلى أين تذهب بعد ذلك
الأدوات
حوّل أي endpoint إلى أداة. مخططات إدخال وحواجز وحدود.
النماذج
Managed AI و OpenAI و Anthropic و Gemini — اختيار النموذج المناسب للمهمة.
الذكاء الاصطناعي المدار
شغّل وكلاء دون مفتاح API، تُفوتر كأرصدة ذكاء اصطناعي.
توليد الصور
ولّد صوراً من عقدة سير عمل؛ تصل المخرجات إلى التخزين.
الذاكرة
ذاكرة محادثة لكل جلسة ولكل مستخدم.
البث
وصّل الوكيل بواجهتك بـ useChat.