188 lines
5.7 KiB
Markdown
188 lines
5.7 KiB
Markdown
# Sistema de Orquestación Multi-Agente TZZR v3
|
|
|
|
## Descripción General
|
|
|
|
El Sistema de Orquestación Multi-Agente TZZR es una arquitectura distribuida diseñada para coordinar múltiples agentes especializados en la gestión de contratos, análisis legal y automatización de procesos. Este sistema permite la colaboración eficiente entre diferentes componentes mediante un coordinador central.
|
|
|
|
## Arquitectura del Sistema
|
|
|
|
### Agente Coordinador: ARCHITECT
|
|
- **Función**: Coordinador central del sistema
|
|
- **Servidor**: tzzrarchitect.me (69.62.126.110)
|
|
- **Responsabilidades**:
|
|
- Coordinar trabajo entre todos los agentes
|
|
- Consolidar información y resultados
|
|
- Mantener repositorios actualizados en Gitea
|
|
- Gestionar infraestructura compartida
|
|
|
|
### Agentes Especializados
|
|
|
|
#### 1. CLARA (Análisis Legal)
|
|
- **Especialidad**: Análisis de contratos y documentos legales
|
|
- **Capacidades**:
|
|
- Extracción de términos contractuales
|
|
- Identificación de riesgos legales
|
|
- Análisis de compliance
|
|
- Generación de reportes legales
|
|
|
|
#### 2. MASON (Construcción y Desarrollo)
|
|
- **Especialidad**: Desarrollo de software y sistemas
|
|
- **Capacidades**:
|
|
- Implementación de código
|
|
- Gestión de repositorios
|
|
- Automatización de procesos
|
|
- Integración de sistemas
|
|
|
|
#### 3. FELDMAN (Análisis Financiero)
|
|
- **Especialidad**: Análisis financiero y económico
|
|
- **Capacidades**:
|
|
- Análisis de costos contractuales
|
|
- Evaluación financiera
|
|
- Reportes económicos
|
|
- Gestión de presupuestos
|
|
|
|
## Infraestructura Técnica
|
|
|
|
### Servidor Principal (ARCHITECT)
|
|
- **IP**: 69.62.126.110
|
|
- **Dominio**: tzzrarchitect.me
|
|
- **Servicios Desplegados**:
|
|
- **Gitea**: Control de versiones y repositorios
|
|
- **Windmill**: Automatización de workflows
|
|
- **PostgreSQL**: Base de datos principal
|
|
- **Directus**: CMS y API headless
|
|
|
|
### Repositorios en Gitea
|
|
- **system**: Configuraciones del sistema central
|
|
- **contratos-comunes**: Templates y contratos base
|
|
- **clara**: Código y configuraciones del agente CLARA
|
|
- **mason**: Código y configuraciones del agente MASON
|
|
- **feldman**: Código y configuraciones del agente FELDMAN
|
|
- **credentials**: Gestión segura de credenciales
|
|
- **architect**: Documentación y código del coordinador
|
|
|
|
## Flujo de Trabajo
|
|
|
|
### 1. Coordinación Central
|
|
```
|
|
Usuario/Sistema → ARCHITECT → Distribución a Agentes → Consolidación → Resultado
|
|
```
|
|
|
|
### 2. Proceso de Análisis de Contratos
|
|
1. **Ingesta**: ARCHITECT recibe documento contractual
|
|
2. **Distribución**: Asigna tareas específicas a cada agente:
|
|
- CLARA: Análisis legal y compliance
|
|
- FELDMAN: Evaluación financiera
|
|
- MASON: Implementación de sistemas de seguimiento
|
|
3. **Consolidación**: ARCHITECT recopila y consolida resultados
|
|
4. **Entrega**: Genera reporte unificado
|
|
|
|
### 3. Gestión de Estado
|
|
- Cada agente mantiene su estado local
|
|
- ARCHITECT centraliza estados globales
|
|
- Sincronización mediante Gitea
|
|
- Backups automáticos en PostgreSQL
|
|
|
|
## Protocolos de Comunicación
|
|
|
|
### Reportes de Agentes
|
|
Los agentes especializados envían reportes a ARCHITECT con:
|
|
- Estado de tareas asignadas
|
|
- Resultados de análisis
|
|
- Errores o excepciones
|
|
- Recomendaciones de acción
|
|
|
|
### Formato de Comunicación
|
|
```json
|
|
{
|
|
"agent": "clara|mason|feldman",
|
|
"timestamp": "ISO-8601",
|
|
"task_id": "unique_identifier",
|
|
"status": "pending|in_progress|completed|error",
|
|
"results": {},
|
|
"recommendations": [],
|
|
"next_actions": []
|
|
}
|
|
```
|
|
|
|
## Seguridad y Acceso
|
|
|
|
### Gitea
|
|
- **URL**: https://git.tzzr.me (HTTP: http://69.62.126.110:3000)
|
|
- **Acceso**: ARCHITECT tiene permisos de escritura completos
|
|
- **Token**: Configurado para operaciones automatizadas
|
|
- **Backup**: Branches automáticos antes de cambios importantes
|
|
|
|
### Credenciales
|
|
- Repositorio dedicado para gestión segura
|
|
- Rotación automática de tokens
|
|
- Acceso basado en roles por agente
|
|
|
|
## Monitoreo y Logs
|
|
|
|
### Sistemas de Monitoreo
|
|
- Windmill para workflows automatizados
|
|
- PostgreSQL para persistencia de logs
|
|
- Directus para dashboard de administración
|
|
|
|
### Métricas Clave
|
|
- Tiempo de respuesta por agente
|
|
- Tasa de éxito de tareas
|
|
- Utilización de recursos
|
|
- Errores y excepciones
|
|
|
|
## Escalabilidad y Mantenimiento
|
|
|
|
### Escalabilidad Horizontal
|
|
- Nuevos agentes pueden agregarse al ecosistema
|
|
- Balanceo de carga mediante ARCHITECT
|
|
- Distribución geográfica de agentes
|
|
|
|
### Mantenimiento
|
|
- Actualizaciones centralizadas vía Gitea
|
|
- Rollback automático en caso de fallos
|
|
- Documentación versionada
|
|
|
|
## Casos de Uso
|
|
|
|
### 1. Análisis Integral de Contratos
|
|
- Ingesta automática de documentos
|
|
- Análisis paralelo por especialistas
|
|
- Reporte consolidado en tiempo real
|
|
|
|
### 2. Gestión de Compliance
|
|
- Monitoreo continuo de regulaciones
|
|
- Alertas automáticas de cambios
|
|
- Actualización de políticas internas
|
|
|
|
### 3. Automatización de Procesos Legales
|
|
- Generación automática de contratos
|
|
- Validación de términos y condiciones
|
|
- Seguimiento de vencimientos y renovaciones
|
|
|
|
## Roadmap v3
|
|
|
|
### Mejoras Planificadas
|
|
- [ ] Integración con IA generativa para drafting
|
|
- [ ] API REST unificada para integraciones externas
|
|
- [ ] Dashboard web para monitoreo en tiempo real
|
|
- [ ] Sistema de notificaciones multi-canal
|
|
- [ ] Análisis predictivo de riesgos contractuales
|
|
|
|
### Nuevas Capacidades
|
|
- [ ] Agente especializado en contratos internacionales
|
|
- [ ] Integración con sistemas ERP empresariales
|
|
- [ ] Automatización de firma electrónica
|
|
- [ ] Blockchain para trazabilidad contractual
|
|
|
|
## Contacto y Soporte
|
|
|
|
- **Administrador Sistema**: ARCHITECT
|
|
- **Repositorio Principal**: https://git.tzzr.me/tzzr/architect
|
|
- **Documentación**: Mantenida en Gitea
|
|
- **Issues**: Gestión vía Gitea Issues
|
|
|
|
---
|
|
|
|
*Documentación generada automáticamente por el sistema TZZR v3*
|
|
*Última actualización: Diciembre 2024* |