سونا AI: الوكيل العام للذكاء الاصطناعي مفتوح المصدر

مجال الذكاء الاصطناعي يتحرك بشكل متزايد نحو وكلاء يمكنهم القيام بأكثر من مجرد معالجة المعلومات - يمكنهم التحرك. تظهر Suna AI في هذا الفضاء كوكيل ذكاء اصطناعي عام ومفتوح المصدر يجذب الانتباه، مصمم ليعمل كرفيق رقمي قادر على فهم التعليمات باللغة الطبيعية وتنفيذ المهام المعقدة في العالم الواقعي بشكل مباشر نيابة عنك. تم تطويره بواسطة Kortix AI وتم إصداره بموجب ترخيص Apache 2.0 المخفف، وتتميز Suna بدمج مجموعة قوية من الأدوات مع واجهة محادثة، بهدف سد الفجوة بين نية المستخدم والعمل الرقمي الملموس.

على عكس أدوات الذكاء الاصطناعي المتخصصة، تكمن قوة Suna في مرونتها. تم بناؤها لتنظيم قدرات متنوعة - من تصفح الويب وإدارة الملفات إلى تنفيذ التعليمات البرمجية والتفاعل مع واجهات برمجة التطبيقات - جميعها مدفوعة بإشعاراتك المحادثية. يوفر هذا المقال نظرة عامة على قدرات Suna الأساسية وهندستها، يليه دليل تفصيلي خطوة بخطوة حول كيفية إعداد وتشغيل مثيلك المحلي، مما يمكّنك من الاستفادة من هذا الوكيل القوي في بيئتك الخاصة.

💡

هل ترغب في أداة اختبار واجهة برمجة التطبيقات رائعة تنتج وثائق واجهة برمجة التطبيقات الجميلة?

هل ترغب في منصة متكاملة، شاملة، لفريق المطورين الخاص بك للعمل معًا بأقصى ميزة إنتاجية?

تقدم Apidog جميع طلباتك، وتحل محل Postman بسعر أكثر قابلية للتحمل بكثير!

زر

ما هو Suna AI وكيف يعمل Suna AI؟

لفهم ما يمكن أن تفعله Suna، من الضروري أن نفهم الأدوات التي تمتلكها. تسمح هذه القدرات لها بالتفاعل مع العالم الرقمي مثل المستخدم البشري، ولكن بطريقة مؤتمتة ومدفوعة بالذكاء الاصطناعي.

أتمتة المتصفح (عبر Playwright): يمكن لـ Suna تشغيل والتحكم في مثيل متصفح ويب داخل بيئتها الآمنة. وهذا يعني أنها يمكنها التنقل إلى عناوين URL محددة، وتسجيل الدخول إلى مواقع الويب (إذا تم توفير بيانات الاعتماد بشكل آمن)، والنقر على الأزرار، وملء النماذج، والتمرير عبر الصفحات، والأهم من ذلك، استخراج البيانات مباشرة من محتوى صفحات الويب. تفتح هذه القدرة الكم الهائل من المعلومات والوظائف المتاحة على الويب للأتمتة.
إدارة الملفات: الوكيل ليس محدودًا فقط بالبيانات على الويب. لديه القدرة على التفاعل مع نظام الملفات داخل بيئته المنعزلة. وهذا يشمل إنشاء ملفات جديدة (مثل التقارير أو تصديرات البيانات)، وقراءة الوثائق الحالية، وتحرير محتواها، وتنظيم الملفات في أدلة. هذا أمر حيوي للمهام التي تتضمن إنشاء مخرجات أو معالجة بيانات محلية.
زحف الويب & البحث المعزز: بالإضافة إلى تصفح صفحة واحدة، يمكن لـ Suna الزحف المنتظم إلى المواقع (متبعًا الروابط) لجمع معلومات شاملة. يمكنها أيضًا التكامل مع واجهات برمجة تطبيقات البحث المخصصة (مثل تكامل Tavily الاختياري) لأداء استرجاع معلومات يستهدف بشكل أكثر تطورًا من استخدام محركات البحث العادية، مما يتيح قدرات بحث أعمق.
تنفيذ سطر الأوامر: داخل حاوية Docker الآمنة الخاصة بها، تتمتع Suna بالقدرة على تنفيذ أوامر shell. تسمح هذه الميزة القوية لها بتشغيل البرامج النصية، واستخدام وحدات سطر الأوامر الأخرى، والتفاعل مع موارد النظام (ضمن حدود الحاوية)، وقد تعمل على أتمتة المهام مثل بناء البرنامج أو النشر إذا تم تكوينها بشكل ملائم. الأمان هو الأهم هنا، يتم التعامل معه بواسطة البيئة المعزولة.
تكامل واجهة برمجة التطبيقات (عبر RapidAPI & المكالمات المباشرة): يمكن لـ Suna إجراء مكالمات إلى واجهات برمجة التطبيقات الخارجية. وهذا يسمح لها بالاتصال بنظام بيئي واسع من الخدمات التابعة. تسلط الوثائق الضوء على تكامل RapidAPI الاختياري، مما يمكّن الوصول إلى موفري بيانات مختلفين (مثل بيانات LinkedIn، المعلومات المالية، إلخ)، ولكن يمكن أيضًا تكوينها للتفاعل مباشرة مع واجهات برمجة التطبيقات RESTful الأخرى، مما يزيد بشكل كبير من إمكانياتها في جمع البيانات واتخاذ الإجراءات.
تفسير الشفرات البرمجية: تشمل Suna القدرة على تنفيذ مقاطع من الشفرات (أساسًا بايثون) داخل بيئتها الآمنة. هذا ليس فقط لتشغيل النصوص الموجودة، ولكن يسمح للوكيل بإنشاء رمز ديناميكيًا وتشغيله لأداء عمليات حسابية معقدة، تحليل البيانات، معالجة المنطق المخصص، أو التحولات التي تتجاوز قدرات أدواتها الأخرى.

