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

> اذكر وكيل Phaseo في Slack أو راسله مباشرةً لتطرح الأسئلة وتقارن النماذج وتبحث في Slack وتجدول المهام وتنشر الصفحات.

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

## استخدام الوكيل في Slack

* **الرسائل المباشرة:** افتح الوكيل من تطبيقاتك في Slack واكتب في علامة التبويب **Messages** الخاصة به. يجيب عن كل رسالة.
* **القنوات:** ادعُ الوكيل إلى قناة عامة أو خاصة، ثم اذكره، مثل `@Phaseo which model should we use to summarise call transcripts?`. يردّ في سلسلة رسائل. اذكره مجددًا لكل متابعة في تلك السلسلة.

أثناء إجابته:

* يقرأ الجزء الأحدث من السلسلة حتى رسالتك، ليتابع المحادثة. يسمح له Slack بقراءة 15 رسالة في كل مرة، ويسمح لتطبيق Phaseo بالقراءة مرة في الدقيقة تقريبًا في كل مساحة عمل Slack.
  * يرى دائمًا أول رسالة في السلسلة.
  * في الرسالة المباشرة، يقرأ أحدث رسائل محادثتك معه.
  * في القناة، يقرأ أحدث الرسائل من آخر 30 دقيقة على الأكثر.
  * عندما تُكتب رسائل أكثر مما استطاع قراءته، يُبلَّغ بأن بعضها مفقود.
  * عندما لا يسمح له Slack بقراءة السلسلة في تلك اللحظة، يعمل انطلاقًا من ردوده السابقة في السلسلة.
* يجيب عن رسالة واحدة في كل مرة في كل سلسلة. تنتظر حتى 5 رسائل أخرى دورها؛ وبعد ذلك يطلب منك انتظار الإجابات السابقة.
* يوقف زر الإيقاف في Slack الإجابة التي يعمل عليها.
* تنتهي كل إجابة باسم النموذج وما كلّفته الإجابة من tokens النموذج، مثل `Auto → GPT-6 Astra · $0.0031`. مع **تلقائي**، يأتي النموذج الذي اختاره بعد سهم، وتأتي النماذج الأخرى التي استخدمتها الإجابة بعد علامة +. يرتبط اسم النموذج بصفحته على Phaseo، وترتبط التكلفة بطلبات تلك الإجابة في **السجلات**، التي يمكن لأعضاء مساحة عمل Phaseo فتحها.

لكل إجابة حد للخطوات والإنفاق؛ راجع [حدود كل إجابة](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer).

## اختيار نموذج لكل رسالة

يمكن للمالكين والمسؤولين السماح للأشخاص باختيار النموذج لرسالة واحدة. في **الإعدادات ← Slack**، تحت **اختيار النموذج**، فعّل **السماح باختيار نموذج لكل رسالة** وأضف حتى 10 نماذج من كتالوج Phaseo. إذا كان لدى مساحة عملك Auto Routing، يضيف **تضمين «تلقائي»** الخيار **تلقائي** إلى القائمة. يظل النموذج المحدد تحت **الوكيل** يجيب عن كل الرسائل الأخرى.

لاختيار نموذج، ابدأ الرسالة بـ `with <model>:` واذكر نموذجًا مسموحًا باسمه أو معرّفه:

```text theme={null}
@Phaseo with Claude Opus 5.5: check this incident summary for gaps
with openai/gpt-6-astra: draft a reply to this customer
```

* تُطابَق النماذج المسموحة فقط، دون اعتبار لحالة الأحرف. تكفي بداية الاسم أو المعرّف عندما لا يحملها إلا نموذج مسموح واحد، لذا يعمل `with claude:` عندما يكون في القائمة نموذج Claude واحد. ويعمل المعرّف أيضًا دون اسم المختبر، مثل `with gpt-6-astra:`.
* يجيب الوكيل عن تلك الرسالة بذلك النموذج، دون الجزء `with …:`، ويذكر التذييل النموذج الذي أجاب.
* إذا ذكرت نموذجًا من الكتالوج غير موجود في القائمة، أو انطبق الاسم على أكثر من نموذج، يردّ الوكيل بشكل خاص بالنماذج التي يمكنك اختيارها ولا يجيب. لا تُحتسب تلك الرسالة إجابةً. أما الرسالة التي تبدأ بـ "With …:" لكنها لا تذكر نموذجًا، مثل "With regards to the invoice: …"، فيُجاب عنها كالمعتاد.
* تبقى لكل إجابة [الحدود](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer) نفسها، \$0.50 و12 خطوة، أيًّا كان النموذج الذي يجيب. وتُفوتر tokens النموذج بسعره الخاص.
* يظل حاجز الحماية **وكيل Slack** ساريًا. إذا لم يستوفه أي مزوّد للنموذج المختار، يقول الوكيل ذلك بدلًا من الإجابة.

