الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

يتيح لك Agno بناء وتشغيل وكلاء AI في Python. يتضمن Agno موفّر نماذج CometAPI رسميًا، لذا يمكنك استخدام CometAPI مباشرةً من agno.models.cometapi دون إنشاء مُكيّف مخصص.

​
المتطلبات الأساسية

​
إعداد التكامل

1

تثبيت Agno

ثبّت Agno في بيئة Python الخاصة بك:
pip install -U agno
2

تعيين مفتاح CometAPI API الخاص بك

خزّن مفتاح CometAPI API الخاص بك في متغير البيئة COMETAPI_KEY:
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
3

إنشاء وكيل Agno

استخدم موفّر CometAPI الرسمي من Agno:
from agno.agent import Agent
from agno.models.cometapi import CometAPI

agent = Agent(
    model=CometAPI(id="your-model-id"),
    markdown=True,
)

agent.print_response("Write a short product update in three bullet points.")
استبدل your-model-id بـ model ID حالي من صفحة نماذج CometAPI.
4

تشغيل الوكيل

احفظ المثال باسم agent.py، ثم شغّله من جلسة shell نفسها:
python agent.py
تؤكد الاستجابة الناجحة أن Agno يرسل استدعاءات النماذج عبر CometAPI.

​
كيف يتصل Agno بـ CometAPI

يقرأ موفّر CometAPI الرسمي من Agno قيمة COMETAPI_KEY من بيئتك ويستخدم https://api.cometapi.com/v1 كعنوان URL أساسي افتراضي. وهو يوسّع واجهة النماذج المتوافقة مع OpenAI في Agno داخليًا، لكن يجب أن يستورد كود التطبيق لديك CometAPI ويُنشئ مثيلًا منه. يمكنك أيضًا تمرير مفتاح API أو عنوان URL الأساسي بشكل صريح عندما لا تتمكن بيئة التشغيل لديك من قراءة متغيرات البيئة: 
import os

from agno.agent import Agent
from agno.models.cometapi import CometAPI

agent = Agent(
    model=CometAPI(
        id="your-model-id",
        api_key=os.environ["COMETAPI_KEY"],
        base_url="https://api.cometapi.com/v1",
    )
)

agent.print_response("Summarize the benefits of a unified AI API.")

​
عرض النماذج المتاحة

يوفّر موفّر Agno الدالة get_available_models() للتحقق من model IDs المتاحة عبر حساب CometAPI الخاص بك: 
from agno.models.cometapi import CometAPI

model = CometAPI()
available_models = model.get_available_models()
print(available_models)

​
استكشاف الأخطاء وإصلاحها

تأكد من أن COMETAPI_KEY معيّن في جلسة shell نفسها التي تشغّل agent.py. إذا كان المتغير مفقودًا، فسيصدر Agno خطأ مصادقة قبل إرسال طلب النموذج.
تأكد من أن قيمة id تطابق model ID من صفحة نماذج CometAPI. يمكنك أيضًا استدعاء CometAPI().get_available_models() لفحص مدى توفر النماذج من حسابك.

​
موارد ذات صلة