WorkBuddy-Setup (Beta)
Installieren Sie einen Beta-WorkBuddy-Skill, der MP3-Sprachdateien über Fish Audio API generiert.
Verbinden Sie Fish Audio TTS mit WorkBuddy
Tencent WorkBuddy kann externe APIs über benutzerdefinierte Fähigkeiten aufrufen. Verwenden Sie den Fish Audio-Skill, um MP3-Dateien aus einer WorkBuddy-Aufgabe zu generieren.
Diese Integration befindet sich in der Betaphase, da die Benutzeroberfläche für den Skill-Import und die Berechtigung von WorkBuddy je nach Desktop-Version variieren kann. Konfigurieren Sie Fish Audio nicht unter Einstellungen → Modell: Dieser Bildschirm erwartet einen Chat-Modell-Endpunkt wie
/chat/completions, nicht den Sprachendpunkt Fish Audio.
Bevor Sie beginnen
Sie benötigen:
- Ein Fish Audio API-Schlüssel mit API-Credits
- Python 3.9 oder höher für WorkBuddy verfügbar – Berechtigung für den Skill, ein lokales Skript auszuführen und auf das Netzwerk zuzugreifen
Erstellen Sie einen dedizierten API-Schlüssel für WorkBuddy, damit dieser unabhängig überwacht und widerrufen werden kann.
Laden Sie den Skill herunter
Laden Sie das Fish Audio TTS Skill-Paket herunter und extrahieren Sie es. Das Paket enthält SKILL.md, skill.yml, eine Python-Implementierung und eine README-Datei.
WorkBuddy-Versionen verwenden derzeit einen dieser Installationsabläufe:
- Öffnen Sie Skills, wählen Sie die Import- oder lokale Skill-Aktion und wählen Sie den extrahierten Ordner aus.
- Wenn Ihre Version keine Importaktion anzeigt, erstellen Sie eine Aufgabe, in der Sie WorkBuddy auffordern, den extrahierten Ordner als benutzerdefinierten Skill zu installieren.
Überprüfen Sie die Dateien und die von WorkBuddy angezeigten Berechtigungen, bevor Sie den Skill aktivieren.
Anmeldeinformationen konfigurieren
Legen Sie den Schlüssel in der Umgebung fest, die WorkBuddy startet:
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"Unter macOS sind in einem Terminal festgelegte Umgebungsvariablen nicht automatisch für eine über den Finder gestartete App verfügbar. Folgen Sie dem Konfigurationsablauf für lokale Geheimnisse oder Umgebungen Ihrer WorkBuddy-Version oder starten Sie die App aus einer Umgebung, die diese Variablen enthält.
Fügen Sie den Schlüssel API niemals in eine WorkBuddy-Konversation ein und speichern Sie ihn niemals im Skill-Ordner.
Testen Sie die Fähigkeit
Starten Sie eine neue WorkBuddy-Aufgabe und fragen Sie:
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.Bestätigen Sie, dass WorkBuddy den Ausgabepfad meldet und dass die MP3-Datei abgespielt wird. Ersetzen Sie dann die Test-Voice-ID durch Ihre bevorzugte Fish Audio Voice-ID.
Fehlerbehebung
- Skill wird nicht erkannt: Bestätigen Sie, dass der extrahierte Ordner im Stammverzeichnis
SKILL.mdenthält, und importieren Sie dann WorkBuddy erneut oder starten Sie es neu. - Python oder Terminalberechtigung wird verweigert: Aktivieren Sie nur die lokale Ausführungsberechtigung, die für diesen Skill erforderlich ist.
- API-Schlüssel fehlt:
FISH_AUDIO_API_KEYfür den WorkBuddy-Prozess verfügbar machen; Fügen Sie es nicht zu den Skill-Dateien hinzu. - 401/402: Ersetzen Sie den API-Schlüssel oder fügen Sie API-Credits hinzu.
- Es wird keine MP3 erstellt: Überprüfen Sie die Aufgabenausgabe auf den HTTP-Status und den Antworttext und bestätigen Sie, dass das Ausgabeverzeichnis beschreibbar ist.
Beta-Supportgrenze
Das enthaltene Skript und die Fish Audio API-Anfrage können unabhängig voneinander getestet werden. Der genaue Skill-Importbildschirm und das Verhalten beim Laden von Geheimnissen müssen noch anhand der von Ihnen verwendeten WorkBuddy-Desktopversion überprüft werden. Wenn die Installation fehlschlägt, geben Sie bei der Kontaktaufnahme mit dem Support die WorkBuddy-Version, das Betriebssystem und die sichtbare Fehlermeldung an.