ساخت ایجنت پشتیبانی با n8n و Claude — قدم‌به‌قدم

۱. نقشه‌ی ورک‌فلو

ورک‌فلو چهار گام دارد: نود Telegram Trigger پیام تازه را دریافت می‌کند، یک گام دسته‌بندی نوع درخواست را مشخص می‌کند، Claude پاسخ را می‌نویسد و در پایان گفت‌وگو در CRM ثبت می‌شود. اگر درخواست حساس باشد، مثل بازگشت وجه یا شکایت، به‌جای پاسخ خودکار برای پشتیبان انسانی فرستاده می‌شود.

۲. اتصال n8n به Claude API

می‌توانید از نود آماده‌ی Anthropic در n8n استفاده کنید یا با نود HTTP Request مستقیم درخواست بفرستید. کلید API را فقط در بخش Credentials ذخیره کنید، نه داخل خود نود.

POST https://api.anthropic.com/v1/messages
x-api-key: <ANTHROPIC_API_KEY>
anthropic-version: 2023-06-01
content-type: application/json

{
  "model": "claude-sonnet-5",
  "max_tokens": 1024,
  "system": "You are a support agent. Reply in Persian.",
  "messages": [{ "role": "user", "content": "..." }]
}

۳. پرامپت سیستم و دسته‌بندی دقیق

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

۴. نکته‌های نسخه‌ی نهایی: خطا، هزینه و امنیت

• برای خطاهای موقت مثل 429 گزینه‌ی Retry On Fail را با فاصله‌ی افزایشی فعال کنید.
• مقدار max_tokens را محدود نگه دارید تا هزینه‌ی هر پاسخ قابل پیش‌بینی بماند.
• داده‌ی شخصی کاربران را فقط تا جایی که لازم است به مدل بفرستید و لاگ‌ها را با اطلاع کاربر نگه دارید.
• قبل از روشن‌کردن پاسخ خودکار، چند روز در حالت «پیش‌نویس» اجرا کنید و پاسخ‌ها را بازبینی کنید.