### سؤال نموذج آخر

ما دام اختيار النموذج مفعّلًا، يمكن للوكيل أيضًا أن يسأل أحد النماذج المسموحة عن رأي ثانٍ أثناء إجابته، مثلًا عندما تسأل عن رأي نموذج آخر:

```text theme={null}
@Phaseo draft a reply to this customer, then ask Claude Opus 5.5 to check it
```

* لا يرى النموذج الآخر إلا ما يرسله إليه الوكيل. لا يرى سلسلة Slack، ولا يستطيع البحث في الويب أو استخدام الأدوات.
* يمكن للوكيل سؤال نماذج أخرى حتى 3 مرات في إجابة واحدة. تُحتسب تكلفتها ضمن [حد \$0.50](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer) نفسه، ويتوقف الوكيل عن السؤال عندما يتبقى أقل مما يلزم لإنهاء إجابته.
* يذكر التذييل كل نموذج استُخدم، مثل `GPT-6 Astra + Claude Opus 5.5 · $0.0123`، وتشملها التكلفة.
* إذا تعذّر استخدام نموذج، مثلًا لأن أيًّا من مزوّديه لا يستوفي حاجز الحماية **وكيل Slack**، يُبلَّغ الوكيل بالسبب ويجيب دونه.

### مقارنة النماذج

لترى كيف يجيب نموذجان أو 3 نماذج مسموحة عن السؤال نفسه، ابدأ الرسالة بـ `compare`، ثم النماذج مفصولة بفواصل، ثم نقطتين:

```text theme={null}
@Phaseo compare GPT-6 Astra, Claude Opus 5.5: what are the risks of moving our database to another region?
compare gpt-6-astra, claude, auto: summarise the EU AI Act in five bullet points
```

* تُطابَق النماذج كما في `with <model>:`، من القائمة المسموحة فقط. إذا لم يكن نموذج في القائمة، أو انطبق اسم على أكثر من نموذج، أو ذكرت أقل من نموذجين أو أكثر من 3، أو لم يكن هناك سؤال بعد النقطتين، يردّ الوكيل بشكل خاص ولا يجيب. لا تُحتسب تلك الرسالة إجابةً. أما الرسالة التي لا تذكر أي نموذج على الإطلاق، مثل `compare the two plans, then pick one: …`، فهي نص عادي ويجيب عنها الوكيل كالمعتاد. وما دام اختيار النموذج متوقفًا، تتلقى رسالة `compare …:` التي تذكر نماذج من الكتالوج ردًا خاصًا بأن المقارنة متوقفة، ولا تُحتسب إجابةً.
* يتلقى كل نموذج سؤالك، لا بقية السلسلة، ويمكنه البحث في الويب وقراءة صفحات الويب. وتجيب النماذج في الوقت نفسه.
* يحتوي الرد على قسم لكل نموذج: اسمه مرتبطًا بصفحته على Phaseo، وما كلّفه، وإجابته. يُطلب من كل نموذج أن يُبقي إجابته قصيرة، وتُقتطع الإجابات الطويلة لتتسع كلها في رسالة Slack واحدة.
* إذا فشل نموذج، يذكر قسمه السبب، وتظل الإجابات الأخرى معروضة.
* تُحتسب المقارنة إجابةً واحدة. يُقسَّم \[حد $0.50](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer) بالتساوي بين النماذج، ويذكر التذييل جميعها ويعرض الإجمالي. لا يحدد التقسيم إلا ما إذا كان النموذج سيُسأل: لا يُسأل النموذج عندما تقل حصته عن $0.02. لا تتوقف الإجابة عند حصتها، لذا قد تكلّف أكثر؛ وبدلًا من ذلك يُحدَّد طول رد كل نموذج.

### الأسئلة ذات الأزرار

عندما يحتاج الوكيل إلى أن تختار بين بضعة خيارات أو توافق على شيء قبل أن يتابع، يسأل في السلسلة مع زر لكل خيار، حتى 5 أزرار. ويمكنه أيضًا عرض **Other…**، الذي يفتح نموذجًا صغيرًا لتكتب إجابتك بكلماتك.

