Compétences voice-agent-expert
🎤

voice-agent-expert

Risque faible ⚡ Contient des scripts📁 Accès au système de fichiers🔑 Variables d’environnement⚙️ Commandes externes🌐 Accès réseau

إصلاح مشاكل وكلاء الصوت فوراً

المحادثات الصوتية مع وكلاء الذكاء الاصطناعي غالباً تفشل بسبب العمليات المكررة وعدم تطابق الأنماط. توفر هذه المهارة تشخيصاً فورياً وإصلاحات آلية لأنظمة صوت Letta.

Prend en charge: Code(CC)
🥉 74 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "voice-agent-expert". لماذا ينتهي وقت وكيل الصوت؟

Résultat attendu:

  • خادم Letta يعمل على المنفذ 8283
  • خادم Livekit يعمل على المنفذ 7880
  • وكيل الصوت لا يعمل
  • تم العثور على 2 من عمليات وكيل الصوت المكررة
  • الإصلاح: تشغيل برنامج إعادة التشغيل لقتل التكرارات والبدء من جديد

Utilisation de "voice-agent-expert". توليد رمز للاختبار

Résultat attendu:

  • عنوان LiveKit: ws://localhost:7880
  • غرفة: test-room
  • رمز: [رمز JWT معروض]
  • الخطوات التالية: فتح https://agents-playground.livekit.io/ والاتصال

Audit de sécurité

Risque faible
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
Fichiers analysés
1,003
Lignes analysées
6
résultats
5
Total des audits
Problèmes à risque faible (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.

Facteurs de risque

⚡ Contient des scripts (3)
scripts/diagnose_voice_system.py:1-125 scripts/generate_token.py:1-67 scripts/start_voice_system.py:1-102
📁 Accès au système de fichiers (2)
scripts/diagnose_voice_system.py:68-69 scripts/start_voice_system.py:61-78
🔑 Variables d’environnement (2)
scripts/generate_token.py:27-34 scripts/start_voice_system.py:60-78
⚙️ Commandes externes (2)
scripts/diagnose_voice_system.py:9-12 scripts/start_voice_system.py:14-18
🌐 Accès réseau (1)
scripts/start_voice_system.py:85
Audité par: claude Voir l’historique des audits →

Score de qualité

59
Architecture
100
Maintenabilité
85
Contenu
31
Communauté
88
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

تصحيح أخطاء انتهاء مهلة وكيل الصوت

تحديد سريع لسبب عدم استجابة وكيل صوت Letta أو انتهاء المهلة أثناء المحادثات.

أتمتة تشغيل خدمات الصوت

تشغيل خدمات الصوت بالترتيب الصحيح مع التحقق من التبعيات ومنع التكرار.

إصلاح مشاكل انقطاع الصوت

حل مشاكل الصوت المتقطعة الناجمة عن عمليات وكيل الصوت المكررة.

Essayez ces prompts

التشخيص الأساسي 
قم بتشغيل تشخيص كامل على نظام وكيل صوت Letta الخاص بي وأخبرني بما هو الخطأ
توليد رمز 
توليد رمز LiveKit جديد للاتصال بوكيل الصوت الخاص بي
تشغيل الخدمات 
تشغيل نظام وكيل الصوت الخاص بي مع جميع الخدمات المطلوبة بالترتيب الصحيح
إعادة التشغيل الطارئة 
إعادة تشغيل كاملة لنظام وكيل الصوت الخاص بي، وقتل أي عمليات عالقة

Bonnes pratiques

  • استخدم دائماً وضع التطوير للاختبار المحلي، ولا تبدأ الوضع أبداً
  • تحقق من العمليات المكررة قبل استكشاف الأخطاء
  • استخدم البرنامج النصي للتشخيص أولاً لتحديد السبب الجذري

Éviter

  • بدء وكيل الصوت مباشرة بدون التحقق من التبعيات
  • استخدام وضع البدء للتطوير المحلي بدلاً من وضع التطوير
  • تجاهل تحذيرات العمليات المكررة في سجلات النظام

Foire aux questions

هل هذا متوافق مع جميع إصدارات Letta؟
مصمم لـ Letta مع تكامل LiveKit. يتطلب إعداداً محدداً لوكيل الصوت مع دعم WebRTC.
ما هي متطلبات النظام؟
يتطلب خادم Letta على المنفذ 8283، وخادم LiveKit على المنفذ 7880، ووكيل صوت Python مع متغيرات البيئة الصحيحة.
هل يمكنني دمج هذا مع إعداد الصوت الحالي؟
تستخدم البرامج النصية مسارات مضمنة تحتاج لتعديل. قم بتعديل مواقع ملفات البيئة لنظامك.
هل بيانات مفتاح API الخاصة بي آمنة؟
تقرأ البرامج النصية فقط ملفات البيئة الموجودة. لا يتم إرسال أو تخزين البيانات خارجياً.
الصوت ينقطع بعد استخدام البرامج النصية
تحقق من اتصالات WebSocket في المتصفح وأذونات الميكروفون. تأكد من تشغيل عملية وكيل صوت واحدة فقط.
كيف يقارن هذا بالتصحيح اليدوي؟
تأتمت الإصلاحات الشائعة مثل اكتشاف التكرار وترتيب تشغيل الخدمات، مما يوفر ساعات من التصحيح اليدوي.

Détails du développeur

Auteur

EGAdams

Licence

MIT

Dépôt

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

Réf

main

Structure de fichiers

📁 scripts/

📄 diagnose_voice_system.py

📄 generate_token.py

📄 start_voice_system.py

📄 QUICK_REFERENCE.md

📄 README.md

📄 SKILL.md