VIVAitwiki - Contribuciones del usuario [es]

Manual de operación de vFlow

2026-05-21T09:38:21Z

Alfredo.rodriguez: /* Integración de vFlow desde Omnisuite */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Pruebas desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:38:09Z

Alfredo.rodriguez: /* Integración de vFlow desde Omnisuite */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Pruebas desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:37:33Z

Alfredo.rodriguez: /* Pruebas desde vFlow */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Pruebas desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:36:45Z

Alfredo.rodriguez: /* Descripción general */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Pruebas desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:36:06Z

Alfredo.rodriguez: /* Para probar desde vFlow */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Pruebas desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:35:18Z

Alfredo.rodriguez: /* Diagnósticos */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:34:22Z

Alfredo.rodriguez: /* Diagnósticos */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
Fichero de log, en nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:33:49Z

Alfredo.rodriguez: /* Diagnósticos */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
:: Fichero de log
:::En nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
::Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
::En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
::en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 
::en nodo Omnisuite, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:32:53Z

Alfredo.rodriguez: /* Diagnósticos */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
:: Fichero de log
:::En nodo vFlowProxy, para cualquier canal
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>
 
::Monitorizar estado del proceso vflowProxy, en nodo vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>
Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
::En nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
 
::en nodo Omnisuite, para canal voz
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:28:16Z

Alfredo.rodriguez: /* Diagnósticos */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<agi-combined.yyyy-mm-dd.log>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/<routing-combined.yyyy-mm-dd.log>
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:25:07Z

Alfredo.rodriguez: /* Restauración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
'''Las ubicaciones de los archivos a resturar pueden ser diferentes'''

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:24:39Z

Alfredo.rodriguez: /* Restauración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario
* Importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
 
* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
 
(Las ubicaciones de los archivos a resturar pueden ser diferentes)

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:24:14Z

Alfredo.rodriguez: /* Restauración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario

* importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
 
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
 
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>

* Volver a poner las carpetas de /opt/vFlow_flowise/
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
 
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>

(Las ubicaciones de los archivos a resturar pueden ser diferentes)

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:23:30Z

Alfredo.rodriguez: /* Restauración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===
Para restaurar, será necesario

* importar de nuevo las dos bases de datos de flowise y la base de datos de vFlow:

mysql -u root -p vflow_flowise_config < vflow_flowise_config_ULTIMAFECHA.sql
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql

* Volver a poner las carpetas de /opt/vFlow_flowise/
mv -vi /opt/vFlow_flowise/.flowise_ULTIMAFECHA /opt/vFlow_flowise/.flowise
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos

(Las ubicaciones de los archivos a resturar pueden ser diferentes)

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:20:46Z

Alfredo.rodriguez: /* Respaldo */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
'''Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo'''

=== Restauración ===

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:20:28Z

Alfredo.rodriguez: /* Respaldo */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
 
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo

=== Restauración ===

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:19:47Z

Alfredo.rodriguez: /* Respaldo */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo

=== Restauración ===

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:19:11Z

Alfredo.rodriguez: /* Respaldo */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql

mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql

mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo

=== Restauración ===

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:18:30Z

