Cua: habilitando agentes de IA para executar aplicativos com segurança em sandboxes do macOS/Linux

Introdução geral

O Cua é um projeto de código aberto chamado Computer-Use Agent, que se pronuncia "koo-ah". Ele foi projetado para dispositivos Apple Silicon, pode criar e executar máquinas virtuais macOS e Linux de alto desempenho, com velocidade próxima à do dispositivo nativo 90%. O Cua usa a tecnologia Virtualization.Framework da Apple, ao mesmo tempo em que oferece suporte a agentes de IA no ambiente virtual para realizar tarefas como navegar na Web e escrever códigos. O projeto enfatiza o isolamento seguro e a proteção do sistema principal do usuário. Ele está disponível no GitHub sob a licença MIT para desenvolvedores, entusiastas de tecnologia e pesquisadores de IA.

Lista de funções

• Crie e execute máquinas virtuais do macOS e do Linux no Apple Silicon.
• Oferece virtualização de alto desempenho com velocidades nativas de até 90%.
• Oferece suporte ao controle de agentes de IA de máquinas virtuais para operações complexas, como navegação e codificação.
• Certifique-se de que as máquinas virtuais estejam completamente isoladas do sistema principal para fins de segurança.
• Ferramentas de linha de comando (Lume CLI) e bibliotecas Python são fornecidas para facilitar o gerenciamento de VMs e agentes de IA.
• Suporte para integração de vários modelos de linguagem (LLM), por exemplo, OpenAI, Anthropic.
• Estrutura de código aberto que permite aos usuários personalizar imagens e recursos de máquinas virtuais.

Usando a Ajuda

A instalação e o uso da Cua são divididos em duas partes: gerenciamento de máquinas virtuais (Lume CLI) e funcionalidade completa do agente de IA. Veja a seguir as etapas detalhadas.

Requisitos do sistema

• Dispositivo: Mac com Apple Silicon (M1/M2/M3/M4).
• Sistema: macOS 14 (Sonoma) ou posterior.
• Python: 3.10 ou superior (somente funcionalidade de agente de IA).
• Espaço em disco: recomenda-se 40 GB ou mais para armazenar imagens de máquinas virtuais.

Processo de instalação

Opção 1: Instalar somente o Lume CLI (gerenciamento de máquinas virtuais)

1. Abra o terminal e verifique se a rede está aberta.
2. Digite o comando para instalar o Lume:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

3. Após a conclusão da instalação, digite lume --version Verifique a versão para ter certeza de que a instalação foi bem-sucedida.

Opção 2: Instalar a funcionalidade completa do AI Agent

1. Instale primeiro o Lume CLI (como nas etapas acima).
2. Instale a biblioteca Python:

pip install cua-computer cua-agent

3. Se precisar de mais funcionalidades, você poderá instalar outras bibliotecas, como a:

pip install cua-core cua-computer-server cua-som pylume

Funções principais

Criação e execução de máquinas virtuais

1. Digite-o no terminal:

lume run macos-sequoia-vanilla:latest

Isso fará o download e iniciará a máquina virtual do macOS Sequoia.
2 Quando a máquina virtual for iniciada, você verá uma área de trabalho separada.
3. pressione Ctrl+C Pare a máquina virtual.

Usando o AI Agent

1. Ambiente de configuração
   Depois de instalar a biblioteca de agentes de IA, crie .env adicione a chave do modelo. Exemplo:

OPENAI_API_KEY=你的密钥

2. exemplo de execução
   Na seção notebooks Localize o código de amostra na pasta, por exemplo:

• Abra um terminal e execute-o:

  python -m cua_agent.examples.basic_agent
  

• O agente de IA reconhece a interface da VM a partir da captura de tela e executa a tarefa.

3. Tarefas personalizadas
   Edite o script Python para definir ações específicas do agente, como navegar em uma página da Web ou clicar em um botão.

Gerenciamento de máquinas virtuais

• Espelhos de listas::

lume images

• Excluir espelho::

lume rm macos-sequoia-vanilla:latest

Operação da função em destaque

Virtualização de alto desempenho

A Cua usa o Virtualisation.Framework da Apple para obter um desempenho quase nativo sem nenhuma configuração adicional. A execução dos testes do Geekbench mostra que a máquina virtual pode ter um desempenho nativo de até 90%.

isolamento seguro

Cada VM é executada em uma área restrita separada. A operação do agente de IA não afeta o sistema principal, o que o torna adequado para testar códigos ou aplicativos inseguros.

Integração do LLM

A Cua suporta a conexão de vários modelos de idiomas. Os usuários só precisam instalar a biblioteca correspondente e configurar a chave. Por exemplo:

• Use Anthropic:

pip install "cua-agent[anthropic]"
export ANTHROPIC_API_KEY=你的密钥

Uso avançado

1. Ver documento
   Visite o site do GitHub docs/Getting-Started.md talvez libs/*/README.mdpara obter detalhes sobre o uso.
2. Executar o exemplo do Notebook
   download notebooks no Jupyter Notebook para experimentar uma demonstração do agente de IA corrigindo um problema do GitHub ou clonando um aplicativo.
3. Código de contribuição
   consulta CONTRIBUTING.mdEnvie novos recursos ou corrija problemas.

advertência

• Compatível somente com Apple Silicon, não é compatível com Macs Intel.
• Imagens de máquinas virtuais maiores (por exemplo, o macOS requer de 20 a 30 GB), verifique se você tem espaço suficiente em disco.
• Os agentes de IA exigem uma rede estável e uma chave de API válida.

cenário do aplicativo

1. Desenvolvimento e teste de software
   Os desenvolvedores usam o Cua para criar várias máquinas virtuais para testar aplicativos no macOS e no Linux.
2. Trabalho automatizado de IA
   Configure um agente de IA para automatizar a raspagem de dados da Web ou tarefas de organização de documentos.
3. Educação e experimentação
   Estudantes ou pesquisadores executam códigos em ambientes isolados para aprender técnicas de virtualização ou IA.

QA

1. Quais sistemas operacionais são compatíveis com o Cua?
   O macOS e o Linux são compatíveis, mas o Windows não.
2. Qual é a velocidade de execução da máquina virtual?
   90% quase nativo, garantido pela Apple Silicon and Virtualisation.
3. Como faço para participar da comunidade?
   Acesse o Discord (https://discord.com/invite/mVnXXpdE85) para compartilhar ideias ou pedir ajuda.