# Execute agentes em uma máquina remota

Execute agentes em outro computador enquanto trabalha no editor local.

## 1. Conecte-se ao projeto por SSH

Instale o **Remote - SSH** no VS Code e confirme que você consegue fazer login no host a partir de um terminal:

```shell
ssh user@hostname
```

Execute **Remote-SSH: Connect to Host…** na Paleta de Comandos. Conecte-se ao host e abra a pasta do projeto nessa máquina. Confira o host na barra de status do editor.

[Configuração do Remote SSH e requisitos do host ↗](https://code.visualstudio.com/docs/remote/ssh)

## 2. Prepare o ambiente remoto

Na janela conectada por SSH, abra a visão Extensões, encontre o Facade Code e instale-o no host SSH. O Window Component fica no seu computador e conecta o projeto remoto aos seus outros projetos do Facade.

No terminal integrado remoto, instale a CLI que você quer usar e conclua o login ou a configuração do provedor. Confirme que ela responde a uma solicitação ali.

| Seu computador | Máquina remota |
| --- | --- |
| Interface do editor e conexão SSH | Extensão de projeto do Facade, CLI do agente, arquivos do projeto, compilações e testes |

O agente remoto usa as ferramentas e as credenciais daquela máquina. Uma CLI instalada só no seu computador não fica disponível para um agente remoto.

## 3. Inicie o agente remoto

Abra o Facade no projeto conectado, escolha **New Agent** e selecione a CLI. Verifique se o local selecionado é a pasta do projeto remoto.

```text
Diga em qual sistema operacional e diretório do projeto você está trabalhando e como executar as verificações deste projeto.
```

Confirme que a resposta descreve o ambiente e o caminho esperados. O agente executa comandos e altera arquivos naquela máquina.

## Edite as configurações onde o agente roda

Com a pasta remota aberta, escolha **Open Settings → Facade: Home → Edit in facade.json**. Se sua janela remota abrir as configurações como JSON, **Open Settings** leva direto ao facade.json. Veja [Configurações dos agentes](https://facadecode.com/pt-br/docs/settings/) para os campos.

Prepare as chaves de API, os caminhos de executáveis e outras variáveis de ambiente na máquina remota; seu ambiente local não é transferido.

## Conecte o trabalho local e o remoto

Mantenha o projeto local e a conexão SSH abertos. Os agentes podem descobrir uns aos outros e trocar mensagens pelo Facade quando as configurações de acesso permitirem.

```text
Use o Facade para perguntar ao agente remoto em qual projeto ele está trabalhando e quais verificações estão disponíveis ali.
```

Veja [Aprovações e acesso entre agentes](https://facadecode.com/pt-br/docs/permissions/) se um agente não encontrar outro. Para acompanhar vários agentes responsáveis pelas funcionalidades, locais ou remotos, em uma única conversa, use o [padrão Facade](https://facadecode.com/pt-br/docs/collaboration/phone-led-team/).

Cada máquina tem seus próprios arquivos de projeto. Faça o checkout do mesmo commit em cada máquina antes de comparar resultados de testes entre sistemas operacionais.