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

# Iniciar uma sessão

> Escreva uma tarefa, escolha o projeto, o local de execução, o modelo e as permissões, adicione anexos ou capturas de tela e entregue o trabalho ao agente.

Uma **sessão** é o registro completo do trabalho entre você e o agente em uma tarefa. Esta página explica como iniciar uma sessão e quais opções você pode ajustar antes de enviar. Para saber como trabalhar em conjunto depois que a sessão começa, consulte [Trabalhar com o agente](https://docs.aihubmix.com/pt/cloud/sessions/work-with-agent.md).

## Iniciar uma sessão

**1. Abra um novo chat**

Clique em **New chat** no topo da barra lateral ou pressione `⌘N` (`Ctrl+N` no Windows). Se você começar pelo **＋** ao lado de um projeto na barra lateral ou por **New task in this project** na página de um projeto, esse projeto já fica selecionado.

**2. Escreva o que você quer que seja feito**

Descreva a tarefa na caixa de entrada, por exemplo "Corrija o campo de entrada desalinhado na página de entrada no Safari e adicione testes." Pressione `Shift+Enter` para uma nova linha. Digite `/` no início para inserir um comando de barra. Para saber como escrever tarefas claras, consulte [Escrever boas tarefas](https://docs.aihubmix.com/pt/cloud/sessions/writing-tasks.md).

**3. Confirme o projeto e o local de execução**

O projeto atual e o local de execução aparecem acima da caixa de entrada. Clique neles para alterar, conforme descrito abaixo.

**4. Ajuste as permissões e o modelo, se necessário**

As permissões ficam no canto inferior esquerdo da caixa de entrada. O modelo e o nível de raciocínio ficam no canto inferior direito.

**5. Envie**

Pressione `Enter` ou clique no botão de envio. A sessão aparece na barra lateral, a página abre a sessão e o agente começa a trabalhar.

![Caixa de entrada na página de novo chat](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/home.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=049b3a780d55363ae4c591ef0758e101)

Novo chat: o projeto e o local de execução ficam acima da caixa de entrada, e as permissões e o modelo ficam abaixo dela

> [!NOTE]
>
> Enviar uma sessão exige o Plus. Se você ainda não o ativou, clique no botão de upgrade na resposta para assinar, e a sua mensagem é enviada automaticamente. Consulte [Plano Plus e uso](https://docs.aihubmix.com/pt/cloud/account/plus.md).

## Escolher um projeto

Clique no botão de projeto acima da caixa de entrada para pesquisar e selecionar um projeto, ou clique em **New project**. Um novo chat não lembra a sua última escolha e sempre começa com **No project**. Pressionar `⌥⌘O` (`Ctrl+Alt+O` no Windows) também abre diretamente um novo chat sem projeto.

* **Escolher um projeto**: a sessão começa no diretório de trabalho atual do projeto. Para saber como criar e configurar projetos, consulte [Projetos e configuração do ambiente](https://docs.aihubmix.com/pt/cloud/environments/projects.md).
* **Sem projeto**: a sessão é executada em um diretório de trabalho temporário, o que é adequado para perguntas e respostas, escrita de um script ou organização de informações. Você pode movê-la para um projeto depois. Consulte [Gerenciar sessões](https://docs.aihubmix.com/pt/cloud/sessions/manage-sessions.md).

Quando você escolhe um projeto local em outro computador, a sessão é executada nesse computador.

## Escolher um local de execução

O **local de execução** determina em qual máquina o agente lê e grava arquivos e executa comandos. O próprio agente é sempre executado na nuvem.

* **Cloud server**: executa no seu [servidor na nuvem](https://docs.aihubmix.com/pt/cloud/environments/cloud-host.md) do início ao fim, sem passar pelo seu computador, e continua quando você desliga o computador. Novas sessões usam esta opção por padrão.
* **Run on your device**: depois que você escolhe um dispositivo, o agente na nuvem usa remotamente o ambiente e os arquivos desse computador. O computador precisa estar online e permitir a execução. Por padrão, projetos locais são executados no dispositivo em que o projeto está.

O local de execução é definido no envio, e não é possível alterá-lo depois que a sessão começa. Para usar outra máquina, crie uma nova sessão. Para saber por que um dispositivo não pode ser selecionado e como autorizá-lo, consulte [Executar no seu dispositivo](https://docs.aihubmix.com/pt/cloud/environments/your-device.md).

## Escolher um modelo

Clique no botão de modelo no canto inferior direito da caixa de entrada para escolher um modelo. O botão ao lado ajusta o effort (nível de raciocínio). Novas sessões usam a escolha padrão da sua conta ou a escolha da última sessão que você criou. Para saber como os modelos diferem e como escolher, consulte [Escolher um modelo](https://docs.aihubmix.com/pt/cloud/models/choose-a-model.md).

## Escolher as permissões

As **permissões** determinam se o agente pergunta a você antes de executar uma ação. Clique no botão de permissões no canto inferior esquerdo da caixa de entrada:

| Permissão | O que o agente faz |
| - | - |
| **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 **Full access** por padrão e sempre começam pelo padrão, sem lembrar a sua última escolha. Você pode alterá-la no mesmo lugar a qualquer momento depois que a sessão começa.

![Menu de permissões](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/permission-menu.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=c507b54ffe41f3881d4155b9eac737be)

Escolha as permissões no canto inferior esquerdo da caixa de entrada

### Sobre o acesso total

Com acesso total, o agente pode executar comandos, instalar dependências, modificar arquivos, acessar a internet e os serviços conectados e ler todos os segredos deste projeto sem perguntar a você. Esta é a opção mais eficiente, mas traz riscos como vazamento de dados sensíveis e injeção de prompt. Para saber quando ela é adequada, consulte [Escrever boas tarefas](https://docs.aihubmix.com/pt/cloud/sessions/writing-tasks.md).

* Na primeira vez que você envia com acesso total, aparece uma explicação. Clique em **Got it, start the task** para enviar. Ela não aparece novamente.
* Na execução no seu dispositivo, mudar para acesso total exige clicar primeiro em **Confirm** em uma caixa de diálogo.
* Na execução no seu dispositivo, as permissões não podem exceder o limite definido para esse dispositivo, e as opções acima dele não podem ser selecionadas. O limite só pode ser alterado no aplicativo para desktop desse dispositivo.
* Quando os privilégios de administrador do servidor na nuvem estão ativados, na primeira vez que você envia no servidor na nuvem é solicitada uma confirmação. Consulte [Servidor na nuvem](https://docs.aihubmix.com/pt/cloud/environments/cloud-host.md).

Se você clicar em **Cancel** nessas caixas de diálogo, a mensagem não é enviada, e o texto e os anexos permanecem na caixa de entrada.

## Adicionar anexos e capturas de tela

Clique em **＋** no canto inferior esquerdo da caixa de entrada (`⌘U`, `Ctrl+U` no Windows) e escolha **Upload files or images** ou **Take a screenshot**. Você também pode arrastar arquivos para a caixa de entrada ou colá-los. É possível enviar anexos sem nenhum texto.

| Limite | Máximo |
| - | - |
| Anexos por mensagem | 10 |
| Imagem individual (PNG, JPEG, WebP, GIF) | 5 MB |
| Outro arquivo individual | 25 MB |
| Tamanho total dos anexos por mensagem | 100 MB |

Arquivos acima dos limites e arquivos vazios não são adicionados. Os demais são adicionados normalmente. Imagens HEIC, HEIF e TIFF são convertidas automaticamente para JPEG. Não é possível enviar até que os anexos estejam prontos.

> [!NOTE]
>
> Quando uma sessão é executada **neste computador**, os arquivos adicionados no aplicativo para desktop vão diretamente para o agente sem upload e não contam para o limite de 100 MB. Ao adicionar anexos no aplicativo web a uma sessão executada em um dispositivo, você só pode adicionar imagens. Adicione arquivos pelo aplicativo para desktop.

As imagens capturadas com **Take a screenshot** viram anexos diretamente:

* **Aplicativo para desktop no macOS**: arraste para selecionar uma área, pressione a barra de espaço para capturar uma janela ou pressione `Esc` para cancelar. Na primeira vez que você captura a janela de outro aplicativo, o sistema pede que você conceda a permissão de gravação de tela.
* **Aplicativo para desktop no Windows**: captura a tela em que o aplicativo está.
* **Aplicativo web**: escolha uma visualização no seletor de compartilhamento de tela do navegador, e um único quadro daquele momento é capturado. Se o navegador não for compatível com o compartilhamento de tela, esta opção fica indisponível.

Se você tiver problemas ao enviar, consulte [Perguntas frequentes e solução de problemas](https://docs.aihubmix.com/pt/cloud/reference/troubleshooting.md).


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