نشر وكيل Agno الخاص بك على TrueFoundry
.webp)
Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
في هذا الدليل، سنوضح لك كيفية نشر وكيل Agno على TrueFoundry، وهي منصة صُممت لتبسيط نشر AI بأقل قدر من خبرة DevOps أو MLOps. تقوم TrueFoundry بأتمتة إدارة البنية التحتية، والتوسع، والمراقبة، مما يتيح لك التركيز على استخلاص الرؤى بدلاً من التعامل مع تعقيدات النشر. بنقرات قليلة فقط، يمكنك تحويل الطلبات باللغة الطبيعية إلى استعلامات SQL ورسوم بيانية ديناميكية، مما يجعل استكشاف البيانات سلسًا وذكيًا. لا يلزم إجراء استعلامات يدوية!
إذا كنت ترغب في تجربة ذلك مباشرةً، يُرجى زيارة منصة TrueFoundry والانتقال إلى Live Demos و agno-Streamlit: العرض التوضيحي المباشر لسير عمل الوكيل الخاص بنا
نظرة عامة على البنية الهيكلية
يتكون هذا المشروع من عدة مكونات رئيسية تعمل معًا:
Query Agent
- يستخدم GPT-4o لفهم اللغة الطبيعية
- ينشئ استعلامات SQL المناسبة لـ ClickHouse
- ينفذ استعلام SQL على SQL database مهيأة مسبقًا
- يعيد البيانات في شكل جدول كمدخلات لوكيل التصور البياني
Visualization Agent: وكيل AI ثانٍ يقوم بـ
- تحديد نوع التصور البياني الأكثر ملاءمة بناءً على البيانات
- إنشاء المخططات باستخدام matplotlib/seaborn
- التعامل مع تنسيق وتصميم التصورات البيانية
FastAPI Backend: RESTful API تقوم بـ
- التنسيق بين الوكلاء باستخدام agno
- إدارة معالجة المهام غير المتزامنة
- تقديم صور المخططات والنتائج
Streamlit Frontend: واجهة المستخدم التي
- توفر واجهة استعلام بديهية
- تعرض حالة المعالجة في الوقت الفعلي
- تعرض تصورات بيانية تفاعلية

تدفق البيانات
يقوم المستخدم بإرسال استعلام باللغة الطبيعية من خلال Streamlit.
- يستخدم Query Agent مكتبة agno مع GPT-4o لإنشاء استعلامات SQL لـ ClickHouse
- ينفذ استعلام SQL على قاعدة بيانات ClickHouse
- يتم إرجاع النتائج في شكل جدول كمدخلات لـ Visualization Agent
- يقوم Visualization Agent بإنشاء التصورات البيانية وإرجاع الصور للعرض
البتدء
استنساخ المستودع (Repository)
أولاً، انتقل إلى مستودع TrueFoundry Getting Started Examples وقم باستنساخه:
الانتقال إلى دليل agno Plot Agent:
إعداد البيئة
أنشئ بيئة افتراضية وقم بتنشيطها:
تثبيت التبعيات (Dependencies):
تهيئة متغيرات البيئة
أنشئ ملف .env:
ملاحظة: عند استخدام TrueFoundry LLM Gateway، يجب أن يكون تنسيق معرف النموذج (Model ID) هو provider-name/model-name (على سبيل المثال، openai-main/gpt-4o). تأكد من أن ملف .env الخاص بك يحتوي على بيانات اعتماد LLM Gateway الصحيحة كما هو موضح في قسم تهيئة البيئة.

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

تطبيق Agno Agent
تشغيل الخدمات
بدء سير عمل agno
بدء FastAPI Backend:
بدء Streamlit UI (محطة طرفية جديدة):

النشر على TrueFoundry
المتطلبات الأساسية
تثبيت TrueFoundry CLI:
تسجيل الدخول إلى TrueFoundry:
خطوات النشر
- انتقل إلى قسم Deployments في TrueFoundry.

- انقر على Service في الأسفل.
- حدد بيئة عمل العنقود (Cluster workspace) الخاصة بك.
- يمكنك النشر من جهاز الكمبيوتر المحمول الخاص بك، أو GitHub، أو Docker. في حال النشر من الكمبيوتر المحمول، تأكد من إكمال المتطلبات الأساسية أعلاه.
- ستقوم منصة TrueFoundry بإنشاء ملف deploy.py وإضافته إلى مشروعك. ستلزمك تعديل هذا الملف لإضافة متغيرات البيئة الخاصة بك. ابحث عن قسم env في الملف المنشأ وأضف بيانات الاعتماد الخاصة بك:
- استخدم ملف
deploy.pyالمنشأ وقم بتعديل قسمenv:
اختبار النشر
إرسال استعلام اختباري:
مثال على الاستجابة الناجحة:
نقاط نهاية API (API Endpoints)
- إرسال استعلام:
- التحقق من حالة الاستعلام:
- استرداد صورة المخطط البياني:
الواجهة الأمامية و CORS
تهيئة CORS في FastAPI:
تعريف متغير البيئة في Streamlit:
ملاحظات ما بعد النشر
- اختبار الاتصال بـ API من Streamlit إلى FastAPI.
- تحديث ملف
.envالخاص بـ Streamlit بنقطة نهاية FastAPI. - التأكد من أن إعدادات CORS تسمح بطلبات Streamlit.
قم بمراقبة وإدارة عملية النشر الخاصة بك من خلال TrueFoundry عن طريق:
- عرض السجلات (Logs)
- مراقبة استخدام الموارد
- تعيين قواعد التوسع التلقائي (Auto-scaling)
- التحقق من صحة الواجهة الخلفية (
/health)، وتوثيق API (/docs)، والمقاييس عند/metrics

إضافة تتبعات (Traces) إلى الوكيل الخاص بك
يساعدك التتبع (Tracing) على فهم ما يحدث تحت الغطاء عند استدعاء تشغيل الوكيل. يمكنك فهم المسار، واستدعاءات الأدوات المنفذة، والسياق المستخدم، والزمن المستغرق عند تشغيل الوكيل الخاص بك باستخدام ميزة التتبع في TrueFoundry عن طريق إضافة أسطر قليلة جدًا من الكود.
تحتاج إلى تثبيت ما يلي
ثم أضف متغيرات البيئة اللازمة لتمكين التتبع
في القاعدة البرمجية الخاصة بك حيث تقوم بتعريف الوكيل، تحتاج فقط إلى هذه الأسطر لتمكين التتبع
ثم أضف المزيّن (Decorator) إلى الوكيل وسير العمل كما يلي

مع هذه الخطوات، تم نشر سير عمل agno agent الخاص بك بنجاح على TrueFoundry!
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.















.webp)




.webp)
.webp)
.png)

.png)
.png)
.png)
.png)
.png)
.webp)
.webp)






