> ## 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 مع CometAPI

> استخدم هذا الدليل لربط وكلاء Agno بـ CometAPI باستخدام موفر نموذج CometAPI ومفتاح API وmodel ID.

يتيح لك [Agno](https://docs.agno.com/) بناء وتشغيل وكلاء AI في Python. يتضمن Agno موفر نموذج `CometAPI` رسميًا، لذلك يمكنك استخدام CometAPI مباشرةً من `agno.models.cometapi` دون إنشاء adapter مخصص.

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

* Python 3.10+
* حزمة Agno لـ Python
* حساب CometAPI مع مفتاح API نشط — [احصل على مفتاحك من لوحة التحكم](https://www.cometapi.com/console/token)

## تكوين التكامل

<Steps>
  <Step title="تثبيت Agno">
    ثبّت Agno في بيئة Python الخاصة بك:

    ```bash theme={null}
    pip install -U agno
    ```
  </Step>

  <Step title="عيّن مفتاح API الخاص بـ CometAPI">
    خزّن مفتاح API الخاص بـ CometAPI في متغير البيئة `COMETAPI_KEY`:

    ```bash theme={null}
    read -rsp "CometAPI API key: " COMETAPI_KEY
    printf '\n'
    export COMETAPI_KEY
    ```
  </Step>

  <Step title="أنشئ وكيل Agno">
    استخدم موفر `CometAPI` الرسمي من Agno:

    ```python theme={null}
    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](/ar/overview/models).
  </Step>

  <Step title="شغّل الوكيل">
    احفظ المثال باسم `agent.py`، ثم شغّله من جلسة shell نفسها:

    ```bash theme={null}
    python agent.py
    ```

    تؤكد الاستجابة الناجحة أن Agno يرسل استدعاءات النموذج عبر CometAPI.
  </Step>
</Steps>

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

يقرأ موفر `CometAPI` الرسمي في Agno القيمة `COMETAPI_KEY` من بيئتك ويستخدم `https://api.cometapi.com/v1` باعتباره base URL الافتراضي. وهو يوسّع داخليًا واجهة النموذج المتوافقة مع OpenAI في Agno، لكن يجب على كود التطبيق لديك استيراد `CometAPI` وإنشاء مثيل منه.

يمكنك أيضًا تمرير مفتاح API أو base URL بشكل صريح عندما لا تتمكن بيئة التشغيل لديك من قراءة متغيرات البيئة:

```python theme={null}
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 الخاص بك:

```python theme={null}
from agno.models.cometapi import CometAPI

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

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

<AccordionGroup>
  <Accordion title="أخطاء المصادقة">
    تأكد من أن `COMETAPI_KEY` تم تعيينه في جلسة shell نفسها التي تشغّل `agent.py`. إذا كان المتغير مفقودًا، فسيُظهر Agno خطأ مصادقة قبل إرسال طلب النموذج.
  </Accordion>

  <Accordion title="أخطاء النموذج">
    تأكد من أن قيمة `id` تطابق model ID من [صفحة نماذج CometAPI](/ar/overview/models). يمكنك أيضًا استدعاء `CometAPI().get_available_models()` لفحص توفر النماذج من حسابك.
  </Accordion>
</AccordionGroup>

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

* [وثائق موفر Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [المصدر الخاص بموفر Agno CometAPI](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [دليل Agno CometAPI العملي](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [البدء السريع في CometAPI](/ar/overview/quick-start)
* [صفحة النماذج في CometAPI](/ar/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "استخدم Agno مع CometAPI",
        "description": "استخدم هذا الدليل لربط وكلاء Agno بـ CometAPI باستخدام موفر نموذج CometAPI ومفتاح API وmodel ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "تثبيت Agno",
            "text": "أكمل خطوة تثبيت Agno في دليل استخدام Agno مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "عيّن مفتاح API الخاص بـ CometAPI",
            "text": "خزّن مفتاح API الخاص بـ CometAPI في متغير البيئة أو حقل الإعدادات الذي يستخدمه التكامل."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "أنشئ وكيل Agno",
            "text": "أكمل خطوة إنشاء وكيل Agno في دليل استخدام Agno مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "شغّل الوكيل",
            "text": "أكمل خطوة تشغيل الوكيل في دليل استخدام Agno مع CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "مستندات CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "عمليات التكامل",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "استخدم Agno مع CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>