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

# Brave Leo

> اربط Brave Leo بـ Venice API لدردشة ذكاء اصطناعي خاصة ومدمجة في المتصفح، وتلخيص الصفحات، والبحث الاختياري على الويب.

[Brave Leo](https://brave.com/leo/) هو مساعد الذكاء الاصطناعي المدمج في متصفح Brave. تتيح ميزة Bring Your Own Model (BYOM) في Leo الاتصال مباشرةً بـ endpoint إكمالات الدردشة المتوافقة مع OpenAI في Venice، مما يسمح لك باستخدام نماذج Venice للدردشة والمساعدة المدركة للصفحات دون تثبيت إضافة.

<CardGroup cols={3}>
  <Card title="مدمج في المتصفح" icon="browser">
    الدردشة وتلخيص الصفحات وشرح النص المحدد داخل Brave
  </Card>

  <Card title="اتصال مباشر" icon="plug">
    إرسال طلبات BYOM مباشرةً من Brave إلى Venice
  </Card>

  <Card title="خيار الخصوصية" icon="shield-halved">
    اختر نموذج Venice بمستوى الخصوصية الذي تحتاجه
  </Card>
</CardGroup>

## المتطلبات

* متصفح Brave 1.69 أو أحدث على Windows أو macOS أو Linux
* مفتاح Venice API من [venice.ai/settings/api](https://venice.ai/settings/api)
* معرّف نموذج من [كتالوج نماذج Venice النصية](/models/text)

<Note>
  تتوفر ميزة BYOM في Brave على سطح المكتب. يجب أن يتطابق معرّف النموذج تمامًا مع معرّف نموذج Venice.
</Note>

## الإعداد

<Steps>
  <Step title="افتح إعدادات Leo">
    افتح `brave://settings/leo-ai`، أو افتح Leo من الشريط الجانبي في Brave، وحدد أيقونة الإعدادات، ثم انتقل إلى **Leo**.
  </Step>

  <Step title="أضف نموذجًا مخصصًا">
    مرّر إلى **Bring your own model** وحدد **Add new model**.
  </Step>

  <Step title="اضبط endpoint الخاص بـ Venice">
    أدخل القيم التالية:

    | الحقل              | القيمة                                               |
    | ------------------ | ---------------------------------------------------- |
    | Label              | `Venice AI`                                          |
    | Model request name | معرّف نموذج من [كتالوج النماذج النصية](/models/text) |
    | Server endpoint    | `https://api.venice.ai/api/v1/chat/completions`      |
    | API key            | مفتاح Venice API الخاص بك                            |

    إذا عرض Brave **Context size**، فعيّنه إلى نافذة السياق التي يدعمها النموذج المحدد. يمكنك أيضًا إضافة موجّه نظام اختياري.

    أدخل مفتاح API نفسه بدون بادئة `Bearer`. يضيف Brave رأس التفويض إلى كل طلب.
  </Step>

  <Step title="احفظ وحدد Venice">
    حدد **Add model**، ثم عيّن **Venice AI** كنموذج افتراضي للمحادثات الجديدة أو اختره من محدد النموذج في Leo.
  </Step>

  <Step title="اختبر الاتصال">
    افتح Leo على صفحة ويب وأرسل موجّهًا مثل:

    ```txt theme={"system"}
    Summarize this page in five bullet points.
    ```

    يرسل Leo المحادثة ومحتوى الصفحة ذي الصلة مباشرةً إلى endpoint الخاص بـ Venice.
  </Step>
</Steps>

## تفعيل بحث Venice على الويب

لا يعرض Brave معلمات نص الطلب الخاصة بـ Venice في BYOM. لتفعيل بحث Venice على الويب، ألحق [لاحقة ميزة النموذج](/api-reference/endpoint/chat/model_feature_suffix) بمعرّف النموذج في **Model request name**:

```txt theme={"system"}
<model-id>:enable_web_search=auto
```

لتفعيل البحث دائمًا وتضمين الاستشهادات، استخدم:

```txt theme={"system"}
<model-id>:enable_web_search=on&enable_web_citations=true
```

<Info>
  يخضع البحث على الويب لتسعير إضافي مبني على الاستخدام. راجع [تسعير API](/overview/pricing) للاطلاع على الأسعار الحالية.
</Info>

## الخصوصية

عند استخدام endpoint BYOM بعيد، يتصل Brave مباشرةً بذلك الموفّر. تتجاوز الطلبات خوادم Brave، لذا لا تنطبق حمايات proxy الخاصة بـ Brave والاحتفاظ من جانب الخادم على تلك الطلبات.

لا تخزّن Venice أو تسجل محتوى الموجّهات والاستجابات في proxy الخاص بها. يحدد النموذج المحدد مستوى الخصوصية في وقت التشغيل:

* تستخدم النماذج **الخاصة (Private)** بنية تحتية بدون احتفاظ بالبيانات.
* تخفي النماذج **المجهّلة (Anonymized)** المعلومات المُعرِّفة عن الموفّر الأعلى، لكن يمكن للموفّر معالجة الموجّه.
* تضيف نماذج **TEE** و**E2EE** عزلًا مدعومًا بالعتاد أو تشفيرًا من جانب العميل حيث يكون مدعومًا.

راجع علامة الخصوصية للنموذج في [كتالوج النماذج النصية](/models/text) واقرأ [خصوصية Venice](/overview/privacy) قبل إرسال معلومات حساسة.

قد يحتفظ Brave بسجل دردشة Leo في التخزين المحلي للمتصفح. يمكنك مسح بيانات Leo، أو استخدام محادثة مؤقتة، أو تعطيل سجل الدردشة المحلي في إعدادات Leo في Brave.

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

* يتطلب Brave مسار endpoint الكامل: `https://api.venice.ai/api/v1/chat/completions`.
* تتغيّر معرّفات النماذج وتوفرها بمرور الوقت. انسخ المعرّف الحالي من [كتالوج النماذج النصية](/models/text).
* يجب ألا يتجاوز حجم السياق نافذة السياق التي يدعمها النموذج المحدد.
* يمكن أن ترسل تلخيصات الصفحات محتوى الصفحة إلى Venice كجزء من الموجّه.
* تتطلب طلبات Venice البعيدة اتصالًا بالإنترنت وتستهلك أرصدة Venice API أو مخصص DIEM المتاح لديك.

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

<AccordionGroup>
  <Accordion title="خطأ 401 أو خطأ مصادقة">
    تأكّد من أن المفتاح مأخوذ من [venice.ai/settings/api](https://venice.ai/settings/api). الصق المفتاح الخام بدون `Bearer` وأزل أي مسافات في البداية أو النهاية.
  </Accordion>

  <Accordion title="النموذج غير موجود">
    انسخ معرّف النموذج تمامًا من [كتالوج النماذج النصية](/models/text). إذا أضفت لاحقة ميزة، فاختبر النموذج أولًا بدون اللاحقة.
  </Accordion>

  <Accordion title="خطأ في الشبكة أو عدم وجود استجابة متدفقة">
    تأكّد من أن endpoint الخادم يتضمّن `/api/v1/chat/completions`. يتوقع Brave Leo استجابة متدفقة متوافقة مع OpenAI.
  </Accordion>

  <Accordion title="تلخيصات الصفحات تفتقر إلى سياق الصفحة">
    تحقق من إذن Leo لاستخدام محتوى الصفحة وتأكّد من أن الصفحة الحالية قابلة للوصول من المتصفح. لا يمكن تلخيص الصفحات الداخلية لـ Brave وبعض الصفحات المحمية.
  </Accordion>
</AccordionGroup>

## الموارد

<CardGroup cols={2}>
  <Card title="دليل Brave BYOM" icon="book" href="https://support.brave.com/hc/en-us/articles/34070140231821-How-do-I-use-the-Bring-Your-Own-Model-BYOM-with-Brave-Leo">
    إعداد Brave الرسمي وتفاصيل الخصوصية
  </Card>

  <Card title="نماذج Venice النصية" icon="list" href="/models/text">
    تصفّح معرّفات النماذج الحالية ومستويات الخصوصية
  </Card>

  <Card title="لواحق ميزات النموذج" icon="sliders" href="/api-reference/endpoint/chat/model_feature_suffix">
    تفعيل البحث على الويب وميزات Venice الأخرى
  </Card>

  <Card title="إنشاء مفتاح API" icon="key" href="/guides/getting-started/generating-api-key">
    أنشئ مفتاح Venice API واحفظه بأمان
  </Card>
</CardGroup>