Fish Audio Docs
Guides d'intégrationIntégrations tierces
Back to site

Configuration de WorkBuddy (bêta)

Installez une version bêta de WorkBuddy Skill qui génère des fichiers vocaux MP3 via le Fish Audio API.

Connectez Fish Audio TTS à WorkBuddy

Tencent WorkBuddy peut appeler des API externes via des compétences personnalisées. Utilisez la compétence Fish Audio pour générer des fichiers MP3 à partir d'une tâche WorkBuddy.

Cette intégration est en version bêta car l'interface utilisateur d'importation et d'autorisation des compétences de WorkBuddy peut varier selon la version de bureau. Ne configurez pas Fish Audio sous Paramètres → Modèle : cet écran attend un point de terminaison de modèle de conversation tel que /chat/completions, et non le point de terminaison vocal Fish Audio.

Avant de commencer

Il vous faut :

  • Une clé Fish Audio API avec les crédits API
  • Python 3.9 ou version ultérieure disponible pour WorkBuddy
  • Autorisation pour la compétence d'exécuter un script local et d'accéder au réseau

Créez une clé API dédiée pour WorkBuddy afin qu'elle puisse être surveillée et révoquée indépendamment.

Téléchargez la compétence

Téléchargez le package de compétences Fish Audio TTS et extrayez-le. Le package contient SKILL.md, skill.yml, une implémentation Python et un README.

Les versions WorkBuddy utilisent actuellement l'un de ces flux d'installation :

  1. Ouvrez Compétences, choisissez l'action d'importation ou de compétence locale, puis sélectionnez le dossier extrait.
  2. Si votre version n'affiche pas d'action d'importation, créez une tâche demandant à WorkBuddy d'installer le dossier extrait en tant que compétence personnalisée.

Vérifiez les fichiers et les autorisations affichées par WorkBuddy avant d'activer la compétence.

Configurer les informations d'identification

Définissez la clé dans l'environnement qui démarre 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"

Sur macOS, les variables d'environnement définies dans un terminal ne sont pas automatiquement disponibles pour une application lancée depuis le Finder. Suivez le flux de configuration du secret local ou de l'environnement de votre version WorkBuddy, ou démarrez l'application à partir d'un environnement qui contient ces variables.

Ne collez jamais la clé API dans une conversation WorkBuddy et ne l'enregistrez jamais dans le dossier Skill.

Testez la compétence

Démarrez une nouvelle tâche WorkBuddy et demandez :

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.

Confirmez que WorkBuddy signale le chemin de sortie et que le MP3 est lu. Remplacez ensuite l'ID vocal de test par votre ID vocal Fish Audio préféré.

Dépannage

  • La compétence n'est pas découverte : vérifiez que le dossier extrait contient SKILL.md à sa racine, puis réimportez ou redémarrez WorkBuddy.
  • Python ou l'autorisation du terminal est refusée : activez uniquement l'autorisation d'exécution locale requise par cette compétence.
  • La clé API est manquante : exposez FISH_AUDIO_API_KEY au processus WorkBuddy ; ne l'ajoutez pas aux fichiers de compétences.
  • 401/402 : remplacez la clé API ou ajoutez des crédits API.
  • Aucun MP3 n'est créé : inspectez la sortie de la tâche pour le statut HTTP et le corps de la réponse, et confirmez que le répertoire de sortie est accessible en écriture.

Limite de support bêta

Le script inclus et la requête Fish Audio API peuvent être testés indépendamment. L'écran exact d'importation des compétences et le comportement de chargement des secrets doivent toujours être vérifiés par rapport à la version de bureau WorkBuddy que vous utilisez. Si l'installation échoue, incluez la version de WorkBuddy, le système d'exploitation et le message d'erreur visible lorsque vous contactez l'assistance.

Documentation associée