لقد تطور Agno بسرعة إلى مستوى الإنتاج وكيل OS—وقت تشغيل، وإطار عمل، ومستوى تحكم لأنظمة متعددة الوكلاء— بينما أعلن CometAPI (مُجمِّع "جميع النماذج في واجهة برمجة تطبيقات واحدة") عن دعمه الرسمي كمزود نماذج لـ Agno. يُسهِّل هذان النظامان تشغيل أنظمة متعددة الوكلاء، مع إمكانية التبديل بين مئات نقاط نهاية النماذج دون الحاجة إلى إعادة كتابة شيفرة الوكيل، مما يتطلب استخدام بوابات موحدة مثل CometAPI كمزودي نماذج مُباشرة لأطر عمل الوكلاء مثل Agno — لذا فإن النموذج الذي نصفه أدناه عملي ومناسب.

ما هما Agno و CometAPI بالضبط؟

ما هو Agno ولماذا يجب أن أهتم؟

Agno هو إطار عمل متعدد الوكلاء عالي الأداء، مبني على بايثون، مع وقت تشغيل وواجهة مستخدم، مصمم لإنشاء الوكلاء والفرق وسير عمل الوكلاء، مع ذاكرة وأدوات ومعرفة ودعم بشري مباشر. يوفر Agno وقت تشغيل FastAPI جاهز (AgentOS)، وأدوات تطوير محلية، وواجهة مستخدم للتحكم، مما يتيح لك اختبار ومراقبة الوكلاء قيد التشغيل دون الحاجة إلى نقل البيانات من بيئتك. إذا كنت ترغب في بناء أنظمة وكلاء عالية الجودة بسرعة مع الحفاظ على التحكم الكامل في البيانات وإمكانية المراقبة، فإن Agno مصمم خصيصًا لهذا الاستخدام.

ما هو CometAPI ولماذا أستخدمه كمقدم LLM؟

CometAPI هو مُجمِّع واجهات برمجة التطبيقات/بوابة نماذج، يُوفِّر واجهة برمجة تطبيقات واحدة ومتسقة لعشرات بل مئات نماذج التعلم الآلي (LLM) والأنماط (نصوص، صور، فيديوهات، إلخ). بدلًا من الارتباط بمورد نموذج واحد، يستدعي المطورون بوابة CometAPI ويُمكنهم تبديل المُزوِّدين أو النماذج عبر مُعاملات، وهو أمر مُفيد لإدارة التكاليف، واختبارات A/B، والحلول البديلة. تدعم المنصة التبديل بين النماذج، والفوترة المُوحَّدة، وتزعم وجود نقاط نهاية متوافقة مع OpenAI - أي أنه يُمكنك غالبًا توجيه عميل مُصمَّم على غرار OpenAI إلى عنوان URL الأساسي ورمز المصادقة الخاص بـ CometAPI، واستدعاء النماذج كما لو كانت نقاط نهاية OpenAI. هذا يجعل CometAPI مُزوِّدًا مُيسَّرًا وسهل الاستخدام للأطر التي تُقدِّم بالفعل واجهة برمجة تطبيقات OpenAI.

الإشارة الأخيرة: تم الإعلان عن CometAPI كمزود نموذجي في الوثائق الرسمية لـ Agno والقنوات المجتمعية، مما يعني أن Agno تشحن CometAPI فئة مزود النموذج التي يمكنك تمريرها إلى Agentوهذا يجعل دمج البوابة أمرًا سهلاً ومدعومًا.

لماذا دمج Agno مع CometAPI؟

• لا يوجد قفل للمزوديتيح لك CometAPI تجربة العديد من النماذج (OpenAI، Claude، إصدارات LLama، Gemini، إلخ) دون الحاجة إلى تبديل حزم تطوير البرامج (SDKs). وهذا يُكمّل تصميم Agno المستقل عن النماذج.
• حلقة تطوير أسرع:نظرًا لأن CometAPI يدعم نقاط النهاية ذات نمط OpenAI، فغالبًا ما ستتجنب كتابة موفر Agno مخصص — يمكنك توجيه محول نموذج OpenAI الخاص بـ Agno إلى CometAPI والبدء.
• القدرة على المراقبة + التحكم:استخدم وقت تشغيل AgentOS ومستوى التحكم الخاص بـ Agno لتشغيل الوكلاء محليًا أو في السحابة أثناء الاتصال بالنماذج من خلال CometAPI، مما يجمع بين أفضل مرونة النموذج وإمكانية المراقبة في وقت التشغيل.

