Loopها

کارهای تکراری را با اجرای زمان‌بندی‌شده، event-driven و دستی Pulse Agent خودکار کنید.

نمای کلی

در workspaceهای منتخب در دسترس است. اجرای Loop از AI allowance فضای کاری مصرف می‌کند.

Loop به Pulse Agent اجازه می‌دهد همان کار را طبق برنامه، روی یک event در Pulse، یا وقتی خودتان شروعش می‌کنید اجرا کند. لازم نیست هر بار chat تازه‌ای باز کنید.

هر Loop دستورالعمل، trigger، خروجی و مجموعه‌ای صریح از permission دارد. Loop می‌تواند رکوردهایی را بخواند که مالک به آن‌ها دسترسی دارد و، اگر اجازه داده باشید، مورد آغازگر run یا سایر موارد مجاز را تغییر دهد. قابلیت‌های اختیاری web search، حافظهٔ runهای قبلی یا دسترسی به MCP connectorهای انتخاب‌شده را اضافه می‌کنند.

ویرایش، automation زنده را همان لحظه عوض نمی‌کند. Pulse تغییرها را در draft ذخیره می‌کند و آخرین نسخهٔ منتشرشده همچنان اجرا می‌شود. Publish یک نسخهٔ ثابت می‌سازد تا هر run با همان دستورها و permissionهایی که واقعاً گرفته قابل بررسی باشد.

برای فعال‌سازی خود Agent، Pulse Agent را ببینید.

نمونهٔ Loopها

Loop وقتی بیشترین ارزش را دارد که کار یک تصمیم تکرارشونده، منبع مشخص context و نتیجه‌ای قابل‌بررسی داشته باشد. برای مثال:

  • هر صبح روز کاری، issueهای باز با اولویت بالا را مرور کند و heartbeatی با blockerها، مالک‌ها و اقدام بعدی بفرستد
  • وقتی issue ساخته شد، description و comment را بررسی کند، جزئیات ناقص بازتولید را پیدا کند و فقط همان را در comment بپرسد
  • وقتی request ثبت شد، آن را از روی محتوا دسته‌بندی کند، fieldهای مناسب را بگذارد و وقتی تصمیم انسانی لازم است به مالک خبر دهد
  • هر جمعه، updateهای اخیر project و سؤال‌های باز را مرور کند و خلاصه‌ای کوتاه از ریسک‌ها و کارهای بعدی بفرستد

الگوهای زیر نشان می‌دهند trigger، instruction و permission چگونه با هم کار می‌کنند.

بررسی bugهای ورودی

Loop را هنگام ساخته‌شدن issue یا با تغییر fieldهایی مثل status، priority یا label اجرا کنید. بخواهید issue و بحث موجود را بخواند، وجود expected behavior، actual behavior و reproduction steps را چک کند و فقط وقتی اطلاعات کم است comment بگذارد.

برای بررسی، Read Pulse data را روشن کنید. فقط اگر Loop باید comment بگذارد یا field را عوض کند، Change Pulse data و اجازهٔ تغییر مورد آغازگر را بدهید. اگر کار به بررسی repository یا coding session هم نیاز دارد، پس از بررسی دسترسی در Permissionها، قابلیت مربوط را فعال کنید.

ساخت کارهای بعدی پس از incident

از issue event با شرط‌هایی مثل label مربوط به incident و status تکمیل‌شده استفاده کنید. در instruction مشخص کنید چه چیزی follow-up حل‌نشده است و issueهای جدید چگونه نام‌گذاری، لینک و assign شوند.

چون نتیجه روی مورد دیگری ساخته می‌شود، این الگو به اجازهٔ تغییر سایر موارد نیاز دارد. action limit بگذارید تا یک incident تعداد نامحدودی issue نسازد.

مسیردهی requestهای جدید

با ثبت request اجرا کنید. Loop می‌تواند request را بخواند، از fieldها و description مقصد مناسب را تعیین کند و وقتی Pulse write access روشن است request را به‌روز کند. اگر فقط بخشی از requestها باید پردازش شوند، condition اضافه کنید.

اگر تصمیم به سیستم خارجی وابسته است، فقط MCP server لازم را وصل کنید و toolهای در دسترس را تا جای ممکن محدود کنید.

آماده‌کردن مرور دوره‌ای projectها

یک schedule هفتگی بسازید و scope را دقیق بنویسید؛ مثلاً projectهای active متعلق به یک تیم. بخواهید update ناقص، target date گذشته، سؤال حل‌نشده و تغییر نسبت به run قبلی را نشان دهد. Heartbeat برای این الگو مناسب است، چون وقتی نکتهٔ مفیدی نیست می‌تواند ساکت بماند.

ساخت Loop با Pulse Agent