تكمن القوة الحقيقية لـ Suna في قدرة الذكاء الاصطناعي على اختيار وتنسيق هذه الأدوات بشكل مناسب استنادًا إلى طلب المستخدم. قد تؤدي تعليمات واحدة إلى تنشيط سير عمل يتضمن البحث على الويب، استخراج البيانات، معالجتها باستخدام الشفرة المفسرة، تنسيق النتيجة في ملف، وحفظها - كل ذلك يتم إدارته بواسطة الوكيل.

بنية Suna: المكونات المعنية

لفهم عملية الإعداد، يتطلب الأمر فهمًا أساسيًا للمكونات المعمارية الرئيسية لـ Suna:

واجهات برمجة التطبيقات الخلفية (بايثون/FastAPI): المنطق الأساسي هنا. يدير طلبات المستخدمين، ويحافظ على حالة المحادثة، وينظم استخدام الوكيل للأدوات، ويتولى الاتصال مع نموذج اللغة الكبير المختار (LLM) عبر LiteLLM (مما يوفر مرونة مع مزودين مثل OpenAI وAnthropic).
الواجهة الأمامية (Next.js/React): هذا هو التطبيق الويب الموجه للمستخدم. يوفر واجهة محادثة للتفاعل مع Suna، ويعرض النتائج، ويشمل عناصر لوحة التحكم لمراقبة نشاط الوكيل.
بيئة Docker للوكيل (عبر Daytona): الأمان والعزلة أمران حاسمان. تعمل كل مهمة وكيل داخل حاوية Docker مخصصة يتم إدارتها بواسطة Daytona. تحتوي هذه الحاوية على جميع الأدوات الضرورية (متصفح، مفسر الشفرة، الوصول إلى نظام الملفات) وتمنع الوكيل من التدخل في النظام المضيف.
قاعدة بيانات Supabase (PostgreSQL): تتولى جميع احتياجات الحفاظ على البيانات، بما في ذلك حسابات المستخدمين والمصادقة، تاريخ المحادثات، التخزين للملفات التي تم إنشاؤها بواسطة الوكيل، تتبع حالة الوكيل، وربما التحليلات.

تعمل هذه المكونات معًا، تتواصل عبر واجهات برمجة التطبيقات، لتقديم تجربة Suna. يتطلب إعداد الاستضافة الذاتية تكوين وتشغيل هذه الأجزاء المتصلة.

كيف يمكن إعداد Suna AI

تشغيل Suna بنفسك يوفر أكبر قدر من التحكم والخصوصية. الخطوات التالية توجهك خلال عملية الإعداد:

المرحلة 1: جمع المتطلبات الأساسية

