> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/skyone-studio/data-management/engine/como-utilizar-o-proxy-para-data-engine.md).

# Como utilizar o Proxy para Data Engine

A funcionalidade "**Proxy para Data Engine**" simplifica a integração dos dados externos com o Data Stack. Ela pode ser utilizada como geração de arquivos estruturados (como JSON) para uso posterior no **Skyone Studio**.

{% hint style="info" %}
Essa funcionalidade está em módulos do tipo REST.
{% endhint %}

### Como acessar

Na área de edição do fluxo, selecione "**Editar**" no módulo REST. Por padrão, a opção "**Proxy para Data Engine**" está desativada. Clique no botão para ativá-la.

<figure><img src="/files/pgIntybLx1ZLyHd8X0IA" alt=""><figcaption></figcaption></figure>

Após ativar o "**Proxy para Data Engine**", o botão "**Configurar**" ficará habilitado.

### Configuração do Data Proxy

Para configurar o "**Proxy para Data Engine**", siga os seguintes passos:

1. Clique no botão "**Configurar**", localizado no lado direito do "**Proxy para Data Engine**".
2. Será mostrada a tela de configurações globais:

<figure><img src="/files/EQY0WhA1JgZ7zMH99E5X" alt=""><figcaption></figcaption></figure>

&#x20;Sendo que:

* **Formato de arquivo:** Escolha entre Parquet, CSV, JSON ou Excel.

{% hint style="danger" %}
Este formato será aplicado à resposta estruturada do Proxy. Escolha o formato compatível com os dados retornados para evitar erros.
{% endhint %}

* **Nome do arquivo:** Adicione um nome.
* **Grupos de leitura:** Escolha os grupos que poderão ler o arquivo. Por padrão, é o grupo '*default*'. Saiba mais em [Grupos](/skyone-studio/visao-geral/configuracoes-e-preferencias/usuarios-e-permissoes.md#permissoes).
* **Grupos de escrita:** Escolha os grupos que poderão escrever o arquivo. Por padrão, é o grupo 'default'. Saiba mais em [Grupos](/skyone-studio/visao-geral/configuracoes-e-preferencias/usuarios-e-permissoes.md#permissoes).
* **Tags (opcional)**: Categorize o arquivo.
* **Utilizar variáveis de retorno (opcional)**: Este é um recurso que permite extrair e utilizar valores específicos da resposta do proxy. Você pode configurar variáveis para retornar valores específicos. Ao escolher essa opção, mostra os campos "**Chave**" e "**Retorno**" para que você possa preenchê-los. A única função interna é o $count()

<figure><img src="/files/wkKYuUjzMKK7TOFqKzD1" alt=""><figcaption></figcaption></figure>

* **Destinos**: Local onde o arquivo será enviado. É possível buscar um destino na barra de busca ou adicionar um novo em "**Adicionar destino"**.&#x20;
* Ao clicar em "**Adicionar destino**", preencha os campos de "**Configurações de destino**":
  * **Tipo**
  * **Destino**
  * **Caminho**: pasta destino no **Data Stack**.

\
3\. Após preencher os campos, clique em "**Concluir**".

### Teste e validação

Após preencher os campos do módulo REST, clique em "**Próximo**".  Você será direcionado para a tela de Entradas, Saídas e Teste.&#x20;

<figure><img src="/files/KMA1MG1uTcocVkyUjYmN" alt=""><figcaption></figcaption></figure>

### Exemplo Prático: análise de vendas

Imagine que você gerencia uma equipe de vendas e precisa de um relatório detalhado ao final de cada dia para avaliar o desempenho e calcular as comissões dos seus vendedores. Em vez de coletar manualmente essas informações de diferentes fontes, você pode automatizar esse processo com o "**Proxy para Data Engine**".

Para conseguir analisar as suas vendas, você vai precisar:

* **API de Vendas:** Configure o proxy para se conectar a uma API de vendas que fornece dados consolidados ao final do dia.
* **Arquivo de Saída:** Crie arquivo com os dados retornados pela API em um arquivo JSON ou em outro formato adequado no **Data Stack**.
* **Análise e Relatórios:** Utilize o arquivo gerado para criar relatórios detalhados e realizar análises, como o cálculo das comissões dos vendedores.

{% hint style="warning" %}
Importante: O "Proxy para Data Engine" salva os dados exatamente como são retornados pela API. Sendo assim, se a estrutura dos dados retornados pela API for complexa, o arquivo gerado refletirá essa complexidade.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/data-management/engine/como-utilizar-o-proxy-para-data-engine.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.