Alfredo.rodriguez: /* Procedimientos de respaldo y restauración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
 
* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
</div>
** El directorio /opt/vFlow_flowise/archivos
<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)
</div>
 
Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo

=== Restauración ===

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T09:16:52Z

Alfredo.rodriguez: /* Procedimientos de respaldo y restauración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==

=== Respaldo ===

* Hacer backup de las bases de datosdel orquestador (flowise) y de vFlow

mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_config_$(date +%F_%H%M%S).sql
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vflow_flowise_config > vflow_flowise_upsert_$(date +%F_%H%M%S).sql
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql

* Copiar:
** El directorio /opt/vFlow_flowise/.flowise
cp -vai /opt/vFlow_flowise/.flowise /opt/vFlow_flowise/.flowise_$(date +%F_%H%M%S)
** El directorio /opt/vFlow_flowise/archivos
cp -vai /opt/vFlow_flowise/archivos /opt/vFlow_flowise/archivos_$(date +%F_%H%M%S)

Todos los ficheros creados pueden ser movidos al destino deseado para almacenar la copia de respaldo

=== Restauración ===

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Omnisuite STT y TTS

2026-05-21T09:06:55Z

Alfredo.rodriguez: /* Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
 
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|400px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Inovación a TTS]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110413.png|500px|miniaturadeimagen|no|Reproducción de audio generado]]
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Omnisuite STT y TTS

2026-05-21T09:06:09Z

Alfredo.rodriguez: /* Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
 
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|350px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Inovación a TTS]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110413.png|500px|miniaturadeimagen|no|Reproducción de audio generado]]
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Omnisuite STT y TTS

2026-05-21T09:05:40Z

Alfredo.rodriguez: /* Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
 
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Inovación a TTS"]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110413.png|500px|miniaturadeimagen|no|Reproducción de audio generado]]
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Archivo:Captura de pantalla 2026-05-21 110413.png

2026-05-21T09:04:46Z

Alfredo.rodriguez:

Reproducción de audio

Omnisuite STT y TTS

2026-05-21T09:03:27Z

Alfredo.rodriguez: /* Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
 
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Text to Speech con "cajas mdtel"]]
 
'''PENDIENTE SUBIR DETALLES CUANDO TENGAMOS TTS CON GOOGLE EN C'''
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Omnisuite STT y TTS

2026-05-21T09:02:28Z

Alfredo.rodriguez: /* Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
 
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
[[Archivo:Captura de pantalla 2026-05-21 110124.png|250px|miniaturadeimagen|no|Text to Speech con "cajas mdtel"]]
 
'''PENDIENTE SUBIR DETALLES CUANDO TENGAMOS TTS CON GOOGLE EN C'''
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Archivo:Captura de pantalla 2026-05-21 110124.png

2026-05-21T09:02:14Z

Alfredo.rodriguez:

Text to Speech con "cajas mdtel"

Omnisuite STT y TTS

2026-05-21T08:49:28Z

Alfredo.rodriguez: /* Google */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
 
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
'''PENDIENTE SUBIR DETALLES CUANDO TENGAMOS TTS CON GOOGLE EN C'''
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Omnisuite STT y TTS

2026-05-21T08:49:11Z

Alfredo.rodriguez: /* Google */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
'''PENDIENTE SUBIR DETALLES CUANDO TENGAMOS TTS CON GOOGLE EN C'''
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Omnisuite STT y TTS

2026-05-21T08:48:53Z

Alfredo.rodriguez:

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==
Se dispone del programa
:* <code>/opt/omnisuite/bin/omnisuiteTTSgoo</code> para '''Text To Speech (TTS)'''

En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo y voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/google.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text", actualmente no disponible
:* Una sección <code>tts</code>, para "text to speech", en la que defimiremos endpoint del servicio y timeout
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=AIzaSyCzkyUQBj9y3L-i1ej3Bj2lzO-wEwxY5mY

[stt]
# no disponible

[tts]
url=https://texttospeech.googleapis.com/v1/text:synthesize?key=%s
to_ms=10000
</pre>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
'''PENDIENTE SUBIR DETALLES CUANDO TENGAMOS TTS CON GOOGLE EN C'''
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

RecordOmni

2026-05-21T08:36:01Z

Alfredo.rodriguez:

=== Introducción ===

recordOmni (actualmente versión 0.0.4) proporciona una gestión estructurada de los ficheros de grabaciones de Omnisuite, permitiendo:
* Reorganizar las grabaciones en una estrucutura de directorios en arbol basada en año/mes/dia/hora/minuto
* Almacenar las grabaciones en esa estructura de directorios y en formato mp3 (para reducir espacio)
* Extraer uno de los canales de la comunicación (el del lado del cliente) para dejarlo además en otra carpeta
 

Para ello, '''en Omnisuite''':
* Se modifica en la tabla "voice_recordings" el campo "value" para reflejar el nuevo destino de la grabación (en vez de "/var/spool/asterisk/monitor" será por ejemplo "/mnt/grabaciones/2025/01/17/11/25")
* Podemos escuchar la grabación (que ha quedado en formato mp3) desde el administrador voice/voice recordings y seleccionando en una grabación la opción "edit voice recording" en la pestaña "player"
 

El proceso que hemos realizado se basa en que actualmente Motion
* Deja las grabaciones en /var/spool/asterisk/monitor
* Escribe el dato en el campo "value" de la tabla "voice_recordings"
* En el campo "type" de la tabla "voice_recordings" las llamadas pueden ser "inbound", "outbound", "dialer" (hay más tipos pero solo estamos usando esos de momento)
 
 

=== Instalación y puesta en marcha ===