كيف تقوم بدمج Agno مع CometAPI خطوة بخطوة؟

فيما يلي سير عمل عملي قابل للنسخ واللصق — من إنشاء virtualenv إلى تشغيل مثيل AgentOS محلي يستدعي النماذج عبر CometAPI.

الفكرة الرئيسية: نظرًا لأن CometAPI يعرض نقطة نهاية متوافقة مع OpenAI، فإن النهج الأكثر بساطة هو استخدام محول نموذج OpenAI الخاص بـ Agno ونقطة OPENAI_API_BASE (أو openai.api_base) على عنوان URL الأساسي لـ CometAPI مع توفير رمز CometAPI الخاص بك كمفتاح واجهة برمجة تطبيقات OpenAI. يوثق CometAPI بشكل صريح عملية "تغيير عنوان URL الأساسي + استخدام تنسيق OpenAI".

البيئة والمتطلبات الأساسية التي تحتاجها قبل البدء

ما هو نظام التشغيل وإصدار Python والأدوات الموصى بها؟

• OS: macOS أو Linux أو Windows — يدعم Agno والأدوات الثلاثة. ()
• بايثون: استخدم CPython حديث (وثائق ومستودعات Agno تستهدف إصدارات Python الحديثة؛ يُنصح باستخدام Python 3.12). تحقق من مستودعات ووثائق Agno للتأكد من التوافق التام قبل النشر في بيئة الإنتاج.
• مدير الحزم / virtualenv: uv (النجمي uv يعد المشروع خيارًا ممتازًا وسريعًا لإدارة البيئات الافتراضية والتبعيات.

ما هي الحسابات والمفاتيح ومتطلبات الشبكة التي يجب عليك إعدادها؟

• حساب CometAPI ومفتاح API. احصل على مفتاحك من CometAPI وقم بتخزينه في متغير بيئي (COMETAPI_KEY). يقرأ محول نموذج CometAPI الخاص بـ Agno COMETAPI_KEY.
• حساب Agno Control Plane اختياري (واجهة مستخدم AgentOS). إذا كنت تخطط لتوصيل AgentOS محلي بمستوى التحكم لمراقبة الميزات أو الفريق، فيجب أن يكون لديك وصول إلى مستوى التحكم وأذونات المنظمة/الفريق جاهزة.
• قاعدة بيانات لحالة الوكيل (اختياري). من أجل الاستمرار، ستقوم عادةً بتكوين SQLite/Postgres اعتمادًا على الحجم؛ يحتوي Agno على أمثلة توضح استخدام SQLite للتطوير المحلي.

كيف تقوم بدمج Agno مع CometAPI خطوة بخطوة؟

فيما يلي سير عمل عملي قابل للنسخ واللصق — من إنشاء virtualenv إلى تشغيل مثيل AgentOS محلي يستدعي النماذج عبر CometAPI.

الفكرة الرئيسية: نظرًا لأن CometAPI يعرض نقطة نهاية متوافقة مع OpenAI، فإن النهج الأكثر بساطة هو استخدام محول نموذج OpenAI الخاص بـ Agno ونقطة OPENAI_API_BASE (أو openai.api_base) على عنوان URL الأساسي لـ CometAPI مع توفير رمز CometAPI الخاص بك كمفتاح واجهة برمجة تطبيقات OpenAI. يوثق CometAPI بشكل صريح عملية "تغيير عنوان URL الأساسي + استخدام تنسيق OpenAI".

1) تثبيت uv وإنشاء البيئة الافتراضية

uv المثبت (سطر واحد):

# macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

إنشاء وتفعيل venv قابل للتكرار (يستخدم Agno quickstart Python 3.12):

# create a venv managed by uv

uv venv --python 3.12
# activate (POSIX)

source .venv/bin/activate

(إذا كنت تفضل التقليدية python -m venv .venv وهذا يعمل أيضا؛ uv يمنح قفل الملف + فوائد إمكانية إعادة الإنتاج.)

2) تثبيت Agno وبيانات وقت التشغيل (عبر uv pip)

