WorkBuddy セットアップ (ベータ版)
Fish Audio API を通じて MP3 音声ファイルを生成するベータ版 WorkBuddy スキルをインストールします。
Fish Audio TTS を WorkBuddy に接続します
Tencent WorkBuddy は、カスタム スキルを通じて外部 API を呼び出すことができます。 Fish Audio スキルを使用して、WorkBuddy タスクから MP3 ファイルを生成します。
WorkBuddy のスキルのインポートと権限の UI はデスクトップのバージョンによって異なる可能性があるため、この統合はベータ版です。 [設定] → [モデル] で Fish Audio を構成しないでください。この画面では、Fish Audio 音声エンドポイントではなく、
/chat/completionsなどのチャット モデル エンドポイントが必要です。
始める前に
必要なものは次のとおりです。
- Fish Audio API キー (API クレジット付き)
- WorkBuddy で Python 3.9 以降が利用可能
- スキルがローカルスクリプトを実行してネットワークにアクセスする権限
WorkBuddy 専用の API キーを作成して、独立して監視および取り消しできるようにします。
スキルをダウンロードする
Fish Audio TTS スキルパッケージをダウンロードして解凍します。パッケージには、SKILL.md、skill.yml、Python 実装、および README が含まれています。
WorkBuddy のバージョンでは現在、次のインストール フローのいずれかを使用しています。
- スキル を開き、インポートまたはローカル スキル アクションを選択し、抽出されたフォルダーを選択します。
- お使いのバージョンにインポート アクションが表示されない場合は、抽出したフォルダーをカスタム スキルとしてインストールするように 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 会話に貼り付けたり、スキル フォルダーに保存したりしないでください。
スキルをテストする
新しい 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 が再生されることを確認します。次に、テスト音声 ID を希望の Fish Audio 音声 ID に置き換えます。
トラブルシューティング
- スキルが検出されません: 抽出されたフォルダーのルートに
SKILL.mdが含まれていることを確認し、再インポートまたは WorkBuddy を再起動します。 - Python または端末権限が拒否されました: このスキルに必要なローカル実行権限のみを有効にします。
- API キーがありません:
FISH_AUDIO_API_KEYを WorkBuddy プロセスに公開します。スキルファイルには追加しないでください。 - 401/402: API キーを置き換えるか、API クレジットを追加します。
- MP3 は作成されません: タスク出力の HTTP ステータスと応答本文を検査し、出力ディレクトリが書き込み可能であることを確認します。
ベータサポートの境界
付属のスクリプトと Fish Audio API リクエストは個別にテストできます。正確なスキルのインポート画面とシークレットの読み込み動作は、使用している WorkBuddy デスクトップ バージョンに対して引き続き検証する必要があります。インストールが失敗した場合は、サポートに連絡するときに WorkBuddy のバージョン、オペレーティング システム、および表示されるエラー メッセージを含めてください。