Repolode
Enviar
cuga-project

cuga-project/cuga-agent

Harness de agentes empresariais que transforma solicitações de negócio em ações em aplicativos, APIs e documentos, com controles de políticas e opções de implantação privada.

Ver no GitHubSite
Estrelas
1,106
Forks
207
Issues abertas
244
Último commit
há 23 horas

O que é?

CUGA é um harness de agentes generalistas de código aberto voltado à automação empresarial. Ele executa tarefas com várias etapas em interfaces web, APIs e documentos, e conecta ferramentas por meio de servidores MCP, serviços OpenAPI e funções Python. As equipes podem configurar agentes e supervisores em uma interface de gerenciamento no navegador, testar uma versão preliminar e publicar uma versão.

O projeto prioriza o controle. As políticas de execução podem bloquear intenções não permitidas, exigir aprovação humana para ferramentas selecionadas, orientar fluxos de trabalho com playbooks e aplicar proteções no nível das ferramentas antes de uma chamada ser executada. O CUGA é compatível com endpoints privados de inferência compatíveis com OpenAI, implantação no Kubernetes por meio de um Helm chart e uma imagem isolada de redes externas com modelos auxiliares pré-carregados. Componentes opcionais adicionam um serviço de eventos separado para execuções agendadas e acionadas por webhooks, e memória baseada em Evolve para reutilizar orientações sobre tarefas.

Desenvolvedores podem usar o CUGA pela CLI ou como SDK Python, por meio das classes CugaAgent e CugaSupervisor. Ele é desenvolvido com Python 3.12 e LangGraph.

Recursos principais

  • 01Conecta ferramentas por meio de servidores MCP, serviços OpenAPI e funções Python
  • 02Cinco tipos de política: Intent Guard, Playbook, Tool Approval, Tool Guide e Output Formatter
  • 03ToolGuard verifica chamadas de ferramentas antes da execução e bloqueia violações
  • 04Compatível com endpoints privados de inferência compatíveis com OpenAI e implantação em ambiente isolado de redes externas
  • 05Coordenação multiagente por meio de CugaSupervisor
  • 06Os recibos de execução informam o uso de tokens, as chamadas de modelo e de ferramentas e o tempo decorrido

Casos de uso

  • Automatizar CRM e operações de receita com etapas de aprovação para atualizações de contas
  • Responder a perguntas sobre documentos da empresa com fontes citadas
  • Coordenar agentes especializados em fluxos de trabalho entre aplicativos
  • Executar agentes em uma nuvem privada ou em um ambiente Kubernetes isolado de redes externas

Início rápido

  1. 1

    Clone o repositório

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

    Entre no diretório do projeto

    cd cuga-agent
  3. 3

    Instale as dependências com uv no Python 3.12

    uv sync --python 3.12
  4. 4

    Inicie o gerenciador com as ferramentas de CRM

    uv run cuga start manager --crm

Antes de usar

  • É necessário configurar um provedor de modelos e as credenciais em .env antes de executar o agente.
  • Os recursos completos de políticas, memória e eventos dependem de serviços opcionais e de configurações adicionais.

Em coleções

Frameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IAServidores MCP

Tópicos

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

Perguntas frequentes

O que é cuga-agent?
Harness de agentes empresariais que transforma solicitações de negócio em ações em aplicativos, APIs e documentos, com controles de políticas e opções de implantação privada. CUGA é um harness de agentes generalistas de código aberto voltado à automação empresarial. Ele executa tarefas com várias etapas em interfaces web, APIs e documentos, e conecta ferramentas por meio de servidores MCP, serviços OpenAPI e funções Python. As equipes podem configurar agentes e supervisores em uma interface de gerenciamento no navegador, testar uma versão preliminar e publicar uma versão.
cuga-agent é gratuito? Qual é a licença?
cuga-agent é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
cuga-agent ainda é mantido?
Manutenção ativa. O último commit de cuga-agent foi em 5 de nov. de 2026.
Para que posso usar cuga-agent?
Automatizar CRM e operações de receita com etapas de aprovação para atualizações de contas Responder a perguntas sobre documentos da empresa com fontes citadas Coordenar agentes especializados em fluxos de trabalho entre aplicativos Executar agentes em uma nuvem privada ou em um ambiente Kubernetes isolado de redes externas
Como instalar cuga-agent?
Clone o repositório: git clone https://github.com/cuga-project/cuga-agent.git Entre no diretório do projeto: cd cuga-agent Instale as dependências com uv no Python 3.12: uv sync --python 3.12 Inicie o gerenciador com as ferramentas de CRM: uv run cuga start manager --crm
Onde consigo cuga-agent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cuga-project/cuga-agent

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados