افزودن مدل پیکو هوش به Dify با OpenAI-API-compatible
در Dify با ارائهدهندهی OpenAI-API-compatible مدل‌های پیکو هوش را اضافه کنید و در اپ چت، ورک‌فلو و ایجنت استفاده کنید؛ همراه نکات embeddings.
پیکو هوش·انتشار: ·به‌روزرسانی: ·۶ دقیقه مطالعه
خلاصه: Dify پلتفرم ساخت اپ‌های هوش مصنوعی (چت‌بات، ورک‌فلو، ایجنت) است. از بخش Model Provider می‌توانید ارائهدهندهی OpenAI-API-compatible را نصب و پیکربندی کنید و هر مدل چت پیکو هوش را با نام آن اضافه کنید. نام منوها در نسخه‌های مختلف (Cloud یا خودمیزبان) ممکن است اندکی فرق کند.
گام ۱: نصب افزونهی ارائه‌دهنده
در Dify به Integrations > Model Provider بروید (در مستندات فعلی این مسیر آمده؛ در نسخه‌های قدیمی‌تر و برخی نصب‌های خودمیزبان Settings > Model Provider است). فقط مالک و ادمین‌های workspace می‌توانند ارائه‌دهنده‌ها را مدیریت کنند. در فهرست، «OpenAI-API-compatible» را پیدا و نصب کنید (در نسخه‌های جدید ارائه‌دهنده‌ها به‌صورت افزونه نصب می‌شوند).
گام ۲: افزودن مدل
روی Add Model در کارت ارائه‌دهنده بزنید و مقادیر زیر را وارد کنید. (صفحه‌ی رسمی Dify درباره‌ی ارائه‌دهندگان، فیلدهای اختصاصی افزونهی OpenAI-API-compatible را فهرست نمی‌کند؛ نام فیلدهای زیر از رابط افزونه و منابع جانبی است و ممکن است بسته به نسخهی افزونه کمی فرق کند، مثلاً «API endpoint URL» به‌جای «API Base URL». حالت Completion mode را روی Chat بگذارید.)
برای هر مدلی که می‌خواهید (مثلاً claude-sonnet-5-5 و claude-haiku-5-5) این مرحله را تکرار کنید. فیلد «Model Name» عیناً به پیکو هوش ارسال می‌شود، پس نباید نام نمایشی باشد.
گام ۳: ساخت اپ چت
۱. Create App و سپس Chatbot (یا Workflow) را انتخاب کنید. ۲. در بخش Model، مدل افزوده‌شده را برگزینید. ۳. در Instructions نقش دستیار را به فارسی بنویسید، مثلاً «تو دستیار پشتیبانی یک فروشگاه هستی و کوتاه و مودبانه پاسخ می‌دهی». ۴. در Preview تست کنید و سپس Publish بزنید. Dify برای اپ شما API و صفحه‌ی وب می‌سازد.
استفاده در Workflow
در حالت ورک‌فلو، یک گره‌ی LLM بگذارید، مدل را انتخاب و در پرامپت از متغیرهای ورودی (از انتخابگر متغیر با تایپ / استفاده کنید؛ قالب داخلی شبیه {{#شناسه‌گره.نام_متغیر#}} است) استفاده کنید. الگوی ارزان: گره‌ی دسته‌بندی با مدل سریع (claude-haiku-5-5) و گره‌ی نوشتن پاسخ با مدل قوی‌تر. گره‌های شرطی (IF/ELSE) مسیر را بر اساس دسته انتخاب می‌کنند.
محدودیت مهم: دانش و embeddings
قابلیت Knowledge (پایگاه دانش و RAG) در Dify برای ایندکس سند به یک مدل Text Embedding نیاز دارد. پیکو هوش فعلاً اندپوینت embeddings ندارد؛ پس نباید «Text Embedding» را روی پیکو هوش تنظیم کنید. از مدل embedding دیگری (مثلاً محلی یا سرویس جداگانه) استفاده کنید، و فقط مدل تولید پاسخ را از پیکو هوش بگیرید. همچنین مدل Rerank و Speech-to-Text را به همین شکل از منبع دیگر تهیه کنید.
هزینه و نکات
در Dify هر اجرای ورک‌فلو ممکن است چند فراخوان LLM داشته باشد؛ با تعداد گره‌ها هزینه ضرب می‌شود.
حافظه‌ی گفتگو (Memory) تاریخچه را در هر درخواست می‌فرستد؛ پنجره‌ی حافظه را کوچک بگیرید.
در Model Provider می‌توانید چند مدل را اضافه و با دکمه‌ی Default Models (بالا سمت راست؛ در نسخه‌های قدیمی‌تر System Model Settings) برای هر کار یک پیش‌فرض تعیین کنید: System Reasoning Model، Embedding Model، Rerank Model، Speech-to-Text و Text-to-Speech. اگر پیش‌فرض خالی باشد قابلیت‌های وابسته به آن کار نمی‌کنند. برای Embedding، Rerank و Speech-to-Text مدل پیکو هوش تنظیم نکنید. مدل پیش‌فرض استدلال برای ساخت عنوان گفتگو، پیشنهاد سوال بعدی و کارهای جانبی استفاده می‌شود؛ پس یک مدل اقتصادی مثل claude-haiku-5-5 برای این کارها بگذارید تا هزینه‌ی غیرضروری ایجاد نشود. مدل‌های قوی‌تر را فقط در گره‌هایی که واقعاً لازم است انتخاب کنید.
پرامپت و متغیرها
در اپ‌های چت، پرامپت سیستم را با متغیرها بنویسید. برای ورک‌فلو، ورودی‌های ساخت‌یافته (فرم) تعریف کنید تا کاربر فقط داده‌ی لازم را وارد کند. در گره‌ی LLM می‌توانید خروجی را به JSON محدود کنید و در گره‌های بعدی از فیلدها استفاده کنید. برای کار با ابزار، گره‌ی Agent یا ابزارهای سفارشی (OpenAPI) را به‌کار ببرید و مدلی با function calling قوی انتخاب کنید؛ پروتکل آن در راهنمای Function Calling آمده است.
انتشار و API
پس از Publish، Dify برای اپ شما کلید API جداگانه و مستندات می‌دهد. توجه کنید که این کلید مربوط به Dify است، نه پیکو هوش؛ هزینه‌ی مدل از کلید پیکو هوش که در Model Provider ثبت کرده‌اید کسر می‌شود. پس اگر اپ را عمومی کنید، محدودیت نرخ و احراز هویت برای جلوگیری از سوءاستفاده تنظیم کنید و سقف ماهانه‌ی کلید پیکو هوش را پایین نگه دارید.
مشاهده‌پذیری
Dify لاگ اجرای هر گره را نشان می‌دهد، از جمله ورودی، خروجی و توکن مصرفی. از آن برای یافتن گره‌های پرهزینه استفاده کنید و با اعداد داشبورد پیکو هوش مقایسه کنید. اگر گره‌ای بیش از حد توکن می‌خورد، پرامپت یا حافظه‌ی آن را کوتاه کنید.
سوالات متداول
آیا به افزونهی جداگانهی «PicoAi» نیاز دارم؟
خیر. ارائهدهندهی OpenAI-API-compatible کافی است.
آیا Dify Cloud هم کار میکند؟
بله، به شرط آنکه به اینترنت عمومی دسترسی داشته باشد. در نسخهی خودمیزبان، دسترسی شبکهی سرور را بررسی کنید.