پروژه‌ها¶
به هر کاری قفسهٔ خودش را بدهید. پروژه پوشه‌ای مستقل روی سرور عامل شماست، با فایل‌ها، دستورالعمل‌ها و گفتگوهای خودش. کارهای بازسازی کنار بازسازی می‌ماند و پایان‌نامه کنار پایان‌نامه؛ همه روی یک عامل.
- 💬برنامهٔ هفتگی
- 💬سؤال‌های اظهارنامهٔ مالیاتی
- 📝«بودجه ۱۵ هزار یورو، همیشه سه پیش‌فاکتور را مقایسه کن»
- 📄quotes.pdf · floor-plan.png
- 💬کاشی آشپزخانه
- 💬برنامهٔ زمانی برق‌کار
- 📄tickets.pdf
- 💬برنامهٔ روزبه‌روز
پروژه چه چیزی به شما می‌دهد¶
-
یک پوشهٔ مستقل
عامل درون پوشهٔ پروژه کار می‌کند: فایل‌هایی که در گفتگوهای پروژه می‌فرستید همان‌جا ذخیره می‌شوند، و فایل‌هایی که خود عامل می‌سازد، کدی که اجرا می‌کند و کارهایی که زمان‌بندی می‌کند هم همین‌طور.
-
دستورالعمل‌های خودش
یادداشتی که عامل در آغاز هر گفتگو در این پروژه می‌خواند: پروژه برای چیست، چطور باید کار کرد و چه چیزهایی را باید در نظر داشت.
-
گفتگوهای خودش
فهرست گفتگوها پروژه‌ای را که در آن هستید نشان می‌دهد و هر چت تازه همان‌جا شروع می‌شود. نه لازم است چیزی را به خاطر بسپارید، نه اینکه بعداً چیزی را مرتب کنید.
-
خصوصی یا اشتراکی
روی عاملی که با دیگران به اشتراک گذاشته‌اید، پروژه می‌تواند فقط مال شما باشد یا با همه به اشتراک گذاشته شود، همراه با فایل‌ها و گفتگوهایش.
بقیهٔ چیزها در همهٔ پروژه‌ها یکی است: حافظه و شخصیت عامل، مهارت‌هایش، مدل و تنظیمات، کلیدها و حساب‌های متصل، و اعتبار شما. مدیریت فایل‌ها و ترمینال در پنل همیشه کل سرور را نشان می‌دهند. عوض کردن پروژه جای کار عامل را تغییر می‌دهد، نه هویتش را.
1 پروژه‌ها را روشن کنید¶
پروژه‌ها تا وقتی کسی روشنشان نکند خاموش‌اند و در این حالت هیچ نشانی از آن‌ها دیده نمی‌شود: همهٔ گفتگوها در پوشهٔ اصلی شما کار می‌کنند. چون این قابلیت تازه است، پنل آن را با برچسب بتا مشخص می‌کند.
- پنل: تنظیمات → پروژه‌ها → استفاده از پروژه‌ها.
- Telegram: /projects را بفرستید و روی ▶️ روشن کردن پروژه‌ها بزنید.
این کلید متعلق به کل عامل است: هر کسی که از عامل استفاده می‌کند، چه مالک و چه کاربر دعوت‌شده، می‌تواند آن را روشن یا خاموش کند. خاموش کردنش به هیچ پوشه‌ای دست نمی‌زند. گفتگوهایی که در یک پروژه شروع شده‌اند همان‌جا به کارشان ادامه می‌دهند؛ فقط گفتگوهای تازه دوباره در پوشهٔ اصلی شما شروع می‌شوند.
2 یک پروژه بسازید¶
- پنل: انتخابگر پروژه را در بالای نوار کناری باز کنید و پروژه جدید را انتخاب کنید. نامی برایش بنویسید و افزودن پروژه را بزنید؛ وارد پروژه می‌شوید و یک چت تازه هم منتظرتان است.
- Telegram: /projects → ➕ پروژهٔ جدید، سپس نام را بفرستید. ربات پروژه را می‌سازد و شما را به آن می‌برد.
- تنظیمات → پروژه‌ها → + پروژه جدید بدون اینکه از پروژهٔ فعلی بیرون بروید، یک پروژه می‌سازد.
هر پروژه روی سرور عامل پوشهٔ مخصوص خودش را می‌گیرد.
💡 اگر اجازه به کاربران اضافی در عامل شما روشن باشد، پنل این را هم می‌پرسد: چه کسی آن را می‌بیند؛ فقط من یا همه کاربران این عامل. بعداً هم می‌توانید آن را تغییر دهید؛ پروژه‌ها در عامل اشتراکی را ببینید. پروژه‌ای که در Telegram ساخته شود در ابتدا خصوصی است.
3 بین پروژه‌ها جابه‌جا شوید¶
در پنل، انتخابگر بالای فهرست گفتگوها نام پروژه‌ای را که در آن هستید نشان می‌دهد. پروژهٔ دیگری را انتخاب کنید تا گفتگوهای آن فهرست را پر کنند و چت‌های تازه همان‌جا شروع شوند. مدیریت پروژه‌ها در پایین همین منو تنظیمات را باز می‌کند.
در Telegram، /projects (یا /menu → تنظیمات → 📁 پروژه‌ها) پروژه‌هایتان را فهرست می‌کند: 🏠 پوشهٔ اصلی شما، 📁 پروژه‌های خودتان، 👥 پروژه‌های اشتراکی، و ✅ کنار پروژهٔ فعال. برای جابه‌جایی روی پروژهٔ دیگری بزنید. اگر چتی که در آن هستید به پروژهٔ دیگری تعلق داشته باشد، بلافاصله یک گفتگوی تازه در پروژهٔ انتخابی شروع می‌شود و عنوان سنجاق‌شده‌اش با نام پروژه آغاز می‌شود. پس از آن، /sessions گفتگوهای همان پروژه را فهرست می‌کند و نام پروژه را بالای فهرست نشان می‌دهد.
تغییر نام، اشتراک‌گذاری، دستورالعمل‌ها و حذف از طریق پنل انجام می‌شوند.
خوب است بدانید:
- هر گفتگو همان‌جایی می‌ماند که شروع شده است. جابه‌جایی هیچ‌وقت چتی را که در جریان است منتقل نمی‌کند. آن چت پروژه، پوشه و دستورالعمل‌هایش را نگه می‌دارد و جابه‌جایی فقط تعیین می‌کند گفتگوی بعدی کجا شروع شود.
- پنل و Telegram جداگانه انتخاب می‌کنند. ممکن است در Telegram در بازسازی باشید و پنل پایان‌نامه را نشان دهد. هر کدام انتخاب خودش را به خاطر می‌سپارد.
4 به پروژه دستورالعمل بدهید¶
تنظیمات → پروژه‌ها → دکمهٔ ⋯ کنار پروژه → دستورالعمل‌ها…
هر چه عامل باید بداند آنجا بنویسید: پروژه برای چیست، چه کسانی درگیرند، چه تصمیم‌هایی گرفته شده و دوست دارید کار چطور انجام شود. عامل این متن را در آغاز هر گفتگو در این پروژه می‌خواند، پس لازم نیست هر بار پیش‌زمینه را از نو توضیح دهید.
برای مثال
«بازسازی آپارتمان‌مان. بودجه ۱۵٬۰۰۰ یورو، تا پایان اسفند تمام شود. همیشه دست‌کم سه پیش‌فاکتور را مقایسه کن. یک جدول هزینهٔ به‌روز در costs.xlsx نگه دار و هر بار پیشنهاد تازه‌ای رسید، آن را به‌روز کن.»
نکته‌های اصلی را بالای متن بنویسید
گفتگویی که در جریان است دستورالعمل‌هایی را که با آن شروع شده نگه می‌دارد، پس هر تغییری از چت بعدی اعمال می‌شود. دستورالعمل طولانی اشکالی ندارد، اما چند هزار نویسهٔ اول مستقیم به عامل می‌رسد و بقیه را عامل در صورت نیاز از فایل می‌خواند.
دستورالعمل‌ها به‌صورت یک فایل معمولی (AGENTS.md) در پوشهٔ پروژه نگه داشته
می‌شوند، بنابراین می‌توانید از خود عامل هم بخواهید آن‌ها را برایتان بنویسد
یا به‌روز کند.
پوشهٔ اصلی شما¶
هر کسی که از عامل استفاده می‌کند یک پوشهٔ اصلی مخصوص خودش دارد که در انتخابگر با نام عمومی نشان داده می‌شود. وقتی پروژه‌ها خاموش‌اند، گفتگوها همین‌جا کار می‌کنند و هر چیزی هم که از پیش از پروژه‌ها مانده، همین‌جاست.
عمومی بیشتر خانهٔ شماست تا یک پروژه: نمی‌توان نامش را تغییر داد، آن را به اشتراک گذاشت یا حذفش کرد. همچنین جای کارهایی است که چند پروژه را در بر می‌گیرند. عامل وقتی در یک پروژه است فقط در پوشهٔ همان پروژه کار می‌کند، اما از عمومی به همهٔ پوشه‌ها دسترسی دارد.
پروژه‌ها در عامل اشتراکی¶
وقتی عامل خود را با دیگران به اشتراک می‌گذارید، هر کس پوشهٔ اصلی و پروژه‌های خودش را دارد. هر پروژه یکی از این دو نوع است:
-
خصوصی (پیش‌فرض)
فقط در فهرست شما دیده می‌شود و فقط گفتگوهای شما در آن قرار می‌گیرند.
-
اشتراکی
در فهرست همهٔ کاربران عامل دیده می‌شود و برچسب اشتراکی دارد. همه با فایل‌ها و دستورالعمل‌های یکسان کار می‌کنند و گفتگوهای آن هم مشترک است.
در پروژهٔ اشتراکی، گفتگوها فضای مشترک‌اند. همه آن‌ها را در فهرست پروژه می‌بینند و می‌توانند بخوانند، ادامه دهند، نامشان را عوض کنند یا حذفشان کنند؛ پس چند نفر می‌توانند در یک چت کار کنند: در پنل، یا در Telegram که در آن /sessions این گفتگوها را با 👥 مشخص می‌کند و با یک ضربه به هر کدام می‌پیوندید. هر پیام نشان می‌دهد چه کسی آن را نوشته و عامل می‌داند به چه کسی پاسخ می‌دهد. عامل پیام‌ها را یکی‌یکی پاسخ می‌دهد: اگر در حال پاسخ دادن به پیام کس دیگری باشد، پنل یا ربات به شما خبر می‌دهد و شما پس از رسیدن پاسخ، پیامتان را می‌فرستید.
- اشتراک‌گذاری یا خصوصی کردن از منوی ⋯ پروژه: اشتراک با همهٔ کاربران یا خصوصی کردن. پروژه‌ای که خصوصی شود از فهرست دیگران خارج می‌شود و گفتگوهای آن‌ها در این پروژه در پوشهٔ اصلی خودشان ادامه پیدا می‌کند.
- چه کسی پروژهٔ اشتراکی را مدیریت می‌کند: کسی که آن را ساخته و مالک عامل. تغییر نام و حذف با آن‌هاست. فقط سازندهٔ پروژه می‌تواند آن را دوباره خصوصی کند.
- کارهای پس‌زمینه در پروژهٔ اشتراکی مال همه است. همهٔ کاربران آن‌ها را در تنظیمات → کارهای پس‌زمینه می‌بینند، می‌توانند تغییرشان دهند و اعلان‌هایشان را در پنل و Telegram دریافت می‌کنند.
- وقتی کاربری حذف می‌شود، پروژه‌هایی که به اشتراک گذاشته اشتراکی می‌مانند و به مالک منتقل می‌شوند. پروژه‌های خصوصی‌اش از فهرست‌ها خارج می‌شوند و فایل‌هایش روی سرور می‌مانند.
خصوصی یعنی پنهان از فهرست، نه زیر قفل
کاربران دعوت‌شده کاربرانی مورد اعتماد هستند. کار همه روی سرور عامل با یک حساب کاربری اجرا می‌شود، پس پروژهٔ خصوصی از فهرست دیگران پنهان است اما گاوصندوق نیست. هر چیزی را که واقعاً محرمانه است روی عامل اشتراکی نگه ندارید.
پروژه را از فهرست بردارید یا برای همیشه حذف کنید¶
حذف در دو مرحله انجام می‌شود تا چیزی تصادفی از دست نرود:
- ⋯ → حذف از فهرست. پروژه از فهرست‌ها خارج می‌شود، اما فایل‌ها و گفتگوهایش روی سرور می‌مانند و گفتگوهای شما در آن زیر عمومی نمایش داده می‌شوند. پروژه را در بخش پروژه‌های حذف‌شده در پایین تنظیمات → پروژه‌ها پیدا می‌کنید و بازگرداندن به فهرست آن را برمی‌گرداند.
- پروژه‌های حذف‌شده → ⋯ → حذف دائمی… این کار پوشه را با همهٔ فایل‌هایش و همهٔ گفتگوهایی که در آن کار کرده‌اند پاک می‌کند و برگشت‌پذیر نیست. برای تأیید باید نام پوشه را تایپ کنید. در پروژهٔ اشتراکی، پنل همچنین می‌گوید چند کاربر دیگر در آن گفتگو دارند.
خوب است بدانید¶
- تغییر نام فقط نام را عوض می‌کند. پوشه همان نامی را که هنگام ساخت داشته نگه می‌دارد، بنابراین پیوندها، اسکریپت‌ها و ابزارهایی که از آن استفاده می‌کنند همچنان کار می‌کنند. پنجرهٔ دستورالعمل‌ها نام واقعی پوشه را نشان می‌دهد.
- فایل‌هایی که می‌فرستید در پروژه می‌مانند. فایلی که در گفتگوی یک پروژه
بفرستید در
uploadsپوشهٔ پروژه کپی می‌شود و عامل همان‌جا روی آن کار می‌کند. وقتی پروژه‌ها خاموش‌اند، فایل‌ها مثل قبل نگه داشته می‌شوند. - کارهای پس‌زمینه در یک پروژه اجرا می‌شوند. در تنظیمات → کارهای پس‌زمینه، نخستین فیلد هر کار پروژهٔ آن است و کار تازه در پروژه‌ای شروع می‌شود که باز دارید. کاری که در گفتگوی یک پروژه از عامل بخواهید در همان پروژه اجرا می‌شود. کار یک پروژهٔ اشتراکی به همهٔ کسانی که از عامل استفاده می‌کنند اعلان می‌دهد و هر کار دیگری فقط به شما. وقتی پروژه‌ها خاموش‌اند، هر کار فقط به صاحب خودش اعلان می‌دهد.
- جستجو همه‌چیز را در بر می‌گیرد. عامل در تاریخچهٔ همهٔ گفتگوهای شما، در هر پروژه‌ای که باشند، جستجو می‌کند و می‌تواند بگوید هر نتیجه از کدام پروژه آمده است.
- API در عمومی کار می‌کند. فراخوانی‌هایی که از طریق API سازگار با OpenAI عامل انجام می‌شوند همیشه در پوشهٔ اصلی فراخواننده کار می‌کنند.
- تا ۵۰ پروژه روی یک عامل جا می‌شود، با احتساب پروژه‌های همه. نام هر پروژه می‌تواند تا ۶۰ نویسه باشد.