VIVAitwiki - Contribuciones del usuario [es]

Omnisuite STT y TTS

2026-06-11T10:38:24Z

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)
<br>
Para los proveedores
:* Evelenlabs
:* Google
<br>
<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>
<br>
== 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)'''
<br>
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>
<br>
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>
<br>
: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>
<br>
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"
<br>
<pre style="background-color: #f6f8fa; border: 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)'''
<br>
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
<br>
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>
<br>
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
<br>
<pre style="background-color: #f6f8fa; border: 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=APIKEYDEGOOGLE

[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"
<br>
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
<br>
* 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
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
<br>
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav | jq -r '.text'</code>
<br>
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|400px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Inovación a TTS]]
<br>
::<code>/opt/omnisuite/bin/omnisuiteTTSgoo /etc/MDtel/google.ini tts es-es "es-ES-Chirp3-HD-Despina" /var/lib/asterisk/sounds/{id_llamada}_tts.alaw "{vflow_respuesta}"</code>
<br>
:::[[Archivo:Captura de pantalla 2026-05-21 110413.png|500px|miniaturadeimagen|no|Reproducción de audio generado]]
<br>
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
<br>
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]
<br>

Omnisuite STT y TTS

2026-06-11T10:35:19Z

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)
<br>
Para los proveedores
:* Evelenlabs
:* Google
<br>
<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>
<br>
== 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)'''
<br>
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>
<br>
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>
<br>
: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>
<br>
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"
<br>
<pre style="background-color: #f6f8fa; border: 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)'''
<br>
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
<br>
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>
<br>
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
<br>
<pre style="background-color: #f6f8fa; border: 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=APIKEYDEGOOGLE

[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"
<br>
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
<br>
* 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
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
<br>
::<code>/opt/omnisuite/bin/omnisuiteSTT11p /etc/MDtel/elevenlabs.ini stt scribe_v2 es /var/lib/asterisk/sounds/{id_llamada}_stt.wav | jq -r '.text'</code>
<br>
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|400px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Inovación a TTS]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-21 110413.png|500px|miniaturadeimagen|no|Reproducción de audio generado]]
<br>
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
<br>
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]
<br>

Operacion cartelia

2026-06-09T13:58:43Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:ejemplo para idioma español
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:58:15Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:58:01Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''
<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:57:51Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
:'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''
<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:57:03Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
:'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:56:54Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
::'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:56:42Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:55:35Z

Alfredo.rodriguez:

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

[[Category:tecnico]]
[[Category:administrador]]
[[Category:Cartelia]]

Operacion cartelia

2026-06-09T13:44:12Z

Alfredo.rodriguez: /* Instalación */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13 (Trixie)
* Apache 2.4.67
* PHP 8.4
* Motor de base de datos MariaDB 11.8.6
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR (cambiar hostname, cambiar IP en no se cuantos sitios, cambiar certificados,...)
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:39:23Z

Alfredo.rodriguez: /* Instalación */

== Instalación ==

Cartelia se entregará en formato de imagen virtual (.qcow) listo para su despliegue y adaptación por parte del personal de instalación.
El personal técnico que despliegue deberá tener nociones básicas de virtualización y administración de sistemas operativos linux

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache versión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:27:16Z

Alfredo.rodriguez: /* Instalación */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache versión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:26:05Z

Alfredo.rodriguez: /* Instalación */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR
<br>

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:25:50Z

Alfredo.rodriguez: /* Instalación */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

La adaptación de la máquina entregada para cada caso pasará por realizar los siguientes cambios:

* INDICAR CAMBIOS A REALIZAR

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:25:13Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:25:00Z

Alfredo.rodriguez: /* Procedimientos básicos */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"
<br>
'''La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel'''
<br>
'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:24:41Z

