این راهنما چه چیزی را پوشش می‌دهد؟
در این راهنما با راه‌اندازی و استفاده از Postman Agent Mode on Cloud آشنا می‌شوید. این قابلیت برای taskهایی مثل به‌روزرسانی repository کد، اجرای testهای API و اجرای workflowها روی Postman Collectionها و GitHub repoها استفاده می‌شود.
بعد از انجام مراحل، می‌توانید Agent را در Slack با @Postman صدا بزنید، فعالیت آن را در برنامه دسکتاپ Postman دنبال کنید و قبل از merge شدن pull request خروجی را مرور کنید.
توجه: AI ممکن است اشتباه کند. کد، پاسخ‌ها و تغییرات پیشنهادی را همیشه قبل از استفاده نهایی بررسی کنید.
پیش‌نیازها
- دسترسی به Slack workspace که با Postman یکپارچه شده باشد.
- حساب Postman با دسترسی به workspace مورد نظر.
- حساب GitHub متصل به organization شما در Postman.
اجازه دسترسی Slack به Postman
برای اینکه Agent بتواند دستورهای task را در Slack دریافت کند و وضعیت کار را همان‌جا بفرستد، باید integration پستمن برای Slack را authorize کنید.
اگر هنوز Slack را به Postman وصل نکرده‌اید، اولین بار که در Slack از @Postman استفاده کنید، پیام authorize کردن برنامه Postman نمایش داده می‌شود.
اگر قبلا از بخش integrationها شروع کرده‌اید، در صفحه اصلی Postman وارد Integrations شوید، Browse All Integrations را انتخاب کنید و Slack را پیدا کنید. سپس مراحل setup مربوط به integration را دنبال کنید.
وقتی به صفحه OAuth در Slack منتقل شدید:
- مجوزهایی را که قرار است به برنامه داده شود مرور کنید.
- Workspace درست را از dropdown انتخاب کنید.
- برای ادامه روی Allow کلیک کنید.
اجازه دسترسی GitHub
برای اینکه Agent بتواند با repositoryهای کد کار کند، testها را اجرا کند و workflowها را در GitHub repoها کامل کند، باید دسترسی GitHub هم authorize شود.
اگر هنوز GitHub را authorize نکرده‌اید، اولین بار که در Slack با flag --repo از @Postman استفاده کنید، از شما خواسته می‌شود برنامه Postman را به GitHub وصل کنید.
مراحل sign-in را دنبال کنید تا Postman اجازه دسترسی به GitHub organization شما را بگیرد. بعد از authorize شدن، repoهای GitHub بر اساس دسترسی‌های شما برای Agent قابل استفاده می‌شوند.
اجرای Agent در Slack
برای شروع:
- وارد channel مناسب در Slack شوید.
- در پیام خود
@Postmanرا mention کنید. - task را با زبان طبیعی توضیح دهید. برای محدود کردن task به یک repository خاص از flag
--repoاستفاده کنید.
نمونه دستورها
@Postman what can you do?@Postman --repo repo-name fix README@Postman --repo repo-name run API tests@Postman --repo repo-name Update my frontend, backend, and tests to match the collection. Add a check on every pull request that updates code based on collection and API updates.پیگیری اجرای Agent
Agent بعد از شروع، وضعیت پیشرفت را در thread همان پیام Slack ارسال می‌کند. اگر گزینه Watch Live نمایش داده شد، می‌توانید فعالیت Agent را زنده ببینید.
در برنامه Postman هم از مسیر Home > Agent Tasks می‌توانید سابقه گفت‌وگوها و taskهای Agent را مشاهده کنید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.