بهتر است اول outcome را در chat Pulse Agent به دست بیاورید، بعد آن را به Loop تبدیل کنید. اول نتیجه را بگویید، بعد trigger و permission را در editor تأیید کنید.

  • Agent را باز کنید (G سپس J) و کار را یک‌بار اجرا کنید تا نتیجه درست باشد
  • از Pulse Agent بخواهید آن را به Loop تبدیل کند، یا Loops را باز کنید، New loop را بزنید، scope Personal را نگه دارید و Agent را انتخاب کنید (می‌توانید خالی شروع کنید و Compose with Agent را در editor بزنید)
  • trigger، condition، instruction، خروجی، connector و permission را مستقل از prompt بررسی کنید
  • Review and publish را بزنید، blockerها را برطرف کنید و اولین نسخه را منتشر کنید

به‌جای «هر هفته projectها را خلاصه کن»، مخاطب، قاعدهٔ انتخاب، اطلاعات لازم، قالب خروجی و مرزها را مشخص کنید:

هر جمعه بعدازظهر، projectهای active متعلق به Product team را بررسی کن. تغییرهای آخرین update، target dateهای گذشته و سؤال‌های باز را خلاصه کن. فقط وقتی projectی نیاز به توجه دارد heartbeat بفرست. fieldهای project را تغییر نده و issue نساز.

Pulse Agent فقط draft را ویرایش می‌کند و هرگز به‌جای شما Publish نمی‌کند. بررسی و انتشار هر نسخه بر عهدهٔ شماست.

ساخت دستی Loop

اگر trigger و مرزها را می‌دانید، Loop را مستقیماً تنظیم کنید.

برای پیکربندی Loop:

  1. Loops را باز کنید و New loop را انتخاب کنید
  2. یک Loop با scope Personal بسازید. scope پس از ایجاد عوض نمی‌شود
  3. trigger را انتخاب کنید:
    • Schedule برای اجرای روزانه، روزهای کاری، روزهای مشخص هفته، ماهانه یا فاصلهٔ ساعتی
    • Event برای تغییر پشتیبانی‌شده روی issue، request، project، initiative یا cycle
    • Manual وقتی Loop فقط با اقدام شما اجرا شود
  4. برای event trigger، event و condition را انتخاب کنید. در event نوع updated، fieldهایی را تعیین کنید که واقعاً باید تغییر کرده باشند
  5. outcome و instruction را بنویسید: چه چیز بررسی شود، چه خروجی یا تغییری ایجاد شود و چه چیز دست نخورد
  6. در صورت نیاز خروجی Heartbeat را روشن کنید. Pulse Agent فقط وقتی حرف مفیدی دارد heartbeat می‌فرستد؛ notification را می‌توان جداگانه فعال کرد
  7. فقط در صورت نیاز به منبع یا action خارجی، MCP connector اضافه کنید
  8. Team access، write access، capability و سقف action و duration را بررسی کنید
  9. Review and publish را انتخاب کنید و نسخه را منتشر کنید

Schedule از timezone نمایش‌داده‌شده در editor استفاده می‌کند و زمانش تقریبی است: Pulse run را در بازهٔ نشان‌داده‌شده شروع می‌کند، نه در یک ثانیهٔ تضمینی. Conditionهای event بعد از تغییر ارزیابی می‌شوند؛ همهٔ conditionهای یک group باید برقرار باشند و groupهای جدا جایگزین یکدیگرند.

تا پیش از اولین Publish هیچ چیز اجرا نمی‌شود. انتشار اولین نسخه، Loop را هم فعال می‌کند.

به‌روزرسانی Loop

تغییرهای Loop منتشرشده در draft ذخیره می‌شوند و نسخه‌ای را که اکنون اجرا می‌شود عوض نمی‌کنند.

برای تغییر Loop منتشرشده:

  1. Loops را باز کنید و Loop موردنظر را انتخاب کنید
  2. Edit را بزنید
  3. trigger، instruction، output، connector یا permission را عوض کنید. editor draft را خودکار ذخیره می‌کند و وضعیت save را نشان می‌دهد
  4. با Review and publish، draft را با تنظیم زنده مقایسه کنید و همهٔ blockerهای انتشار را یک‌جا ببینید
  5. draft را Publish کنید. runهایی که بعد از انتشار پذیرفته می‌شوند نسخهٔ جدید را می‌گیرند؛ runهای قبلاً پذیرفته‌شده با نسخهٔ شروع خود ادامه می‌دهند

Disable کردن Loop فقط اجرای خودکار جدید را متوقف می‌کند و draft، نسخه‌های منتشرشده و run history را حذف نمی‌کند. برای ازسرگیری triggerهای خودکار دوباره Enable کنید.

بررسی runهای یک Loop

