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

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

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

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

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

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

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

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

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

• WhatsApp Business Platform. یک اتصال API رسمی، یک کسب‌وکار تأییدشده و یک شماره تأییدشده.
• پنجره 24 ساعته. پاسخ آزاد تا 24 ساعت پس از آخرین پیام مشتری مجاز است؛ پس از آن به یک تمپلیت تأییدشده نیاز دارید.
• سیاست. از 15 ژانویه 2026، WhatsApp دستیارهای هوش مصنوعی عمومی را از پلتفرم دور نگه می‌دارد. عاملی که به مشتریان خودتان خدمت می‌کند مجاز است و وقتی پاسخ‌ها خودکار هستند انتظار می‌رود مسیری روشن به سوی انسان وجود داشته باشد.
• افراد. برخی گفتگوها باید با تاریخچه سالم به یک نفر بروند، درون ابزاری که تیم شما از قبل استفاده می‌کند.
• کانال‌های دیگر. مشتریانی که در 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 عامل خودشان را با ابزارها، واگذاری‌ها و آزمون‌های خودشان نوشته‌اند و می‌خواهند آن کد را اجرا کنند؛ چگونه عامل هوش مصنوعی خودتان را به WhatsApp وصل کنید را ببینید.

گام‌به‌گام: یک عامل OpenAI Agents SDK در WhatsApp

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الگوهایی که در WhatsApp خوب کار می‌کنند

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

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

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

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

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

هزینه‌ها

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

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

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

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

عامل فارسی‌زبان با OpenAI Agents SDK

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