'''Para instalar:'''
* Instalar paquetes
sudo apt install libdbi-perl
sudo apt install libdbd-mysql-perl
* Copiar el archivo <code>recordOmni.pl</code> a la carpeta <code>/opt/omnisuite/bin/</code> y darle los permisos <code>744</code> y usuario <code>root:root</code>
* Copiar el archivo <code>recordOmni.logrotate</code> a la carpeta <code>/etc/logrotate.d</code> renombrarlo a recordOmni con los permisos <code>744</code> y usuario <code>root:root</code>
* Crear la carpeta <code>/etc/MDtel</code>
* Copiar el archivo <code>recordOmni.pconf</code> a la carpeta <code>/etc/MDtel</code> con los permisos <code>644</code> y usuario <code>root:root</code>
* Copiar el archivo <code>recordOmni.sh</code> a la carpeta <code>/etc/init.d</code> y renombrarlo a <code>recordOmni</code> con los permisos <code>755</code> y el usuario <code>root:root</code>
 

<code>recorOmni</code> queda instalado de esta manera como un demonio en el sistema
 

'''Para puesta en marcha'''
* Habilitar el arranque automatico con el comando <code>systemctl enable recordOmni </code>
* Configurar el archivo <code>/etc/MDtel/recordOmni.pconf</code>; ver sección [[#Configuración]]
 
 

=== Configuración ===
==== Parametros importantes para configuración ====

'''La conexion con la BD'''
# Conexion de base de datos
$db = 'motion2';
$dbHost = 'localhost';
$dbPort = '3306';
$dbUsuario = 'root';
$dbClave = 'aaaaaqaaaaaa';
 
'''Directorios donde se van a copiar los archivos'''
# Directorio donde van las grabaciones
$grabRutaDest = '/tmp/grabaciones';
$grabRutaUsaTimestamp = 1;
 
El parametro grabRutaUsaTimestamp si vale 1 se crean los directorios con AAAA/MM/DD/HH/MM/SS
 
# Directorio donde van el lado cliente de las grabaciones si '' no se obtiene
$grabRutaDestCli = '/tmp/grabacionesCli';
$grabRutaCliUsaTimestamp = 0;
 
'''Compresion de los archivos MP3'''
#Compresion del mp3 (valores permidos: 8k 16k 32k 128k)
$grabCompresionMP3 = 32k
 
'''Dias que deben transcurrir para dar alarma al arrancar y subir el contador "Antiguas" en la monitorizacion'''
# Dias transcurridos de la llamada a procesar para dar alarma
$diasDesdeLlamada = 5;
 

==== Ejemplo de fichero <code>recordOmni.pconf</code> completo y operativo ====

#
# Configuracion de recordOmni.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/record/recordOmni.log';
#logArch = '';

# Archivo para el pid (eliminando el .pid final)
$pidArch = '/var/run/record/recordOmni';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas
$toBucle = 15;

# Tipos de llamada analizados
$tiposLlamada = "'inbound','outbound','dialer','internal'";

# Conexion de base de datos
$db = 'motion2';
$dbHost = 'omsui-bdtr';
$dbPort = '3306';
$dbUsuario = 'xcall';
$dbClave = '';
# indice inicial para empezar la busqueda de grabaciones (0 desde el principio)
$dbIndInicial = 113920;
# segundos de retardo en la fecha de la BD para empezar a procesar grabaciones (0 sin retardo)
# 3600 (1 hora)
# 86400 (1 dia)
$dbSegRetardo = 3600;

# Configuracion de la supervision
$supPort = '2111';

# Directorio donde se localizan las grabaciones
$grabRutaOrig = '/var/spool/asterisk/monitor';

# Directorio donde van las grabaciones
$grabRutaDest = '/mnt/almacen/grabaciones';

#Fichero que tiene que estar en la ruta destino para comprobar que si es una nas este montada. Si es '' no se comprueba
$grabDestFileMarca = 'NASmontada';

# grabRutaUsaTimestamp valores 0 $grabRutaDest
# 1 $grabRutaDest/AAAA/MM/DD
# 2 $grabRutaDest/AAAA/MM/DD/HH/MM
$grabRutaUsaTimestamp = 1;

#Compresion del mp3 (valores permidos: 8k 16k 32k 128k)
$grabCompresionMP3 = 32k
#Hay compresion
#grabCompresion valores 0 sin compresion
# 1 wav estereo -> mp3 (defecto)
$grabCompresion = 1;

# Directorio donde van el lado cliente de las grabaciones si '' no se obtiene
$grabRutaDestCli = '/mnt/almacenCIL/grabacionesCli';

# grabRutaCliUsaTimestamp valores 0 $grabRutaDest
# 1 $grabRutaDest/AAAA/MM/DD
# 2 $grabRutaDest/AAAA/MM/DD/HH/MM
$grabRutaCliUsaTimestamp = 0;

# Dias transcurridos de la llamada a procesar para dar alarma
$diasDesdeLlamada = 5;
 

=== Diagnósticos ===
Los eventos de recorOmni quedan registrados en <code>/var/log/record/recordOmni.log</code>
 

Para ver el estado del proceso, y reiniciarlo en caso necesario
/etc/init.d/recordOmni status
/etc/init.d/recordOmni stop
/etc/init.d/recordOmni start
 
 

[[Category:tecnico]]
[[Category:Omnisuite]]

Manual de operación de vFlow

2026-05-21T08:34:18Z

Alfredo.rodriguez: /* Ejemplo de voz */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:33:40Z

Alfredo.rodriguez: /* Ejemplo de chat */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:33:20Z

Alfredo.rodriguez: /* Cerrar sesión */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:32:57Z

Alfredo.rodriguez: /* Enviar texto */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:32:02Z

Alfredo.rodriguez: /* Abrir sesión */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:31:37Z

Alfredo.rodriguez: /* Para canales de texto */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:30:58Z

Alfredo.rodriguez: /* Ver versión */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T08:30:34Z

Alfredo.rodriguez: /* Ver configuración */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T07:10:13Z

Alfredo.rodriguez:

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 
== Procedimientos de respaldo y restauración ==
== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T07:06:56Z

Alfredo.rodriguez: /* Diagnósticos */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep <callysquare_name>
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Omnisuite STT y TTS

2026-05-21T06:50:52Z

Alfredo.rodriguez: /* Google */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
 
Para los proveedores
:* Evelenlabs
:* Google
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
'''La configuración adecuada por agilidad y costes es usar STT de ElevenLabs y TTS de Google'''
</div>
 
== ElevenLabs ==
Se dispone de los programas
:* <code>/opt/omnisuite/bin/omnisuiteSTT11p</code> para '''Speech to Text (STT)'''
:* <code>/opt/omnisuite/bin/omnisuiteTTS11p</code> para '''Text To Speech (TTS)'''
 
En la invocación para '''Speech to Text''' incluiremos
:* Fichero ".ini"
:* <code>stt</code> --> comando para speech a text
:* Modelo a usar
:* idioma a usar
:* fichero a convertir a texto
Ejemplo STT
: Invocación
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav </code>
: Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK",
"text": "¿En qué más puedo ayudarte?",
"language": "es",
"elevenlabs_language": "spa",
"confidence": 100
}

</pre>
 
En la invocación para '''Text to Speech''' incluiremos
:* Fichero ".ini"
:* <code>tst</code> --> comando para speech a text
:* idioma a usar
:* Modelo a usar
:* Voz a usar
:* Fichero donde quedará el audio obtenido
:* Texto a convertir
Ejemplo TTS
: Invocación
::<code> /opt/omnisuite/bin/omnisuiteTTS11p /etc/MDtel/elevenlabs.ini tts es eleven_turbo_v2_5 1eHrpOW5l98cxiSRjbzJ /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}" </code>
 
:Respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>
 
El fichero ".ini" (por defecto <code>/etc/MDtel/elevenlabs.ini</code>) contiene:
:* Una sección <code>comun</code> en la que habrá que cambiar el <code>api_key</code>
:* Una sección <code>stt</code>, para "speech to text" en la que se configurarán los keyterms del proyecto
:* Una sección <code>tts</code>, para "text to speech"
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[comun]
proxy=no
api_key=APIKEYDELPROYECTO

[stt]
# enable_logging=false solo enterprise
url=https://api.elevenlabs.io/v1/speech-to-text?enable_logging=true
to_ms=10000
# temperature=0.0 a 2.0
temperature=0.1
# keyterms_XX: pueden estar todos vacios o no existir. 00<=XX<=09
keyterms_00=
keyterms_01=
keyterms_02=
keyterms_03=
keyterms_04=
keyterms_05=
keyterms_06=
keyterms_07=
keyterms_08=
keyterms_09=

[tts]
url=https://api.elevenlabs.io/v1/text-to-speech/%s?output_format=%s_8000
to_ms=10000
</pre>

== Google ==

<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /tmp/a.wav "Buenos días. ¿Me puedes decir la hora?" </code>

== Integración en Omnisuite (SIN INTERRUPCIÓN A AGENTE) ==
En Omnisuite la invocación a un ASR o TTS del catálogo integrado requiere la inserción de una sola caja en Cally Square, por ejemplo "Google Cloud TTS" o "OpenAI Whisper"
 
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
 
