ph-agent-hub
PH Agent Hub es una plataforma modular de IA multi-institucional con interfaz de chat para usuarios y panel administrativo para gestionar modelos, herramientas, tenencias y usuarios.
Ficha actualizada 22 sept 2026, 18:26 · upstream 22 sept 2026, 16:18 · release 2.7.0
Qué es ph-agent-hub
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
PH Agent Hub es una plataforma de inteligencia artificial multi-tenencia diseñada para equipos que necesitan tanto una experiencia de chat productiva como un control administrativo robusto sobre modelos, herramientas y tenencias. Se construye sobre FastAPI + React y utiliza el framework Microsoft Agent Framework para la orquestación del agente.
La plataforma ofrece dos interfaces principales: una interfaz de chat dedicada a los usuarios finales y una interfaz administrativa que permite gestionar modelos, herramientas, tenencias y usuarios con un nivel de control operacional. Esto es especialmente relevante para equipos que desarrollan productos de IA multi-institucional donde la seguridad y el aislamiento entre clientes son prioritarios.
La arquitectura soporta entornos Docker nativos tanto para desarrollo como producción, lo que facilita la despliegue escalable. Además, incluye capacidades avanzadas como corrección automática de JSON en respuestas de DeepSeek, orquestación con retry, y soporte para protocolos A2A (Agent-to-Agent) que permiten integrar agentes externos al ecosistema PH Agent Hub.
- Gestión multi-institucional de copilots de IA donde cada cliente tiene sus propios modelos y herramientas
- Implementación de un chat de IA en una web corporativa con control de acceso por roles y tenencias
- Desarrollo de agentes autónomos que ejecutan tareas complejas mediante orquestación con Microsoft Agent Framework
- Creación de widgets embeddables para sitios externos que permitan a usuarios no registrados interactuar con la plataforma
- Gestión de herramientas y modelos compartidos entre múltiples tenencias con auditoría completa
- Automatización de flujos de trabajo empresariales mediante agentes especializados entrenados en dominios específicos
- Soporte nativo para Microsoft Agent Framework, permitiendo orquestación de agentes con capacidades como razonamiento, reparación de JSON y retry automático
- Diseño multi-institucional desde el modelo del dominio, no como adición posterior, lo que simplifica la gestión de datos entre clientes
- Capacidad de corrección automática de respuestas en formato JSON para modelos compatibles con DeepSeek
- Soporte para protocolos A2A (Agent-to-Agent), permitiendo que los agentes PH Agent Hub actúen como herramientas en otros sistemas externos
- Interfaz unificada que combina chat de usuarios y panel administrativo, reduciendo la complejidad operativa
- Arquitectura Docker-native con despliegues separados para desarrollo y producción, facilitando escalabilidad
- La corrección automática de JSON es específica para modelos compatibles con DeepSeek y no garantiza compatibilidad con otros modelos
- El soporte A2A se limita a agentes externos que implementen la interfaz correspondiente; no se integra nativamente con todos los ecosistemas existentes
- La arquitectura actual requiere configuración manual de variables de entorno (JWT_SECRET, ENCRYPTION_KEY) en cada instancia
- La integración con Microsoft Agent Framework puede requerir dependencias adicionales según el proveedor de modelos elegido
- El sistema depende de servicios externos como MinIO para almacenamiento y Redis para caché, lo que introduce puntos únicos de fallo
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar PH Agent Hub, se recomienda usar Docker Compose con la configuración `infrastructure/docker-compose.yml`. Se deben configurar variables de entorno en el archivo `.env.example`: JWT_SECRET (para autenticación), ENCRYPTION_KEY (para cifrado de claves API), ADMIN_EMAIL y ADMIN_PASSWORD (para inicialización del usuario administrador). Es necesario al menos un proveedor de modelo activo. Para producción, se recomienda desplegar la aplicación en Kubernetes con una configuración de seguridad reforzada, incluyendo mapeo de IPs restringido, WAF y monitoreo de logs. El despliegue en Docker Compose es adecuado para desarrollo local y pruebas intermedias, pero no es suficiente para entornos de producción a gran escala.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.