> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Como usar integrações no Brain

> Como instalar uma integração do Marketplace e usá-la em um AI Agent ou no Canvas dentro do Brain Studio.

As integrações do Marketplace são instaladas uma vez e ficam disponíveis em todo o seu espaço de trabalho. Esta página explica as duas formas de instalá-las e as duas superfícies onde você pode usá-las: **AI Agent** e **Canvas**.

## Como instalar uma integração

### Com o Jelou Agent

Descreva o que você quer construir. O [Jelou Agent](https://docs.jelou.ai/guides/getting-started/jelou-agent.md) detecta qual integração você precisa, pede confirmação da conexão e constrói o fluxo automaticamente.

**1. Descreva o que você quer construir**

Ative o modo **Jelou Agent** no Canvas e escreva seu prompt.

Exemplos:

* "Crie um agente que consulte os últimos leads do Bitrix24 e me permita adicionar um novo por voz"
* "Crie um fluxo que cobre com Stripe e confirme o pagamento ao usuário"
* "Monte um agente que agende consultas no Google Calendar"

**2. Confirme a integração**

Se a integração não estiver instalada, o Jelou Agent a detecta e exibe um card de confirmação. Clique em **Confirmar** para conectá-la. O Jelou Agent exibe a integração como **Conectado** e continua construindo o fluxo.

**3. Clique em Drag to canvas**

O Jelou Agent gera o fluxo completo com todos os nós configurados. Clique em **Drag to canvas** para transferi-lo.

> [!NOTE]
>
> O Jelou Agent escolhe a superfície correta de acordo com o caso. Um fluxo de cobranças gera nós Canvas com a ferramenta de pagamento e suas saídas específicas. Um fluxo de CRM ou agenda gera um AI Agent com a integração configurada como ferramenta.

> [!TIP]
>
> O fluxo aparece no Canvas com todos os nós configurados.

### Pelo Marketplace

**1. Abra o Marketplace**

No Brain Studio, selecione **Marketplace** no menu lateral esquerdo.

**2. Conecte a integração**

Navegue por categorias ou use a busca. Clique na integração e depois em **Conectar**. Insira suas credenciais (API key, token) ou autorize o acesso via OAuth.

**3. Instale**

Clique em **Instalar**.

> [!TIP]
>
> A integração aparece na aba **Instaladas** do Marketplace e na barra lateral do Canvas na seção **Marketplace**.

## Como usar uma integração instalada

> [!NOTE]
>
> O habitual é usar a integração como **ferramenta** em um nó **AI Agent**: o modelo decide quando invocar cada ferramenta de acordo com a conversa. Use o **Canvas** quando o processo exigir **ramificações e saídas explícitas** (por exemplo, cobranças com vários resultados possíveis). Se você construir com o **Jelou Agent**, ele incorpora a integração na superfície que melhor se encaixa no seu caso.

### Em um AI Agent

**O caso mais frequente:** dentro de um [**nó AI Agent**](https://docs.jelou.ai/pt/guias/nodos/ai-agent.md) você dá acesso a uma ou mais integrações do Marketplace; o agente decide **quando** invocar cada ferramenta de acordo com o contexto da conversa.

É a superfície natural quando **as intenções do usuário são variadas**: o mesmo agente pode consultar um CRM, agendar no calendário ou enviar um e-mail, dependendo do que ele pedir a cada momento.

![Painel do nó AI Agent no Brain Studio: aba Ferramentas com uma integração do Marketplace adicionada e lista de tools ativáveis](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/como-usar-integraciones-en-brain/ai-agent-herramientas.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=c8b7ab8dd0917aee87a7f5e3aec12c87)

AI Agent — aba Ferramentas, integração adicionada e configuração de tools (exemplo no Brain Studio)

**1. Abra a aba Ferramentas**

No nó **AI Agent**, vá para a aba **Ferramentas** e clique em **Adicionar ferramenta**.

**2. Busque e selecione a integração**

Digite o nome da integração na busca e selecione-a.

**3. Escolha quais ferramentas ela pode usar**

* **Integração completa:** o agente acessa todas as ferramentas disponíveis.
* **Seleção individual:** ative apenas as ferramentas de que você precisa.

> [!NOTE]
>
> Algumas integrações mostram dois grupos de ferramentas dentro do **AI Agent**. Shopify, por exemplo, separa as ferramentas nativas do **Jelou Shop** (ativas por padrão) das ferramentas externas da API do Shopify (desativadas por padrão). Ative as que correspondam ao seu caso de uso.

**4. Defina o comportamento por tool**

Para cada tool ativa, configure o que o agente faz ao executá-la:

* **Nenhum:** o agente continua a conversa normalmente.
* **Executar end\_function:** o agente finaliza a tarefa ao concluir essa ação.
* **Pausar interação:** o agente espera antes de continuar, útil para validações ou confirmações intermediárias.

### No Canvas

**Use o Canvas** quando o processo precisar de **etapas ordenadas** e cada resultado exigir um **caminho diferente** no fluxo.

O caso mais claro são as **cobranças**: um pagamento pode terminar em sucesso, falha, erro de código ou erro HTTP, e o fluxo deve reagir de forma diferente para cada um. As ferramentas de pagamento expõem essas saídas; o **Canvas** permite conectar cada uma à próxima etapa adequada.

![Brain Studio: nó de integração do Marketplace no Canvas com painel Tools, salvar resposta em memória e corpo JSON](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/como-usar-integraciones-en-brain/canvas-nodo-tool.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=da4c03a3697e403664e907d7740d7925)

Canvas — nó de integração do Marketplace com tool selecionada e corpo da requisição (exemplo no Brain Studio)

**1. Arraste a integração para o Canvas**

No painel lateral esquerdo, expanda a seção **Marketplace**. Arraste a integração que você quer usar para o Canvas.

**2. Selecione a ferramenta**

No painel direito, abra o seletor **Tools** e escolha a ação que você quer executar.

As ferramentas estão etiquetadas com seu tipo:

* **Ferramenta nativa** — capacidade construída por Jelou, com saídas específicas do processo (Pagamento bem-sucedido, Pagamento falho, Código de erro, Validação bem-sucedida etc.)
* **Ferramenta externa** — ação da API do provedor, com duas saídas genéricas: Tarefa finalizada e Houve um erro

**3. Configure os inputs**

* **Ferramenta nativa:** preencha os campos do formulário (valor, motivo do pagamento, ambiente etc.).
* **Ferramenta externa:** preencha o corpo da requisição em JSON. Use `{{$memory.variable}}` para passar variáveis do fluxo.

**4. Conecte as saídas**

Conecte cada saída à próxima etapa conforme o resultado esperado.

> [!TIP]
>
> O nó mostra o nome da ferramenta selecionada quando está corretamente configurado. "Nó sem configurar" indica que falta selecionar uma ferramenta ou completar campos obrigatórios.

## Canvas vs AI Agent

Comparação rápida entre **Canvas** e **AI Agent**:

| Critério | Canvas | AI Agent |
| - | - | - |
| Controle sobre o fluxo | Total — você define cada etapa | Delegado ao agente |
| Tipo de processo | Etapas fixas com resultados específicos | Intenções variadas do usuário |
| Gestão de resultados | Explícita por nó, com saídas específicas | Gerenciada pelo agente |
| Ideal para | Cobranças, verificações de identidade, assinatura de documentos | Assistentes com múltiplas capacidades |

> [!NOTE]
>
> Canvas e AI Agent não são excludentes. Um agente pode derivar para um nó Canvas para executar uma transação que requer etapas controladas, e retomar a conversa após a conclusão.

> [card] [Integrações](https://docs.jelou.ai/pt/guias/integracoes/integracoes.md)
>
> Explore todas as integrações disponíveis organizadas por categoria.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.