کار با Agentها

نحوه کار تیمی Agentها

با Team Mode خاموش، Alex درخواست را مدیریت می‌کند. زمانی Team Mode را روشن کنید که کار نیاز دارد Mike چند مرحله را هماهنگ کند یا وقتی می‌خواهید از یک Product Manager، Architect، Data Analyst یا متخصص در دسترس دیگری نام ببرید.

در Team Mode، کار می‌تواند از یک Agent به Agent دیگر منتقل شود. Working Process و پیام‌های Agent را دنبال کنید تا دیگر هیچ کاری فعال نباشد. اگر نتیجه یک کارت Version ایجاد کرد، Preview را انتخاب کنید تا آن را در App Viewer باز کنید و پیش از انتشار یا درخواست تغییر دیگر، آن را آزمایش کنید.

روشن یا خاموش کردن Team Mode

این Team Mode کلید در + منوی کنار ورودی Chat قرار دارد. وقتی کلید خاموش است، Alex درخواست را مدیریت می‌کند. وقتی روشن است، Chat می‌تواند از Mike و Agentهای متخصص در دسترس استفاده کند.

پیش از تغییر حالت: نمی‌توانید هنگام فعال بودن Deep Research یا Atoms Cloud، Team Mode را تغییر دهید. Deep Research فقط از Iris استفاده می‌کند، بنابراین فهرست معمول Group Members در دسترس نیست. از Agentهایی که در Chat فعلی نشان داده شده‌اند استفاده کنید. اگر Team Mode به‌صورت ثابت روشن است و Alex نمایش داده می‌شود، برای یک وظیفه مهندسی مستقیماً از Alex نام ببرید. برای استفاده از گزینه‌های استاندارد Team Mode، از جریان کاری اختصاصی خارج شوید و یک Chat عادی پروژه را باز کنید.

1. Chat پروژه را باز کنید.
2. انتخاب کنید + در کنار کادر پیام.
3. در منو، Team Mode را برای جریان کاری تیمی روشن کنید. وقتی می‌خواهید Alex درخواست را مدیریت کند، آن را خاموش کنید.
4. منو را ببندید، درخواست را بنویسید و آن را ارسال کنید.

اگر @ را تایپ کنید در حالی که Team Mode خاموش است، Chat این را نشان می‌دهد: برای نام بردن از Agent به team mode تغییر دهید. انتخاب کنید Team را انتخاب کنید تا Team Mode روشن شود و Group Members, باز شود، یا Engineer را انتخاب کنید تا انتخاب‌گر بسته شود و بدون نام بردن، کار با Alex ادامه پیدا کند.

روشن یا خاموش کردن Team Mode

بگذارید Mike کار را هماهنگ کند

وقتی Team Mode روشن است و Mike در بخش Group Members, در دسترس است، وقتی می‌خواهید Mike تصمیم بگیرد کدام Agentها باید کار را انجام دهند، پیامی را بدون @ mention ارسال کنید. این ساده‌ترین گزینه برای نتیجه‌ای است که چند مرحله را در بر می‌گیرد. اگر Deep Research فعال است، به‌جای آن از Iris استفاده کنید.

1. مطمئن شوید Mike در دسترس است. وقتی کلید در دسترس است، Team Mode را روشن کنید. اگر کلید قفل است، فقط زمانی از این جریان کاری استفاده کنید که Mike در بخش Group Members.
2. نتیجه نهایی، وضعیت فعلی پروژه، محدودیت‌های مهم و این‌که نتیجه را چگونه ارزیابی خواهید کرد توصیف کنید.
3. درخواست را بدون @ mention ارسال کنید تا Mike آن را هماهنگ کند. برای خطاب مستقیم به او، @ را تایپ کنید و Mike را در بخش Group Members.
4. دنبال کنید Working Process و پیام‌های Agent را. وقتی پرسشی ظاهر شد، پاسخ دهید. اگر یک کارت Plan آماده است، Approve را انتخاب کنید تا ادامه یابد یا منوی فلش آن را باز کنید و Decline را انتخاب کنید وقتی طرح نیاز به بازبینی دارد.

این نوع درخواست اطلاعات کافی به Mike می‌دهد تا کار را برنامه‌ریزی کند، بدون این‌که لازم باشد خودتان هر مرحله را تعیین کنید.

مستقیماً از یک Agent نام ببرید

وقتی می‌دانید چه کسی باید یک وظیفه متمرکز را دریافت کند، از یک Agent نام ببرید.

