Repolode
Enviar
cuga-project

cuga-project/cuga-agent

Harness de agentes empresarial que convierte solicitudes de negocio en acciones en aplicaciones, API y documentos, con controles de políticas y opciones de despliegue privado.

Ver en GitHubSitio web
Estrellas
1,123
Forks
206
Issues abiertos
244
Último commit
hace 23 horas

¿Qué es?

CUGA es un harness de agentes generalista y de código abierto, orientado a la automatización empresarial. Ejecuta tareas de varios pasos en interfaces web, API y documentos, y conecta herramientas mediante servidores MCP, servicios OpenAPI y funciones de Python. Los equipos pueden configurar agentes y supervisores desde una interfaz de administración basada en navegador, probar un borrador y publicar una versión.

El proyecto se centra en el control. Las políticas de ejecución pueden bloquear intenciones no permitidas, requerir aprobación humana para determinadas herramientas, orientar los flujos de trabajo con playbooks y aplicar controles a nivel de herramienta antes de ejecutar una llamada. Admite endpoints privados de inferencia compatibles con OpenAI, despliegues en Kubernetes mediante un chart de Helm y una imagen aislada de redes externas con modelos auxiliares precargados. Los componentes opcionales añaden un servicio de eventos independiente para ejecuciones programadas y activadas por webhooks, y memoria basada en Evolve para reutilizar las instrucciones de las tareas.

Los desarrolladores pueden usar CUGA desde la CLI o como SDK de Python mediante las clases CugaAgent y CugaSupervisor. Está construido sobre Python 3.12 y LangGraph.

Funciones clave

  • 01Conecta herramientas mediante servidores MCP, servicios OpenAPI y funciones de Python
  • 02Cinco tipos de políticas: Intent Guard, Playbook, Tool Approval, Tool Guide y Output Formatter
  • 03ToolGuard comprueba las llamadas a herramientas antes de ejecutarlas y bloquea las que incumplen las reglas
  • 04Admite endpoints privados de inferencia compatibles con OpenAI y despliegues aislados de redes externas
  • 05Coordinación multiagente mediante CugaSupervisor
  • 06Los recibos de ejecución informan del uso de tokens, las llamadas a modelos y herramientas, y el tiempo transcurrido

Casos de uso

  • Automatizar operaciones de CRM e ingresos con controles de aprobación para actualizar cuentas
  • Responder preguntas sobre documentos de la empresa con fuentes citadas
  • Coordinar agentes especializados para flujos de trabajo entre aplicaciones
  • Ejecutar agentes en una nube privada o en un entorno de Kubernetes aislado de redes externas

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/cuga-project/cuga-agent.git
  2. 2

    Entra en el directorio del proyecto

    cd cuga-agent
  3. 3

    Instala las dependencias con uv en Python 3.12

    uv sync --python 3.12
  4. 4

    Inicia el gestor con las herramientas de CRM

    uv run cuga start manager --crm

Antes de usarlo

  • Es necesario configurar un proveedor de modelos y las credenciales en .env antes de ejecutar el agente.
  • Las funciones completas de políticas, memoria y eventos dependen de servicios opcionales y de una configuración adicional.

En colecciones

Frameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IAServidores MCP

Temas

#agentic-ai#ai-agents#enterprise#mcp#openapi#guardrails#langgraph#multi-agent#agents#coding-agent

Preguntas frecuentes

¿Qué es cuga-agent?
Harness de agentes empresarial que convierte solicitudes de negocio en acciones en aplicaciones, API y documentos, con controles de políticas y opciones de despliegue privado. CUGA es un harness de agentes generalista y de código abierto, orientado a la automatización empresarial. Ejecuta tareas de varios pasos en interfaces web, API y documentos, y conecta herramientas mediante servidores MCP, servicios OpenAPI y funciones de Python. Los equipos pueden configurar agentes y supervisores desde una interfaz de administración basada en navegador, probar un borrador y publicar una versión.
¿cuga-agent es gratuito? ¿Qué licencia tiene?
cuga-agent es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿cuga-agent sigue mantenido?
Mantenimiento activo. El último commit de cuga-agent fue el 5 nov 2026.
¿Para qué puedo usar cuga-agent?
Automatizar operaciones de CRM e ingresos con controles de aprobación para actualizar cuentas Responder preguntas sobre documentos de la empresa con fuentes citadas Coordinar agentes especializados para flujos de trabajo entre aplicaciones Ejecutar agentes en una nube privada o en un entorno de Kubernetes aislado de redes externas
¿Cómo se instala cuga-agent?
Clona el repositorio: git clone https://github.com/cuga-project/cuga-agent.git Entra en el directorio del proyecto: cd cuga-agent Instala las dependencias con uv en Python 3.12: uv sync --python 3.12 Inicia el gestor con las herramientas de CRM: uv run cuga start manager --crm
¿Dónde consigo cuga-agent?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cuga-project/cuga-agent

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados