# Assistente de IA para Conectores

O **Assistente de IA para Conectores** é um recurso com tecnologia de IA disponível em conectores específicos. Ele ajuda você a configurar suas integrações mais rapidamente, gerando conteúdos de configuração com base nas informações e no contexto fornecidos.

## **Como usar o Assistente de IA para Conectores**

Nos conectores compatíveis, você verá o botão **Escreva com IA**. Isso indica que o conector possui campos que podem ser configurados com o auxílio da inteligência artificial.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2F0XrREmA8cdegpwBgs4dI%2Fconnector-level-helper-pt.gif?alt=media&#x26;token=7080505e-0574-4752-8456-c84141099d79" alt=""><figcaption></figcaption></figure>

Ao clicar no botão, um painel lateral será aberto ao lado do formulário de configuração do conector. Nesse painel, você poderá fornecer as seguintes informações:

* **Entrada**: Insira ou envie um arquivo JSON representando o dado de entrada esperado.
* **Saída**: Insira ou envie um arquivo JSON representando o resultado desejado.
* **Prompt**: Forneça um contexto adicional ou instruções para orientar a IA.

A IA analisará os dados e gerará uma resposta diretamente no formulário de configuração do conector.

{% hint style="info" %}
É possível refinar a resposta da IA até 5 vezes. Após isso, será necessário redefinir a IA para continuar.
{% endhint %}

### **Quais são os conectores compatíveis?**

* [**Transformer (JOLT) V2**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/connectors/tools/jolt-v2): Disponível no campo **JOLT**.
* [**REST V2**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/connectors/web-protocols/rest-v2): Disponível no campo **Body** ao realizar a operação **POST**.

## **Exemplos de uso do Assistente de IA**

### **Transformer (JOLT) V2**

Suponha que você queira enriquecer os dados de um cliente adicionando uma data de nascimento padrão.

#### **Configuração com IA**

**Entrada:**

```json
{
  "cliente": {
    "nome": "Cliente Padrão",
    "cpf": "123.456.789.10"
  }
}
```

**Saída:**

```json
{
  "cliente": {
    "nome": "Cliente Padrão",
    "cpf": "123.456.789.10",
    "dataNascimento": "01/01/1970"
  }
}
```

**Prompt:**

Certifique-se de que o JSON de saída inclua o campo `dataNascimento`, mesmo que ele esteja ausente na entrada.

#### **Resposta gerada pela IA**

A IA pode gerar a seguinte especificação JOLT:

```json
[
  {
    "operation": "default",
    "spec": {
      "cliente": {
        "dataNascimento": "01/01/1970"
      }
    }
  }
]
```

{% hint style="info" %}
As respostas da IA são generativas, o que significa que a estrutura e a formulação podem variar ligeiramente entre as tentativas.
{% endhint %}

### **REST V2**

Suponha que você queira transformar as informações do usuário em um objeto de transação, mapeando diretamente o `id`, `email` e `nome` do usuário, enquanto preenche o campo `cargo` com uma [expressão Double Braces](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/double-braces) (`{{ message.cargo.id }}`).

#### **Configuração de IA**

**Entrada:**

```json
{
  "usuario": {
    "nome": "Alice",
    "email": "alice@exemplo.com",
    "id": 123
  }
}
```

**Saída:**

```json
{
  "transacao": {
    "id_usuario": "",
    "contato": {
      "email": "",
      "nome_completo": ""
    },
    "cargo": ""
  }
}
```

**Prompt:**

Preencha o objeto **`"transacao"`** com os dados do usuário de entrada (sem Double Braces):

* `"id_usuario"` = usuario.id
* `"contato.email"` = usuario.email
* `"contato.nome_completo"` = usuario.nome
* `"cargo"` = `{{ message.cargo.id }}`

{% hint style="warning" %}
Por padrão, os campos vazios são preenchidos com expressões Double Braces. Se não quiser que isso aconteça, especifique no prompt.
{% endhint %}

#### **Resposta gerada pela IA**

A IA pode produzir o seguinte JSON:

```json
{
  "transacao": {
    "id_usuario": 123,
    "contato": {
      "email": "alice@example.com",
      "nome_completo": "Alice"
    },
    "cargo": "{{ message.cargo.id }}"
  }
}
```

{% hint style="info" %}
As respostas da IA são generativas, portanto a estrutura e a redação podem variar ligeiramente entre as tentativas.
{% endhint %}
