> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceitos principais

> Sessões, projetos, servidores na nuvem, execução no seu dispositivo, Harness e modelos, fontes de modelos, permissões, requer sua ação e subagentes, além do que cada área da interface faz.

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](https://docs.aihubmix.com/pt/cloud/sessions/start-a-session.md) e [Gerenciar sessões](https://docs.aihubmix.com/pt/cloud/sessions/manage-sessions.md).

## 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](https://docs.aihubmix.com/pt/cloud/environments/projects.md).

## 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.

| | Servidor na nuvem | No seu dispositivo |
| - | - | - |
| Ambiente e arquivos usados | A cópia do projeto e o ambiente do projeto no servidor na nuvem | O ambiente e as pastas de projeto nesse computador |
| Projetos disponíveis | Projetos na nuvem, sessões sem projeto | Projetos locais nesse computador, sessões sem projeto |
| Harnesses compatíveis | Todos | Por enquanto, somente Claude Code |
| Computador desligado ou offline | Não é afetado | A tarefa atual é pausada e retomada automaticamente após a reconexão |

Você escolhe o local de execução ao criar uma sessão e não pode alterá-lo depois. Consulte [Servidor na nuvem](https://docs.aihubmix.com/pt/cloud/environments/cloud-host.md) e [Executar no seu dispositivo](https://docs.aihubmix.com/pt/cloud/environments/your-device.md).

## 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](https://docs.aihubmix.com/pt/cloud/models/choose-a-model.md).

## Fontes de modelos

A **fonte de modelos** determina quem fornece o modelo e onde o uso é contabilizado.

| | Modelos Plus | Suas assinaturas | BYOK |
| - | - | - | - |
| O que é | Modelos incluídos no plano Plus | As suas próprias contas de assinatura do ChatGPT, Claude ou outras | API keys que você mesmo adiciona |
| Onde o uso é contabilizado | No plano Plus, sem cobrança extra | Na cota dessa conta de assinatura | No provedor correspondente, cobrado pelos preços dele |

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](https://docs.aihubmix.com/pt/cloud/models/model-sources.md).

## 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](https://docs.aihubmix.com/pt/cloud/sessions/work-with-agent.md).

## 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](https://docs.aihubmix.com/pt/cloud/sessions/subagents.md).

## 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.

> [!NOTE]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.