چگونه با OpenAI Agents SDK یک عامل واتس‌اپ بسازیم

OpenAI Agents SDK چارچوب متن‌باز OpenAI برای ساخت عامل‌هاست: یک مدل با دستورالعمل‌ها، ابزارهایی که می‌تواند فراخوانی کند، واگذاری‌ها به عامل‌های دیگر و محافظ‌هایی پیرامون ورودی‌ها و خروجی‌هایش، همه در یک حلقه اجرا می‌شوند تا کار تمام شود. راه بسیار خوبی برای ساخت عامل است. اما به‌تنهایی به شما شماره واتس‌اپ، صندوق ورودی تیم، پیام‌های تمپلیت یا راهی برای تحویل‌گرفتن توسط یک نفر نمی‌دهد. با Agent Harness در MonoChat، OpenAI Agents SDK را به‌عنوان یک AI Harness انتخاب می‌کنید، یک نود AI Agent را در یک جریان قرار می‌دهید، واتس‌اپ را متصل می‌کنید و آزمایش می‌کنید، و MonoChat بقیه را انجام می‌دهد.

این راهنما آنچه SDK به شما می‌دهد، سه راه برای استفاده از عامل‌های OpenAI در MonoChat، یک راه‌اندازی گام‌به‌گام و جزئیات مخصوص واتس‌اپ را که تعیین می‌کنند مشتریان به عامل اعتماد می‌کنند یا نه پوشش می‌دهد.

OpenAI Agents SDK چه چیزی به شما می‌دهد

SDK حول مجموعه کوچکی از ایده‌ها ساخته شده است:

• عامل‌ها: یک مدل به‌همراه دستورالعمل‌هایی که کار آن را توصیف می‌کنند.
• ابزارها: توابعی که عامل می‌تواند فراخوانی کند، مانند «جستجوی یک سفارش» یا «بررسی یک بازه زمانی»، به‌علاوه سرورهای MCP.
• واگذاری‌ها: یک عامل کار را به عامل دیگری که در آن تخصص دارد می‌سپارد، مثلاً از یک عامل پشتیبانی عمومی به یک عامل مرجوعی.
• محافظ‌ها: بررسی‌هایی که در کنار عامل اجرا می‌شوند تا جلوی ورودی‌ها یا خروجی‌هایی را که نمی‌خواهید بگیرند.
• نشست‌ها و ردیابی: حافظه در میان نوبت‌ها و سابقه‌ای از آنچه عامل گام‌به‌گام انجام داده است.

در کنار هم، این یک agent harness است: حلقه‌ای که به مدل اجازه می‌دهد عمل کند، کار خود را بررسی کند و ادامه دهد، به‌جای اینکه یک بار پاسخ دهد. برای پیام‌رسانی مشتری، این تفاوت میان توضیح سیاست مرجوعی شما و واقعاً ایجاد مرجوعی است.

واتس‌اپ چه چیزی به مسئله اضافه می‌کند

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

• WhatsApp Business Platform. یک اتصال API رسمی، یک کسب‌وکار تأییدشده و یک شماره تأییدشده.
• پنجره 24 ساعته. پاسخ آزاد تا 24 ساعت پس از آخرین پیام مشتری مجاز است؛ پس از آن به یک تمپلیت تأییدشده نیاز دارید.
• سیاست. از 15 ژانویه 2026، واتس‌اپ دستیارهای هوش مصنوعی عمومی را از پلتفرم دور نگه می‌دارد. عاملی که به مشتریان خودتان خدمت می‌کند مجاز است و وقتی پاسخ‌ها خودکار هستند انتظار می‌رود مسیری روشن به سوی انسان وجود داشته باشد.
• افراد. برخی گفتگوها باید با تاریخچه سالم به یک نفر بروند، درون ابزاری که تیم شما از قبل استفاده می‌کند.
• کانال‌های دیگر. مشتریانی که در Instagram، Messenger یا وب‌سایت شما می‌نویسند همان پاسخ‌ها را انتظار دارند.

MonoChat این موارد را پیرامون عامل مدیریت می‌کند، بنابراین کار شما روی خود عامل می‌ماند.

سه راه برای استفاده از عامل‌های OpenAI در MonoChat

گزینه	محل اجرا	آنچه نیاز دارید
OpenAI Agents SDK	درون MonoChat	چیز اضافه‌ای نیاز نیست؛ از مدل‌های هوش مصنوعی شما استفاده می‌کند
OpenAI Agents API (میزبانی‌شده توسط OpenAI)	ابر OpenAI	کلید API شما در OpenAI
سفارشی (سرویس Agents SDK خودتان)	سرور خودتان	یک نشانی نقطه‌پایانی و یک رمز مشترک