* Para STT:
::* (Opcional) una caja "system" que reproduzca un pitido
::* Una caja "system" que grabe el audio del usuario
::* Una caja "system" que invoque al STT con dicho audio grabado
 
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
 
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
 
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
 
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|300px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
 
'''PENDIENTE SUBIR DETALLES CUANDO TENGAMOS TTS CON GOOGLE EN C'''
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
 
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
 
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]

Manual de operación de vFlow

2026-05-21T06:40:10Z

Alfredo.rodriguez: /* Descripción general */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 500px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T06:39:48Z

Alfredo.rodriguez: /* Descripción general */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/opt/omnisuite/bin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/opt/omnisuite/bin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Archivo:Captura de pantalla 2026-05-20 132119.png

2026-05-21T06:23:40Z

Alfredo.rodriguez: Alfredo.rodriguez subió una nueva versión de Archivo:Captura de pantalla 2026-05-20 132119.png

panel vflow

Archivo:Ventana Panel de vFlow.png

2026-05-21T06:20:26Z

Alfredo.rodriguez: Alfredo.rodriguez subió una nueva versión de Archivo:Ventana Panel de vFlow.png

Ventana Panel de vFlow

Portal de administración de vFlow

2026-05-21T06:20:05Z

Alfredo.rodriguez: /* Panel de vFlow */

[[Archivo:Icono en construccion.png|600px|miniaturadeimagen|center|marco|En construcción]]
 

<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;max-width: 600px">
El Dashboard de vflow actualmente no gestiona ningún tipo de configuración a nivel de orquestador de IA
 

Lo siguientes elementos:
* Agentes (incluso producción, preproducción y prueba)
* Stores
* API loaders de los Stores
Han de ser dados de alta tanto en vFlow Dashboard como en el orquestador
</div>
 
== Acceso ==
El acceso a vFlow dispone de tres niveles de usuario:
* Guest: Puede ver conversaciones e interacciones
* User: Además Puede actualizar RAG
* Admin: Además puede hacer altas/bajas/modificaciones en usuarios, plataformas, agentes y orquestadores

[[Archivo:Pantalla acceso vflow.png|400px|miniaturadeimagen|centro|Pantalla de acceso a vFlow Dashboard]]

== Ventanas de vFlow dashboard ==
vFlow dashboard proporciona las siguientes ventanas:

* Panel de vFlow: Presenta estadísticas generales de la plataforma
::[[Archivo:Captura de pantalla 2026-05-20 132119.png|500px|miniaturadeimagen|no|Panel vflow]]
 
* Búsqueda semántica: Permite realizar búsquedas dentro de todas las conversaciones almacenadas en vFlow
::[[Archivo:Captura de pantalla 2026-05-20 132316.png|500px|miniaturadeimagen|no|Búsqueda semántica]]
 
* Gestión RAG: Permite gestionar versiones de los API Loaders (Que habrán sido dados de alta tanto en vFlow como en el orquestador)
::[[Archivo:Captura de pantalla 2026-05-20 132434.png|500px|miniaturadeimagen|no|Gestión RAG]]
 
* Historial de peticiones: Lista todas las peticiones que cumplan el filtro seleccionado
::[[Archivo:Captura de pantalla 2026-05-20 132550.png|500px|miniaturadeimagen|no|Historial de peticiones]]
 
* Sesiones: Lista las sesiones que cumplan el filtro seleccionado y muestra su detalle
::[[Archivo:Captura de pantalla 2026-05-20 132657.png|500px|miniaturadeimagen|no|Historial de sesiones]]
 
* Panel de administración de vFlow: De acceso solo para usuarios "admin" permite altas, bajas y modificaciones de plataformas, agentes, orquestadores, usuarios y diferentes parámetros de configuración
::[[Archivo:Captura de pantalla 2026-05-20 132747.png|500px|miniaturadeimagen|no|Panel de administración]]
 
