اتصال GapGPT به انجیر؛ پاسخ‌نویسی و استخراج اطلاعات با حساب خودتان
حساب GapGPT را با کلید API به انجیر وصل کنید، مدل انتخاب کنید و پاسخ متنی یا خروجی JSON بگیرید. این راهنما تنظیم اتصال، سقف مصرف و خطاهای رایج را توضیح می‌دهد.
· ۶ دقیقه خواندن · تیم انجیر
چه کاری می‌توان انجام داد؟
برنامه GapGPT متن را به مدل انتخابی شما می‌فرستد و پاسخ را در اختیار مرحله بعد می‌گذارد: خلاصه پیام، پیش‌نویس پاسخ پشتیبانی یا استخراج اطلاعات در یک شیء JSON.
این نسخه چهار اکشن کاربردی دارد: پیش‌نویس پاسخ مشتری، استخراج اطلاعات از متن، خلاصه‌سازی و دسته‌بندی و تولید و بازنویسی محتوا. پرسش آزاد (پیشرفته) و فهرست مدل‌ها هم برای تنظیمات تخصصی در دسترس‌اند. تریگر مستقلی ندارد؛ گردش‌کار با پیام تلگرام، فرم، وبهوک یا زمان‌بندی شروع می‌شود. تبدیل ویس، تولید تصویر و حافظه گفت‌وگو در این نسخه ارائه نشده‌اند.
دریافت کلید
- در پنل توسعه‌دهندگان GapGPT، کلیدهای API وارد حساب شوید.
- «ایجاد کلید API جدید» را بزنید؛ نام و اعتبار موردنیاز کلید را تعیین کنید.
- کلید را کپی کنید. طبق راهنمای سرویس، مقدار کلید فقط یک بار نمایش داده می‌شود.
- در مرحله GapGPT در انجیر، یک اتصال بسازید و کلید را در فیلد «کلید API» قرار دهید.
آزمایش اتصال، فهرست مدل‌ها را دریافت می‌کند. این آزمایش به معنی کافی‌بودن اعتبار برای تولید پاسخ یا پشتیبانی همه مدل‌ها از همه قابلیت‌ها نیست. اعتبار حساب و کلید را در پنل GapGPT کنترل کنید.
تنظیم مرحله
در اکشن پرسش آزاد (پیشرفته):
- مدل گفت‌وگو: از فهرست سرویس انتخاب کنید. قیمت و قابلیت مدل‌ها متفاوت است؛ فهرست به معنی تضمین پشتیبانی JSON نیست.
- متن ورودی: پیام یا داده مرحله قبلی را از انتخابگر داده قرار دهید.
- دستور پاسخ: قواعد، لحن و اطلاعات قابل‌استناد کسب‌وکار را بنویسید. برای اطلاعات نامشخص از مدل بخواهید سؤال بپرسد.
- سقف توکن پاسخ: پیش‌فرض ۲۰۴۸ است. سقف کوچک ممکن است پاسخ را نیمه‌تمام کند؛ سقف بزرگ‌تر اجازه مصرف بیشتری می‌دهد.
- خروجی JSON: برای استخراج فیلدها روشن کنید. مدل باید این قالب را پشتیبانی کند.
خروجی text متن پاسخ است. در حالت JSON، data هم یک شیء قابل‌استفاده در نگاشت ستون‌هاست. model و usage برای بررسی مدل پاسخ‌دهنده و مصرف برگردانده می‌شوند؛ usage لزوماً مبلغ نهایی صورتحساب نیست.
اکشن‌های آماده برای کار روزمره
پیش‌نویس پاسخ مشتری
پیام مشتری، اطلاعات مجاز کسب‌وکار، مدل و لحن را تعیین کنید. خروجی text پیش‌نویس پاسخ است و خود اکشن چیزی ارسال نمی‌کند. برای ارسال، مرحله پیام‌رسان را بعد از بازبینی قرار دهید. اطلاعات نامشخص مثل قیمت و موعد نباید ساخته شود؛ این قاعده در دستور اکشن آمده، ولی بازبینی انسانی همچنان لازم است.
استخراج اطلاعات از متن
متن را از مرحله قبلی بگیرید و برای هر فیلد، کلید انگلیسی، عنوان و توضیح فیلد و نوع تعیین کنید. برای مثال، quantity با عنوان «تعداد سفارش» از نوع عدد؛ mobile با عنوان «موبایل مشتری» از نوع متن. کلیدها باید یکتا باشند. مدل باید JSON را پشتیبانی کند.
خروجی data فقط فیلدهای تعیین‌شده را دارد. مقدار نامشخص null است و عدد صفر یا مقدار «خیر» حذف نمی‌شود. اگر مدل مقدار متنی به‌جای عدد بدهد، اکشن خطا می‌دهد و تبدیل حدسی انجام نمی‌شود. برای مبلغ، واحد پول را در توضیح فیلد مشخص کنید؛ اکشن تبدیل تومان و ریال انجام نمی‌دهد. موبایل، شناسه و تاریخ را متنی انتخاب کنید.
خلاصه‌سازی و دسته‌بندی
متن یا مکالمه و دسته‌های مجاز مثل «فروش»، «پشتیبانی» و «سایر» را بدهید. خروجی شامل summary (خلاصه فارسی)، category (دسته)، urgency (low، normal یا high)، sentiment (positive، neutral یا negative) و nextAction (اقدام پیشنهادی) است. این فیلدها برای شرط و ارجاع به تیم قابل‌استفاده‌اند. دسته‌ای خارج از فهرست یا خروجی نامعتبر به مرحله بعد نمی‌رود. ارزیابی لحن و فوریت، پیشنهاد مدل است.
تولید و بازنویسی محتوا
قالب «توضیح محصول»، «کپشن اینستاگرام»، «پست لینکدین»، «پیامک» یا «بازنویسی متن» را انتخاب کنید. اطلاعات واقعی یا متن اصلی، مخاطب و لحن را مشخص کنید. خروجی text است؛ انتشار یا ارسال به اکشن جدا نیاز دارد. متن پیامک و تعداد بخش‌های آن را پیش از ارسال در سرویس پیامک بررسی کنید.
مثال تنظیم تخصصی JSON
متن ورودی: «مشتری رضایی، تعداد سفارش ۱۲ عدد». دستور پیشنهادی:
ساختار مورد انتظار:
{"customer":"رضایی","quantity":12}آیا پیام‌های قبلی را به یاد دارد؟
اکشن فعلی گپ در انجیر هر ورودی را جدا پردازش می‌کند. برای مثال، اگر مشتری ابتدا نوع سفارش را بگوید و در پیام بعدی فقط بنویسد «۱۲ عدد»، اجرای دوم به‌صورت خودکار متن پیام اول را ندارد. برای خلاصه‌سازی یک متن کامل یا استخراج اطلاعات همان متن، این رفتار کافی است؛ برای ادامه گفت‌وگو باید سابقه مرتبط هم در درخواست قرار بگیرد.
هزینه و اطلاعات ارسالی
متن ورودی و دستور پاسخ برای پردازش به GapGPT ارسال می‌شود. داده‌ای که مجوز ارسالش را ندارید، رمز و کلیدهای دسترسی را در این فیلدها نگذارید. در نسخه فعلی انجیر، هر بار فقط دستور و متن همان مرحله برای مدل فرستاده می‌شود. پیام‌های قبلی گفت‌وگو خودکار به این درخواست اضافه نمی‌شوند.
برای قیمت، تعرفه زنده مدل‌ها و برای مصرف، پنل GapGPT را بررسی کنید. در صورت قطع اینترنت بین‌الملل، قابل‌دسترس‌بودن درگاه به‌تنهایی تضمین پاسخ‌دادن مدل خارجی نیست.
رفع خطا
| پیام | اقدام |
|---|---|
| کلید پذیرفته نشد | فعال‌بودن کلید و اتصال انتخاب‌شده را بررسی کنید. |
| اعتبار کافی نیست | موجودی حساب و سقف اعتبار همان کلید را بررسی کنید. |
| تنظیمات پذیرفته نشد | مدل گفت‌وگو انتخاب کنید؛ پشتیبانی JSON، طول ورودی و سقف توکن را بررسی کنید. |
| پاسخ کامل نیست | سقف پاسخ را بیشتر یا درخواست را کوتاه‌تر کنید. خروجی ناقص به مرحله بعد داده نمی‌شود. |
| سقف درخواست پر شده | تعداد اجراها و محدودیت حساب را بررسی کنید. |
| ارتباط برقرار نشد | وضعیت GapGPT و دسترسی سرور انجیر به سرویس بررسی شود. |
پس از قطع ارتباط، تکرار درخواست ممکن است دوباره هزینه داشته باشد؛ این اکشن درخواست تولید پاسخ را خودکار تکرار نمی‌کند.
بیشتر در راهنمای برنامه‌ها
همه
نوبیتکس در انجیر؛ قیمت و آمار بازار با واحد مشخص
سه اکشن داده عمومی و تریگر عبور قیمت نوبیتکس را بشناسید؛ با تفاوت تومان و ریال، شکل خروجی و محدودیت درخواستها.
اتصال Groq به انجیر؛ هوش مصنوعی سریع با پلن رایگان برای شروع
Groq با یک کلید هم ویس فارسی را به متن تبدیل می‌کند هم از متن ستونهای مرتب بیرون میکشد؛ سریع است و پلن رایگانش برای ساختن و آزمایش اولین گردشکارها کافی است.
اتصال OpenRouter به انجیر؛ یک اتصال برای GPT، Claude، Gemini و مدل‌های رایگان
بیشتر راهکارهای هوش مصنوعی انجیر از OpenRouter استفاده میکنند. یک بار وصلش میکنی و در هر مرحله هر مدلی را که خواستی انتخاب میکنی؛ از GPT و Claude تا مدل‌های رایگان.