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

> ## Agent Instructions
> Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request.
> Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance.
> For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code.
> The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust.
> Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool.
> Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name <name> --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md.

# إدارة وكيل Slack والفوترة

> اضبط حدود وكيل Slack وسقف إنفاقه، واطّلع على تكلفته كل شهر، وتحقّق من طريقة تعامله مع بيانات Slack.

يضبط المالكون والمسؤولون حدود وكيل Slack وسقف إنفاقه في **الإعدادات ← Slack**، ويدفعون سعرًا شهريًا مقابل الأشخاص الذين استخدموه، إضافة إلى tokens النماذج بسعر كل نموذج. لإضافة الوكيل أولًا، راجع [إعداد وكيل Slack](https://phaseo.app/docs/ar/v1/guides/slack-agent.md). أما إعدادات الميزات المفردة، مثل البحث في Slack والذاكرة والمهام المتكررة والصفحات المشتركة، فهي مع تلك الميزات في [استخدام وكيل Slack](https://phaseo.app/docs/ar/v1/guides/slack-agent-usage.md).

## الحدود

يضبطها المالكون والمسؤولون في **الإعدادات ← Slack**:

| الإعداد | ما يفعله | الافتراضي |
| - | - | - |
| **الخطة** | عدد الأشخاص الذين يخدمهم الوكيل شهريًا: حتى 3 أو 10 أو 25 أو 50 أو 100، أو عدد تختاره أكبر من 100. | حتى 3 أشخاص |
| **عندما يتجاوز شخص جديد الخطة** | **الرفض** يخبر الشخص الجديد بأن الخطة ممتلئة. **الانتقال إلى خطة أعلى تلقائيًا** يجعل الخطة تكبر مع الأشخاص الذين يستخدمون الوكيل، حتى **الحد الأقصى للأشخاص شهريًا**. | **الرفض** |
| **الحد الأقصى للأشخاص شهريًا** | حد ثابت لعدد الأشخاص في الشهر، أيًّا كانت الخطة. لا يمكن أن يكون أقل من الخطة. | بلا حد |
| **سقف الإنفاق الشهري** | أقصى ما يمكن أن تبلغه الرسوم الشهرية للوكيل. عندما تتجاوزه الإجابة التالية، يتوقف الوكيل عن الإجابة حتى الشهر التالي. يجب أن يغطي سعر الخطة على الأقل. | يُضبط عند التثبيت |
| **الإجابات لكل شخص في الساعة** | يمنع شخصًا واحدًا من استهلاك الشهر كله. | 60 |
| **حد الإنفاق الشهري على النماذج** | يحدّ مما ينفقه مفتاح API الخاص بالوكيل على tokens النماذج كل شهر. | بلا حد |

يوجد **السماح للضيوف** و**السماح لأشخاص من شركات أخرى** تحت **الحدود** أيضًا؛ راجع [من يمكنه استخدامه](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#who-can-use-it).

يضبط قسم **الوكيل** النموذج و**التعليمات**: إرشادات إضافية يتبعها الوكيل في كل إجابة، مثل النبرة أو ما يركّز عليه، حتى 8,000 حرف.

### حدود كل إجابة

تتوقف كل إجابة بعد 12 خطوة أو $0.50 من الإنفاق على النموذج، أيهما يحدث أولًا. الخطوة هي استدعاء واحد للنموذج والأدوات التي يشغّلها، مثل بحث على الويب. تُحتسب النماذج الأخرى التي يسألها الوكيل، والنماذج في المقارنة، والصور التي ينشئها الوكيل كلها ضمن الـ $0.50 نفسها. عندما يوقف حدٌّ إجابةً، يذكر الوكيل ذلك، ويمكنك أن تطلب منه المتابعة. هذه الحدود واحدة لكل مساحات العمل.

## ما تكلفته

تدفع مقابل عدد الأشخاص الذين تلقوا إجابة واحدة على الأقل خلال الشهر (UTC). يُحتسب الشخص مرة واحدة في الشهر مهما كان عدد الإجابات التي تلقاها، والشهر الذي لا يستخدم فيه أحد الوكيل لا يكلّف شيئًا.

| الأشخاص الذين استخدموا الوكيل خلال الشهر | السعر شهريًا |
| - | - |
| من 1 إلى 3 | \$0.99 |
| من 4 إلى 10 | \$2.99 |
| من 11 إلى 25 | \$4.99 |
| من 26 إلى 50 | \$7.99 |
| من 51 إلى 100 | \$14.99 |
| من 101 إلى 1,000 | يرتفع بالتساوي من $15 إلى $59، بالدولار الكامل. مثلًا، 200 شخص بسعر $20 و500 شخص بسعر $35. |
| أكثر من 1,000 | $59، أو $0.045 لكل شخص بالدولار الكامل عندما يكون ذلك أكثر (بدءًا من نحو 1,300 شخص). مثلًا، 2,000 شخص بسعر \$90. |

يشمل كل شخص 300 إجابة شهريًا، مشتركة على مستوى مساحة العمل كلها. وتكلّف الإجابات الإضافية \$0.25 لكل 1,000.

مثلًا، إذا تلقى 8 أشخاص 3,000 إجابة في شهر، فالسعر $2.99 لما يصل إلى 10 أشخاص. لديهم 2,400 إجابة مشمولة، فتكلّف الإجابات الـ 600 الأخرى $0.15، وتبلغ رسوم الشهر \$3.14. غيّر الأرقام لتحسب شهرك:

<dl>
  <dt />

  <dd />
</dl>

tokens النماذج ليست جزءًا من هذا السعر. تُحتسب عبر مفتاح API الخاص بالوكيل كطلبات Gateway عادية، بسعر كل نموذج، أثناء إجابة الوكيل. حدّها باستخدام **حد الإنفاق الشهري على النماذج**.

### كيف تُحتسب الرسوم

* تُخصم رسوم الشهر من رصيدك في الساعات الأولى بعد انتهاء الشهر، ولا تتجاوز أبدًا **سقف الإنفاق الشهري**.
* يعرض **هذا الشهر** في **الإعدادات ← Slack** الأشخاص والإجابات والرسوم المقدّرة حتى الآن. تظهر كل رسوم ضمن **الرسوم السابقة** وفي معاملات الفوترة باسم **وكيل Slack**.
* إذا لم يغطِّ رصيدك الرسوم، تنتظر الرسوم توفر الرصيد، وتصبح حالة الوكيل **الدفع مستحق**. يتوقف عن الإجابة حتى تُدفع الرسوم. يعيد Phaseo المحاولة كل ساعة، لذا تُستأنف الإجابات خلال نحو ساعة من إضافة الرصيد. يُحدَّد المبلغ عند المحاولة الأولى.

## رسائل البريد إلى المالكين والمسؤولين

عندما يرفض الوكيل أشخاصًا لسبب لا يستطيع إصلاحه إلا مالك أو مسؤول، يرسل Phaseo بريدًا إلى كل مالكي مساحة العمل ومسؤوليها:

| السبب | موضوع البريد | ما يجب فعله |
| - | - | - |
| الخطة ممتلئة | Slack agent: someone new was turned away | اختر خطة أكبر، أو **الانتقال إلى خطة أعلى تلقائيًا**. |
| بلوغ **الحد الأقصى للأشخاص شهريًا** | Slack agent: people limit reached | ارفع **الحد الأقصى للأشخاص شهريًا** أو أزله. |
| بلوغ **سقف الإنفاق الشهري** | Slack agent: monthly spending cap reached | ارفع السقف، أو انتظر الشهر التالي. |
| رسوم غير مدفوعة | Slack agent: paused until the charge is paid | أضف رصيدًا. |

يُرسل كل بريد مرة واحدة على الأكثر شهريًا لكل سبب. لا يذكر أي مستخدم في Slack ولا يقتبس أي رسائل.

لا تُرسل رسائل بريد عن رفض الضيوف أو الأشخاص من شركات أخرى أو الرفض بسبب الحد بالساعة. يسجّل سجل نشاط مساحة العمل كل شهر أول رفض بسبب امتلاء الخطة أو بلوغ **الحد الأقصى للأشخاص شهريًا** أو **سقف الإنفاق الشهري**، وبالنسبة إلى الضيوف والأشخاص من شركات أخرى والحد بالساعة، أول رفض لكل شخص. لا يقول رد الوكيل في Slack أبدًا إن مسؤولًا قد أُبلغ.

## البيانات والخصوصية

لا تسمح شروط واجهة Slack البرمجية بالتدريب على بيانات Slack ولا بأرشفتها، لذا أُعدّ الوكيل على هذا النحو:

* **لا محتوى للرسائل في سجلات Phaseo.** لا يخزّن مفتاح API الخاص بالوكيل أبدًا محتوى الطلبات أو الاستجابات، لا في السجلات ولا في الذاكرة المؤقتة ولا في بيانات القياس عن بُعد، أيًّا كانت إعدادات مساحة عملك. تظل طلباته تظهر في استخدامك وسجلاتك دون محتوى، مع [تسميات الطلبات](https://phaseo.app/docs/ar/v1/guides/request-labels.md) `app=slack-agent` و`slack_team` و`slack_channel` و[عنوان التطبيق](https://phaseo.app/docs/ar/v1/guides/app-attribution.md) `Phaseo Slack agent`.
* **لا مزوّدين يدرّبون على الموجّهات.** يعطّل [ضابط الحماية](https://phaseo.app/docs/ar/v1/cookbook/guardrails-for-api-keys.md) **Slack agent** التدريب على النماذج المدفوعة والمجانية ونشر الموجّهات، فلا يُستخدم أبدًا أي مزوّد يدرّب على الموجّهات. يمكن أن يجيب مزوّدون يحتفظون بسجلات دون التدريب عليها، وقد يحتفظون بمحتوى الرسائل في تلك السجلات وفق سياساتهم الخاصة؛ أما سجلات Phaseo وذاكرته المؤقتة وبيانات القياس عن بُعد فلا تزال لا تحتفظ بأي محتوى للرسائل.
* **ذاكرة عمل قصيرة.** يحتفظ الوكيل لكل سلسلة رسائل بإجاباته الأخيرة، وملاحظات قصيرة عن الأدوات التي استخدمها، والرسائل التي تنتظر دورها، ومعرّفات أحدث رسائل السلسلة (دون نصها) ليعرف من أين يقرأ، ومن أرسل إليهم زر Connect، والأسئلة التي طرحها مع إجاباتها. تُحذف بعد 7 أيام من آخر نشاط في السلسلة.
* **ذاكرة يمكنك رؤيتها وحذفها.** يحتفظ الوكيل بالملاحظات والعناصر المثبّتة والمهام والمهارات التي يطلب منه الأشخاص حفظها، بكلماته هو وليست نسخًا من الرسائل أبدًا، مع معرّف Slack الخاص بمن طلب ذلك. تبقى حتى يحذفها أحد، أو يمضي التاريخ الذي حُفظت حتى حلوله، أو تلغي تثبيت الوكيل. يمكن للمالكين والمسؤولين رؤيتها وحذفها في **الإعدادات ← Slack**، وإيقاف الملاحظات من هناك (راجع [الذاكرة والمهارات](https://phaseo.app/docs/ar/v1/guides/slack-agent-usage.md#memory-and-skills)). لا يرى الأشخاص من شركات أخرى ملاحظات مساحة العمل كلها أبدًا.
* **تُقرأ الملفات المشتركة ولا تُحفظ.** ينزّل الوكيل الصور وملفات PDF التي يقرؤها لإجابة ما، ويرسلها إلى النموذج مع طلبات تلك الإجابة وفق القواعد نفسها. لا يخزّنها أبدًا؛ ولا يبقى مع الرسالة سوى معرّفات ملفاتها في Slack وأسمائها حتى تنتهي الإجابة.
* **لا تُحفظ نتائج البحث في Slack.** ما يجده الوكيل عندما [يبحث في Slack](https://phaseo.app/docs/ar/v1/guides/slack-agent-usage.md#searching-slack) يذهب إلى النموذج مع طلبات تلك الإجابة ولا يذهب إلى أي مكان آخر: لا إلى ذاكرة العمل، ولا إلى سجلاته، ولا إلى قاعدة بيانات Phaseo، ولا حتى أثناء انتظاره ردك على سؤال. منذ أول بحث في الإجابة، لا تذهب طلباتها إلا إلى مزوّدين لا يحتفظون بأي بيانات، فلا تبقى النتائج في سجلات أي مزوّد أيضًا. في الإجابة التي بحثت، لا تحتفظ ذاكرة العمل إلا بالأدوات التي استخدمها وبملاحظة أنه أجاب، لا بما بحث عنه ولا بما وجده ولا بما كتبه. يُحفظ إذن Slack بالبحث نيابةً عنك مع رسالتك حتى تنتهي الإجابة.
* **المهام المتكررة.** لكل مهمة، يحتفظ الوكيل بعنوانها وتعليماتها، ومكان نشرها، وجدولها ومنطقتها الزمنية، ومعرّف Slack للشخص الذي أعدّها، ونتيجة آخر تشغيل لها. تبقى حتى يلغي أحد المهمة أو يحذفها، أو تلغي تثبيت الوكيل. يمكن للمالكين والمسؤولين رؤيتها وإيقافها مؤقتًا وحذفها في **الإعدادات ← Slack**.
* **صفحات مشتركة حتى تنتهي صلاحيتها.** قد تتضمن الصفحة التي ينشرها الوكيل ما قيل في Slack أو ما وجده، لكنها لا تتضمن أبدًا نتائج البحث في Slack. الصفحات ثابتة، لذا لا تستطيع الصفحة تشغيل برامج نصية ولا إرسال أي شيء إلى أي مكان. يحتفظ Phaseo بالصفحة وعنوانها ومعرّف Slack للشخص الذي طلبها وعدد مرات فتحها حتى تنتهي صلاحيتها (بعد 7 أو 30 أو 90 يومًا، حسب اختيار المسؤولين)، أو يحذفها مالك أو مسؤول، أو تلغي تثبيت الوكيل. يمكن لأي شخص لديه رابطها فتحها، أو لأعضاء مساحة عمل Slack الذين سجّلوا الدخول فقط، حسب إعداد الصفحة. لا تظهر الصفحات أبدًا في سجلات Phaseo.
* **لا شيء مؤرشف.** لا يؤرشف Phaseo أي شيء من Slack. لا تحتفظ سجلات الوكيل نفسه إلا بمعرّفات Slack والحالات.
* **أسرار مشفّرة.** تُخزَّن رموز البوت وأسرار تطبيق Slack الخاص بك مشفّرة ولا تُعرض مرة أخرى.

يحذف إلغاء التثبيت مفتاح API الخاص بالوكيل وملاحظاته ومهاراته المحفوظة ومهامه المتكررة وصفحاته المشتركة، ويزيل ضابط الحماية الخاص به (راجع [الإيقاف المؤقت أو إلغاء التثبيت](#pause-or-uninstall)).

## الإيقاف المؤقت أو إلغاء التثبيت

* يوقف **إيقاف الإجابات مؤقتًا** في **الإعدادات ← Slack** كل الإجابات حتى تختار **استئناف الإجابات**. يتلقى من يراسل الوكيل ملاحظة خاصة بأنه متوقف مؤقتًا. تتخطى المهام المتكررة التشغيلات التي يحين موعدها أثناء الإيقاف المؤقت، ثم تستمر في موعدها التالي بعد استئناف الإجابات.
* يوقف **إلغاء التثبيت** الوكيل فورًا، ويحذف مفتاح API الخاص به وملاحظاته ومهاراته المحفوظة ومهامه المتكررة، ويزيل ضابط الحماية الخاص به، ويزيل التطبيق من Slack. إذا لم يؤكد Slack الإزالة، يخبرك Phaseo بذلك، وعليك إزالة التطبيق من Slack أيضًا. يبقى ضابط الحماية إذا كنت قد أضفته إلى مفاتيح أو أعضاء آخرين.
* يحذف إلغاء التثبيت أيضًا الصفحات المشتركة للوكيل، لذا تتوقف روابطها عن العمل.
* تؤدي إزالة التطبيق من داخل Slack، أو إلغاء رمز البوت الخاص به، إلى إلغاء تثبيته في Phaseo بالطريقة نفسها.

تبقى الرسوم السابقة في سجل الفوترة. يظل الأشخاص الذين استخدموا الوكيل في الشهر الذي ألغيت فيه التثبيت يُحتسبون عند انتهاء ذلك الشهر. يمكنك إضافة الوكيل مرة أخرى في أي وقت.

## عندما لا يستطيع الوكيل الإجابة

عندما لا يستطيع الوكيل الإجابة عن شخص ما، يرد عليه بشكل خاص في Slack:

| الرد في Slack | السبب | الحل |
| - | - | - |
| "The Phaseo agent is paused until this workspace's Phaseo bill is paid." | رسوم شهر سابق تنتظر الرصيد (**الدفع مستحق**). | أضف رصيدًا. تُستأنف الإجابات خلال نحو ساعة. |
| "The Phaseo agent is paused in this Slack workspace." | اختار مسؤول **إيقاف الإجابات مؤقتًا**. | اختر **استئناف الإجابات**. |
| "…has answered as many people this month as this workspace's plan covers…" | الخطة ممتلئة ويُرفض الأشخاص الجدد. | اختر خطة أكبر، أو **الانتقال إلى خطة أعلى تلقائيًا**. |
| "This workspace has reached its Slack agent limit for the month." | بُلغ **الحد الأقصى للأشخاص شهريًا**. | ارفع الحد أو أزله. |
| "…has reached this workspace's monthly spending cap…" | ستتجاوز الإجابة التالية **سقف الإنفاق الشهري**. | ارفع السقف، أو انتظر الشهر التالي. |
| "You've reached the limit of … answers an hour." | بُلغ حد **الإجابات لكل شخص في الساعة**. | انتظر، أو ارفع الحد. |
| "The Phaseo agent isn't available to guests in this workspace." | **السماح للضيوف** معطّل. | فعّله إذا كان يجب أن يستخدم الضيوف الوكيل. |
| "The Phaseo agent only answers people in this organization." | **السماح لأشخاص من شركات أخرى** معطّل. | فعّله إذا كان يجب أن يستخدموا الوكيل. |
| "Connect your Phaseo account to use the Phaseo agent here." | الوصول مضبوط على **الحسابات المرتبطة فقط**. | [اربط حساب Slack](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#link-a-slack-account). |
| "I'm still working through earlier messages in this thread." | هناك 5 رسائل تنتظر بالفعل في هذه السلسلة. | انتظر تلك الإجابات. |
| "Sorry, I couldn't check your Slack account just now." | لم يستجب Slack لعملية بحث. | حاول مرة أخرى بعد دقيقة. |
| "The model chosen for this agent isn't available to the Slack agent." | لا يستطيع الـ Gateway استخدام نموذج الوكيل بمفتاحه: **تلقائي** دون التوجيه التلقائي، أو لا يستوفي أي مزوّد للنموذج ضابط الحماية **Slack agent**. | اختر نموذجًا آخر في **الإعدادات ← Slack**. |
| "…isn't one of the models you can choose here, so I didn't answer." | بدأت الرسالة بـ `with …:` وذكرت نموذجًا غير موجود ضمن **اختيار النموذج**، أو اسمًا يطابق أكثر من نموذج مسموح به. | استخدم نموذجًا من القائمة في الرد، أو احذف `with …:`. |
| "The model you chose for this message isn't available to the Slack agent." | لا يستطيع الـ Gateway استخدام النموذج المختار بمفتاح الوكيل، كما في الصف السابق. | اسأل دون `with …:`، أو استبدل النموذج ضمن **اختيار النموذج**. |
| "The model this agent uses can't read the files shared here." | لا يستطيع أي مزوّد لنموذج الوكيل قراءة الصور أو ملفات PDF المشتركة. | اسأل دون الملفات، أو اختر في **الإعدادات ← Slack** نموذجًا يقرأ الصور. |
| "I stopped here: after a Slack search, I can only use AI providers that keep no data…" | بحثت الإجابة في Slack، ولم يستطع أي مزوّد للنموذج لا يحتفظ بأي بيانات أن يجيب. | اختر في **الإعدادات ← Slack** نموذجًا لا يحتفظ بالبيانات. وإذا بدأت الرسالة بـ `with <model>:`، فاختر هناك نموذجًا لا يحتفظ بالبيانات، أو احذفها لاستخدام نموذج الوكيل. |
| "…so I didn't compare them." أو "Name 2 or 3 different models to compare…" | بدأت الرسالة بـ `compare …:`، وأحد النماذج ليس ضمن **اختيار النموذج**، أو طابق اسم أكثر من نموذج مسموح به، أو ذكرت أقل من نموذجين أو أكثر من 3 نماذج مختلفة. | استخدم نموذجين أو 3 من القائمة في الرد. |
| "Comparing models isn't turned on here, so I didn't answer." | بدأت الرسالة بـ `compare …:` وذكرت نماذج من الكتالوج، لكن اختيار النموذج معطّل. | اطلب من مالك أو مسؤول تفعيل **السماح باختيار نموذج لكل رسالة** ضمن **اختيار النموذج**، أو احذف `compare …:`. |

إذا لم يرد الوكيل على الإطلاق، أو لم يكتمل التثبيت، فراجع [إصلاح مشكلات الإعداد](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#fix-setup-problems).


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