قبل تثبيت Suna، تحتاج إلى العديد من الخدمات الخارجية والاعتمادات:

مشروع Supabase:

سجل أو قم بتسجيل الدخول في supabase.com وأنشئ مشروعًا جديدًا.
انتقل إلى الإعدادات > واجهة برمجة التطبيقات لمشروعك. انسخ بعناية عنوان URL للمشروع، anon مفتاح العموم، وservice_role مفتاح الخدمة السري.
ثبّت Supabase CLI: اتبع التعليمات على supabase.com/docs/guides/cli.

قاعدة بيانات Redis:

الخيار 1 (سحابي - موصى به): استخدم خدمة مثل Upstash (تقدم مستوى مجاني). أنشئ قاعدة بيانات وسجل المضيف/النقطة النهائية، المنفذ، كلمة المرور، ودوّن ما إذا كان SSL/TLS مطلوبًا (عادةً نعم).
الخيار 2 (محلي): ثبّت Redis محليًا (مثل brew install redis على macOS، sudo apt install redis-server على Debian/Ubuntu، أو عبر Docker/WSL على Windows). لاحظ المضيف (localhost)، المنفذ (عادةً 6379)، كلمة المرور (عادةً لا شيء)، وإعداد SSL (False).

حساب Daytona & تكوين الصورة:

سجل في daytona.io.
اذهب إلى الإعدادات > مفاتيح API وولد مفتاح API جديد. انسخه.
انتقل إلى قسم الصور. انقر على إضافة صورة.
اسم الصورة: adamcohenhillel/kortix-suna:0.0.20
نقطة الدخول: /usr/bin/supervisord -n -c /etc/supervisor/conf.d/supervisord.conf
احفظ إعداد هذه الصورة.

مفتاح API لنموذج اللغة الكبير:

اختر بين OpenAI (platform.openai.com) أو Anthropic (console.anthropic.com). احصل على مفتاح API من مزودك المختار.
دوّن معرف النموذج المحدد الذي تخطط لاستخدامه (مثل gpt-4o، anthropic/claude-3-5-sonnet-latest).

(اختياري) مفتاح API Tavily: للحصول على نتائج بحث أفضل. احصل على مفتاح من Tavily AI.

(اختياري) مفتاح API RapidAPI: إذا كنت تنوي استخدام تكاملات مسبقة البناء تحتاج إليها (مثل حاصرات ويب معينة).

احصل على مفتاح من rapidapi.com.
تذكر الاشتراك في واجهات برمجة التطبيقات المحددة (مثل حاصرات LinkedIn) في سوق RapidAPI التي قد تستخدمها أدوات Suna. تحقق من backend/agent/tools/data_providers/ للدليل لمعرفة شفرة الأدوات ذات الصلة وروابط قاعدة بيانات واجهة برمجة التطبيقات المطلوبة.

المرحلة 2: التثبيت والتكوين

الآن، قم بتكوين مكونات تطبيق Suna:

استنساخ المستودع:

git clone https://github.com/kortix-ai/suna.git
cd suna

تكوين الخلفية (.env):

cd backend
cp .env.example .env (أو أنشئ .env إذا كان المثال مفقودًا).
قم بتحرير .env باستخدام بيانات الاعتماد من المرحلة الأولى:

NEXT_PUBLIC_URL="http://localhost:3000" # أو عنوان URL للواجهة الأمامية الخاص بك إذا كان مختلفًا

# Supabase
SUPABASE_URL=YOUR_SUPABASE_URL
SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY=YOUR_SUPABASE_SERVICE_ROLE_KEY

# Redis
REDIS_HOST=YOUR_REDIS_HOST
REDIS_PORT=YOUR_REDIS_PORT
REDIS_PASSWORD=YOUR_REDIS_PASSWORD # اترك فارغاً إذا لم يكن هناك
REDIS_SSL=True # أو False لـ Redis المحلي بدون SSL

# Daytona
DAYTONA_API_KEY=YOUR_DAYTONA_API_KEY
DAYTONA_SERVER_URL="https://app.daytona.io/api"
DAYTONA_TARGET="us" # أو منطقتك

