Documentation/Connecter PrismVox à Prism

Connecter PrismVox à Prism

La connexion a deux sens. PrismVox appelle Prism pour identifier les appelants et ouvrir leurs conversations vocales. Prism appelle PrismVox pour administrer la téléphonie et exécuter ses actions. Configurez les deux adresses et les deux types d’identifiants.

Avant de connecter

Partez d’installations autonomes fonctionnelles et sauvegardez-les. L’exemple suppose le même hôte Docker, le nom de projet prismvox, un jeton de service Prism et une console PrismVox protégée. Consoles et modèles peuvent conserver des défauts distincts.

1. Rattacher Prism au réseau vocal

Dans le dossier Prism, créez compose.vox.yml comme ci-dessous. Démarrez PrismVox au moins une fois pour créer son réseau externe. Rattachez seulement prism-server à ce second réseau ; gardez l’agent PrismVox sur son unique réseau agentnet pour un adressage RTP correct.

services:
  prism-server:
    networks:
      default:
      voice:
        aliases:
          - prism-server
networks:
  voice:
    external: true
    name: prismvox_agentnet

2. Configurer Prism → PrismVox

Dans Prism/.env, renseignez ces valeurs. VOX_USER et VOX_PASSWORD doivent correspondre à UI_USER et UI_PASSWORD de PrismVox. Le nom de service ui est résolu sur le réseau vocal partagé ; n’utilisez pas une URL localhost destinée au navigateur.

VOX_URL=http://ui:7860
VOX_USER=admin
VOX_PASSWORD=YOUR_PRISMVOX_UI_PASSWORD

docker compose -f docker-compose.yml -f compose.vox.yml up -d --no-deps prism-server

Si vous utilisez déjà des overrides Compose, ajoutez-les également et gardez cette liste complète pour les mises à jour. Avec un nom de projet différent, remplacez prismvox_agentnet par le véritable réseau du projet.

3. Configurer PrismVox → Prism

Dans PrismVox/.env, réglez la racine API interne, le même PRISM_TOKEN que Prism et l’adresse ouverte par les utilisateurs dans leur navigateur. Ce jeton est privilégié ; ne le remplacez pas par un mot de passe utilisateur.

PRISM_URL=http://prism-server:8080
PRISM_TOKEN=YOUR_PRISM_SERVICE_TOKEN
PRISM_PUBLIC_URL=http://localhost:48080

L’URL publique ci-dessus vise un navigateur local. Utilisez votre véritable URL HTTPS Prism à distance. Dans le dossier PrismVox, appliquez le nouvel environnement sans appel actif :

docker compose up -d --no-deps agent ui

4. Régler identités et modèle téléphonique

Dans Prism, réglez Phone et Incoming transfers dans le profil d’un utilisateur de test. Dans Admin → Telephony, vérifiez annuaire, personnalité du standard, connaissances vocales publiques et voix. Conversation model — recognised callers peut choisir un modèle rapide dédié parmi les sources IA sans changer le modèle web.

Les appelants reconnus disposent de leur profil et de leurs connaissances autorisées, avec des outils vocaux restreints. La reconnaissance ne donne pas accès au terminal, à Docker, aux fichiers, au mail ni au calendrier. Les inconnus restent sur le standard ; choisissez explicitement ses connaissances publiques et ses outils.

5. Tester les deux sens

Ouvrez Admin → Telephony et vérifiez chargement du statut SIP et des voix ; sinon examinez VOX_URL et les identifiants de console.
Appelez depuis le numéro du profil de test et vérifiez reconnaissance personnalisée et modèle téléphonique.
Appelez depuis un numéro inconnu et vérifiez qu’il reste dans le périmètre public du standard.
Effectuez un transfert et laissez un message de test ; vérifiez les résultats effectifs, pas seulement les promesses prononcées.

Déconnexion et hôtes séparés

Sur des hôtes séparés, remplacez les noms Docker par des adresses de confiance routables et protégez les échanges par HTTPS ou réseau privé. La recette locale ne crée pas de routage inter-hôtes. Pour revenir en autonome, videz PRISM_URL/PRISM_TOKEN et recréez agent/ui, puis videz VOX_* dans Prism et recréez prism-server. Vérifiez connaissances et annuaire autonomes avant de reprendre les appels.

Ce qui change après raccordement

Le raccordement change qui répond et quelle source fait autorité. Il ne fusionne ni bases, ni annuaires, ni catalogues de modèles, ni outils web. Le routage suivant concerne les appels téléphoniques.

Appelant	Modèle de conversation	Connaissances et actions
AppelantEntrant autonome	Modèle de conversationModèle standard PrismVox	Connaissances et actionsCollections locales et MCP activés, plus actions téléphoniques.
AppelantRaccordé, appelant inconnu	Modèle de conversationModèle standard et personnalité de standard PrismVox	Connaissances et actionsCollection vocale publique sélectionnée dans Prism ; MCP PrismVox activés et actions téléphoniques.
AppelantRaccordé, appelant reconnu	Modèle de conversationModèle vocal Prism des appelants reconnus	Connaissances et actionsProfil, mémoire et connaissances autorisées ; outils vocaux restreints, sans héritage des MCP/outils personnalisés web.
AppelantMission sortante	Modèle de conversationModèle on-call PrismVox	Connaissances et actionsLa mission et les actions MCP/téléphoniques permises ; pas de recherche documentaire entrante.

Où gérer chaque réglage

Prism Admin → Telephony gère la stack téléphonique via son API protégée. La console autonome redirige vers Prism ; ce n’est pas une seconde console indépendante.
Annuaire de transferts entrants : profils Prism. Les contacts PrismVox locaux restent destinés aux missions sortantes ; pas de synchronisation bidirectionnelle automatique.
Connaissances des inconnus : choisissez une collection dans Telephony. Sélectionnez du contenu pouvant être lu à des appelants externes. Les collections locales PrismVox n’y sont pas ajoutées.
Modèle des reconnus : Conversation model — recognised callers utilise une source Prism configurée. Le modifier ne change ni le défaut web, ni les modèles des inconnus et missions sortantes.
Voix, SIP et micro-tâches de contrôle restent dans PrismVox. La connexion de modèle autonome demeure nécessaire pour ces tâches et les inconnus.

Identité téléphonique et actions restreintes

Prism reconnaît l’appelant en rapprochant le numéro présenté d’un profil. Cela fournit un contexte personnel, pas les outils web complets. Les actions vocales comprennent recherche documentaire, transfert, message et raccrochage ; les reconnus peuvent aussi mémoriser des faits personnels. Shell, Docker, fichiers, mail, calendrier et MCP/outils arbitraires ne sont pas accordés par cette reconnaissance. Utilisez une connexion opérateur de confiance pour les identités présentées.

Demander à Prism de passer un appel

L’agent web dispose de place_call, list_calls et cancel_call quand PrismVox est disponible. Donnez une mission complète et un destinataire de test autorisé. Consultez le résumé : done signifie terminé, pas objectif atteint. Seul un appel en attente peut être annulé. Ces outils sont réservés aux administrateurs par défaut en mode partagé.

Appelle le contact accueil de test et demande si une livraison est possible demain matin. Ne confirme pas de commande. Rapporte la réponse et le résultat.

La ligne SIP reste dans PrismVox

Prism fournit contexte et orchestration ; Asterisk dans PrismVox enregistre la ligne Centrex unique, transporte l’audio et effectue les transferts. Le raccordement ne transforme pas Prism en serveur SIP et n’exige pas de publier les consoles administratives sur Internet.

Continuer : Exploiter et dépanner PrismVox →