Saltar para o conteúdo principal
Esta página explica os conceitos que você encontrará com frequência ao usar o Cloud Agent. Os dois mais importantes são sessões e servidores na nuvem: você atribui trabalho ao agente em uma sessão, e o agente o conclui em um servidor na nuvem ou no seu computador.

Sessões

Uma sessão é o registro completo do trabalho entre você e o agente em uma tarefa, incluindo as suas mensagens, as etapas do agente, as respostas dele e as alterações que ele fez. Uma sessão pode pertencer a um projeto ou a nenhum projeto. Clique em New chat na barra lateral para iniciar uma sessão. Você pode arquivar as sessões que já concluiu e, quando quiser tentar outra direção, pode bifurcar (fork) uma nova sessão a partir de uma mensagem. Consulte Iniciar uma sessão e Gerenciar sessões.

Projetos

Um projeto é o diretório de código ou repositório ao qual uma sessão pertence. Há dois tipos:
  • Projeto na nuvem: criado na nuvem, importado do GitHub ou enviado do seu computador. Ele é executado no servidor na nuvem, e você pode configurar um ambiente para ele.
  • Projeto local: uma pasta do seu computador vinculada no aplicativo para desktop. As sessões são executadas nesse computador, e a pasta não é sincronizada com a nuvem.
Uma sessão que não está em nenhum projeto é executada em um diretório de trabalho temporário. Você pode movê-la para um projeto depois. Consulte Projetos e configuração do ambiente.

Servidor na nuvem e execução no seu dispositivo

Um servidor na nuvem é a máquina Linux dedicada com IP público incluída no Plus. As sessões executadas nele continuam quando você desliga o computador. Você pode abrir uma área de trabalho remota para acompanhar o que o agente faz ou assumir o controle. A execução no seu dispositivo (exibida na interface como Run on your device) é a outra forma de execução: o agente permanece na nuvem, mas a leitura e a gravação de arquivos e a execução de comandos acontecem no computador que você escolher, com o mesmo efeito de uma execução local. Esse computador precisa estar conectado ao aplicativo para desktop com Allow execution ativado. Você escolhe o local de execução ao criar uma sessão e não pode alterá-lo depois. Consulte Servidor na nuvem e Executar no seu dispositivo.

Harness e modelos

Um Harness é o framework que executa o agente, como Claude Code ou Codex CLI. Um modelo é o modelo de linguagem de grande porte que o Harness chama. Depois que uma sessão envia a primeira mensagem, não é possível alterar o Harness, mas ainda é possível alterar o modelo. O nível de raciocínio (exibido na interface como Effort) define a profundidade com que o modelo pensa. Os níveis disponíveis variam conforme o modelo. Consulte Escolher um modelo.

Fontes de modelos

A fonte de modelos determina quem fornece o modelo e onde o uso é contabilizado. No BYOK, a AIHubMix é um provedor de gateway comum: uma API key da AIHubMix que você adiciona é cobrada da mesma forma que qualquer outra chave e não tem relação com o Plus. Consulte Fontes de modelos.

Permissões

As permissões determinam se o agente pergunta a você antes de executar uma ação. Escolha-as no canto inferior esquerdo da caixa de entrada:
  • Ask for approval: sempre pergunta a você antes de modificar arquivos fora do ambiente ou acessar a internet.
  • Approve for me: pergunta somente quando detecta uma ação potencialmente insegura.
  • Full access: acessa a internet e todos os arquivos do ambiente na nuvem sem restrições. Novas sessões usam este nível por padrão.
Você pode alterar as permissões a qualquer momento durante uma sessão.

Requer sua ação

Quando o agente para e aguarda que você aprove um comando, responda a uma pergunta, forneça um segredo ou conclua algo que ele não pode fazer por você, como entrar em uma conta, a sessão requer sua ação. A solicitação aparece acima da caixa de entrada, e a sessão também é marcada na barra lateral. Depois que você a atende, a sessão continua automaticamente. Consulte Trabalhar com o agente.

Subagentes

Um subagente é um auxiliar que o agente envia dentro da mesma sessão para cuidar de partes do trabalho em paralelo. Quando todos terminam, os resultados são incorporados à sessão principal. Você pode ver o processo de cada subagente no painel direito, mas não pode enviar mensagens diretamente a ele. Um subagente é diferente de uma sessão que você bifurca manualmente: a bifurcação cria uma sessão comum e separada. Consulte Subagentes.

Visão geral da interface

  • Barra de ícones: a coluna de ícones na extremidade esquerda da janela. Ela alterna entre Cloud Tasks, Scheduled, Projects, Cloud servers e Activity. O avatar na parte inferior abre o menu da conta.
  • Barra lateral: a lista de sessões, agrupada em Pinned, Cloud projects, Local projects e Recents.
  • Área da sessão: a área principal no centro da janela. Ela mostra as mensagens entre você e o agente, as etapas dele e os resultados.
  • Caixa de entrada: na parte inferior da área da sessão. Use-a para enviar mensagens, adicionar anexos e escolher o modelo, o nível de raciocínio e as permissões.
  • Painel direito: alterações, arquivos, prévias web, a área de trabalho remota do servidor na nuvem, o chat lateral e os subagentes são abertos aqui.
A web móvel não tem barra de ícones. As mesmas entradas ficam na parte inferior da barra lateral. Quando o painel direito é aberto, ele ocupa a página inteira.