=== Panel de vFlow ===
Desde la ventana de panel de vFlow podremos ver diferentes tablas y gráficas:
* Tokens por modelo
* Evolución de peticiones
* Peticiones por modelo
* Evolución de tokens
* Llamadas a LLM por día
* Duración por modelo
* Peticiones por hora el día
 
Filtradas por período
 
Es configurable las gráficas que ve cada tipo de usuario
 
[[Archivo:Ventana Panel de vFlow.png|1000px|miniaturadeimagen|centro|ventana panel de vFlow]]
 
 

=== Búsqueda semántica ===
La ventana de búsqueda semántica permite la búsqueda de cualquier cadena dentro de los registros de conversaciones e interaciones de vFlow, incluso dentro de la conversación
 
[[Archivo:Ventana busqueda semantica.png|1000px|miniaturadeimagen|centro|Ventana de búsqueda semántica|link=]]
 
 

=== Gestión RAG ===

Desde la ventana de gestión RAG podremos realizar tareas de gestión de versiones de los documentos o loaders que tengamos en el sistema, agrupados por almacenes o stores.

Las acciones se podrán realizar sobre los loaders, incluyendo:
* Eliminar loader
* subir una nueva versión del loader
* Gestionar versiones (definir versión activa)
 
[[Archivo:Ventana RAG 1.png|1000px|miniaturadeimagen|centro|Ventana principal gestión RAG|link=]]
 
 
La ventana de gestión de versiones nos permitirá:
* Definir la versión activa
* Ver el documento asociado al loader
* Eliminar una versión
* Subir nueva versión
 
[[Archivo:Ventana RAG 2.png|1000px|miniaturadeimagen|centro|Gestión de versiones de loader|link=]]
 
 

=== Historial de peticiones ===
Desde la ventana de historial de peticiones obtendremos un listado de las peticiones realizadas desde la plataforma a vFlow con las respuestas proporcionadas por este, existiendo la posibilidad de filtrar por período
 

[[Archivo:Ventana de historial de peticiones.png|1000px|miniaturadeimagen|centro|Ventana de historial de peticiones|link=]]
 
 

=== Sesiones ===
La ventana de sesiones nos permite poder ver el detalle de todas las consultas y respuestas que han sido realizadas desde las plataformas a vFlow, pudiendo filtrar por período y sesión
 
[[Archivo:Ventana sesiones.png|1000px|miniaturadeimagen|centro|Ventana de sesiones|link=]]
 
 

=== Panel de vFlow ===
Desde la ventana de panel de administración podremos hacer altas, bajas y modificiones de plataformas, agentes, orquestadores, usuarios y configuraciones adicionales
 
[[Archivo:Ventana panel de administracion.png|1000px|miniaturadeimagen|centro|Ventana panel de administración|link=]]

Portal de administración de vFlow

2026-05-21T06:19:12Z

Alfredo.rodriguez: /* Panel de vFlow */

[[Archivo:Icono en construccion.png|600px|miniaturadeimagen|center|marco|En construcción]]
 

<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;max-width: 600px">
El Dashboard de vflow actualmente no gestiona ningún tipo de configuración a nivel de orquestador de IA
 

Lo siguientes elementos:
* Agentes (incluso producción, preproducción y prueba)
* Stores
* API loaders de los Stores
Han de ser dados de alta tanto en vFlow Dashboard como en el orquestador
</div>
 
== Acceso ==
El acceso a vFlow dispone de tres niveles de usuario:
* Guest: Puede ver conversaciones e interacciones
* User: Además Puede actualizar RAG
* Admin: Además puede hacer altas/bajas/modificaciones en usuarios, plataformas, agentes y orquestadores

[[Archivo:Pantalla acceso vflow.png|400px|miniaturadeimagen|centro|Pantalla de acceso a vFlow Dashboard]]

== Ventanas de vFlow dashboard ==
vFlow dashboard proporciona las siguientes ventanas:

* Panel de vFlow: Presenta estadísticas generales de la plataforma
::[[Archivo:Captura de pantalla 2026-05-20 132119.png|500px|miniaturadeimagen|no|Panel vflow]]
 
* Búsqueda semántica: Permite realizar búsquedas dentro de todas las conversaciones almacenadas en vFlow
::[[Archivo:Captura de pantalla 2026-05-20 132316.png|500px|miniaturadeimagen|no|Búsqueda semántica]]
 
