Fish Audio Docs
أدلة التكاملتكاملات الطرف الثالث
Back to site

إعداد WorkBuddy (إصدار تجريبي)

قم بتثبيت الإصدار التجريبي من WorkBuddy Skill الذي يقوم بإنشاء ملفات كلام MP3 من خلال Fish Audio API.

قم بتوصيل Fish Audio TTS بـ WorkBuddy

يمكن لـ Tencent WorkBuddy الاتصال بواجهات برمجة التطبيقات الخارجية من خلال المهارات المخصصة. استخدم مهارة Fish Audio لإنشاء ملفات MP3 من مهمة WorkBuddy.

هذا التكامل في الإصدار التجريبي لأن واجهة مستخدم WorkBuddy لاستيراد المهارات والأذونات يمكن أن تختلف حسب إصدار سطح المكتب. لا تقم بتكوين Fish Audio ضمن الإعدادات → النموذج: تتوقع هذه الشاشة نقطة نهاية نموذج الدردشة مثل /chat/completions، وليس نقطة نهاية الكلام Fish Audio.

قبل أن تبدأ

أنت بحاجة إلى:

  • مفتاح Fish Audio API مع أرصدة API
  • Python 3.9 أو الأحدث متاح لـ WorkBuddy
  • إذن للمهارة لتشغيل برنامج نصي محلي والوصول إلى الشبكة

قم بإنشاء مفتاح API مخصص لـ WorkBuddy حتى يمكن مراقبته وإبطاله بشكل مستقل.

تنزيل المهارة

قم بتنزيل Fish Audio TTS حزمة المهارات واستخرجها. تحتوي الحزمة على SKILL.md، skill.yml، تطبيق Python، وREADME.

تستخدم إصدارات WorkBuddy حاليًا أحد تدفقات التثبيت التالية:

  1. افتح المهارات، واختر إجراء الاستيراد أو إجراء المهارة المحلي، وحدد المجلد المستخرج.
  2. إذا لم يُظهر الإصدار الخاص بك إجراء استيراد، فقم بإنشاء مهمة تطلب من WorkBuddy تثبيت المجلد المستخرج كمهارة مخصصة.

قم بمراجعة الملفات والأذونات التي يعرضها WorkBuddy قبل تمكين المهارة.

تكوين بيانات الاعتماد

قم بتعيين المفتاح في البيئة التي تبدأ WorkBuddy:

export FISH_AUDIO_BASE_URL="https://fishaudio.org/v1"
export FISH_AUDIO_API_KEY="YOUR_FISH_AUDIO_API_KEY"
export FISH_AUDIO_VOICE_ID="00a1b221-6137-4b73-ad62-b0cbce134167"
export FISH_AUDIO_MODEL="fishaudio-s21pro-flash"

في نظام التشغيل macOS، لا تتوفر متغيرات البيئة المعينة في الوحدة الطرفية تلقائيًا لتطبيق يتم تشغيله من Finder. اتبع تدفق تكوين البيئة أو السرية المحلية لإصدار WorkBuddy الخاص بك، أو ابدأ تشغيل التطبيق من بيئة تحتوي على هذه المتغيرات.

لا تقم مطلقًا بلصق مفتاح API في محادثة WorkBuddy أو حفظه في مجلد Skill.

اختبار المهارة

ابدأ مهمة WorkBuddy جديدة واسأل:

Use the Fish Audio TTS Skill to create an MP3 file that says:
"Hello, this is a Fish Audio test."
Save it as fish-audio-test.mp3.

تأكد من قيام WorkBuddy بالإبلاغ عن مسار الإخراج وتشغيل ملف MP3. ثم استبدل معرف الصوت الاختباري بـ Fish Audio Voice ID المفضل لديك.

استكشاف الأخطاء وإصلاحها

  • لم يتم اكتشاف المهارة: تأكد من أن المجلد المستخرج يحتوي على SKILL.md في جذره، ثم أعد استيراد WorkBuddy أو أعد تشغيله.
  • تم رفض Python أو إذن المحطة: قم بتمكين إذن التنفيذ المحلي الذي تتطلبه هذه المهارة فقط.
  • مفتاح API مفقود: كشف FISH_AUDIO_API_KEY لعملية WorkBuddy؛ لا تقم بإضافته إلى ملفات Skill.
  • 401/402: استبدل مفتاح API أو أضف أرصدة API.
  • لم يتم إنشاء MP3: افحص مخرجات المهمة لحالة HTTP ونص الاستجابة، وتأكد من أن دليل المخرجات قابل للكتابة.

حدود دعم بيتا

البرنامج النصي المضمن وطلب Fish Audio API قابلان للاختبار بشكل مستقل. لا يزال يتعين التحقق من شاشة استيراد المهارات الدقيقة وسلوك التحميل السري مقابل إصدار سطح المكتب WorkBuddy الذي تستخدمه. إذا فشل التثبيت، قم بتضمين إصدار WorkBuddy ونظام التشغيل ورسالة الخطأ المرئية عند الاتصال بالدعم.

الوثائق ذات الصلة