هر Loop دارای run history است تا زمان اجرا، علت و نتیجه قابل‌بررسی باشد.

برای دیدن یک run:

  1. Loops را باز کنید و یک Loop انتخاب کنید
  2. Run history را بزنید
  3. یک run را باز کنید تا trigger context، نسخهٔ منتشرشده، instruction، outcome، effect و usage ثبت‌شده را ببینید
  4. اگر run به Pulse Agent رسیده، conversation آن را برای context کامل اجرا باز کنید. runهایی که پیش از رسیدن به Agent skip شده‌اند transcript ندارند

History بین موفقیت، no-action، اجرای ناقص، failure، cancellation و occurrenceهای skipشده فرق می‌گذارد. همچنین نشان می‌دهد کدام action اجرا، رد یا ناموفق شده یا قابل‌تأیید نبوده. در failure، Pulse به مرتبط‌ترین محل رفع مشکل لینک می‌دهد؛ مثل permissionهای Loop، capability settings، usage settings یا run limits.

از منوی Loop می‌توانید Run now را هم بزنید. Loopهای event از شما می‌خواهند issue، request، project، initiative یا cycle سازگار را انتخاب کنید. اجرای دستی Loop غیرفعال یا paused یک‌باره است و وضعیت خودکار را Enable یا Resume نمی‌کند.

بازگرداندن نسخهٔ قبلی

نسخه‌های منتشرشده snapshot ثابت می‌مانند. Restore بلافاصله نسخهٔ زنده را عوض نمی‌کند؛ Pulse آن را در draft کپی می‌کند تا اول بررسی شود.

برای بازگرداندن نسخه:

  1. Loop را باز کنید و Edit را بزنید
  2. Published versions را باز کنید
  3. نسخه را انتخاب کنید و Restore version را بزنید
  4. draft بازگردانده‌شده را بررسی کنید. connector یا capabilityهایی را که دیگر در دسترس نیستند دوباره authorize یا حذف کنید
  5. وقتی draft آماده شد آن را Publish کنید

تا زمان Publish، نسخه‌ای که قبل از restore زنده بود همچنان اجرا می‌شود.

MCP connectorها

MCP connector به Loop امکان استفاده از context و action سرویس دیگر را می‌دهد. بسته به server متصل، Loop می‌تواند مستندات بازیابی کند، error report بخواند، pull request را بررسی کند یا بیرون از Pulse update بفرستد.

دسترسی connector دو لایه دارد. workspace policy مشخص می‌کند کدام MCP server مجاز است و مالک Loop اتصال‌های active مشخص را به Loop می‌دهد. نسخهٔ منتشرشده شناسهٔ connection و محدودیت اختیاری tool را ذخیره می‌کند، نه credential کپی‌شده. اگر connection لغو شود، دیگر برای Loop resolve نمی‌شود.

connector شخصی به Loop اجازه می‌دهد با هویت شما عمل کند. فقط toolهای لازم را بدهید.

افزودن و مدیریت connectorها

برای افزودن connector:

  1. draft Loop را باز کنید و Connectors را پیدا کنید
  2. یک connection موجود را انتخاب کنید یا به MCP server مجاز workspace وصل شوید
  3. از منوی connector، toolهایی را که Loop می‌تواند استفاده کند محدود کنید
  4. draft را Publish کنید تا connector برای runهای بعدی فعال شود

runهای Loop نمی‌توانند از connector محلی Bridge استفاده کنند که به بیدار بودن Mac شما وابسته است. connector باید هنگام اجرای بدون نظارت از hosted runtime در دسترس باشد.

Pulse فعلاً integration اشتراکی اختصاصی Slack برای Loops ندارد. اگر Slack برای workspace موجود باشد، به‌صورت MCP connector و با authorization و محدودیت tool خودش استفاده می‌شود.

راه‌اندازی

اگر Loops در sidebar نیست، Loops برای این workspace فعال نیست. یک platform admin می‌تواند فعالش کند.

مدیریت Loop مشترک هنوز موجود نیست. Loop جدید شخصی است و configuration، version، result و run history فقط برای مالک دیده می‌شود — حتی از workspace admin. Loop شخصی همچنان می‌تواند به دادهٔ مجاز تیم دسترسی بگیرد؛ این دسترسی Loop را shared نمی‌کند.

Workspace policy می‌تواند capability یا MCP server مشخص را مجاز یا مسدود کند. editor قابلیت unavailable را با دلیل نشان می‌دهد و draft وابسته به دسترسی غیرقابل‌اجرا را Publish نمی‌کند.

Permissionها