1. در یک پروژه عادی، + را کنار ورودی Chat انتخاب کنید و Team Mode را روشن کنید. اگر یک جریان کاری اختصاصی حالت را قفل کرده است، از این مرحله بگذرید و فقط از Agentهایی که در Chat فعلی نشان داده شده‌اند استفاده کنید.
2. تایپ کنید @ در کادر پیام.
3. در بخش Group Members, Agent را انتخاب کنید.
4. پس از mention، وظیفه، زمینه مهم، آنچه باید بدون تغییر بماند و نتیجه‌ای را که انتظار دارید توضیح دهید.
5. پیام را ارسال کنید.

یک Agent را از Group Members انتخاب کنید

Group Members معمولاً شامل Alex، Bob، David، Emma و Mike است. Sarah و Adrian در پروژه‌های shadcn/ui یا Atoms Cloud پشتیبانی‌شده ظاهر می‌شوند. وقتی Deep Research فعال است، انتخاب‌گر mention فقط Iris را نشان می‌دهد. از فهرستی که در Chat شما نشان داده می‌شود به‌عنوان مرجع اصلی استفاده کنید.

Agent	نقش	وقتی این Agent را استفاده کنید که
Mike	رهبر تیم	وظیفه به برنامه‌ریزی، واگذاری یا هماهنگی میان چند Agent نیاز دارد.
Emma	مدیر محصول	نیاز دارید کاربران، اولویت‌ها، دامنه، جریان‌های کاری یا موازنه‌های ویژگی‌ها را روشن کنید.
Bob	معمار	برای ساختار سیستم، مدل‌های داده، یکپارچه‌سازی‌ها یا محدودیت‌های فنی به کمک نیاز دارید.
Alex	Engineer	می‌خواهید پیاده‌سازی پروژه را بسازید، تغییر دهید، رفع اشکال کنید یا آزمایش کنید.
David	تحلیلگر داده	می‌خواهید داده‌ها، فایل‌ها، معیارها یا روندها را تحلیل کنید.
Iris	پژوهشگر عمیق	به تحقیق مبتنی بر شواهد درباره بازار، رقبا، مخاطب یا مسائل فنی نیاز دارید.
Sarah	متخصص SEO	می‌خواهید محتوای SEO را برای یک پروژه وب پشتیبانی‌شده برنامه‌ریزی و بهبود دهید.
Adrian	متخصص تبلیغات	می‌خواهید Google Ads را برای یک پروژه وب منتشرشده و پشتیبانی‌شده آماده یا تحلیل کنید.

نمی‌توانید از Agentی نام ببرید که در بخش Group Members. نشان داده نشده است. از Mike بخواهید با تیم در دسترس هماهنگ کند، یا از جریان کاری اختصاصی‌ای استفاده کنید که متخصص موردنیاز شما را فعال می‌کند.

با بیش از یک Agent کار کنید

می‌توانید در یک پیام Team Mode از بیش از یک Agent نام ببرید. از این کار برای وظایف مستقلی استفاده کنید که نمی‌توانند روی یکدیگر بازنویسی شوند، و به‌روشنی مشخص کنید هر Agent باید کدام بخش را انجام دهد.

هر واگذاری را به‌وضوح جدا کنید و مشخص کنید آیا Agent می‌تواند پروژه را تغییر دهد یا فقط باید آن را بررسی کند.

برای کارهای وابسته، همه مراحل را هم‌زمان به چند Agent نفرستید. از Mike بخواهید ترتیب را هماهنگ کند و نقطه‌ای را که باید کار را تأیید کنید در درخواست بگنجانید.

فقط از Agentهای لازم برای نتیجه استفاده کنید، سپس Credits used را پس از تکمیل کار بررسی کنید.

وظایف، تأییدها و واگذاری‌ها را دنبال کنید

کار را در Chat. Working Process پروژه دنبال کنید؛ مراحل فعال Agent را نشان می‌دهد، کارت‌های پرسش منتظر پاسخ شما می‌مانند، کارت‌های Plan منتظر تأیید می‌مانند، و وقتی پروژه نسخه‌ای تولید کند که بتوانید پیش‌نمایش آن را ببینید، یک کارت Version ظاهر می‌شود.

آنچه می‌بینید	معنای آن	چه کاری انجام دهید
Working Processیک Agent را به‌عنوان فعال نشان می‌دهد	مرحله فعلی هنوز در حال اجرا است.	منتظر نتیجه بمانید. اگر Queue فعال باشد، می‌توانید دستور بعدی را تایپ کنید و Return را فشار دهید تا بدون متوقف کردن کار فعال، در صف قرار گیرد.
یک کارت پرسش	Mike پیش از ادامه جریان کاری به اطلاعات نیاز دارد.	به هر پرسش پاسخ دهید، ازNextاستفاده کنید وقتی صفحه دیگری وجود دارد، سپسSubmit.
یک کارت Plan	طرح پیشنهادی برای بررسی آماده است و اجرا هنوز شروع نشده است.	انتخاب کنیدApproveرا برای ادامه انتخاب کنید. برای درخواست بازبینی، فلش کنار Approve را باز کنید وDecline.
پاسخ نهایی یک Agent	آن Agent مرحله واگذارشده خود را به پایان رسانده است.	بررسی کنیدWorking Processو پیام‌های بعدی را پیش از این‌که کل درخواست را کامل‌شده تلقی کنید.
Agent دیگری شروع به کار می‌کند	کار به متخصص دیگری واگذار شده است.	پیام‌های Agent جدید را دنبال کنید و اگر اطلاعات یا تأیید خواست، پاسخ دهید.
یک کارت Version	پروژه نسخه‌ای تولید کرده که قابل بررسی است.	برای آخرین نسخه،Preview. را انتخاب کنید. برای یک نسخه تاریخی،Load previewرا ابتدا و سپسView Preview.