Alfredo.rodriguez: /* Procedimientos básicos */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code> (las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel

<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:24:20Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code>(las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel
<br>

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:24:00Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code>(las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel
<br>
'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:23:50Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code>(las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:22:46Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta <code>C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe</code>
*** Ejemplo invocación: <code>msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" </code>(las carpetas cambiarán en cada caso)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:21:34Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

'''Herramientas necesarias''':

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
*** Ejemplo invocación: msgunfmt.exe "C:\xibo-cms\locale\es.mo" -o "C:\xibo-cms\locale\es.po" (las carpetas pueden cambiar)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

'''Instrucciones para cambiar mensajes'''
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:21:15Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

Herramientas previas necesarias:

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
*** Ejemplo invocación: msgunfmt.exe "C:\xibo-cms\locale\es.mo" -o "C:\xibo-cms\locale\es.po" (las carpetas pueden cambiar)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

Instrucciones para cambiar mensajes
:(ejemplo para idioma español)
:entre paréntesis perfil que puede realizar la tarea con seguridad
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:21:01Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

Herramientas previas necesarias:

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
*** Ejemplo invocación: msgunfmt.exe "C:\xibo-cms\locale\es.mo" -o "C:\xibo-cms\locale\es.po" (las carpetas pueden cambiar)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

Instrucciones para cambiar mensajes
<br>
:(ejemplo para idioma español)
<br>
:entre paréntesis perfil que puede realizar la tarea con seguridad
<br>
#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:20:02Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

Herramientas previas necesarias:

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
*** Ejemplo invocación: msgunfmt.exe "C:\xibo-cms\locale\es.mo" -o "C:\xibo-cms\locale\es.po" (las carpetas pueden cambiar)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

Instrucciones para cambiar mensajes
<br> (ejemplo para idioma español)
<br> entre paréntesis perfil que puede realizar la tarea con seguridad

#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:19:32Z

Alfredo.rodriguez: /* Modificar textos idioma */

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

Herramientas previas necesarias:

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
*** Ejemplo invocación: msgunfmt.exe "C:\xibo-cms\locale\es.mo" -o "C:\xibo-cms\locale\es.po" (las carpetas pueden cambiar)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

Instrucciones para cambiar mensajes
<br>(ejemplo para idioma español)
<br> entre paréntesis perfil que puede realizar la tarea con seguridad

#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:18:57Z

Alfredo.rodriguez:

== Instalación ==

Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guía detalles de como copiar dicha máquina virtual en cada entorno

Los elementos principales de la máquina son:

* Sistema Operativo Debian 13
* Apache verisión
* Motor de base de datos MariaDB
* Elementos de seguridad por defecto
** Firewall (basado en )
** fail2ban

== Procedimientos básicos ==

=== Modificar textos idioma ===

Herramientas previas necesarias:

* poedit (https://poedit.com/); nos permitirá:
** Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar una traducción
*** Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
*** Ejemplo invocación: msgunfmt.exe "C:\xibo-cms\locale\es.mo" -o "C:\xibo-cms\locale\es.po" (las carpetas pueden cambiar)
* Ver las traducciones para un fichero ".po"
* Modificar y "compilar" a fichero ".mo"

Instrucciones para cambiar mensajes (ejemplo para idioma español); entre paréntesis perfil que entendemos puede realizar la tarea con seguridad

#.- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
#.- (PU) Descompilar el fichero con la herramienta msgunfmt
#.- (PU) Modificar mensajes con "poedit" y compilar
#.- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo

Operacion cartelia

2026-06-09T13:16:45Z

Alfredo.rodriguez: Página creada con « == Instalación == Cartelia se entregará al instalador como una máquina virtual a partir de la cual podrá realizar la adaptación necesaria. No se incluye en esta guí…»

MediaWiki:Sidebar

2026-06-09T13:14:04Z

Alfredo.rodriguez:

**mainpage|mainpage-description

* Usuario
** Documentación de usuario VIVAit Call|VIVAit Call
** Documentacion de usuario VIVAit Suite|VIVAit Suite
** Documentacion de usuario VIVAit Alert|VIVAit Alert


* Administrador
** Arquitectura VIVAit|Arquitectura
** Release Notes|Release Notes
** Funcionalidades | Funcionalidades
** Portales de administración VIVAit |Portales de administración
** Preguntas frecuentes administración | Preguntas frecuentes

* Servicio técnico
** Manuales de instalación|Instalación
** Actualización|Actualización
** Manuales de operación plataforma VIVAit |Manuales de operación
** Terminales homologados en VIVAit | Terminales
** Hylafax + IAXmodem en VIVAit Call| Solución de fax para VIVAit Call
** Howtos| Howtos
** Formación| Formación
** Incidencias| Incidencias
** Base de datos| Base de datos

* Desarrollo
** APIs integracion|API's de integración
** Kit argumentarios|Desarrollo de argumentarios

* vFlow
** Manual de operación de vFlow|Operación
** Portal de administración de vFlow|Administración

* Omnisuite
** RecordOmni|Mejora grabaciones
** Manual de operación de vFlow | Integración vflow (punto 6)
** Omnisuite STT y TTS | STT y TTS

* VIVAit Fax
** Documentación de usuario VIVAit Fax|Usuario
** Arquitectura VIVAit Fax|Arquitectura
** Instalación VIVAit Fax|Instalación
** Documentacion técnica|Servicio Técnico

* Cartelia
** Operacion_cartelia | Operacion de cartelia

* Roadmap
** Proyectos en desarrollo|Proyectos en desarrollo

Omnisuite STT y TTS

2026-05-29T05:58:25Z

Alfredo.rodriguez: /* Google */

== Introducción ==
Se han desarrollado conectores propios para
:* Speech To Text (STT)
:* Text To Speech (TTS)
<br>
Para los proveedores
:* Evelenlabs
:* Google
<br>
<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>
<br>
== 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)'''
<br>
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>
<br>
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>
<br>
: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>
<br>
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"
<br>
<pre style="background-color: #f6f8fa; border: 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)'''
<br>
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
<br>
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>
<br>
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
<br>
<pre style="background-color: #f6f8fa; border: 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=APIKEYDEGOOGLE

[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"
<br>
Utilizando la implementación realizada por mdtel, se requerirá al menos de dos cajas:
<br>
* 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
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134424.png|250px|miniaturadeimagen|no|Speech To Text con "cajas mdtel"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134721.png|250px|miniaturadeimagen|no|Reproducción de "beep"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134822.png|300px|miniaturadeimagen|no|Grabación de audio a transcribir]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 134933.png|500px|miniaturadeimagen|no|Invocación a transcripción]]
<br>
* Para TTS:
::* Una caja "system" que invoca al TTS y deja el audio generado en un fichero
::* Una caja "system" que reproduce el audio
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 141728.png|400px|miniaturadeimagen|no|Texto to speech con "cajas mdtel"]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-21 110124.png|500px|miniaturadeimagen|no|Inovación a TTS]]
<br>
:::[[Archivo:Captura de pantalla 2026-05-21 110413.png|500px|miniaturadeimagen|no|Reproducción de audio generado]]
<br>
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
<br>
:::'''Este proceso genera un fichero temporal de audio para STT y otro para TTS que deberán ser borrados'''
</div>
<br>
:::[[Archivo:Captura de pantalla 2026-05-14 135949.png|500px|miniaturadeimagen|no|Ejemplo para borrar archivo temporal TTS]]
<br>

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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
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>
<br>
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>
<br>
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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
::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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
::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>
<br>
::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>
<br>
::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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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>
<br>
::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>
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
::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>
<br>
::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>
<br>

