Fish Audio Docs
Руководства по интеграцииСторонние интеграции
Back to site

Настройка WorkBuddy (бета-версия)

Установите бета-версию WorkBuddy Skill, которая генерирует речевые файлы MP3 с помощью Fish Audio API.

Подключите Fish Audio TTS к WorkBuddy

Tencent WorkBuddy может вызывать внешние API с помощью пользовательских навыков. Используйте навык Fish Audio для создания файлов MP3 из задачи WorkBuddy.

Эта интеграция находится в стадии бета-тестирования, поскольку пользовательский интерфейс импорта и разрешений WorkBuddy Skill может различаться в зависимости от версии настольного компьютера. Не настраивайте Fish Audio в разделе Настройки → Модель: на этом экране ожидается конечная точка модели чата, такая как /chat/completions, а не конечная точка речи Fish Audio.

Прежде чем начать

Вам нужно:

  • Ключ Fish Audio API с кредитами API.
  • Python 3.9 или более поздняя версия доступна для WorkBuddy.
  • Разрешение Скиллу на запуск локального скрипта и доступ к сети

Создайте специальный ключ API для WorkBuddy, чтобы его можно было отслеживать и отзывать независимо.

Загрузите навык

Загрузите Пакет навыков Fish Audio TTS и распакуйте его. Пакет содержит SKILL.md, skill.yml, реализацию Python и README.

В версиях WorkBuddy в настоящее время используется один из следующих процессов установки:

  1. Откройте Навыки, выберите действие импорта или локального навыка и выберите извлеченную папку.
  2. Если в вашей версии не отображается действие импорта, создайте задачу, попросив 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 и не сохраняйте его в папке Skill.

Проверьте навык

Запустите новую задачу 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 воспроизводится. Затем замените тестовый голосовой идентификатор на предпочитаемый вами Fish Audio Voice ID.

Поиск неисправностей

  • Навык не обнаружен: убедитесь, что извлеченная папка содержит SKILL.md в корне, затем повторно импортируйте или перезапустите WorkBuddy.
  • Python или разрешение терминала отклонено: включите только разрешение локального выполнения, необходимое для этого навыка.
  • Ключ API отсутствует: предоставьте FISH_AUDIO_API_KEY процессу WorkBuddy; не добавляйте его в файлы навыков.
  • 401/402: замените ключ API или добавьте кредиты API.
  • MP3 не создан: проверьте выходные данные задачи на наличие статуса HTTP и тела ответа и убедитесь, что выходной каталог доступен для записи.

Граница поддержки бета-версии

Включенный сценарий и запрос Fish Audio API можно протестировать независимо. Точный экран импорта навыков и поведение секретной загрузки по-прежнему необходимо сверять с используемой вами настольной версией WorkBuddy. Если установка не удалась, при обращении в службу поддержки укажите версию WorkBuddy, операционную систему и видимое сообщение об ошибке.

Сопутствующая документация