ارائه‌دهندهٔ هوش مصنوعی Grok

توضیحات

این افزونه یکپارچه‌سازی Grok (از xAI) را برای کیت توسعهٔ WP AI Client فراهم می‌کند و به سایت‌های وردپرس امکان می‌دهد از مدل‌های Grok برای تولید متن و سایر قابلیت‌های هوش مصنوعی مرتبط استفاده کنند.

ویژگی‌ها:

• تولید متن با مدل‌های Grok
• پشتیبانی از فراخوانی توابع (Function Calling)
• پشتیبانی از ورودی بینایی (Vision input) برای مدل‌های سازگار
• ثبت خودکار ارائه‌دهنده (Automatic provider registration)

مدل‌های در دسترس به‌صورت پویا از Grok API کشف می‌شوند.

پیش‌نیازها:

• PHP نسخهٔ ۷.۴ یا بالاتر
• افزونهٔ WP AI Client باید نصب و فعال شده باشد.
• کلید API Grok از xAI
• خرید توکن‌های API از x.ai — برای کارکرد صحیح درخواست‌های API داشتن موجودی معتبر توکن ضروری است.

نحوهٔ استفاده

این ارائه‌دهنده به‌صورت خودکار روی هوک init ثبت می‌شود. پس از فعال بودن هر دو افزونه و پیکربندی کلید API، می‌توانید تولید متن را آغاز کنید:

تولید متن پایه (Basic Text Generation)

$text = AI_Client::prompt( 'Explain quantum computing.' )->using_provider( 'grok' )->generate_text();

به‌همراه دستورالعمل‌های سیستم (System Instructions)

$text = AI_Client::prompt( 'Summarize the history of WordPress.' )->using_provider( 'grok' )->using_system_instruction( 'Be concise and accurate.' )->using_temperature( 0.2 )->using_max_tokens( 500 )->generate_text();

Vision (ورودی تصویر)

$text = AI_Client::prompt( 'Describe this image.' )->using_provider( 'grok' )->with_file( 'https://example.com/photo.jpg', 'image/jpeg' )->generate_text();

نیازمند مدلی از Grok با قابلیت بینایی (Vision) است.

خروجی JSON

$json = AI_Client::prompt( 'Analyze this topic: WordPress plugins' )->using_provider( 'grok' )->as_json_response( $schema )->generate_text();

برای مشاهدهٔ مثال‌های کامل استفاده—including تاریخچهٔ چت، فراخوانی توابع (Function Calling) و شناسایی قابلیت‌ها—به فایل README در GitHub مراجعه کنید.

سرویس‌های خارجی

این افزونه برای فراهم کردن قابلیت‌های تولید متن مبتنی بر هوش مصنوعی در وردپرس، به xAI Grok API متصل می‌شود. xAI Grok API یک سرویس شخص ثالث است که توسط شرکت xAI ارائه می‌شود.

چه داده‌ای و چه زمانی ارسال می‌شود

• کلید API: کلید API شما در xAI همراه هر درخواست برای احراز هویت ارسال می‌شود.
• فهرست مدل‌ها (Model listing): زمانی که افزونه در دسترس بودن ارائه‌دهنده را بررسی می‌کند یا فهرست مدل‌های موجود را نمایش می‌دهد، درخواستی به xAI API برای دریافت فهرست به‌روز مدل‌های Grok ارسال می‌کند.
• پرومپت‌های تولید متن (Text generation prompts): زمانی که سایت شما از افزونه برای تولید متن استفاده می‌کند، متن پرومپت (و هر تصویر یا فایل پیوست‌شده، دستورالعمل‌های سیستم و تاریخچهٔ گفتگو) برای پردازش به xAI API ارسال می‌شود.

تمام تبادلات داده به این نشانی ارسال می‌شوند: https://api.x.ai/v1

داده فقط زمانی ارسال می‌شود که افزونه برای تولید متن یا بررسی در دسترس بودن مدل‌ها به‌طور فعال استفاده شود. هیچ داده‌ای به‌صورت غیرفعال یا در پس‌زمینه ارسال نمی‌شود.

لینک‌های سرویس

• وب‌سایت xAI: https://x.ai
• مستندات API xAI: https://docs.x.ai/developers/models
• شرایط سرویس xAI: https://x.ai/legal/terms-of-service
• سیاست حفظ حریم خصوصی xAI: https://x.ai/legal/privacy-policy

مشارکت

از مشارکت شما استقبال می‌کنیم! می‌توانید با روش‌های زیر کمک کنید:

• گزارش باگ‌ها یا پیشنهاد قابلیت‌های جدید از طریق GitHub Issues
• ارسال Pull Request در GitHub

پیش از ارسال Pull Request، لطفاً راهنمای مشارکت ما را مطالعه کنید.