راهنمای ساخت زیرعامل Claude؛ کدنویسی ماژولار را از امروز شروع کنید

خلاصه

با زیرعامل‌های Claude می‌توانید پروژه‌های پیچیده را به بخش‌های کوچک مستقل تقسیم کنید، خطا را سریع‌تر پیدا کنید و سیستم را بی‌درنگ گسترش دهید. این مقاله همه‌چیز از نصب تا بهینه‌سازی را مرحله‌به‌مرحله نشان می‌دهد.

مقدمه

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

چرا زیرعامل بسازیم؟

افزایش سرعت توسعه

هر زیرعامل فقط روی یک وظیفه تمرکز دارد، بنابراین کد کوتاه‌تر و قابل فهم‌تر می‌شود.

اشکال‌زدایی آسان

وقتی خطایی رخ می‌دهد، فقط همان بخش را چک می‌کنید؛ لازم نیست کل سیستم را زیرورو کنید.

مقیاس بی‌نهایت

هر زیرعامل را جداگانه ارتقا یا حذف می‌کنید؛ بقیه سیستم بی‌تأثر باقی می‌مانند.

آماده‌سازی محیط کار

  1. مخزن نمونه را کلون کنید: git clone https://github.com/anthropics/sub-agent-starter.git
  2. وابستگی‌ها را نصب کنید: npm install
  3. ترمینال تعاملی TermKit را اجرا کنید تا بتوانید تغییرات را لحظه‌ای ببینید.

ساخت اولین زیرعامل

تعریف ساده

{name: "mail_reader", description: "ایمیل‌های ورودی را می‌خواند و خلاصه می‌کند", model: "claude-3-haiku", tools: ["gmail_api"]}

نکات مهم

نام و توضیح کوتاه بنویسید؛ بعداً خودتان هم یادتان می‌ماند دقیقاً چه کار می‌کند.

مدل سبک‌تر را برای کارهای ساده انتخاب کنید تا هزینه پایین بیاید.

اختصاص ابزار مناسب

نوع کارابزار پیشنهادیمدل مناسب
تحلیل دادهpandas_apiclaude-3-sonnet
پردازش زبانnltk_toolclaude-3-haiku
تصویر‌برداریopencv_bridgeclaude-3.5-sonnet

تست مستقل هر زیرعامل

قبل از اتصال به سیستم اصلی، برای هر زیرعامل یک فایل تست جداگانه بنویسید.

ورودی‌های مرزی مانند متن خالی یا فایل ۰ بایت بدهید تا مطمئن شوید خطا مدیریت می‌شود.

ثبت وقایع و اشکال‌زدایی

شناسه یکتا

به هر درخواست و پاسخ یک UUID بچسبانید؛ بعداً در میان هزاران لاگ، سریع ردیف می‌شوید.

رنگ‌بندی در ترمینال

خروجی موفقیت را سبز، هشدار را زرد و خطا را قرمز نمایش دهید تا با یک نگاه متوجه مشکل شوید.

بهینه‌سازی و مقیاس‌پذیری

کاهش هزینه

کارهای ساده را با مدل Haiku انجام دهید؛ فقط مراحل پیچیده را به Sonnet یا Opus بسپرید.

کش ابزار

اگر یک ابزار مکرراً فراخوانی می‌شود، نتایج را تا ۵ دقیقه در حافظه نگه دارید تا API کمتر صدا زده شود.

کنترل دسترسی

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

چک‌لیست نهایی

  • هر زیرعامل را مستقل تست کرده‌ام.
  • شرط توقف (timeout یا تعداد تلاش) مشخص شده است.
  • ابزارها با نسخه جدید API سازگارند.
  • لاگ‌ها به‌روز و قابل‌جست‌جو هستند.
  • مدل‌ها بر اساس پیچیدگی کار انتخاب شده‌اند.

دیدگاه‌ خود را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *