技能 voice-agent-expert
🎤

voice-agent-expert

低风险 ⚡ 包含脚本📁 文件系统访问🔑 环境变量⚙️ 外部命令🌐 网络访问

Résoudre instantanément les problèmes d'agent vocal

Les conversations vocales avec les agents IA échouent souvent en raison de processus en double et d'incompatibilités de modes. Cette compétence fournit des diagnostics instantanés et des corrections automatiques pour les systèmes d'agent vocal Letta.

支持: Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“voice-agent-expert”。 Pourquoi mon agent vocal expire-t-il ?

预期结果:

  • Le serveur Letta fonctionne sur le port 8283
  • Le serveur Livekit fonctionne sur le port 7880
  • L'agent vocal ne fonctionne pas
  • Trouvé 2 processus d'agent vocal en double
  • Solution : Exécuter le script de redémarrage pour éliminer les duplicatas et démarrer proprement

正在使用“voice-agent-expert”。 Générer un jeton pour les tests

预期结果:

  • URL LiveKit : ws://localhost:7880
  • Salle : test-room
  • Jeton : [Jeton JWT affiché]
  • Prochaines étapes : Ouvrir https://agents-playground.livekit.io/ et se connecter

安全审计

低风险
v5 • 1/17/2026

Legitimate voice agent diagnostic and management skill. All static findings represent standard service administration patterns for local development. Scripts only access localhost services, read user-configured environment files, and generate tokens for the user's own session. No external data transmission or credential exfiltration detected.

7
已扫描文件
1,003
分析行数
6
发现项
5
审计总数
低风险问题 (1)
scripts/diagnose_voice_system.py:49scripts/diagnose_voice_system.py:68-69scripts/generate_token.py:9scripts/start_voice_system.py:61
Hardcoded absolute paths limit portability
Scripts contain hardcoded absolute paths specific to the author's system (/home/adamsl/planner, /home/adamsl/ottomator-agents). Users must modify paths for their environment.

风险因素

⚡ 包含脚本 (3)
scripts/diagnose_voice_system.py:1-125 scripts/generate_token.py:1-67 scripts/start_voice_system.py:1-102
📁 文件系统访问 (2)
scripts/diagnose_voice_system.py:68-69 scripts/start_voice_system.py:61-78
🔑 环境变量 (2)
scripts/generate_token.py:27-34 scripts/start_voice_system.py:60-78
⚙️ 外部命令 (2)
scripts/diagnose_voice_system.py:9-12 scripts/start_voice_system.py:14-18
🌐 网络访问 (1)
scripts/start_voice_system.py:85
审计者: claude 查看审计历史 →

质量评分

59
架构
100
可维护性
85
内容
20
社区
88
安全
91
规范符合性

你能构建什么

Déboguer les expirations de l'agent vocal

Identifier rapidement pourquoi votre agent vocal Letta ne répond pas ou expire pendant les conversations.

Automatiser le démarrage des services vocaux

Démarrer les services vocaux dans le bon ordre avec vérification des dépendances et prévention des duplicatas.

Résoudre les problèmes de coupure audio

Résoudre les problèmes audio intermittents causés par des processus d'agent vocal en double.

试试这些提示

Diagnostics de base 
Exécuter un diagnostic complet sur mon système d'agent vocal Letta et me dire ce qui ne va pas
Générer un jeton 
Générer un nouveau jeton LiveKit pour me connecter à mon agent vocal
Démarrer les services 
Démarrer mon système d'agent vocal avec tous les services requis dans le bon ordre
Redémarrage d'urgence 
Effectuer un redémarrage complet de mon système d'agent vocal, en tuant tous les processus bloqués

最佳实践

  • Toujours utiliser le mode dev pour les tests locaux, jamais le mode start
  • Vérifier les processus en double avant le dépannage
  • Utiliser d'abord le script de diagnostic pour identifier la cause profonde

避免

  • Démarrer l'agent vocal directement sans vérification des dépendances
  • Utiliser le mode start pour le développement local au lieu du mode dev
  • Ignorer les avertissements de processus en double dans les journaux système

常见问题

Est-ce compatible avec toutes les versions de Letta ?
Conçu pour Letta avec intégration LiveKit. Nécessite une configuration spécifique de l'agent vocal avec support WebRTC.
Quelles sont les exigences système ?
Nécessite le serveur Letta sur le port 8283, le serveur LiveKit sur le port 7880, et un agent vocal Python avec les variables d'environnement appropriées.
Puis-je intégrer ceci avec ma configuration vocale existante ?
Les scripts utilisent des chemins codés en dur qui doivent être ajustés. Modifiez les emplacements des fichiers d'environnement pour votre système.
Mes données de clé API sont-elles sécurisées ?
Les scripts lisent uniquement les fichiers d'environnement existants. Aucune donnée n'est transmise ou stockée en externe.
L'audio coupe toujours après l'utilisation des scripts
Vérifiez les connexions WebSocket du navigateur et les permissions du microphone. Assurez-vous qu'un seul processus d'agent vocal est en cours d'exécution.
Comment cela se compare-t-il au dépannage manuel ?
Automatise les corrections courantes comme la détection des duplicatas et l'ordre de démarrage des services, faisant gagner des heures de débogage manuel.

开发者详情

作者

EGAdams

许可证

MIT

仓库

https://github.com/EGAdams/planner/tree/main/.claude/skills/voice-agent-expert

引用

main

文件结构

📁 scripts/

📄 diagnose_voice_system.py

📄 generate_token.py

📄 start_voice_system.py

📄 QUICK_REFERENCE.md

📄 README.md

📄 SKILL.md