Instale uma habilidade beta do WorkBuddy que gera arquivos de fala MP3 por meio do Fish Audio API.

Conecte Fish Audio TTS ao WorkBuddy

O Tencent WorkBuddy pode chamar APIs externas por meio de habilidades personalizadas. Use a habilidade Fish Audio para gerar arquivos MP3 a partir de uma tarefa WorkBuddy.

Esta integração está em versão beta porque a interface de importação e permissão de habilidades do WorkBuddy pode variar de acordo com a versão do desktop. Não configure Fish Audio em Configurações → Modelo: essa tela espera um terminal de modelo de bate-papo como /chat/completions, não o terminal de fala Fish Audio.

Antes de começar

Você precisa de:

Uma chave Fish Audio API com créditos API
Python 3.9 ou posterior disponível para WorkBuddy
Permissão para a Skill executar um script local e acessar a rede

Crie uma chave API dedicada para WorkBuddy para que possa ser monitorada e revogada de forma independente.

Baixe a habilidade

Baixe o pacote de habilidades Fish Audio TTS e extraia-o. O pacote contém SKILL.md, skill.yml, uma implementação Python e um README.

As versões do WorkBuddy atualmente usam um destes fluxos de instalação:

Abra Habilidades, escolha a ação de importação ou habilidade local e selecione a pasta extraída.
Se a sua versão não mostrar uma ação de importação, crie uma tarefa solicitando ao WorkBuddy que instale a pasta extraída como uma habilidade personalizada.

Revise os arquivos e as permissões mostradas pelo WorkBuddy antes de habilitar a habilidade.

Configurar credenciais

Defina a chave no ambiente que inicia o 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"

No macOS, as variáveis de ambiente definidas em um terminal não estão automaticamente disponíveis para um aplicativo iniciado no Finder. Siga o fluxo de configuração de ambiente ou segredo local da sua versão do WorkBuddy ou inicie o aplicativo a partir de um ambiente que contenha essas variáveis.

Nunca cole a chave API em uma conversa do WorkBuddy ou salve-a na pasta Skill.

Teste a habilidade

Inicie uma nova tarefa do WorkBuddy e pergunte:

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 se o WorkBuddy informa o caminho de saída e se o MP3 é reproduzido. Em seguida, substitua o ID de voz de teste pelo seu [ID de voz Fish Audio] preferido (/pt/docs/api-reference/voices/list).

Solução de problemas

A habilidade não foi descoberta: confirme se a pasta extraída contém SKILL.md em sua raiz e importe novamente ou reinicie o WorkBuddy.
Python ou permissão de terminal negada: habilite apenas a permissão de execução local exigida por esta Skill.
Falta a chave API: exponha FISH_AUDIO_API_KEY ao processo WorkBuddy; não o adicione aos arquivos de habilidades.
401/402: substitua a chave API ou adicione créditos API.
Nenhum MP3 é criado: inspecione a saída da tarefa para o status HTTP e o corpo da resposta e confirme se o diretório de saída é gravável.

Limite de suporte beta

O script incluído e a solicitação Fish Audio API podem ser testados de forma independente. A tela exata de importação de habilidades e o comportamento de carregamento secreto ainda devem ser verificados em relação à versão de desktop do WorkBuddy que você usa. Se a instalação falhar, inclua a versão do WorkBuddy, o sistema operacional e a mensagem de erro visível ao entrar em contato com o suporte.

Configuração do WorkBuddy (beta)