<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
mysql -u root -p vFlow < vFlow_ULTIMAFECHA.sql
</div>
<br>
* 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
<br>
mv -vi /opt/vFlow_flowise/archivos_ULTIMAFECHA /opt/vFlow_flowise/archivos
</div>
<br>
(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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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
<br>
mysql -u root -p vflow_flowise_upsert < vflow_flowise_upsert_ULTIMAFECHA.sql
<br>
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
<br>
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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
'''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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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
<br>
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
<br>
mariadb-dump -u root -p --single-transaction --routines --events --triggers --default-character-set=utf8mb4 vFlow > vFlow_$(date +%F_%H%M%S).sql
</div>
<br>
* 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>
<br>
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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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>
<br>
* 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>
<br>
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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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>
<br>
* 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>
<br>
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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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<span style="margin-left: 3em;"></span>--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador<span style="margin-left: 3em;"></span>--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy<span style="margin-left: 3em;"></span>--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM<span style="margin-left: 3em;"></span>--> Modelo de lenguaje natural que usará un orquestadores
* Agente<span style="margin-left: 3em;"></span>--> Cada uno de los flujos creados en vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio<span style="margin-left: 3em;"></span>--> 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)
<br>
'''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 ==
<br>

Existe un nodo vFlow en los repositorios habituales proporcionados

<br>

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)
<br>

'''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.
<br>

'''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
<br>

'''Portal orquestador Flowise'''

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

<br>
<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>

<br>

<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
<br>
/etc/init.d/vFlowProxy.service stop
<br>
/etc/init.d/vFlowProxy.service start
<br>
</div>

<br>

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)
<br>
<br>

<br>
== 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>
<br>
* 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>
<br>
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'''<br>
::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>
<br>
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
<br>
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión en vFlow|link=]]
<br>

=== 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=]]
<br>
<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>
<br>

* '''<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=]]
<br>
* '''<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=]]
<br>
::* 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=]]
<br>
::::::[[Archivo:Captura de pantalla 2026-05-20 140326.png|700px|miniaturadeimagen|no|Loader creado en orquestador flowise|link=]]
<br>
* '''<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=]]
<br>
::::* 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=]]
<br>
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=]]
<br>
<br>

=== 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=]]
<br>
<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>
<br>
* 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=]]
<br>
* 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=]]
<br>
::::[[Archivo:Captura de pantalla 2026-05-20 143239.png|700px|miniaturadeimagen|no|Store, loader y detalle de loader|link=]]
<br>

== 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
<br>

<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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)
<br>
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<pre style="background-color: #f6f8fa; border: 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
<br>
<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 ==
<br>

=== 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>
<br>

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=]]
<br>

=== 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]]
<br>
<br>
<br>

<pre style="background-color: #f6f8fa; border: 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>
::<small>salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square</small>

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

<pre style="background-color: #f6f8fa; border: 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>
::<small>la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})</small>

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

<pre style="background-color: #f6f8fa; border: 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]]