* Gestión RAG: Permite gestionar versiones de los API Loaders (Que habrán sido dados de alta tanto en vFlow como en el orquestador)
::[[Archivo:Captura de pantalla 2026-05-20 132434.png|500px|miniaturadeimagen|no|Gestión RAG]]
 
* Historial de peticiones: Lista todas las peticiones que cumplan el filtro seleccionado
::[[Archivo:Captura de pantalla 2026-05-20 132550.png|500px|miniaturadeimagen|no|Historial de peticiones]]
 
* Sesiones: Lista las sesiones que cumplan el filtro seleccionado y muestra su detalle
::[[Archivo:Captura de pantalla 2026-05-20 132657.png|500px|miniaturadeimagen|no|Historial de sesiones]]
 
* Panel de administración de vFlow: De acceso solo para usuarios "admin" permite altas, bajas y modificaciones de plataformas, agentes, orquestadores, usuarios y diferentes parámetros de configuración
::[[Archivo:Captura de pantalla 2026-05-20 132747.png|500px|miniaturadeimagen|no|Panel de administración]]
 
=== Panel de vFlow ===
Desde la ventana de panel de vFlow podremos ver diferentes tablas y gráficas:
* Tokens por modelo
* Evolución de peticiones
* Peticiones por modelo
* Evolución de tokens
* Llamadas a LLM por día
* Duración por modelo
* Peticiones por hora el día
 
Filtradas por período
 
Es configurable las gráficas que ve cada tipo de usuario
 
[[Archivo:Ventana Panel de vFlow.png|1000px|miniaturadeimagen|centro|ventana panel de vFlow|link=]]
 
 

=== Búsqueda semántica ===
La ventana de búsqueda semántica permite la búsqueda de cualquier cadena dentro de los registros de conversaciones e interaciones de vFlow, incluso dentro de la conversación
 
[[Archivo:Ventana busqueda semantica.png|1000px|miniaturadeimagen|centro|Ventana de búsqueda semántica|link=]]
 
 

=== Gestión RAG ===

Desde la ventana de gestión RAG podremos realizar tareas de gestión de versiones de los documentos o loaders que tengamos en el sistema, agrupados por almacenes o stores.

Las acciones se podrán realizar sobre los loaders, incluyendo:
* Eliminar loader
* subir una nueva versión del loader
* Gestionar versiones (definir versión activa)
 
[[Archivo:Ventana RAG 1.png|1000px|miniaturadeimagen|centro|Ventana principal gestión RAG|link=]]
 
 
La ventana de gestión de versiones nos permitirá:
* Definir la versión activa
* Ver el documento asociado al loader
* Eliminar una versión
* Subir nueva versión
 
[[Archivo:Ventana RAG 2.png|1000px|miniaturadeimagen|centro|Gestión de versiones de loader|link=]]
 
 

=== Historial de peticiones ===
Desde la ventana de historial de peticiones obtendremos un listado de las peticiones realizadas desde la plataforma a vFlow con las respuestas proporcionadas por este, existiendo la posibilidad de filtrar por período
 

[[Archivo:Ventana de historial de peticiones.png|1000px|miniaturadeimagen|centro|Ventana de historial de peticiones|link=]]
 
 

=== Sesiones ===
La ventana de sesiones nos permite poder ver el detalle de todas las consultas y respuestas que han sido realizadas desde las plataformas a vFlow, pudiendo filtrar por período y sesión
 
[[Archivo:Ventana sesiones.png|1000px|miniaturadeimagen|centro|Ventana de sesiones|link=]]
 
 

=== Panel de vFlow ===
Desde la ventana de panel de administración podremos hacer altas, bajas y modificiones de plataformas, agentes, orquestadores, usuarios y configuraciones adicionales
 
[[Archivo:Ventana panel de administracion.png|1000px|miniaturadeimagen|centro|Ventana panel de administración|link=]]

Manual de operación de vFlow

2026-05-21T06:03:34Z

Alfredo.rodriguez: /* Descripción general */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio|link=]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-05-21T06:01:37Z

Alfredo.rodriguez: /* Gestión en vFlow */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)
 
'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno, dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 
::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
 