را انتخاب کنید. یک پاسخ نوشتاری، Plan یا خلاصه تحقیق به‌تنهایی تأیید نمی‌کند که پروژه تغییر کرده است. وقتی درخواست شامل پیاده‌سازی است، به‌دنبال کارت Version حاصل بگردید، Preview, را انتخاب کنید و کل مسیر کاربر را در App Viewer.

یک پیگیری مفید ارسال کنید

یک پیگیری مفید به Agent می‌گوید چه چیزی تغییر کرده، چه چیزی باید ثابت بماند و نتیجه چگونه باید بررسی شود.

در حالی که یک Agent در حال کار است، دستور بعدی را در ورودی Chat تایپ کنید. وقتی ورودی می‌گوید برای قرار دادن پیام در صف Return را فشار دهید, ، Return را فشار دهید. پیام به پنل Queue بالای ورودی اضافه می‌شود و بدون قطع کردن کار فعال منتظر می‌ماند.

این Queue پنل پس از قرار گرفتن اولین پیام در صف، به‌طور خودکار ظاهر می‌شود. اگر جمع شده است، آن را باز کنید. برای تغییر ترتیب، پیام‌ها را بکشید؛ از Send now, Edit, یا Remove روی یک پیام جداگانه استفاده کنید. پیام صف‌شده‌ای که پیوست دارد قابل ویرایش نیست. سربرگ Queue همچنین Clear queue, Pause processing queued messages, و Resume processing queued messages.

را فراهم می‌کند. اگر Queue در دسترس نیست، پیش از ارسال پیگیری منتظر بمانید تا وظیفه فعلی تمام شود. همان دستور را به‌طور تکراری ارسال نکنید، زیرا درخواست‌های تکراری می‌توانند کارهای متعارض ایجاد کنند.

یک پیگیری صف‌شده را بررسی کنید

وقتی کار گیر کرده یا در مسیر اشتباه پیش می‌رود، بازیابی شوید

از مرحله 1 شروع کنید، و فقط اگر مرحله قبلی مشکل را حل نکرد، در فهرست پایین بروید.

1. وضعیت فعلی را بررسی کنید. آخرین پیام‌های Agent و Working Process. را بخوانید. به‌دنبال Agentی بگردید که هنوز فعال است، یک پرسش یا Plan که منتظر ورودی شماست، یا پیگیری‌ای که در Queue.
2. منتظر مانده است. مسیر را اصلاح کنید. یک اصلاح روشن ارسال کنید. نتیجه موردنظر، کوچک‌ترین تغییر لازم و آنچه باید بدون تغییر بماند را توضیح دهید. در صورت نیاز از Agentی که باید آن را انجام دهد نام ببرید.
3. فقط در صورت لزوم کار فعال را متوقف کنید. کنترل مربعی Stop را در سمت راست ورودی Chat انتخاب کنید. راهنمای آن می‌گوید اگر می‌خواهید همه وظایف را متوقف کنید کلیک کنید. در پنجره تأیید، Yes, I'm Sure. را انتخاب کنید. این کار همه وظایف فعال در آن Chat را متوقف می‌کند، و پاسخ قطع‌شده با برچسب Response stopped.
4. یک نسخه سالمِ شناخته‌شده را بازیابی کنید. اگر یک تغییر تکمیل‌شده پروژه را بدتر کرده است، Versions را در سربرگ پروژه انتخاب کنید. آخرین نسخه سالمِ شناخته‌شده را انتخاب کنید. در صورت نیاز، Load preview و سپس View Preview. را انتخاب کنید. در پیش‌نمایش نسخه، Restore to this version. را انتخاب کنید. پیش از تأیید:
   • را فراهم می‌کند. اگر Sync database اگر ظاهر شد، آن را با دقت بررسی کنید. به‌طور پیش‌فرض انتخاب شده است. اگر می‌خواهید پایگاه داده همراه با نسخه بازیابی شود، آن را انتخاب‌شده باقی بگذارید؛ اگر می‌خواهید پایگاه داده فعلی حفظ شود، تیک آن را بردارید.
   • انتخاب کنید Restore را برای تأیید انتخاب کنید. پروژه به نسخه انتخاب‌شده بازمی‌گردد. نسخه‌های بعدی در Versions در دسترس می‌مانند و در صورت نیاز می‌توان آن‌ها را دوباره اعمال کرد.
