Настройка WorkBuddy (бета-версия)
Установите бета-версию WorkBuddy Skill, которая генерирует речевые файлы MP3 с помощью Kitta Audio API.
Подключите Kitta Audio TTS к WorkBuddy
Пакет сохраняет имя
fish-audio-tts, название Kitta Audio и совместимые переменныеFISH_AUDIO_*; сайт документации не переименовывает его. Явное значениеFISH_AUDIO_BASE_URLниже выбирает сервис; используйте ключ соответствующего аккаунта Kitta Audio.
Tencent WorkBuddy может вызывать внешние API с помощью пользовательских навыков. Используйте навык Kitta Audio для создания файлов MP3 из задачи WorkBuddy.
Эта интеграция находится в стадии бета-тестирования, поскольку пользовательский интерфейс импорта и разрешений WorkBuddy Skill может различаться в зависимости от версии настольного компьютера. Не настраивайте Kitta Audio в разделе Настройки → Модель: на этом экране ожидается конечная точка модели чата, такая как
/chat/completions, а не конечная точка речи Kitta Audio.
Прежде чем начать
Вам нужно:
- Ключ Kitta Audio API с кредитами API.
- Python 3.9 или более поздняя версия доступна для WorkBuddy.
- Разрешение Скиллу на запуск локального скрипта и доступ к сети
Создайте специальный ключ API для WorkBuddy, чтобы его можно было отслеживать и отзывать независимо.
Загрузите навык
Загрузите Пакет навыков Kitta 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 и не сохраняйте его в папке Skill.
Проверьте навык
Запустите новую задачу WorkBuddy и спросите:
Use the fish-audio-tts Skill to create an MP3 file that says:
"Hello, this is a Kitta Audio test."
Save it as fish-audio-test.mp3.Убедитесь, что WorkBuddy сообщает путь вывода и что MP3 воспроизводится. Затем замените тестовый голосовой идентификатор на предпочитаемый вами Kitta Audio Voice ID.
Поиск неисправностей
- Навык не обнаружен: убедитесь, что извлеченная папка содержит
SKILL.mdв корне, затем повторно импортируйте или перезапустите WorkBuddy. - Python или разрешение терминала отклонено: включите только разрешение локального выполнения, необходимое для этого навыка.
- Ключ API отсутствует: предоставьте
FISH_AUDIO_API_KEYпроцессу WorkBuddy; не добавляйте его в файлы навыков. - 401/402: замените ключ API или добавьте кредиты API.
- MP3 не создан: проверьте выходные данные задачи на наличие статуса HTTP и тела ответа и убедитесь, что выходной каталог доступен для записи.
Граница поддержки бета-версии
Включенный сценарий и запрос Kitta Audio API можно протестировать независимо. Точный экран импорта навыков и поведение секретной загрузки по-прежнему необходимо сверять с используемой вами настольной версией WorkBuddy. Если установка не удалась, при обращении в службу поддержки укажите версию WorkBuddy, операционную систему и видимое сообщение об ошибке.