# Troubleshooting: Falha de comunicação do Agente

### Introdução

Este documento descreve o troubleshooting para falha de comunicação do Agente, quando o agente instalado não se comunica com o **Skyone Studio**, apresenta status “**Offline**” ou falha na execução de integrações locais, mesmo com o serviço em execução.

São abordadas as causas mais comuns, os requisitos de rede necessários e um passo a passo para diagnóstico e correção, finalizando com um checklist para validação da resolução do problema.

#### O que vamos encontrar

* [Problema](#problema)
* [Causas mais comuns](#causas-mais-comuns)
* [Requisitos de rede](#requisitos-de-rede-firewall)
* [Passo a passo](#passo-a-passo-para-resolucao)
* [Checklist](#checklist-de-finalizacao)

***

### Problema

O Agente instalado não se comunica com o **Skyone Studio**, apresenta status "**Offline**" ou falha ao tentar executar integrações locais, mesmo com o serviço rodando.

### Causas Mais Comuns

* Bloqueio de Firewall (Portas ou Endereços não liberados).
* O Agente não está instalado na infraestrutura local do cliente (Erro de Arquitetura).
* Configuração incorreta de IP (Apontamento externo ao invés de interno).

### Requisitos de Rede (Firewall)

Para o correto funcionamento, é mandatório que a rede permita tráfego de **saída** para os destinos abaixo:

#### Endereços (Domains/Hosts)

A regra de firewall deve permitir acesso aos seguintes endereços da Skyone:

* `app-v2.integrasky.cloud`
* `api-v2.integrasky.cloud`
* `agent-proxy.integrasky.cloud`
* `amqp.integra.skyone.tools`

#### Portas (TCP)

* **443** - HTTPS (Comunicação API/Web)
* **5671** - AMQPS (Mensageria Segura)

***

### Passo a Passo para Resolução

Siga a ordem abaixo para diagnosticar e corrigir:

#### Passo 1: Teste de Conectividade (Validação do Firewall)

Antes de verificar a instalação, valide se o servidor consegue chegar nos endereços da Skyone. Execute os testes abaixo na máquina do Agente:

**Teste Porta 443 (HTTPS)**:

`telnet agent-proxy.integrasky.cloud 443`

(Se conectar, a tela ficará preta ou o cursor piscará. Se der erro, o firewall está bloqueando).

**Teste Porta 5671 (AMQP)**:

`telnet amqp.integra.skyone.tools 5671`

**Opção via PowerShell (Windows)**:

```
- Test-NetConnection -ComputerName agent-proxy.integrasky.cloud -Port 443
- Test-NetConnection -ComputerName amqp.integra.skyone.tools -Port 5671
```

**Busque pelo resultado**:

`TcpTestSucceeded : True`

***

#### Passo 2: Validar Local de Instalação (Arquitetura)

O Agente deve estar instalado em um servidor dentro da infraestrutura On-Premise que devemos acessar.

**Erro comum**:

Instalar o agente em uma máquina na nuvem (AWS/Azure) tentando acessar o banco/servidor do cliente via IP Público. Isso não funcionará corretamente para este cenário.

**Solução**:

Mover a instalação para um servidor na mesma rede local da aplicação.

***

#### Passo 3: Configuração do Host no Agente

No arquivo de configuração, confirme se o terminal está preenchido com o agente instalado e verifique o apontamento para o sistema do cliente.

O Agente deve apontar para o **IP Local (Rede Interna)**.

* **Correto**: 10.10.x.x ou hostname-interno
* **Incorreto**: IPs Públicos, DNS Externos ou rotas via internet

***

### Checklist de Finalização

O problema é considerado resolvido quando:

* [ ] O comando telnet ou `Test-NetConnection` retorna sucesso nas portas **443** e **5671**.
* [ ] O Agente está instalado fisicamente/virtualmente na infraestrutura local 
* [ ] Acessa o IP Local do servidor da aplicação.
* [ ] O Status no Studio consta como “**Online**”.

***

### Conclusão

A falha de comunicação do Agente geralmente está relacionada a configurações de rede, local de instalação ou ao endereçamento  de IP. Seguindo o passo a passo e validando os itens do checklist, é possível garantir que o agente se comunique corretamente com o **Skyone Studio** e apresente status “**Online**”.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/how-to/troubleshooting-falha-de-comunicacao-do-agente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.