> ## 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.

# ربط Langfuse بـ CometAPI

> استخدم هذا الدليل لربط Langfuse بـ CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.

يوفّر [Langfuse](https://langfuse.com/) إمكانات observability لـ LLM، وإدارة Prompt، وplaygrounds، ومسارات عمل التقييم. قم بتهيئة LLM Connection في Langfuse مع CometAPI عندما تريد أن يستخدم Langfuse Playground أو تقييمات LLM-as-a-Judge نماذج CometAPI.

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

* مشروع Langfuse Cloud أو مثيل Langfuse مستضاف ذاتيًا
* حساب CometAPI مع مفتاح API نشط — [احصل على مفتاحك من لوحة التحكم](https://www.cometapi.com/console/token)
* model ID واحد على الأقل من CometAPI تم اختياره من [صفحة نماذج CometAPI](/ar/overview/models)

## تهيئة التكامل

<Steps>
  <Step title="إنشاء LLM connection في Langfuse">
    في Langfuse، افتح **Project Settings** → **LLM Connections**. ابدأ مسار إضافة مفتاح API لـ LLM.
  </Step>

  <Step title="اختيار OpenAI adapter">
    اختر **OpenAI** باعتباره provider. يستخدم Langfuse هذا adapter لموفري النماذج الذين يدعمون مخطط OpenAI API.
  </Step>

  <Step title="إدخال بيانات اعتماد CometAPI">
    قم بتهيئة الاتصال باستخدام هذه القيم:

    | Field            | Value                                                               |
    | ---------------- | ------------------------------------------------------------------- |
    | مفتاح API        | مفتاح API الخاص بك في CometAPI                                      |
    | Base URL         | `https://api.cometapi.com/v1`                                       |
    | Custom model IDs | model ID واحد أو أكثر من [صفحة نماذج CometAPI](/ar/overview/models) |

    إذا كان Langfuse يعرض حقل base URL ضمن **Advanced Settings**، فقم بتوسيع هذا القسم قبل حفظ الاتصال.
  </Step>

  <Step title="الاختبار في Playground">
    في Langfuse Playground، اختر LLM connection الخاصة بـ CometAPI وأحد model IDs التي تمت تهيئتها. أرسل Prompt قصيرًا للتأكد من أن Langfuse يتلقى استجابة.
  </Step>
</Steps>

## استخدام CometAPI لـ LLM-as-a-Judge

يمكن لمقيّمي LLM-as-a-Judge في Langfuse استخدام LLM connection نفسها. اختر اتصال CometAPI في تهيئة المقيّم، ثم اختر model ID يدعم tool calling إذا كان Prompt التقييم لديك يتطلب استخراجًا منظّمًا.

استخدم خيارات provider فقط عندما يدعم نموذج CometAPI المحدد حقول الطلب تلك. لاكتشاف النماذج، استخدم [صفحة نماذج CometAPI](/ar/overview/models) أو واجهة `/v1/models` API.

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

<AccordionGroup>
  <Accordion title="النموذج غير ظاهر في Langfuse">
    أضف model ID المطابق تمامًا من CometAPI إلى قائمة custom model IDs في LLM connection. لا يكتشف Langfuse كل نموذج تلقائيًا لموفري OpenAI-compatible المخصصين.
  </Accordion>

  <Accordion title="يستخدم الطلب مسار API غير صحيح">
    استخدم `https://api.cometapi.com/v1` باعتباره base URL. يضيف Langfuse المسار المتوافق مع OpenAI الخاص بالـ adapter المحدد.
  </Accordion>

  <Accordion title="تفشل استدعاءات المقيّم">
    تأكد من أن النموذج المحدد يدعم ميزات الطلب التي يستخدمها المقيّم، مثل tool calling أو إخراج JSON.
  </Accordion>
</AccordionGroup>

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

* [اتصالات Langfuse LLM](https://langfuse.com/docs/administration/llm-connection)
* [البدء السريع في 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/langfuse#howto",
        "name": "ربط Langfuse بـ CometAPI",
        "description": "استخدم هذا الدليل لربط Langfuse بـ CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "إنشاء اتصال Langfuse LLM",
            "text": "أكمل خطوة إنشاء اتصال Langfuse LLM في دليل ربط Langfuse بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "اختيار محول OpenAI",
            "text": "أكمل خطوة اختيار محول OpenAI في دليل ربط Langfuse بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "إدخال بيانات اعتماد CometAPI",
            "text": "أكمل خطوة إدخال بيانات اعتماد CometAPI في دليل ربط Langfuse بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "الاختبار في Playground",
            "text": "أكمل خطوة الاختبار في Playground في دليل ربط Langfuse بـ 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": "ربط Langfuse بـ CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/langfuse"
          }
        ]
      }
    ]
    }
    `}
</script>