Blank white background with no objects or features visible.

تحية إلى منطقة أوروبا والشرق الأوسط وأفريقيا! توسع TrueFoundry نطاق حضورها في هذه المنطقة الحيوية. اقرأ المزيد ←

نشر وكيل Agno الخاص بك على TrueFoundry

Updated: November 3, 2026

Published: July 2, 2026

في هذا الدليل، سنوضح لك كيفية نشر وكيل 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:

خطوات النشر

  1. انتقل إلى قسم Deployments في TrueFoundry.
  1. انقر على Service في الأسفل.
  2. حدد بيئة عمل العنقود (Cluster workspace) الخاصة بك.
  3. يمكنك النشر من جهاز الكمبيوتر المحمول الخاص بك، أو GitHub، أو Docker. في حال النشر من الكمبيوتر المحمول، تأكد من إكمال المتطلبات الأساسية أعلاه.
  4. ستقوم منصة TrueFoundry بإنشاء ملف deploy.py وإضافته إلى مشروعك. ستلزمك تعديل هذا الملف لإضافة متغيرات البيئة الخاصة بك. ابحث عن قسم env في الملف المنشأ وأضف بيانات الاعتماد الخاصة بك:
  5. استخدم ملف 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!

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
November 17, 2026
|
5 min read

شرح قيود Claude Code (إصدار 2026)

No items found.
Guide to Langgraph vs Langchain
November 16, 2026
|
5 min read

مقارنة بين LangChain وLangGraph: أيهما الأفضل لك؟

مقارنة
A detailed guide on Claude Fable 5
November 16, 2026
|
5 min read

كلود فيبل 5: واجهة برمجة التطبيقات، المعايير، التسعير وكيفية استخدامه

الهندسة والمنتج
openrouter vs litellm
November 17, 2026
|
5 min read

LiteLLM مقابل OpenRouter: أيهما الأنسب لك؟

مقارنة
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour