# 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="/files/QFZ4dLb5UpbS8OfdgODa" 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**](/documentation/connectors-and-triggers/pt-br/connectors/tools/jolt-v2.md): Disponível no campo **JOLT**.
* [**REST V2**](/documentation/connectors-and-triggers/pt-br/connectors/web-protocols/rest-v2.md): 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](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) (`{{ 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 %}


---

# 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.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/canvas/connector-ai-assistant.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.