=== En orquestador (Flowise) ===
* '''<big>1.- Crear agente</big>''': Se crearán hasta '''tres agentes''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los agentes''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 144432.png|800px|miniaturadeimagen|no|Creación de agente en orquestador flowise (uno por entorno)|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2, 3 y 4 solo en caso de tener RAG'''</div>
 

* '''<big>2.- Crear store </big>''': Se crearán hasta '''tres stores''' (pro/pre/pru) en función de los entornos deseados; es importante '''anotar los ID's de los stores''' creados (se ven en la URL)
::[[Archivo:Captura de pantalla 2026-05-20 135417.png|800px|miniaturadeimagen|no|Creación de store (uno por entorno)|link=]]
 
* '''<big>3.- Crear loader'''</big> : Para cada loader que se desee manejar, se creará en el orquestador y en el document store, para los entornos deseados
::* Subir fichero (p.ej "ld1.txt" a <code>/var/www.html/storages/production</code> (o a <code>/staging</code> o a <code>test</code> si procede)
::::[[Archivo:Captura de pantalla 2026-05-20 135757.png|700px|miniaturadeimagen|no|Subir fichero inicial (uno por entorno)|link=]]
 
::* Crear loader
::::* Tipo: API loader
::::* Method: get
::::* URL : <cde>http://127.0.0.1/storages/production/nombrefich.txt</code> (o /staging /test) (formatos posibles txt, pdf, doc, docx)
::::* Splitter: Recursive character text splitter
::::* Comprobar con "preview chunks"
::::* Pulsar "process"
::::::[[Archivo:Captura de pantalla 2026-05-20 140146.png|700px|miniaturadeimagen|no|Creador loader en orquestador flowise|link=]]
 
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
 
* '''<big>4.- Sincronizar chunks</big>''' en store ('''para cada entorno''')
::* En Store, more actions / Upsert All Chunks
::::[[Archivo:Captura de pantalla 2026-05-20 141118.png|700px|miniaturadeimagen|no|Upsert chunks store flowise|link=]]
 
::::* Embeddings: Por ejemplo OpenAI embeddings (requiere "Credential")
::::* Vector Store: Qdrant
::::::* Credential: cflow_qdrant
::::::* URL: http://localhost:6333
::::::* Qdrant Collection Name: vflow
::::* Record Manager: MySQL
::::::* Connect credential: mysql_upsert
::::::* Host: localhost
::::::* Database: vflow_flowise_upsert
::::::* Cleaun: Full
::::* Aplicar
::::::* Save config
::::::* Upsert
::::::[[Archivo:Captura de pantalla 2026-05-20 141626.png|700px|miniaturadeimagen|no|Sincronizado de store en flowise|link=]]
 
La siguiente imagen muestra como quedará en el orquestador (flowise) un document store de vflow con entornos de producción, reproducción y pruebas
::[[Archivo:Captura de pantalla 2026-05-20 142148.png|700px|miniaturadeimagen|no|Document store en flowise con los tres entornos (tres document stores)|link=]]
 
 

=== En flow ===
* 1.- '''<big> Crear un agente</big>''': Vincularlo a los tres agentes de orquestador (pro/pre/pru) anotados anteriormente
::::[[Archivo:Captura de pantalla 2026-05-20 143843.png|800px|miniaturadeimagen|no|Crear agente en vflow|link=]]
 
<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
✅ '''Puntos 2 y 3 solo en caso de tener RAG'''</div>
 
* 2.- '''<big>Crear un store</big>''': Vinculado a los stores de orquestador anotados anteriormente (pro/pre/pru)
::::[[Archivo:Captura de pantalla 2026-05-20 142920.png|800px|miniaturadeimagen|no|Creacion de Store en vflow|link=]]
 
* 3.- '''<big>Crear un loader</big>'''
::* Loader vinculado a agente de vflow
::* El sistema comprobará que el fichero ya existe en el orquestador
:: Pulsar "crear"
::::[[Archivo:Captura de pantalla 2026-05-20 143126.png|700px|miniaturadeimagen|no|Crear loader en vflow|link=]]
 
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
 

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

En /home/sat/vFlowProxy hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== Integración de vFlow desde Omnisuite ==
 

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise <code>/etc/MDtel/vflow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vflow/service.ini</code>
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test
EJEMPLO ".INI" DE SERVICIO
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[arch_uuids]
agent=/etc/MDtel/vflow/agent_loop_01.ini
platform=/etc/MDtel/vflow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vflow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vflow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vflow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]