younited genaibots

Proyecto GenaiBots

Descripción general

GenaiBots es un marco integral diseñado para automatizar y gestionar interacciones en varias plataformas digitales. Es principalmente una herramienta empresarial para integrar la IA generativa en procesos operativos a través de medios como mensajería instantánea, correos electrónicos, herramientas de emisión de tickets o herramientas internas. Al utilizar IA avanzada y un sistema de complementos modular, permite la creación de flujos operativos sofisticados y modelos de interacción personalizados tanto para empresas como para desarrolladores.

Más detalles en la wiki https://github.com/YounitedCredit/younited-genaibots/wiki También puedes usar el chat con el GPT dedicado aquí para cualquier pregunta relacionada con la instalación, configuración y desarrollo de GenaiBots: https://chatgpt. com/g/g-HGEDT9hA2-genaibots-asistente

este ejemplo de cliente web funciona bien con el marco si desea probarlo rápidamente: https://github.com/Pilosite/genaibot-basicweb-client

Características clave

• Mejoras de la IA : integre la IA generativa en el centro de las interacciones. Esto permite no solo la generación de IA personalizada a través de indicaciones, sino también la capacidad de desencadenar acciones y gestionar procesos con un rápido ciclo de retroalimentación.
• Controladores de acciones personalizadas : cree fácilmente acciones personalizadas basadas en condiciones y desencadenantes específicos, e invoquelas directamente a través de indicaciones.
• Arquitectura de complementos extensible : amplíe la funcionalidad o integre servicios de terceros a través de complementos, lo que garantiza flexibilidad y extensibilidad.
• Integración con sistemas empresariales : interconecte la IA generativa sin problemas dentro de la infraestructura central de TI a través de un servidor web o un contenedor Docker. Esto permite procesar y rastrear tareas realizadas por bots en diversos contextos (mensajería, herramientas de emisión de tickets, correos electrónicos, aplicaciones personalizadas).
• Servicios backend dinámicos : se integra con varios servicios backend para procesamiento y almacenamiento de datos, lo que permite que el sistema se adapte a casos de uso y requisitos empresariales específicos.

Requisitos del sistema

• Sistema operativo : Compatible con Windows, MacOS y Linux.
• Versión de Python : 3.8 o posterior.
• Bibliotecas y dependencias adicionales : enumeradas en el archivo requirements.txt .

Guía de instalación

1. Clonar el repositorio

   git clone https://github.com/YounitedCredit/younited-genaibots
   cd genaibots

2. Configurar entorno virtual (recomendado)

   python -m venv venv
   source venv/bin/activate  # On Windows use `venvScriptsactivate`

3. Instalar dependencias

   pip install -r requirements.txt

Configuración

Configure los ajustes de la aplicación editando el archivo config.yaml en el directorio config . Asegúrese de que todas las claves API necesarias y las configuraciones de la base de datos estén configuradas correctamente.

configuración.yaml

El archivo config.yaml centraliza los ajustes de configuración de la aplicación GenaiBots. A continuación se muestran algunas secciones clave y sus propósitos:

• BOT_CONFIG : Contiene configuraciones relacionadas con el comportamiento del bot y los niveles de depuración.

  • LOG_DEBUG_LEVEL : define el nivel de depuración para el registro.
  • PROMPTS_FOLDER , CORE_PROMPT , MAIN_PROMPT , SUBPROMPTS_FOLDER : especifique los directorios y archivos para las solicitudes.
  • SHOW_COST_IN_THREAD : alternar para mostrar información de costos en hilos.
  • Aquí también se configuran varios nombres y comportamientos predeterminados de los complementos.

• UTILS : Contiene configuraciones de utilidades, como configuraciones de registro.

  • LOGGING : configura el registro, incluidas las rutas del sistema de archivos y la configuración de Azure.

• PLUGINS : Define los complementos disponibles y sus configuraciones.

  • Las categorías incluyen ACTION_INTERACTIONS , BACKEND , USER_INTERACTIONS , GENAI_INTERACTIONS y USER_INTERACTIONS_BEHAVIORS .

Configuración del entorno

Las variables de entorno se cargan mediante python-dotenv , normalmente desde un archivo .env . Esto permite que la aplicación cargue de forma segura datos confidenciales, como claves API y URL de bases de datos. Aquí hay una descripción básica de cómo funciona la configuración del entorno en GenaiBots:

1. Carga de variables de entorno : la función load_dotenv() se llama para cargar variables de entorno desde un archivo .env en la aplicación.
2. Acceso a variables de entorno : los ajustes de configuración en config.yaml pueden hacer referencia a estas variables de entorno utilizando la sintaxis $(ENV_VAR_NAME) .

Ejecutando la aplicación

Ejecute el siguiente comando en el directorio raíz del proyecto:

python app.py

Esto iniciará el servidor y comenzará a manejar solicitudes basadas en acciones y activadores configurados.

Depuración en Visual Studio Code

Para depurar la aplicación en Visual Studio Code, use el siguiente comando:

c: ; cd ' c:reposYuc.GenaiBots ' ; & ' C:Users<your profile>miniconda3python.exe ' ' c:Users<your profile>.vscodeextensionsms-python.debugpy-2024.6.0-win32-x64bundledlibsdebugpyadapter/../..debugpylauncher ' ' 64580 ' ' -- ' ' -m ' ' uvicorn ' ' app:app ' ' --host ' ' localhost ' ' --port ' ' 7071 ' ' --workers ' ' 1 ' 

Arquitectura de complementos

GenaiBots emplea una arquitectura de complementos modular categorizada en varias familias:

1. Interacciones de acción :

   • Complementos predeterminados : acciones predefinidas para tareas comunes.
   • Complementos personalizados : acciones definidas por el usuario adaptadas a necesidades específicas.

2. Parte trasera :

   • Maneja el procesamiento de datos internos y las interacciones con los servicios backend.

3. Interacciones del usuario :

   • Mensajería instantánea : complementos para manejar plataformas de mensajería como Slack y Teams.
   • API personalizada : complementos para interactuar con API personalizadas.

4. Interacciones GenAI :

   • Texto : complementos para generar y manejar interacciones de texto utilizando IA.
   • Imagen : Complementos para generar y manejar interacciones de imágenes utilizando IA.
   • Búsqueda de vectores : complementos para manejar funcionalidades de búsqueda de vectores.

5. Comportamientos de interacción del usuario :

   • Define el comportamiento de las interacciones de los usuarios en diferentes plataformas de mensajería y API personalizadas.

Licencia

Este proyecto tiene la licencia MIT; consulte el archivo LICENSE.md para obtener más detalles.

Soporte y Contacto

Para cualquier consulta de soporte o para informar problemas, visite nuestra página de problemas de GitHub en: https://github.com/YounitedCredit/younited-genaibots/issues