* لا يستطيع الإجابة إلا الشخص الذي يجيبه الوكيل. ومن يضغط زرًا غيره يتلقى ملاحظة خاصة.
* يمكنك أيضًا الرد في السلسلة بدلًا من ذلك (في القناة، اذكر الوكيل). يُعدّ ردك إجابتك.
* بعد أن تجيب، تُستبدل الأزرار بإجابتك ويتابع الوكيل من حيث توقف.
* ينتظر السؤال حتى ساعة. بعد ذلك يذكر السؤال أنه انتهت صلاحيته وتنتهي الإجابة عنده. اسأل مجددًا عندما تكون مستعدًا.
* يعمل زر الإيقاف في Slack أيضًا أثناء الانتظار.
* أثناء الانتظار، تنتظر رسائل الأشخاص الآخرين في السلسلة دورها، ويُبلَّغون بشكل خاص بمن ينتظره الوكيل.
* يمكن لإجابة واحدة أن تطرح حتى 3 أسئلة. يُحتسب كل ذلك إجابةً واحدة، وتغطي [حدود كل إجابة](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer) كل شيء، قبل كل سؤال وبعده.

### التحقق من علامة التبويب Home

افتح الوكيل في Slack واختر **Home** لترى طريقة استخدامه والنموذج الذي يستخدمه وما إذا كان حسابك في Phaseo مربوطًا. إذا لم يكن مربوطًا، وكان الربط مفيدًا (مع **الحسابات المرتبطة فقط**، أو حيث يُسمح ببيانات الاستخدام)، تعرض علامة التبويب الزر **Connect your Phaseo account**. ويرى أعضاء مساحة عمل Phaseo الذين ربطوا حساباتهم أيضًا عدد الإجابات التي قدّمها الوكيل في مساحة عمل Slack هذا الشهر (بتوقيت UTC). تعرض علامة التبويب الإعدادات والأعداد فقط، ولا تعرض الرسائل أبدًا. كما تسرد المهام المتكررة التي أعددتها، مع موعد تشغيلها التالي (راجع [المهام المجدولة](#scheduled-tasks)).

مع تطبيق Slack خاص بك، تحتاج علامة التبويب Home إلى أحدث [manifest](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#use-your-own-slack-app).

## الرسوم البيانية والصور والملفات

يمكن للوكيل نشر رسوم بيانية وصور في السلسلة، وقراءة الصور وملفات PDF التي تشاركها معه.

* **الرسوم البيانية:** اطلب رسمًا بيانيًا، مثل `@Phaseo chart our spend by week this month`. يرسم الوكيل مخططًا شريطيًا أو خطيًا أو دائريًا من الأرقام المتوفرة لديه وينشره في السلسلة صورةً. يستخدم نص الرسم البياني الحروف اللاتينية والسيريلية؛ وأي شيء آخر يبقى في رده.
* **الصور:** اطلب منه إنشاء صورة، مثل `@Phaseo make an icon of a paper plane in blue`. يستخدم [GPT Image 2](https://phaseo.app/models/openai/gpt-image-2) عبر مفتاح API الخاص بالوكيل، ويُفوتر كأي طلب آخر. تكلّف الصورة بضعة سنتات وتُحتسب ضمن \[حد $0.50](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer) للإجابة، ويشملها تذييل الإجابة. تنشئ الإجابة الواحدة صورتين على الأكثر، وفقط ما دام متبقيًا من حدها $0.15 على الأقل.
* **الملفات التي تشاركها:** أرفق صورًا (PNG أو JPEG أو GIF أو WebP، حتى 5 MB لكل منها) أو ملفات PDF (حتى 10 MB) برسالتك، أو برسائل سابقة في السلسلة يقرؤها الوكيل. يقرأ حتى 4 ملفات، بمجموع 12 MB، لكل إجابة، بدءًا بالأحدث. لا يمكن قراءة أنواع الملفات الأخرى بعد.

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

تُنزَّل الملفات التي تشاركها للإجابة التي تقرؤها ولا تُخزَّن أبدًا. أما الرسوم البيانية والصور التي ينشرها الوكيل فهي ملفات في مساحة عمل Slack لديك، مثل أي ملف آخر.

يحتاج الوكيل الذي أُضيف قبل أن يتمكن من ذلك إلى [تحديث أذونات Slack](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#update-slack-permissions).

## البحث في Slack

يمكن للوكيل البحث في مساحة عمل Slack لديك نيابةً عن الشخص الذي يسأل، والإجابة بروابط إلى الرسائل والملفات التي استخدمها. على سبيل المثال:

```text theme={null}
What did we decide about the launch date?
@Phaseo find the latest incident review in #ops and summarise it
Who has been working on the billing migration this month?
```

* **يبحث بصفتك أنت.** يستخدم البحث الفوري في Slack بالإذن الذي يمنحه له Slack لرسالتك، لذا لا يجد إلا ما يمكنك رؤيته في Slack. يبحث في القنوات العامة فقط، ولا يبحث أبدًا في القنوات الخاصة أو الرسائل المباشرة أو الرسائل المباشرة الجماعية.
* **يربط ما يستخدمه.** كل رسالة أو ملف يعتمد عليه يكون مرتبطًا، لتتمكن من فتحه في Slack. وعندما لا يجد البحث شيئًا، يقول ذلك.
* **يمكنه تضييق البحث** إلى قناة أو شخص أو نطاق زمني، ويبحث حتى 4 مرات لإجابة واحدة، 10 نتائج في كل مرة.
* **بالمعنى أو بالكلمة المفتاحية.** تُبحث الأسئلة المكتوبة بكلماتك بالمعنى في خطط Slack التي تتضمن البحث بالذكاء الاصطناعي (Business+ وEnterprise+)؛ أما الخطط الأخرى فتبحث بالكلمة المفتاحية.
* **مزوّدون لا يحتفظون بالبيانات فقط.** بعد أن تبحث الإجابة في Slack، يذهب باقيها، بما في ذلك نموذج آخر تسأله أو صورة تنشئها، إلى مزوّدي ذكاء اصطناعي ذوي احتفاظ صفري بالبيانات فقط، فلا يبقى ما وجده أبدًا في سجلات أي مزوّد. ويتوقف أيضًا البحث في الويب وقراءة صفحات الويب لبقية تلك الإجابة، فلا يمكن لأي شيء وجده أن يخرج في بحث أو رابط: اطلب منه البحث في الويب أولًا إذا احتجت إلى الأمرين.

اختر أين يبحث تحت **البحث في Slack** في **الإعدادات ← Slack**. يسري التغيير فورًا.

| الخيار | أين يبحث |
| - | - |
| **إيقاف** | لا مكان. |
| **الرسائل المباشرة** (الافتراضي) | في الرسائل المباشرة مع الوكيل فقط، فلا يقرأ ما يجده إلا الشخص الذي يسأل. |
| **الرسائل المباشرة والقنوات** | في القنوات أيضًا، عندما يذكره أحدهم. يقرأ الإجابة كل من في القناة، بمن فيهم الضيوف الذين لا يستطيعون فتح القنوات التي وجدها، لذا لا تختر هذا إلا إذا كان مقبولًا لمساحة عملك. |

تأتي بعض الحدود من Slack:

* لا يبحث إلا عند الإجابة عن رسالة شخص ما: يمنحه Slack إذن البحث مع كل رسالة تذكره أو تُرسل إليه مباشرةً، ولا يحتفظ الوكيل بذلك الإذن إلا حتى يجيب.
* لا يسمح Slack للتطبيقات بالبحث نيابةً عن الضيوف، ولا يبحث الوكيل أبدًا نيابةً عن أشخاص من شركات أخرى.
* يسمح Slack لكل شخص بالبحث نحو 10 مرات في الدقيقة. وعندما يكون الضغط أكبر من ذلك، يجيب الوكيل بما لديه ويقول ذلك.
* لا يسمح Slack بهذا البحث إلا للتطبيقات الموجودة في Slack Marketplace وللتطبيقات الخاصة بالشركة نفسها. يستطيع تطبيق Phaseo في Slack البحث بعد الموافقة على إدراجه في Slack Marketplace؛ وحتى ذلك الحين، يقول الوكيل إن البحث غير متاح. للبحث الآن، استخدم [تطبيق Slack خاصًا بك](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#use-your-own-slack-app).
* تحتاج عمليات التثبيت التي سبقت البحث إلى [تحديث أذونات Slack](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#update-slack-permissions).

يحتاج البحث أيضًا إلى نموذج يمكن أن يقدّمه مزوّد ذو احتفاظ صفري بالبيانات. مع **تلقائي**، يستطيع الوكيل البحث: بعد البحث، لا يختار «تلقائي» إلا بين النماذج التي لها مزوّد لا يحتفظ بالبيانات. لا يبحث الوكيل باستخدام نموذج يحتفظ جميع مزوّديه بالبيانات، ويقول ذلك عندما يُطلب منه. يمكن للمسؤول اختيار نموذج لا يحتفظ بالبيانات في **الإعدادات ← Slack**، أو، عندما يستطيع الأشخاص [اختيار نموذج لكل رسالة](#choosing-a-model-per-message)، بدء الرسالة بـ `with <model>:` لاستخدام أحدها. إذا أفاد الـ Gateway بعد البحث بأنه لا يوجد مزوّد لا يحتفظ بالبيانات يستطيع الإجابة، يتوقف الوكيل عند ذلك ويذكر السبب (أما الإخفاقات الأخرى، مثل غياب مفتاح المزوّد، فتتلقى رسالتها المعتادة)؛ وتظل تكلفة الإجابة حتى تلك اللحظة محتسبة.

يُستخدم ما يجده لتلك الإجابة فقط ولا يُخزَّن أبدًا (راجع [البيانات والخصوصية](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#data-and-privacy)). وللسبب نفسه، لا تستطيع الإجابة التي بحثت في Slack التوقف لطرح سؤال عليك، أو حفظ الملاحظات أو التثبيتات أو المهام أو المهارات، أو إعداد مهمة متكررة، أو نشر صفحة مشتركة.

## السؤال عن الاستخدام

يمكن للأعضاء المرتبطين سؤال الوكيل عن مساحة عمل Phaseo هذه (ومن يسأل غيرهم يتلقى [زر ربط حسابه](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#link-a-slack-account)):

* الطلبات والإنفاق خلال فترة، حسب اليوم أو الأسبوع أو الشهر، وحسب النموذج أو المزوّد؛
* رصيد الأرصدة، والأرصدة المحجوزة للطلبات الجارية، والأرصدة المنفقة هذا الشهر؛
* الطلبات والإنفاق لكل مفتاح API؛
* النماذج في كتالوج Phaseo.

التواريخ بتوقيت UTC وتبدأ الأسابيع يوم الاثنين. اختر أين يمكن للوكيل الإجابة عن هذه الأسئلة تحت **بيانات الاستخدام**:

| الخيار | أين يمكن للأعضاء المرتبطين السؤال |
| - | - |
| **إيقاف** | لا مكان. لا يشارك الوكيل بيانات الاستخدام أبدًا. |
| **الرسائل المباشرة** (الافتراضي) | في رسالة مباشرة مع الوكيل فقط. |
| **الرسائل المباشرة والقنوات المختارة** | في الرسائل المباشرة، وفي القنوات المدرجة تحت **معرّفات القنوات (ID)** (حتى 100). |

يستطيع كل من في القناة قراءة إجابات الوكيل، لذا لا تدرج إلا القنوات التي يجوز لأعضائها رؤية إنفاق مساحة عملك. يوجد معرّف القناة أسفل تفاصيلها في Slack، مثل `C0123ABCD`.

## الذاكرة والمهارات

يمكن للوكيل أن يتذكر ما يطلبه فريقك، وأن يتبع المهارات: تعليمات محفوظة للمهام التي تكررها. اطلب منه ذلك في Slack، مثل:

* `@Phaseo remember that deploys freeze on Fridays after 3pm`
* `@Phaseo pin this for everyone: our fiscal year starts on 1 April`
* `@Phaseo add a to-do: send the Q4 budget to finance`، ثم لاحقًا `@Phaseo the budget to-do is done`
* `@Phaseo what do you remember about deploys?` أو `@Phaseo forget the note about deploys`

يحفظ ثلاثة أنواع من الملاحظات، كل منها حتى 500 حرف وبكلماته هو:

| النوع | الغرض منه |
| - | - |
| **ملاحظة** | شيء يجب تذكّره. يبحث الوكيل في الملاحظات عندما تكون ذات صلة. |
| **تثبيت** | شيء يجب استحضاره طوال الوقت. يرى الوكيل حتى 10 من تثبيتات المحادثة و10 تثبيتات على مستوى مساحة العمل مع كل رسالة. |
| **مهمة** | شيء يجب متابعته، ويمكن وضع علامة عليه بأنه منجز. |

تنتمي الملاحظة إلى القناة أو الرسالة المباشرة التي حُفظت فيها، ما لم يطلب أحدهم أن تكون على مستوى مساحة العمل. في المحادثة، يرى الوكيل ملاحظات تلك المحادثة والملاحظات على مستوى مساحة العمل، ولا يرى أبدًا ملاحظات قناة أخرى أو رسالة مباشرة أخرى. الملاحظات على مستوى مساحة العمل متاحة لكل من يجيبه الوكيل في مؤسستك. أما الأشخاص من شركات أخرى في قنوات Slack Connect المشتركة فلا يرون ولا يحفظون إلا ملاحظات المحادثة التي هم فيها، ولا يرون أبدًا الملاحظات على مستوى مساحة العمل؛ ويمكنهم استخدام المهارات المحفوظة لكن لا يمكنهم حفظ مهارات جديدة، لأن المهارات تنطبق على مساحة العمل كلها. يمكن الاحتفاظ بالملاحظة حتى تاريخ معيّن، مثل `remember until Friday that the office is closed`، وتُحذف بعده.

لا يحفظ الوكيل ملاحظة إلا عندما يطلب منه أحدهم أن يتذكر شيئًا أو يثبّته أو يتابعه، أو لحقيقة دائمة مثل قرار أو موعد نهائي. ولا ينسخ أبدًا رسائل أو سلاسل كاملة.

### المهارات

المهارة اسم ووصف من سطر واحد وتعليمات حتى 4,000 حرف لمهمة يكررها فريقك، مثل تقرير أسبوعي. اطلب من الوكيل حفظ واحدة:

`@Phaseo save a skill called Weekly report: list what shipped this week, then what slipped, then next week's priorities`

مع كل رسالة، يرى الوكيل أسماء وأوصاف أحدث 20 مهارة تغيّرت. ويحمّل تعليمات المهارة عندما يطابقها طلب ما، أو عندما يطلب أحدهم ذلك، مثل `@Phaseo use the Weekly report skill`. لا يحفظ مهارة إلا عندما يطلب أحدهم ذلك صراحةً، ولا يستبدل مهارة تحمل الاسم نفسه إلا عندما يُطلب منه.

### ما يتحكم فيه المسؤولون

* **السماح للوكيل بالاحتفاظ بالملاحظات** (مفعّل افتراضيًا، تحت **الذاكرة والمهارات** في **الإعدادات ← Slack**) يوقف الملاحظات والتثبيتات والمهام. وما دام متوقفًا، لا يحفظ الوكيل أيًّا منها ولا يرى أيًّا منها، ويخبر من يطلب منه تذكّر شيء بأن مسؤولًا أوقف الذاكرة. تظل المهارات تعمل. تبقى الملاحظات المحفوظة سابقًا، ويظل بإمكان المالكين والمسؤولين رؤيتها وحذفها؛ وعند إعادة تفعيله يستخدمها الوكيل مجددًا.
* تحتفظ كل مساحة عمل Slack بما يصل إلى 500 ملاحظة و100 مهارة. عندما تمتلئ الذاكرة، يقول الوكيل ذلك؛ احذف بعضها لإفساح المجال.
* يرى المالكون والمسؤولون كل ما حفظه الوكيل تحت **الذاكرة والمهارات** في **الإعدادات ← Slack**. يمكنهم تصفية الملاحظات حسب النوع، وحذف أي ملاحظة أو مهارة، وتعديل اسم المهارة ووصفها وتعليماتها. يسجّل سجل نشاط مساحة العمل هذه التغييرات دون النص.
* [إلغاء تثبيت الوكيل](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#pause-or-uninstall) يحذف جميع ملاحظاته ومهاراته. وإضافته مجددًا تبدأ بذاكرة فارغة.

## المهام المجدولة

اطلب من الوكيل فعل شيء بانتظام، فيُعدّ مهمة متكررة في تلك المحادثة. على سبيل المثال:

* `@Phaseo every weekday at 9:00, summarise yesterday's news about electric vehicles`
* `@Phaseo every Monday at 8:30, list last week's Phaseo spend by model`
* `@Phaseo on the 1st of every month at 10:00, list the API keys nobody used last month`
* `@Phaseo which recurring tasks are set up here?` أو `@Phaseo cancel the Monday spend summary`

يؤكد الوكيل ما أعدّه: ما تفعله المهمة، وأين تنشر، وكم مرة، ومتى تُشغَّل في المرة التالية.

* **كم مرة:** كل ساعة (في الدقيقة التي تختارها)، أو كل يوم، أو في أيام العمل (من الاثنين إلى الجمعة)، أو مرة في الأسبوع في يوم تختاره، أو مرة في الشهر في يوم تختاره (وفي الأشهر الأقصر، في آخر يوم منها). ولا تتكرر أبدًا أكثر من مرة في الساعة.
* **متى:** في وقت محلي حسب المنطقة الزمنية في Slack للشخص الذي أعدّها، وكذلك عند تغيير الساعة.
* **أين:** في القناة أو الرسالة المباشرة التي أُعدّت فيها. ينشر كل تشغيل رسالة قصيرة **Scheduled: …** هناك ويجيب عنها في السلسلة. والردود في تلك السلسلة رسائل عادية إلى الوكيل.
* **ما الذي يُشغَّل:** يحفظ الوكيل الطلب تعليمةً مكتفية بذاتها، فيعمل كل تشغيل دون المحادثة التي أُعدّ فيها. لا تطرح عمليات التشغيل المجدولة أسئلة ذات أزرار ولا تبحث في Slack، ولا يمكنها إعداد مهام متكررة أو تغييرها.

كل تشغيل إجابة عادية للشخص الذي أعدّ المهمة. يتحقق الوكيل من أنه لا يزال قادرًا على استخدامه، ويُحتسب التشغيل إحدى إجاباته ضمن خطتك و**سقف الإنفاق الشهري** و**الإجابات لكل شخص في الساعة**، ويلتزم بـ[حدود كل إجابة](https://phaseo.app/docs/ar/v1/guides/slack-agent-admin.md#limits-on-each-answer)، وينتهي بالتذييل المعتاد.

عندما يتعذر المضي في تشغيل:

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

يمكن للأشخاص إلغاء المهام التي أعدّوها بسؤال الوكيل. ويمكن لمالكي مساحة عمل Phaseo ومسؤوليها الذين [ربطوا حساب Slack الخاص بهم](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#link-a-slack-account) إلغاء مهام أي شخص. يستطيع الأشخاص من شركات أخرى في قنوات Slack Connect المشتركة رؤية مهام المحادثة لكن لا يستطيعون إعدادها. وتسرد علامة التبويب **Home** الخاصة بالوكيل مهامك أنت.

### إعدادات المهام المتكررة

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

| الإعداد | ما يفعله | الافتراضي |
| - | - | - |
| **السماح بإعداد المهام المتكررة** | عند إيقافه، لا يستطيع أحد إعداد مهمة ولا يُشغَّل أي منها. تُحفظ المهام، وتُشغَّل مجددًا بعد إعادة تفعيله. | مفعّل |
| **الحد الأقصى للمهام المتكررة في مساحة العمل هذه** | من 1 إلى 100. تخفيضه يُبقي المهام المُعدّة مسبقًا. | 20 |
| **من يمكنه إعدادها** | **كل من يمكنه استخدام الوكيل**، أو **فقط من ربطوا حساب Phaseo الخاص بهم**. | الجميع |

يسرد القسم نفسه كل مهمة: ما تفعله، وأين تنشر، وكم مرة، وتشغيلها التالي، ومن أعدّها، وما فعله تشغيلها الأخير. يمكنك إيقاف أي منها مؤقتًا أو استئنافها أو حذفها. تُشغَّل المهمة المستأنفة في موعدها التالي، ويبدأ عدّ إخفاقاتها من الصفر مجددًا. ويحذف إلغاء تثبيت الوكيل جميع مهامه المتكررة.

## الصفحات المشتركة

عندما تكون الإجابة أطول أو أغنى من أن تتسع لها رسالة Slack، مثل تقرير أو جدول أو رسم بياني، يمكن للوكيل نشرها صفحة ويب وربطها في رده. اطلب واحدة، مثل:

* `@Phaseo make a page comparing our spend by model this month`
* `@Phaseo turn the decisions in this thread into a one-page summary`

الصفحة ملف HTML واحد يكتبه الوكيل، يحتوي على نص وجداول ورسوم بيانية. الصفحات ثابتة: قبل الاحتفاظ بالصفحة، يزيل Phaseo منها النصوص البرمجية والروابط والنماذج وأي شيء يُحمَّل من مكان آخر، مثل الخطوط أو الصور من مواقع أخرى. لذا لا تستطيع الصفحة تشغيل نصوص برمجية أو إرسال أي شيء إلى أي مكان، وتظهر عناوين الويب فيها نصًا عاديًا. تُفتح الصفحات على `slack.phaseo.app` في بيئة معزولة مقيّدة، فلا تستطيع الصفحة الوصول إلى تسجيل دخولك في Phaseo أو Slack.

| من يمكنه عرض الصفحة | الكيفية |
| - | - |
| **أي شخص لديه الرابط** (الافتراضي) | أي شخص لديه الرابط، دون تسجيل الدخول. الرابط طويل وعشوائي، فلا يمكن تخمينه. |
| **الأشخاص في مساحة عمل Slack هذه** | أعضاء مساحة عمل Slack لديك، بعد تسجيل دخولهم عبر Slack. لا يستطيع الضيوف عرضها إلا ما دام **السماح للضيوف** مفعّلًا، ولا يستطيع ذلك الأشخاص من شركات أخرى. يدوم تسجيل الدخول 8 ساعات. |

يستخدم الوكيل الإعداد الافتراضي الذي اختاره مسؤولوك ما لم يطلب أحدهم الخيار الآخر، مثل `@Phaseo make it a page only our Slack workspace can see`.

إذا لم تُفتح صفحة مشتركة، فربما انتهت صلاحيتها أو حُذفت: اطلب من الوكيل صفحة جديدة. تطلب منك الصفحة المشتركة مع مساحة عمل Slack تسجيل الدخول عبر Slack؛ سجّل الدخول بتلك المساحة. ولا يستطيع الضيوف فتحها إلا ما دام **السماح للضيوف** مفعّلًا.

### حدود الصفحات

* يُحتفظ بالصفحة 30 يومًا افتراضيًا، ثم تُحذف. يمكن للمسؤولين اختيار 7 أو 30 أو 90 يومًا للصفحات الجديدة.
* يمكن لكل إجابة نشر حتى 3 صفحات، وتحتفظ كل مساحة عمل Slack بما يصل إلى 200 صفحة في الوقت نفسه. ويمكن أن يصل حجم الصفحة إلى 512 KB.
* النشر جزء من الإجابة: لا يكلّف شيئًا إضافيًا، وتُحتسب tokens النموذج المنفقة في كتابة الصفحة ضمن حد \$0.50 للإجابة.
* لا يستطيع الأشخاص من شركات أخرى في قنوات Slack Connect المشتركة نشر الصفحات.
* لا تستطيع الإجابة التي بحثت في Slack نشر صفحة، لأن الصفحة تحتفظ بما كتبه الوكيل (راجع [البحث في Slack](#searching-slack)).

### ما يتحكم فيه المسؤولون في الصفحات

تحت **الصفحات المشتركة** في **الإعدادات ← Slack**:

* **السماح للوكيل بنشر الصفحات** (مفعّل افتراضيًا) يوقف النشر. تبقى الصفحات المنشورة مسبقًا حتى تنتهي صلاحيتها أو تحذفها.
* **الاحتفاظ بالصفحات الجديدة لمدة** 7 أو 30 أو 90 يومًا.
* **يمكن لأي شخص لديه الرابط عرض الصفحات** (مفعّل افتراضيًا). عند إيقافه، تحتاج كل صفحة إلى تسجيل الدخول عبر Slack، بما في ذلك الصفحات المنشورة مسبقًا.
* **الصفحات الجديدة متاحة لـ** يحدد الإعداد الافتراضي عندما يكون الخياران متاحين.
* تعرض القائمة عنوان كل صفحة، ومن طلبها، ومتى نُشرت ومتى تنتهي صلاحيتها، وكم مرة فُتحت. يمكن للمالكين والمسؤولين حذف أي صفحة، فيتوقف رابطها عن العمل فورًا. ويمكنهم فتح الصفحة عندما يسمح لهم وصولها بذلك: تتطلب صفحة مساحة عمل Slack أن يسجّلوا الدخول عبر Slack بصفتهم أعضاء. يسجّل سجل نشاط مساحة العمل عمليات الحذف دون العنوان.

يحتاج **الأشخاص في مساحة عمل Slack هذه** إلى ميزة Sign in with Slack لتطبيق Slack الذي يستخدمه الوكيل. وإلى أن تُعدّ، تذكر **الإعدادات ← Slack** ذلك، وتكون الصفحات متاحة لأي شخص لديه الرابط. مع تطبيق Slack خاص بك، يجب أن يتضمن الـ manifest الخاص به عنوان إعادة التوجيه `https://slack.phaseo.app/p/signin`، كما يفعل manifest الخاص بـ Phaseo (راجع [استخدام تطبيق Slack خاص بك](https://phaseo.app/docs/ar/v1/guides/slack-agent.md#use-your-own-slack-app)).


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