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

# روبوت Gorbit Slack

> كيفية إعداد روبوت Slack متصل بـ Gorbit

## نظرة عامة

يمكن لـ Gorbit الاتصال بمساحة عمل Slack الخاصة بك والإجابة على الأسئلة مثل زميل خبير.

يمكنك تكوين GorbitBot للاستجابة لأنواع معينة من الرسائل، في قنوات محددة،
ومع بيانات مختارة من فهرسك.

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/slackbot/slackbot_response.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=18d08fd5f71ea10f90bbe8491f747960" alt="Gorbit Slack Bot" width="1422" height="790" data-path="assets/admins/slackbot/slackbot_response.png" />

## الإعداد

<Note>
  يجب أن تكون مسؤولاً في مساحة عمل Slack لإعداد روبوت Slack.
</Note>

<Steps>
  <Step title="أنشئ تطبيق Slack جديد">
    انتقل إلى [لوحة تطبيقات Slack](https://api.slack.com/apps)
    وانقر على **إنشاء تطبيق جديد** ← **من ملف manifest**.

    حدد مساحة العمل التي تريد توصيلها بـ Gorbit.
  </Step>

  <Step title="استخدم ملف YAML manifest">
    انقر على علامة تبويب **YAML** والصق ملف manifest التالي في المربع:

    ```yaml YAML Manifest expandable theme={null}
    display_information:
      name: GorbitBot
      description: I help answer questions in Slack!
    features:
      app_home:
        home_tab_enabled: false
        messages_tab_enabled: true
        messages_tab_read_only_enabled: false
      bot_user:
        display_name: GorbitBot
        always_online: true
      slash_commands:
        - command: /gorbit
          description: Get back a private answer!
          usage_hint: Put your question here!
          should_escape: false
    oauth_config:
      scopes:
        bot:
          - app_mentions:read
          - channels:history
          - channels:join
          - channels:read
          - chat:write
          - commands
          - groups:history
          - groups:read
          - im:history
          - im:read
          - mpim:history
          - reactions:write
          - reactions:read
          - usergroups:read
          - users:read.email
          - users:read
        user:
          - channels:history
          - channels:read
          - groups:read
          - im:read
          - mpim:history
          - mpim:read
          - search:read
    settings:
      event_subscriptions:
        bot_events:
          - app_mention
          - message.channels
          - message.groups
          - message.im
          - message.mpim
      interactivity:
        is_enabled: true
      org_deploy_enabled: false
      socket_mode_enabled: true
      token_rotation_enabled: false
    ```

    انقر على **إنشاء** وسيتم نقلك إلى صفحة التطبيق.
  </Step>

  <Step title="أنشئ رمز تطبيق">
    انتقل لأسفل إلى قسم **رموز مستوى التطبيق** وانقر على **إنشاء رمز ونطاقات**.

    أعطِ رمزك اسمًا، وأضف نطاق `connections:write` إلى رمز مستوى التطبيق وانقر على **إنشاء**.
    احفظ هذا الرمز للاستخدام لاحقًا.

    <Tip>
      يمكنك تخصيص اسم روبوت Slack ووصفه وأيقونته في قسم **معلومات العرض**.
    </Tip>

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/slackbot/slackbot_app_token.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=3c25aa62cb784da4788cdf462260cc57" alt="Gorbit Slack Bot App Token" width="2564" height="1644" data-path="assets/admins/slackbot/slackbot_app_token.png" />
  </Step>

  <Step title="ثبّت تطبيق Slack">
    انتقل إلى علامة تبويب **OAuth والأذونات**، وانقر على **تثبيت في مساحة العمل**،
    واتبع التعليمات لتثبيت التطبيق.

    انسخ **رمز OAuth مستخدم الروبوت** و**رمز OAuth المستخدم** (موصى به) واحفظه للاستخدام لاحقًا.

    <Note>
      لا يدعم Gorbit حاليًا تدوير الرموز.
    </Note>

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/slackbot/slackbot_bot_token.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=8d58fa4d71e2e51b6ea681b43ca3a4e5" alt="Gorbit Slack Bot Bot Token" width="2430" height="1126" data-path="assets/admins/slackbot/slackbot_bot_token.png" />
  </Step>

  <Step title="إعداد Gorbit لروبوت Slack">
    انتقل إلى لوحة إدارة Gorbit وحدد علامة تبويب **روبوتات Slack**.

    أدخل **رمز الروبوت** و**رمز التطبيق** و**رمز المستخدم** (موصى به) وانقر **إنشاء!**

    <img className="rounded-image" src="https://mintlify.s3.us-west-1.amazonaws.com/gorbit/assets/admins/slackbot/slackbot_gorbit_setup.png" alt="Gorbit Slack Bot Gorbit Setup" />
  </Step>

  <Step title="تكوين سلوك روبوت Slack">
    بمجرد إنشاء روبوت Slack الخاص بك، يمكنك تكوين سلوكه العام من خلال **التكوين الافتراضي**.

    يمكنك أيضًا تعيين سلوك خاص بالقناة باستخدام **تكوينات القناة**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/slackbot/slackbot_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=fdfe5b7ac5f79744685d311a652393a4" alt="Gorbit Slack Bot Configuration" width="2132" height="2186" data-path="assets/admins/slackbot/slackbot_config.png" />
  </Step>
</Steps>

<HowToUseGorbitBot />

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

هناك مجموعة من خيارات التكوين المتقدمة المتاحة عبر متغيرات البيئة التي تتحكم في سلوك
روبوت Slack الخاص بك.

يمكنك العثور على القائمة الكاملة لخيارات التكوين [في GitHub
Gorbit](https://github.com/gorbit-dot-app/gorbit/blob/main/backend/gorbit/configs/gorbitbot_configs.py).

<Warning>
  خيارات التكوين هذه نادرًا ما تكون مطلوبة ويجب استخدامها بحذر.
</Warning>

<AccordionGroup>
  <Accordion title="GORBIT_BOT_NUM_RETRIES">
    عدد محاولات إعادة المحاولة لإنشاء إجابة قبل الفشل.

    الافتراضي: `5 (int)`
  </Accordion>

  <Accordion title="GORBIT_BOT_NUM_DOCS_TO_DISPLAY">
    عدد المستندات المعروضة تحت "المستندات المرجعية".

    الافتراضي: `5 (int)`
  </Accordion>

  <Accordion title="GORBIT_BOT_DISABLE_DOCS_ONLY_ANSWER">
    تعطيل الردود التي تظهر فقط "المستندات المرجعية" عندما لا يستطيع LLM الإجابة.

    الافتراضي: `false (bool)`
  </Accordion>

  <Accordion title="GORBIT_BOT_REACT_EMOJI">
    رمز تعبيري يظهر أثناء تفكير Gorbit في رسالة.

    الافتراضي: `eyes (str)`
  </Accordion>

  <Accordion title="GORBIT_BOT_FOLLOWUP_EMOJI">
    رمز تعبيري يُستخدم للإشارة إلى أن المستخدم قد يحتاج لمزيد من المساعدة.

    الافتراضي: `sos (str)`
  </Accordion>

  <Accordion title="GORBIT_BOT_FEEDBACK_VISIBILITY">
    رؤية ملاحظات إجابات AI المرسلة إلى GorbitBot. الخيارات: `private` (فقط المستخدم النقر)،
    `anonymous` (عام لكن مجهول)، `public` (عام مع اسم المستخدم).

    الافتراضي: `private (str)`
  </Accordion>

  <Accordion title="NOTIFY_SLACKBOT_NO_ANSWER">
    إذا تم التمكين، يرسل GorbitBot رسالة اعتذار موجزة عندما لا يجد إجابة، لذلك لن يتساءل المستخدمون.

    الافتراضي: `false (bool)`
  </Accordion>

  <Accordion title="GORBIT_BOT_DISPLAY_ERROR_MSGS">
    إظهار تفسيرات خطأ موجزة عندما يحدث خطأ ما في الإجابة على سؤال (مفيد للتصحيح).

    الافتراضي: `false (bool)`
  </Accordion>

  <Accordion title="GORBIT_BOT_RESPOND_EVERY_CHANNEL">
    الرد في جميع القنوات افتراضيًا، بدلاً من فقط تلك المكوّنة في الواجهة.

    الافتراضي: `false (bool)`
  </Accordion>

  <Accordion title="GORBIT_BOT_MAX_QPM">
    الحد الأقصى للأسئلة في الدقيقة التي يمكن للروبوت الإجابة عليها. اضبط على `0` أو اتركه غير مضبوط لعدم الحد.

    الافتراضي: `uncapped (int)`
  </Accordion>

  <Accordion title="GORBIT_BOT_MAX_WAIT_TIME">
    الحد الأقصى للوقت بالثواني الذي سينتظره السؤال في قائمة الانتظار قبل انتهاء المهلة.

    الافتراضي: `180 (seconds; 3 minutes)`
  </Accordion>

  <Accordion title="GORBIT_BOT_FEEDBACK_REMINDER">
    الدقائق التي يُرسل بعدها تذكير برسالة مباشرة لطلب ملاحظات على إجابة. اضبط على `0` للتعطيل.

    الافتراضي: `0 (disabled; 0 minutes)`
  </Accordion>

  <Accordion title="GORBIT_BOT_REPHRASE_MESSAGE">
    إعادة صياغة رسائل مستخدم Slack قبل إرسالها إلى LLM (قد يحسن الوضوح للنموذج).

    الافتراضي: `false (bool)`
  </Accordion>

  <Accordion title="GORBIT_BOT_RESPONSE_LIMIT_PER_TIME_PERIOD">
    عدد الردود التي يمكن لـ GorbitBot إرسالها خلال نافذة زمنية. اضبط على `0` لتعطيل الحد.

    الافتراضي: `5000 (int)`
  </Accordion>

  <Accordion title="GORBIT_BOT_RESPONSE_LIMIT_TIME_PERIOD_SECONDS">
    طول نافذة حد الرد بالثواني.

    الافتراضي: `86400 (seconds; 24 hours)`
  </Accordion>
</AccordionGroup>