با Harness مربوط به OpenAI Agents SDK شروع کنید اگر عاملی به سبک OpenAI می‌خواهید بدون استقرار چیزی. OpenAI Agents API را انتخاب کنید اگر عامل‌های شما از قبل روی پلتفرم میزبانی‌شده OpenAI هستند. سفارشی را انتخاب کنید اگر توسعه‌دهندگان شما با SDK عامل خودشان را با ابزارها، واگذاری‌ها و آزمون‌های خودشان نوشته‌اند و می‌خواهند آن کد را اجرا کنند؛ چگونه عامل هوش مصنوعی خودتان را به واتس‌اپ وصل کنید را ببینید.

گام‌به‌گام: یک عامل OpenAI Agents SDK در واتس‌اپ

1. یک AI Harness اضافه کنید

یک AI Harness در MonoChat اضافه کنید و OpenAI Agents SDK را به‌عنوان ارائه‌دهنده انتخاب کنید. درون MonoChat اجرا می‌شود و از مدل‌های هوش مصنوعی‌ای که از قبل تنظیم کرده‌اید استفاده می‌کند، بنابراین برای این گام کلید یا سرور اضافه‌ای نیست.

2. یک نود AI Agent به یک جریان اضافه کنید

در جریانی که گفتگوهای واتس‌اپ شما را دریافت می‌کند، یک نود AI Agent اضافه کنید و Harness را انتخاب کنید. دستورالعمل‌های عامل را بنویسید: به چه کسی خدمت می‌کند، چه کارهایی می‌تواند انجام دهد، چه کارهایی را هرگز نباید انجام دهد و چه زمانی واگذار می‌کند.

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

هر نود AI Agent سه نقش مدل دارد:

• مدل اصلی استدلال می‌کند و پاسخ‌ها را می‌نویسد.
• مدل جایگزین پس از حد نرم یا خطا کار را به دست می‌گیرد.
• مدل سریع کارهای پس‌زمینه را انجام می‌دهد.

یک حد بودجه برای هر اجرا اضافه کنید تا یک گفتگوی غیرمعمول نتواند صورتحساب بزرگی بسازد. مطمئن نیستید جایگزین را چگونه انتخاب کنید؟ چرا عامل هوش مصنوعی رو‌در‌رو با مشتری شما به مدل جایگزین نیاز دارد را بخوانید.

4. ابزارهایتان را متصل کنید

ابزارهایی را که با پرتکرارترین درخواست‌های شما مطابقت دارند به عامل بدهید:

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

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

5. واتس‌اپ (و هر چیز دیگر) را متصل کنید

شماره WhatsApp Business خود را از طریق MonoChat، شریک تجاری رسمی Meta، متصل کنید. همان جریان می‌تواند در Instagram، Messenger، TikTok، Telegram، چت وب، پیامک و تماس صوتی اجرا شود، بنابراین یک عامل همه کانال‌ها را پوشش می‌دهد.

6. با پیام‌های واقعی آزمایش کنید

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

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

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

پیش از اقدام‌های بازگشت‌ناپذیر تأیید بگیرید. بگذارید عامل پیشنهاد دهد و مشتری تأیید کند، پیش از لغو، بازپرداخت یا تغییر رزرو.

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

دستورالعمل‌هایی که محدودیت‌ها را نام می‌برند. «بازپرداخت تا 50 یورو را می‌توانی تأیید کنی؛ بالاتر از آن به تیم صورتحساب واگذار کن.» اعداد صریح از قوانین مبهم بهترند.

درباره کسب‌وکار خود بمانید. عاملی که به مشتریان شما کمک می‌کند در واتس‌اپ مجاز است. عاملی که به هر چیزی پاسخ می‌دهد خطر نقض قوانین 2026 واتس‌اپ را دارد؛ راهنمای سیاست چت‌بات هوش مصنوعی واتس‌اپ ما توضیح می‌دهد مرز کجاست.

هزینه‌ها

سه چیز جمع می‌شوند: طرح MonoChat شما، مصرف مدل هوش مصنوعی و هزینه پیام‌های واتس‌اپ Meta. از 1 اکتبر 2026، Meta پاسخ‌های خدمات را پس از 1,000 پاسخ اول هر ماه برای هر شماره کسب‌وکار محاسبه می‌کند؛ راهنمای قیمت‌گذاری API واتس‌اپ ما را ببینید.

در سمت هوش مصنوعی، وقتی از کلیدهای ارائه‌دهنده خودتان استفاده می‌کنید MonoChat هیچ سربار اضافه نمی‌کند. بودجه برای هر اجرا، یک مدل سریع ارزان‌تر برای کارهای پس‌زمینه و یک مدل جایگزین قابل‌اعتماد، صورتحساب را قابل پیش‌بینی نگه می‌دارند.

گرفتار یک انتخاب نیستید

Agent Harness به شما اجازه می‌دهد چارچوب را انتخاب کنید، نه فقط مدل را. اگر بعداً بخواهید Claude Agent SDK، Pi، Claude Managed Agents یا چارچوب خودتان را امتحان کنید، یک AI Harness دیگر اضافه کنید و نود AI Agent را به آن اشاره دهید. کانال‌ها، ابزارها و واگذاری شما همان‌طور که هستند می‌مانند. همه ارائه‌دهندگان را در صفحه Agent Harness مقایسه کنید.