# --- تكوين LLM (املأ مجموعة واحدة فقط) ---
# مثال Anthropic:
ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY
MODEL_TO_USE="anthropic/claude-3-5-sonnet-latest" # أو نموذج Claude آخر
OPENAI_API_KEY=
# مثال OpenAI:
# ANTHROPIC_API_KEY=
# OPENAI_API_KEY=YOUR_OPENAI_API_KEY
# MODEL_TO_USE="gpt-4o" # أو نموذج OpenAI آخر
# -----------------------------------------

# اختياري
TAVILY_API_KEY=YOUR_TAVILY_API_KEY # اختياري
RAPID_API_KEY=YOUR_RAPID_API_KEY # اختياري

مهم: قدم مفاتيح لمزود واحد فقط من LLM (إما Anthropic أو OpenAI).

إعداد مخطط قاعدة بيانات Supabase:

تأكد أنك في دليل backend.
تسجيل الدخول: supabase login
رابط المشروع: supabase link --project-ref YOUR_PROJECT_REF_ID (احصل على المعرف من لوحة معلومات Supabase).
تطبيق الترقيات: supabase db push
تحقق من المخطط: انتقل إلى لوحة معلومات مشروع Supabase الخاص بك -> إعدادات المشروع -> واجهة برمجة التطبيقات -> قسم المخطط تحت "التكوين". تأكد من إدراج basejump في "المخططات المكشوفة". أضفه إن كان مفقودًا واحفظه.

تكوين الواجهة الأمامية (.env.local):

cd ../frontend
cp .env.example .env.local (أو أنشئ .env.local).
تحرير .env.local:

NEXT_PUBLIC_SUPABASE_URL=YOUR_SUPABASE_URL # كما هو في الخلفية .env
NEXT_PUBLIC_SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY # كما هو في الخلفية .env
NEXT_PUBLIC_BACKEND_URL="http://localhost:8000/api" # الموقع الافتراضي للخلفية
NEXT_PUBLIC_URL="http://localhost:3000" # الموقع الافتراضي للواجهة الأمامية

تثبيت الاعتمادات:

الواجهة الأمامية (Node.js/npm):

# في دليل الواجهة الأمامية
npm install

الخلفية (بايثون 3.11):

# في دليل الخلفية (استخدم بيئة افتراضية!)
# python -m venv venv
# source venv/bin/activate  OR .\venv\Scripts\activate (Windows)
pip install -r requirements.txt

المرحلة 3: تشغيل Suna

بدء خدمة الخلفية:

افتح Terminal.
انتقل إلى path/to/suna/backend.
إذا كنت تستخدم بيئة افتراضية، قم بتفعيلها (source venv/bin/activate).
قم بتشغيل: python api.py
ابحث عن تأكيد بأن الخادم يعمل (ربما على المنفذ 8000).

بدء خدمة الواجهة الأمامية:

افتح طرفية ثانية.
انتقل إلى path/to/suna/frontend.
قم بتشغيل: npm run dev
ابحث عن تأكيد بأن الخادم يعمل (ربما على المنفذ 3000).

الوصول إلى مثيل Suna الخاص بك:

افتح متصفح الويب واذهب إلى http://localhost:3000.
استخدم خيار التسجيل لإنشاء حساب المستخدم الخاص بك (ممكّن بواسطة Supabase Auth).
قم بتسجيل الدخول وابدأ بإعطاء التعليمات لوكيل Suna الذي تستضيفه بنفسك.

الخاتمة

تمثل Suna AI خطوة عملية نحو وكلاء الذكاء الاصطناعي المستقلين القادرين على تنفيذ المهام في المجال الرقمي. طبيعتها المفتوحة المصدر، إلى جانب مجموعة أدوات قوية وهندسة معمارية نمطية، تجعلها خيارًا جذابًا للمطورين والمستخدمين الذين يبحثون عن مساعد ذكي قابل للتخصيص ويمكن استضافته ذاتيًا. من خلال اتباع عملية الإعداد التفصيلية الموضحة أعلاه، يمكنك نشر مثيلك الخاص من Suna، مما يمنحك واجهة محادثة لأتمتة التصفح، والتلاعب بالملفات، وجمع البيانات، وتنفيذ الشفرات، والمزيد، كلها ضمن بيئة تسيطر عليها. بينما يتطلب إعدادها اهتمامًا دقيقًا لمكوناتها المتعددة، فإن النتيجة هي وكيل ذكاء اصطناعي متعدد الاستخدامات جاهز للعمل نيابة عنك.

💡

زر