5. یک مشکل در Atoms را گزارش کنید. اگر خود Atoms مطابق انتظار رفتار نمی‌کند، ... را روی آخرین پیام Agent مرتبط باز کنید و Feedback. را انتخاب کنید. شناسه chat و شناسه message فعلی به‌طور خودکار پیوست می‌شوند. مراحل دقیق، آنچه انتظار داشتید، آنچه به‌جای آن رخ داد، و در صورت مفید بودن یک اسکرین‌شات واضح را توضیح دهید.

پیش از توقف یا بازیابی. هیچ‌یک از این دو اقدام را فقط به این دلیل که یک وظیفه بیشتر از انتظار طول کشیده است استفاده نکنید. توقف می‌تواند پیشرفت فعال را از بین ببرد. بازیابی وضعیت فعلی پروژه را تغییر می‌دهد و همچنین وقتی Sync database انتخاب شده باشد، می‌تواند پایگاه داده را نیز تغییر دهد.

همه وظایف فعال را متوقف کنید

نتیجه، Credits و اطلاعات حساس را بررسی کنید

پیش از انتشار، به‌روزرسانی یا اتکا به نتیجه، بررسی کنید که:

• هر مرحله درخواستی کامل شده باشد، از جمله هر واگذاری به Agent دیگر.
• نسخه نهایی به‌درستی در App Viewer.
• باز می‌شود. مسیر اصلی کاربر از ابتدا تا انتها کار می‌کند.
• Agent اطلاعات، ویژگی‌ها و طراحی‌ای را که از او خواسته بودید تغییر ندهد، حفظ کرده است.
• هیچ اطلاعات خصوصی، اعتبارنامه یا محتوای فقط داخلی در نتیجه ظاهر نمی‌شود.

Credits used را بررسی کنید

در آخرین پیام Agent در یک نوبت تکمیل‌شده، ...را باز کنید. منو Worked for; را نشان می‌دهد؛ Credits used را پس از پایان نوبت و زمانی که میزان مصرف در دسترس باشد نشان می‌دهد. برای بررسی موجودی workspace، منوی پروفایل خود را باز کنید و Plans را در دسکتاپ یا Plans and credits را در موبایل انتخاب کنید. در پنل Plans and credits ، Credits remaining.

را بررسی کنید. Credits used را پس از هر نوبت تکمیل‌شده بررسی کنید، و پیش از تأیید حجم زیادی از کار، طرح و دامنه را بازبینی کنید.

Worked for و Credits used را بررسی کنید

گذرواژه‌ها، API keyها، authentication tokenها، جزئیات پرداخت یا اطلاعات شخصی یا محرمانه غیرضروری را در Chat جای‌گذاری نکنید.

پرسش‌های متداول

اگر Atoms به این دلیل که یک درخواست ممکن است زیان‌بار باشد آن را رد کند، چه باید بکنم؟

Atoms ممکن است یک درخواست را رد کند یا وقتی نتیجه درخواستی می‌تواند ناایمن باشد، توضیح بیشتری بخواهد. برای دور زدن آن پاسخ، تلاش نکنید یک درخواست زیان‌بار را پنهان، مبدل یا تکه‌تکه کنید.

1. اگر هدفتان مشروع است، هدف امن، این‌که چه کسی کار را مجاز کرده، و این‌که نتیجه نباید چه کاری انجام دهد را توضیح دهید.
2. داده‌های شخصی واقعی، اعتبارنامه‌ها، اطلاعات محرمانه و دستورالعمل‌هایی را که می‌توانند به شخص یا سیستم دیگری آسیب بزنند حذف کنید.
3. به‌جای دستورالعمل‌هایی که سوءاستفاده را ممکن می‌کنند، یک توضیح دفاعی، فهرست بررسی ایمنی یا مثال بی‌ضرر بخواهید.
4. پیش از ارسال، درخواست بازبینی‌شده را بررسی کنید و آن را به اطلاعات لازم برای وظیفه امن محدود نگه دارید.

اگر یک درخواست کاملاً مشروع و بی‌ضرر همچنان رد می‌شود، با Atoms Support و Chat Link و یک نسخه ویرایش‌شده از درخواست تماس بگیرید. کاربرد موردنظر را توضیح دهید، اما اطلاعات حساس را وارد نکنید و از Support نخواهید یک کنترل ایمنی را دور بزند.