Instale una habilidad Beta de WorkBuddy que genera archivos de voz MP3 a través de Fish Audio API.

Conecte Fish Audio TTS a WorkBuddy

Tencent WorkBuddy puede llamar a API externas a través de habilidades personalizadas. Utilice la habilidad Fish Audio para generar archivos MP3 a partir de una tarea de WorkBuddy.

Esta integración está en Beta porque la interfaz de usuario de permisos e importación de habilidades de WorkBuddy puede variar según la versión de escritorio. No configure Fish Audio en Configuración → Modelo: esa pantalla espera un punto final de modelo de chat como /chat/completions, no el punto final de voz Fish Audio.

Antes de empezar

Necesitas:

Una clave Fish Audio API con créditos API
Python 3.9 o posterior disponible para WorkBuddy
Permiso para que Skill ejecute un script local y acceda a la red

Cree una clave API dedicada para WorkBuddy para que pueda monitorearse y revocarse de forma independiente.

Descargar la habilidad

Descargue el paquete de habilidades Fish Audio TTS y extráigalo. El paquete contiene SKILL.md, skill.yml, una implementación de Python y un archivo README.

Las versiones de WorkBuddy actualmente utilizan uno de estos flujos de instalación:

Abra Habilidades, elija la acción de importación o de habilidad local y seleccione la carpeta extraída.
Si su versión no muestra una acción de importación, cree una tarea pidiéndole a WorkBuddy que instale la carpeta extraída como una habilidad personalizada.

Revise los archivos y los permisos mostrados por WorkBuddy antes de habilitar la Skill.

Configurar credenciales

Establezca la clave en el entorno que inicia 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"

En macOS, las variables de entorno configuradas en una terminal no están disponibles automáticamente para una aplicación iniciada desde Finder. Siga el flujo de configuración del entorno o secreto local de su versión de WorkBuddy, o inicie la aplicación desde un entorno que contenga estas variables.

Nunca pegue la clave API en una conversación de WorkBuddy ni la guarde en la carpeta Skill.

Prueba la habilidad

Inicie una nueva tarea de WorkBuddy y pregunte:

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.

Confirme que WorkBuddy informe la ruta de salida y que se reproduzca el MP3. Luego reemplace la ID de voz de prueba con su [ID de voz Fish Audio] preferida (/es/docs/api-reference/voices/list).

Solución de problemas

La habilidad no se descubre: confirme que la carpeta extraída contenga SKILL.md en su raíz, luego vuelva a importar o reinicie WorkBuddy.
Python o permiso de terminal denegado: habilite solo el permiso de ejecución local requerido por esta Skill.
Falta la clave API: exponer FISH_AUDIO_API_KEY al proceso WorkBuddy; no lo agregue a los archivos de habilidades.
401/402: reemplaza la clave API o agrega créditos API.
No se crea ningún MP3: inspeccione la salida de la tarea para el estado HTTP y el cuerpo de la respuesta, y confirme que se pueda escribir en el directorio de salida.

Límite de soporte Beta

El script incluido y la solicitud Fish Audio API se pueden probar de forma independiente. La pantalla exacta de importación de habilidades y el comportamiento de carga de secretos aún deben verificarse con la versión de escritorio de WorkBuddy que utiliza. Si la instalación falla, incluya la versión de WorkBuddy, el sistema operativo y el mensaje de error visible cuando se comunique con el soporte.

Configuración de WorkBuddy (Beta)