> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# الترحيل من Helicone AI Gateway

> انقل تكامل وكيل Helicone المتوافق مع OpenAI إلى Phaseo، وأزل رؤوس قابلية الرصد التي لم تعد بحاجة إليها.

استخدم هذا الدليل إذا كانت Helicone تقع بين تطبيقك ومزوّد الذكاء الاصطناعي. غالبًا ما يكون التغيير الأساسي في الطلب صغيرًا، لكن خطّط لنقل قابلية الرصد بعناية توازي تغيير نقطة النهاية.

## ما الذي سيتغير

| الإعداد | قبل | بعد |
| - | - | - |
| عنوان URL الأساسي | عنوان URL لوكيل Helicone | `https://api.phaseo.app/v1` |
| المصادقة | مفتاح المزوّد ومصادقة Helicone | `PHASEO_API_KEY` |
| رؤوس Helicone | تُضاف إلى الطلبات | تُزال |
| الاطلاع على الطلبات | لوحة معلومات Helicone | نشاط Phaseo وتفاصيل الطلبات |

<Steps>
  <Step title="احصر سلوكيات Helicone التي تعتمد عليها">
    سجّل الخصائص المخصصة والجلسات ومعرّفات المستخدم والتخزين المؤقت وحدود المعدل والتنبيهات ولوحات المعلومات التي تؤثر في عمليات الإنتاج. لا تفترض أن إزالة الوكيل ستعيد إنشاء مسارات العمل هذه تلقائيًا في مكان آخر.
  </Step>

  <Step title="استبدل إعداد الوكيل">
    وجّه عميلك المتوافق مع OpenAI إلى Phaseo، وأزل `Helicone-Auth` والرؤوس الأخرى الخاصة بـ Helicone.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      import OpenAI from "openai";

      const client = new OpenAI({
        apiKey: process.env.PHASEO_API_KEY,
        baseURL: "https://api.phaseo.app/v1",
      });

      const response = await client.chat.completions.create({
        model: "openai/gpt-4.1-mini",
        messages: [{ role: "user", content: "Reply with: migration ready" }],
      });
      ```

      ```python Python theme={null}
      import os
      from openai import OpenAI

      client = OpenAI(
          api_key=os.environ["PHASEO_API_KEY"],
          base_url="https://api.phaseo.app/v1",
      )
      ```

      ```bash cURL theme={null}
      curl https://api.phaseo.app/v1/chat/completions \
        -H "Authorization: Bearer $PHASEO_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "openai/gpt-4.1-mini",
          "messages": [{"role": "user", "content": "Reply with: migration ready"}]
        }'
      ```
    </CodeGroup>
  </Step>

  <Step title="انقل إمكانية الاطلاع على الطلبات">
    استخدم نشاط Phaseo ومعرّفات الطلب ومحاولات المزوّد وتفاصيل التسعير لتصحيح مشكلات التشغيل. إذا كان فريقك يصدّر بيانات القياس عن بُعد إلى مكان آخر، فأعد إعداد تكامل [قابلية الرصد](../guides/integrations/observability.mdx) المناسب قبل التحويل.
  </Step>

  <Step title="اختبر وأطلق التغيير">
    تحقّق من اكتمال الطلبات من دون رؤوس Helicone، ومن قدرة فريقك على الإجابة عن أسئلة التشغيل التي يحتاج إليها أثناء الحوادث. انقل حركة المرور تدريجيًا بعد اجتياز فحوصات الاستدلال وقابلية الرصد.
  </Step>
</Steps>

## قائمة التحقق من الترحيل

* أُزيل عنوان URL لوكيل Helicone ورؤوس المصادقة.
* تم التحقق من معرّفات نماذج الإنتاج باستخدام `GET /v1/models`.
* لا تزال بيانات الطلب الوصفية المطلوبة متاحة في Phaseo أو في حزمة القياس عن بُعد لديك.
* وُضع بديل مقصود للتنبيهات ولوحات المعلومات عند الحاجة.
* يظل التراجع مقتصرًا على تغيير إعداد نقطة النهاية والمفتاح.

## الخطوات التالية

* [قابلية الرصد](../guides/integrations/observability.mdx)
* [حالات المزوّدين](../guides/provider-statuses.mdx)
* [معالجة الأخطاء](../api-reference/errors.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.