```bash
uv pip install -U agno openai mcp 'fastapi' sqlalchemy 'httpx'
# optionally, add extras you need

uv pip install -U agno  # if using cloud infra plugins

(قم بتثبيت المكتبات الأخرى التي تحتاجها: عملاء قاعدة بيانات المتجهات، ومكتبات المراقبة، وما إلى ذلك.)  
يتم تثبيت Agno بشكل شائع `agno` + مزود SDKs.

### 3) تصدير مفتاح API CometAPI

قم بتعيين متغير البيئة الذي سيقرأه موفر Agno Comet:

bash

macOS / Linux

export COMETAPI_KEY="sk-xxxx-your-cometapi-key"

Windows (PowerShell)

setx COMETAPI_KEY "sk-xxxx-your-cometapi-key"

يعتمد موفر CometAPI الخاص بـ Agno افتراضيًا على القراءة `COMETAPI_KEY`.

### 4) إنشاء وكيل Agno صغير يستخدم موفر CometAPI

افتح المجلد وأنشئ ملفًا جديدًا. احفظه أدناه باسم `comet_agno_agent.py`:

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.cometapi import CometAPI
from agno.os import AgentOS
from agno.tools.mcp import MCPTools

1) Create an Agent which uses CometAPI as the model provider

id parameter selects a model id from the CometAPI catalog

agno_agent = Agent(
name="Agno Agent",
model=CometAPI(id="gpt-5-mini"),
# Add a database to the Agent

db=SqliteDb(db_file="agno.db"),
# Add the Agno MCP server to the Agent

tools=,
# Add the previous session history to the context

add_history_to_context=True,
markdown=True,

)

2) Attach Agent to AgentOS and get FastAPI app

agent_os = AgentOS(agents=)

Get the FastAPI app for the AgentOS

app = agent_os.get_app()

### 5) قم بتشغيل Agno محليًا للاختبار

ابدأ تشغيل خادم تطوير AgentOS (FastAPI):

In the activated .venv (uv-managed)

fastapi dev agno_comet_agent.py

defaults to http://localhost:8000

ساعات العمل `http://localhost:8000/docs` لتفقد نقاط النهاية التي تم إنشاؤها تلقائيًا.

> تأكد من تعيين متغيرات البيئة (COMETAPI\_KEY\_API\_KEY)

### 6) قم بتوصيل AgentOS المحلي الخاص بك بطائرة التحكم AgentOS (اختياري)

إذا كنت تريد أن تقوم طائرة التحكم على الويب Agno بمراقبة AgentOS المحلي الخاص بك:

1. قم بزيارة مستوى التحكم AgentOS: `os.agno.com` وتسجيل الدخول.
2. انقر **إضافة نظام تشغيل جديد → محلي**، أدخل `http://localhost:8000`، أعطه اسمًا، و **التواصل**.  
   بمجرد الاتصال، ستحصل على واجهة مستخدم الويب للدردشة والجلسات والمقاييس والإدارة.

