اولین پایپ‌لاین را بسازید

آنچه خواهید ساخت

در پایان این آموزش، این‌ها را در اختیار خواهید داشت:

• یک قالب پایپ‌لاین ذخیره‌شده که عاملی را با یک پرامپت اعزام می‌کند
• اجراهای دستی روشن روی آن، تا بتوان آن را دستی شروع کرد
• یک اجرای کامل‌شده، با ورودی و خروجی گام در دیدرس

پیش‌نیازها: اولین عامل را اعزام کنید را کامل کرده باشید تا عاملی با یک آداپتور و یک مدل داشته باشید.

یک پایپ‌لاین یک DAG از گام‌هاست. قالب‌ها گراف را تعریف می‌کنند؛ یک اجرا همان اجراشدن آن قالب است. برای مدل پشت آن، پایپ‌لاین‌ها و خودکارسازی را بخوانید؛ برای واژگان کامل گام‌ها، انواع گام پایپ‌لاین.

گام 1: ایجاد یک قالب

1. به تنظیمات → فضای کاری → قالب‌های پایپ‌لاین بروید
2. روی قالب جدید کلیک کنید

ویرایشگر روی یک اسکلت اولیه به نام پایپ‌لاین جدید باز می‌شود (شناسه pipeline_N). روی عنوان در سرصفحه کلیک کنید و نامش را عوض کنید — برای این آموزش، code_quality_check نام خوبی است. هیچ دیالوگ شناسه‌ای و هیچ فیلد توضیحی وجود ندارد.

بوم خالی نیست. یک قالب جدید از پیش به شکل Trigger → Step → پایانه سیم‌کشی شده است، که در آن «Step» یک گرهٔ عامل پرامپت است و پایانه یک دیده‌بان نامرئی است که ویرایشگر آن را به هر مقصد قابل‌دسترس دوباره سیم‌کشی می‌کند.

همان گرهٔ Step که از قبل آنجاست را پیکربندی می‌کنید.

گام 2: پیکربندی گام

1. روی گرهٔ Step روی بوم کلیک کنید
2. در پنل پیکربندی گره در سمت راست، این‌ها را تنظیم کنید:
   • عامل: همان عامل آموزش قبلی
   • قالب پرامپت: «کد روی شاخهٔ فعلی را از نظر مشکلات کیفیت بازبینی کن. هر چه پیدا می‌کنی را فهرست کن.»
3. تریگرها از را دست نزنید — گره از قبل طوری سیم‌کشی شده که بعد از Trigger فعال شود

گام 3: ذخیره

در سرصفحهٔ ویرایشگر ذخیره را فشار دهید.

نقطهٔ بررسی. عنوان «تغییرات ذخیره‌نشده» پاک می‌شود.

گام 4: اجازه دادن به اجراهای دستی

1. روی کاشی خط‌چین افزودن تریگر روی بوم کلیک کنید (یا اجرای دستی را از بخش تریگرها در کتابخانهٔ گره بکشید) و اجرای دستی را انتخاب کنید.
2. آن گره را انتخاب کنید. در بازرس سمت راست، فعال را روشن کنید — «در صفحهٔ اجرا نشان بده و دستی شروع کن.»

این کار اختیاری نیست و به‌سادگی از قلم می‌افتد. یک قالب جدید بدون هیچ ردیف تریگری ساخته می‌شود، پس تا وقتی این را روشن نکنید صفحهٔ اجرا آن را فهرست نمی‌کند و چیزی برای شروع وجود ندارد. این کلید تریگر را بی‌درنگ می‌نویسد؛ منتظر ذخیرهٔ دیگری نمی‌ماند.

همین کلید پشت اجرای دستی در سرصفحهٔ ویرایشگر قرار دارد، جایی که کنار ورودی‌های اعلام‌شدهٔ قالب می‌نشیند.

گام 5: اجرای آن

1. در نوار کناری روی پایپ‌لاین‌ها کلیک کنید
2. در سرصفحه روی اجرای پایپ‌لاین کلیک کنید
3. در نوار کناری سمت چپ code_quality_check را انتخاب کنید
4. روی فرم روی اجرای پایپ‌لاین کلیک کنید — قالب شما ورودی‌ای اعلام نمی‌کند، پس چیزی برای پر کردن نیست

نقطهٔ بررسی. یک توست تأیید می‌کند که اجرا شروع شده است و Control Center جزئیات اجرا را باز می‌کند.

موتور رکورد اجرا را می‌سازد، تریگر را کامل می‌کند، گام را زمان‌بندی می‌کند، عامل را اعزام می‌کند و اجرا را وقتی شاخهٔ ورودی پایانه تمام شود کامل می‌کند.

گام 6: بررسی نتیجه

روی گام در اجرا کلیک کنید تا پنل جزئیاتش باز شود:

• زمان‌های شروع‌شده و تمام‌شده و مدت
• ورودی: حالتی که به گام داده شده است
• خروجی: آنچه تولید کرد — اینجا، پاسخ عامل
• فعالیت عامل، با پیوندی به گفتگویی که گام هدایتش کرده است

نقطهٔ بررسی. وضعیت گام کامل‌شده خوانده می‌شود و خروجی‌اش بازبینی عامل را در خود دارد.

افزودن گام‌های بیشتر

گره‌ها با کشیدن یک مورد از کتابخانهٔ گره در سمت چپ روی بوم اضافه می‌شوند، یا با فشردن افزودن گام (+) درست بعد از یک گره. برای وصل کردن آن‌ها، از درگاه خروجی یک گره روی گرهٔ دیگری بکشید، یا گرهٔ جدید را انتخاب کنید و زیر تریگرها از گام بالادستش را تیک بزنید.

گرهٔ پایانه رسم نمی‌شود و نمی‌توان انتخابش کرد. ویرایشگر آن را به هر مقصد قابل‌دسترس دوباره سیم‌کشی می‌کند، پس گره‌ای که بعد از Step اولیه اضافه کنید هم اجرا می‌شود.

خلاصه

یک قالب ساختید، گرهٔ عامل پرامپتی را که با آن ساخته شده بود پیکربندی کردید، ذخیره‌اش کردید، قابل‌اجرای دستی‌اش کردید، یک اجرا شروع کردید و ورودی و خروجی گام را خواندید.

پایپ‌لاین‌ها بسیار بزرگ‌تر از این می‌شوند — مسیریاب‌های شرطی، شاخه‌های موازی، گره‌های join، انشعاب for-each، دروازه‌های انسانی — اما شکل هرگز تغییر نمی‌کند: گام‌هایی در یک DAG که حالت را می‌گذرانند.

بعدی: Slack را به فضای کاری‌تان متصل کنید، آخرین آموزش در این مجموعه.

• راه‌اندازی تریگرهای پایپ‌لاین برای شروع پایپ‌لاین‌ها از رویدادها یا یک زمان‌بندی
• پایپ‌لاین‌ها و خودکارسازی برای مدل زیرین
• انواع گام پایپ‌لاین برای هر نوع گام