Connaissances et MCP PrismVox
Le RAG permet au standard de répondre depuis des documents. MCP lui permet d’agir via des outils externes. Commencez par une petite collection et un outil sans effet important, puis validez en texte et sur un vrai appel. Le modèle doit gérer les appels d’outils structurés pour ces capacités.
1. Créer une collection documentaire
- Ouvrez Knowledge Base → + New collection. Entrez un nom et une description facultative puis Create. Regroupez les documents par sujet pour faciliter leur entretien.
- Ajoutez un fichier TXT, Markdown ou PDF contenant du texte. Un PDF numérisé sans texte extractible nécessite un OCR préalable.
- Vérifiez le nombre de passages et le calcul des embeddings. L’envoi découpe le document et tente l’indexation automatiquement. Les collections activées alimentent la recherche.
- Dans Configuration → Agent, activez knowledge search et sauvegardez. Testez une question couverte par le document et une sans réponse dans celui-ci.
Comment l’agent recherche
L’agent entrant autonome reçoit search_knowledge_base quand la recherche est activée. Il choisit quand l’appeler et répond depuis les passages retournés ; les documents ne sont pas insérés automatiquement à chaque échange. RAG_TOP_K limite le nombre de passages pertinents. Les missions sortantes ne disposent pas de cette recherche ; placez les faits nécessaires dans leur mission.
Maintenir et réindexer les documents
Renvoyer le même nom de fichier dans la même collection remplace ses passages existants. Vous pouvez examiner/supprimer des passages et activer ou désactiver les collections. Re-index embeddings retente leur calcul, par exemple après rétablissement du service. Si l’indexation échoue à l’envoi, le texte peut être conservé sans vecteurs ; fichier envoyé ne signifie pas indexation sémantique réussie.
PrismVox autonome utilise son service local d’embeddings et un schéma pgvector à 384 dimensions. Ne remplacez pas le modèle par une dimension incompatible. Gardez originaux et sauvegardes séparément ; supprimer une collection retire son contenu enregistré.
2. Connecter un serveur d’outils
- Ouvrez MCP → + Add an MCP server. Indiquez nom, Type (Streamable HTTP ou Legacy SSE) et URL accessible depuis les conteneurs PrismVox. Stdio n’est pas pris en charge.
- Si nécessaire, saisissez son jeton Bearer dans le formulaire sécurisé puis Add. Cette connexion ne propose pas le parcours d’autorisation OAuth navigateur de Prism.
- Cliquez Probe pour découvrir les outils. Ouvrez leur liste et activez ceux nécessaires au standard. Vérifiez descriptions et effets avant d’autoriser les écritures.
- Gardez le serveur activé. Dans Configuration → Agent, activez MCP tools puis sauvegardez. Testez une lecture dans Test the agent puis au téléphone.
Actualiser les outils et appliquer les changements
Après mise à jour d’un serveur, Probe actualise noms/descriptions et retire les anciennes entrées ; revérifiez les sélecteurs d’outils. Désactiver conserve les réglages mais retire les outils. Les changements concernent appels ou échanges texte suivants ; un appel actif conserve sa configuration MCP. Un appelant inconnu peut influencer les requêtes : exposez uniquement des opérations adaptées.
3. Vérifier les résultats réels
Test the agent utilise personnalité, annuaire et RAG/MCP autonomes avec le modèle standard, sans outils téléphoniques de transfert/message/raccrochage. Admin chat utilise le modèle on-call pour l’administration : c’est un autre test. Une réponse texte ne valide ni SIP, ni transcription, ni lecture audio. Vérifiez la trace et le résultat effectif du service externe.
Quand Prism est raccordé
Pour les appels entrants, la recherche utilise la collection vocale publique sélectionnée dans Prism pour les inconnus ; les appelants reconnus utilisent leur contexte Prism autorisé. Les collections Knowledge Base locales ne sont pas fusionnées dans cette collection publique. Les inconnus gardent le modèle PrismVox et peuvent utiliser ses MCP activés. Les reconnus utilisent les outils vocaux restreints de Prism, sans hériter des MCP web.
Voir le routage et la gestion des réglages →