Permission حداکثر scope هر run را تعیین می‌کند، اما دسترسی مالک را گسترش نمی‌دهد. Loop نمی‌تواند داده‌ای را بخواند یا تغییر دهد که مالک مستقیماً به آن دسترسی ندارد. کمترین مجموعهٔ لازم برای کار را بدهید.

Team access

Team access مشخص می‌کند Loop دادهٔ کدام تیم را بخواند یا تغییر دهد. Loop شخصی می‌تواند همهٔ تیم‌های public یا مجموعه‌ای مشخص را استفاده کند. انتخاب تیم فقط data scope را محدود می‌کند و Loop را با آن تیم‌ها به اشتراک نمی‌گذارد.

دسترسی به دادهٔ Pulse

Read Pulse data اجازه می‌دهد Loop رکوردهای مجاز Pulse مثل issue، request، project و document را بررسی کند. Change Pulse data ابزارهای نوشتن موجود را فعال می‌کند، اما کنترل write-scope پایین همچنان مشخص می‌کند کدام رکورد قابل‌تغییر است.

Remember previous runs نتیجه‌گیری runهای قبلی را به‌عنوان context می‌گذارد. وقتی پیوستگی نتیجه را بهتر می‌کند روشن کنید؛ اگر هر run باید مستقل باشد خاموش بگذارید.

Web access

Search the web به Loop اجازه می‌دهد اطلاعات عمومی به‌روز را جستجو کند و source را cite کند. این قابلیت باید هم در deployment موجود باشد و هم در workspace policy فعال شده باشد.

Web access ممکن است بخشی از context Loop را به website یا search service خارجی بفرستد. برای کاری که می‌تواند دادهٔ حساس workspace داشته باشد، فقط اگر این انتقال پذیرفته است آن را روشن کنید.

تغییر مورد آغازگر و سایر موارد

Write permission به دو کنترل تقسیم می‌شود:

  • Change the item that triggered it اجازه می‌دهد run روی issue یا request آغازگر comment بگذارد یا آن را update کند
  • Change other items تغییر موارد دیگر را در محدودهٔ Team access و permission خود مالک ممکن می‌کند

دومی به‌صورت پیش‌فرض خاموش است. فقط وقتی روشن کنید که outcome واقعاً به ساخت یا update کار مرتبط نیاز دارد. Loop زمان‌بندی‌شده مورد آغازگر ندارد؛ رفتار نوشتن آن را Team access، capability و اجازهٔ تغییر سایر موارد تعیین می‌کنند.

محدودیت run

هر Loop سقف تعداد action و حداکثر duration دارد. با رسیدن به هرکدام، run متوقف و به‌عنوان partially completed ثبت می‌شود. از limit برای محدود کردن هزینه و جلوگیری از تغییر بیش از انتظار از instruction گسترده استفاده کنید.

دسترسی repository و coding session

Code Intelligence به Loop اجازه می‌دهد repositoryهای متصل را بررسی کند. این قابلیت به پشتیبانی deployment، دسترسی Code Intelligence مالک و تأیید workspace در Settings → Loops (/settings/loops) نیاز دارد. محدودیت repository در workspace و انتخاب خود Loop می‌توانند دسترسی را محدودتر کنند. تأیید workspace برای Code Intelligence و coding session به‌صورت پیش‌فرض خاموش است.

Coding sessions به Code Intelligence همان Loop، تأیید جداگانهٔ workspace و connection مجاز برای coding session نیاز دارد. هر run مجاز می‌تواند یک coding session برای تغییر کد و بازکردن pull یا merge request جهت بازبینی انسانی شروع کند؛ نتیجه را merge نمی‌کند. پیش از Publish، خلاصهٔ دسترسی editor را بررسی کنید. قابلیت unavailable با دلیل غیرفعال می‌ماند.

قابلیت‌هایی که هنوز فعال نیستند

نوشتن روی issue و commentهای externally synchronized در مدل permission هست، اما برای Loops قابل استفاده نیست. Pulse آن را unavailable نشان می‌دهد و تنظیمی را که اجرا نمی‌شود نمی‌پذیرد.

Pulse فعلاً برای triggerهای issue یا request بین منبع خارجی trusted فرق نمی‌گذارد؛ بنابراین allowlist جداگانه‌ای برای منبع خارجی در هر Loop نیست.


مصرف هوش مصنوعی

runهای Loop از AI allowance موجود workspace استفاده می‌کنند. صفحهٔ run، در صورت گزارش provider، token usage، model و duration را ثبت می‌کند. اگر allowance تمام شود، runهای خودکار به‌جای failure تکراری pause می‌شوند. بعد از رفع محدودیت usage توسط admin، Loop را از منوی آن Resume کنید.

Pulse از کنترل‌های موجود usage و spend در workspace استفاده می‌کند، نه balance جداگانهٔ Loops.

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

آخرین به‌روزرسانی