شروع
برنامهٔ agentی ثبت و نصب کنید که بتواند در کارهای Pulse مشارکت کند.
این راهنما نشان میدهد چطور agentی را به Pulse بیاورید تا افراد Issue را به آن تفویض کنند، در Comment منشنش کنند و کارش را در یک جا دنبال کنند.
مرور
برنامهٔ agent نرمافزار شماست که در Pulse ثبت میشود و ادمین آن را در فضای کاری نصب میکند. برنامه کاربر application خودش را دارد، با نشان Application در pickerهای تفویض و منشن ظاهر میشود و از طریق agent session در Issueها مشارکت میکند. افراد میتوانند کارش را ببینند، پاسخ دهند یا توقفش را بخواهند.
برنامه روی زیرساخت شما اجرا میشود. Pulse وبهوک امضاشده میفرستد و برنامه با activityهای session پاسخ میدهد و با توکن خودش از API یا MCP استفاده میکند. میتوانید آن را برای یک تیم داخلی بسازید. در نسخهٔ اول برنامهها خصوصیاند و فقط در همان فضای کاری که ثبت شدهاند نصب میشوند.
کوتاهترین مسیر تا یک agent قابلاستفاده این است:
- برنامهٔ agent را ثبت کنید و نام، مسیر بازگشت OAuth و URL وبهوک را بدهید.
- از ادمین بخواهید با
actor=appآن را نصب کند و تیمها و scopeها را تأیید کند. - وبهوک
AgentSessionEventرا بررسی کنید و session تازه را با یک activity از نوعthoughtتأیید کنید. - اقدامها، سؤالها و پاسخ نهایی را در همان session بفرستید.
برنامهٔ agent با Pulse Agent و agent شخصی فرق دارد. اجرا و مجوزهایش در اختیار شماست؛ Pulse مالک sessionی است که افراد میبینند.
SDK و agentهای نمونه
برای TypeScript روی Node.js 22 به بالا یا Bun، بستهٔ @try-pulse/agent-sdk کار پروتکل را انجام میدهد: امضای وبهوک را بررسی میکند، نصب OAuth با actor=app را اجرا میکند، توکنها را تازه میکند، درخواستها را امن تکرار میکند و activityهای session را میفرستد. هیچ وابستگی زمان اجرا ندارد.
npm install @try-pulse/agent-sdkدو agent کامل همهٔ مسیر را نشان میدهند و هرکدام گامهای راهاندازی را از ثبت برنامه تا تفویض Issue دارند:
| مخزن | چه چیزی را نشان میدهد |
|---|---|
| try-pulse/pulse-agent-sdk | کد، مرجع و changelog خود SDK |
| try-pulse/pulse-agent-scout | Scout، agentی قطعی و بدون LLM؛ سریعترین راه برای دیدن session، plan، سؤال و Stop |
| try-pulse/pulse-claude-managed-agents-demo | پلی که هر agent session را روی یک Claude Managed Agent اجرا میکند |
استفاده از SDK اختیاری است: همهٔ گامهای این صفحهها با HTTPS ساده و از هر زبانی کار میکنند.
راهاندازی
در Settings → API → Agent apps برنامه بسازید. نام و آیکون کوتاه و قابلشناسایی انتخاب کنید؛ افراد همین هویت را هنگام تفویض و منشن میبینند. URL عمومی HTTPS برای وبهوک و URL بازگشت OAuth بدهید. میتوانید فرم را پر کنید یا manifest را از JSON وارد کنید؛ مرجع راهاندازی برنامه همهٔ فیلدها را فهرست میکند.
وبهوک باید پیش از استفادهٔ افراد آماده باشد. رویدادهای session را خودکار میگیرد و در صورت نیاز میتوانید رویدادهای Issue، Comment و Project را نیز فعال کنید. ظرف پنج ثانیه به هر تحویل پاسخ دهید و کار را در پسزمینه انجام دهید.
احراز هویت
نصب برنامه با OAuth، actor=app و PKCE انجام میشود. ادمین scopeهای درخواستی را بررسی میکند و All teams یا Selected teams را انتخاب میکند. Pulse کاربر برنامه را میسازد و access token، refresh token چرخشی، installation_id، app_user_id و workspace_id برمیگرداند. توکنهای هر نصب را جداگانه نگه دارید. مراحل OAuth URL مجوزدهی و مبادلهٔ توکن را نشان میدهد.
Actor و scopeها
توکن نصب با actor=app به کاربر application خود برنامه تعلق دارد. هر درخواست با همین هویت ثبت میشود؛ از نشست یا توکن شخصیِ نصبکننده برای کار agent استفاده نکنید.
Scopeهای تفویض و منشن
برای تفویض Issue، app:assignable و برای @منشن در Comment، app:mentionable را درخواست کنید. read و فقط scopeهای نوشتنی موردنیاز را اضافه کنید. برنامهٔ agent نمیتواند admin بگیرد.
Scopeهای خواندن و نوشتن
read دسترسی خواندن در تیمهای مجاز را میدهد. برای نوشتن، write یا scope محدودتر issues:create و comments:create را بخواهید. فقط مجوزهای لازم برای کاری را درخواست کنید که برنامه واقعاً انجام میدهد.
دسترسی ادمین
برنامهٔ agent به admin دسترسی نمیگیرد. مجوزهای هر نصب را ادمین فضای کاری تعیین میکند.
نصب
نصب فقط برای همان فضای کاریِ ثبت برنامه ممکن است. ادمین پیش از تأیید، scopeها و تیمها را میبیند؛ برنامه بعد از نصب در pickerهای مربوط ظاهر میشود.
مدیریت
هر نصب فقط به تیمهایی دسترسی دارد که ادمین انتخاب کرده است. ادمین میتواند این انتخاب را عوض کند یا برنامه را حذف نصب کند. Pulse هنگام تغییر تیمها PermissionChange و هنگام حذف نصب OAuthApp / revoked میفرستد. دسترسیها و توکنهای مربوط را بر همین اساس بهروز یا حذف کنید.
چرخهٔ agent session
وقتی کسی Issue را تفویض کند یا برنامه را @منشن کند، Pulse یک agent session باز میکند و AgentSessionEvent / created میفرستد. رویداد شامل Issue یا Comment، دیدگاههای قبلی، راهنماییها و رشتهٔ prompt_context است. بهسرعت thought بفرستید تا دریافت درخواست معلوم شود؛ سپس با پیشرفت کار از activityهای action، elicitation، response یا error استفاده کنید. Pulse وضعیت قابلمشاهدهٔ session را از این activityها به دست میآورد.
افراد میتوانند در session پاسخ دهند یا Stop را بزنند. پاسخ به شکل prompted و توقف با سیگنال stop میرسد. توسعهٔ تعامل agent محمولهها و API را پوشش میدهد و سیگنالها وقفه و درخواست ورودی را توضیح میدهد.
دریافت نخستین وبهوک
پس از created، امضای تحویل را بررسی کنید، ظرف ۵ ثانیه پاسخ 2xx بدهید و کار را در پسزمینه آغاز کنید. ظرف ۱۰ ثانیه با یک thought نشان دهید درخواست دریافت شده است. نمونهٔ محموله و قرارداد فعالیتها در توسعهٔ تعامل agent آمدهاند.
برای تجربهای که افراد میبینند، agentهای شخص ثالث را بخوانید. برای اصول این مدل، راهنمای تعامل agentها را ببینید.
جزئیات انواع agent، تفویض، scopeها و محدودیتها در مرجع مدل agent پالس آمده است.
آخرین بهروزرسانی