VoiceBot et orchestration
Contrat et décision VoiceBot6 composants
Ingress VoiceBot API v1 et SDKCode
- Rôle / owner
- Contrat headless entre Navy Phone et VoiceBot. Owner API VoiceBot.
- Interfaces / confiance
/api/v1/voicebot/*HTTPS privé; port cible à figer.
- État / dépendances
- Tenant, session, révision, scopes et idempotence.
- HA / panne
- Panne produit laisse téléphonie/file/humain disponibles.
- Sécurité / preuve / source
- JWT Ed25519 court, clé 0600, scopes. Source: README VoiceBot, intégration produit.
Sessions et tours préparésCode
- Rôle / owner
- Machine d’état prepared-turn/ACK/commit. Owner VoiceBot.
- Interfaces / confiance
- API produit avec token opaque et révision optimiste.
- État / dépendances
- Session, tour, protocole, décision, token, expiration.
- HA / panne
- Conflit CAS, ACK ancien ou timeout = aucun commit.
- Sécurité / preuve / source
- Audit de transition et idempotence. Source: contrats VoiceBot,
voice-turn.ts.
VAD, gestion de tour et barge-inCode
- Rôle / owner
- Début/fin de parole et annulation propagée. Owner média Navy Phone.
- Interfaces / confiance
- Frames PCM, VAD, génération, AbortSignal, clear/FLUSH_MEDIA.
- État / dépendances
- Génération courante, buffers, mark et token invalide.
- HA / panne
- Purge et aucun commit; nouveau final réévalue l’intention.
- Sécurité / preuve / source
- Aucun audio brut dans métriques. Source:
lib/media-session.ts, bridge Twilio, tests média.
Orchestrateur conversationnelCode
- Rôle / owner
- Choisit protocole, faits, outils, dialogue et handoff. Owner VoiceBot.
- Interfaces / confiance
- STT final, session, RAG, LLM et garde via contrats internes.
- État / dépendances
- Contexte minimal, révision, outils allowlistés et provenance.
- HA / panne
- Repli déterministe et humain; aucune boucle outil non bornée.
- Sécurité / preuve / source
- Isolation tenant et audit atomique. Source: moteur/contrats du dépôt VoiceBot.
Garde déterministeCode / contrat
- Rôle / owner
- Décide autorisation, correction, question, refus ou handoff avant action et restitution.
- Interfaces / confiance
- Proposition LLM, protocole, faits, provenance et état courant.
- État / dépendances
- Version de policy, raison et décision; pas un filtre unique post-LLM.
- HA / panne
- Erreur ou fait manquant = fail-closed/handoff.
- Sécurité / preuve / source
- Décision auditée et déterministe aux zones critiques. Source: runtime map, gates produit.
Graph RAG, corpus et protocolesCode / contenu
- Rôle / owner
- Faits sourcés, navigation de protocole et réponses contrôlées. Owner contenu VoiceBot.
- Interfaces / confiance
- Retrieval interne; endpoint/vector store cible à figer.
- État / dépendances
- Documents, version, source, fraîcheur et embeddings.
- HA / panne
- Source absente = clarification/handoff, jamais fait inventé.
- Sécurité / preuve / source
- Isolation tenant, chiffrement et double revue. Source: README VoiceBot et corpus gouverné.