![](https://resource.cometapi.com/blog/uploads/2025/10/agno-bulid-1024x475.webp)
![](https://resource.cometapi.com/blog/uploads/2025/10/screenshot-20251017-161131-1024x490.png)

## ما هي أفضل ممارسات التكوين والأمان؟

### الأسرار ومفاتيح API

لا تُلزم أبدًا بمفاتيح API. استخدم متغيرات البيئة، أو مدير الأسرار، أو `.env` جنبا إلى جنب مع المحلية `.gitignore`أفضل الممارسات: تدوير المفاتيح بانتظام وتقييد الاستخدام حسب عنوان IP إذا كان المزوّد يدعم ذلك. (توصي مستندات OpenAI والموردون الآخرون باستخدام متغيرات البيئة).

### اختيار النموذج والتحكم في التكاليف

استخدم كتالوج نماذج CometAPI لاختيار نماذج ذات توازن مناسب بين التكلفة وزمن الوصول. ضع حدودًا معقولة للسرعة، ونفّذ عمليات إعادة المحاولة مع تأخر أسي. يعرض CometAPI قوائم النماذج والأسعار في وثائقه.

### قابلية الملاحظة

استخدم مستوى تحكم AgentOS من Agno لسجلات الوكيل، وتتبعات الجلسات، والمقاييس. ادمج ذلك مع مقاييس مستوى المزود (لوحة معلومات CometAPI) لربط التكاليف/الزمن المستغرق بنشاط الوكيل.

### الخصوصية وإقامة البيانات

لأن AgentOS يعمل على سحابتك، فأنت تحتفظ بالتحكم في بيانات الجلسة. مع ذلك، تجنب إرسال معلومات تعريف شخصية حساسة إلى نماذج خارجية إلا إذا سمحت السياسة بذلك صراحةً؛ وإذا لزم الأمر، استخدم استضافة نموذج محلي أو خاص.

## ما هي أفضل الممارسات وحالات الاستخدام الموصى بها؟

### أفضل الممارسات

- **تبدأ صغيرة:** اختبار مع وكيل تطوير ونموذج منخفض المستوى (أرخص) قبل التوسع.
- **نموذج احتياطي:** تنفيذ سلسلة احتياطية (على سبيل المثال، نموذج صغير أرخص ← نموذج أقوى عند الفشل). يُسهّل CometAPI تبديل النماذج حسب الاسم.
- **الأدوات ذات الحبيبات الدقيقة:** يُقدّم للوكلاء أدوات محدودة ومُدقّقة (بحث ويب، وصول إلى قاعدة البيانات) واستدعاءات أدوات آلية مع تتبعات. يُوفّر Agno تكاملات أدوات ونمطًا للاستدعاءات الآلية.
- **تحديد المعدلات والتجميع:** تجميع الطلبات المتشابهة، وتطبيق حدود المعدلات على البوابة أو العميل لتجنب الزيادات المفاجئة.

### حالات الاستخدام النموذجية

- **روبوتات الدردشة RAG (الجيل المعزز بالاسترجاع)** — وكلاء Agno للمستندات + CometAPI لتوليد اللغة.
- **سير العمل الآلي** - سير عمل متعددة الوكلاء تجمع بين أدوات كشط الويب وقواعد بيانات المتجهات والخطوات التوليدية.
- **من النموذج الأولي إلى الإنتاج** - التكرار بسرعة باستخدام CometAPI لتجربة نماذج مختلفة، ثم تثبيت المزود المختار أو الانتقال إلى عقد مؤسسي.

## كيفية البدء باستخدام Comet API

CometAPI هي منصة واجهات برمجة تطبيقات موحدة تجمع أكثر من 500 نموذج ذكاء اصطناعي من أبرز المزودين، مثل سلسلة GPT من OpenAI، وGemini من Google، وClaude من Anthropic، وMidjourney، وSuno، وغيرهم، في واجهة واحدة سهلة الاستخدام للمطورين. من خلال توفير مصادقة متسقة، وتنسيق الطلبات، ومعالجة الردود، تُبسط CometAPI بشكل كبير دمج قدرات الذكاء الاصطناعي في تطبيقاتك. سواء كنت تُنشئ روبوتات دردشة، أو مُولّدات صور، أو مُلحّنين موسيقيين، أو خطوط أنابيب تحليلات قائمة على البيانات، تُمكّنك CometAPI من التكرار بشكل أسرع، والتحكم في التكاليف، والاعتماد على مورد واحد فقط، كل ذلك مع الاستفادة من أحدث التطورات في منظومة الذكاء الاصطناعي.

للبدء، استكشف قدرات النموذج [كوميت ايه بي اي](https://www.cometapi.com/ar/?utm_source=agno uted) في  [ملعب](https://www.cometapi.com/console/playground) واستشر الاستمرار [دليل واجهة برمجة التطبيقات](https://apidoc.cometapi.com/continue-1624859m0) للحصول على تعليمات مفصلة. قبل الدخول، يُرجى التأكد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. [مع](https://www.cometapi.com/ar/)[e](https://www.cometapi.com/ar/?utm_source=agno uted)[tAPI](https://www.cometapi.com/ar/) عرض سعر أقل بكثير من السعر الرسمي لمساعدتك على التكامل.

هل أنت مستعد للذهاب؟→ [سجل في CometAPI اليوم](https://api.cometapi.com/login) !

إذا كنت تريد معرفة المزيد من النصائح والإرشادات والأخبار حول الذكاء الاصطناعي، فتابعنا على [VK](https://vk.com/id1078176061), [X](https://x.com/cometapi2025) و [ديسكورد](https://discord.com/invite/HMpuV6FCrG)!

## الأفكار النهائية

يتيح لك دمج Agno مع CometAPI طريقة عملية لبناء أنظمة وكلاء مرنة وقابلة للملاحظة ومستقلّة عن البائعين. يوفر Agno مستوى التشغيل والتحكم، بينما يوفر CometAPI بوابة واحدة للعديد من النماذج. معًا، يُقلّلان من الاحتكاك التشغيلي: ترابط أقل بين النماذج لكل وكيل، وتجربة أسهل، وفواتير/عناصر تحكم مركزية.