Assistente de IA

Descubra os recursos do Assistente de IA disponíveis na Digibee Integration Platform.

O Assistente de IA é uma ferramenta com inteligência artificial disponível no Canvas da Digibee Integration Platform. Como parte da abordagem AI Pair Programmer, ele ajuda a acelerar tarefas demoradas, como:

• Criar a lógica de integrações

• Gerar especificações JOLT

• Documentar integrações

• Consultar a documentação para responder a perguntas específicas

Com o Assistente de IA, você pode concluir essas tarefas sem sair do ambiente em que está construindo suas integrações.

Como usar o Assistente de IA

Acesse o Assistente de IA clicando no ícone IA no menu à esquerda. Assim que abrir, você verá uma lista de opções alinhadas ao seu objetivo:

Em qualquer uma dessas opções, você pode dar feedback curtindo ou não a resposta, ajudando a melhorar nossos modelos de IA.

Estruturar um pipeline

Informe um prompt descrevendo a lógica da sua integração e receba uma estrutura de pipeline em troca. Isso inclui:

• Uma árvore de fluxo (flow tree)

• Os passos da integração

• Um resumo da estrutura

Após receber a estrutura do pipeline, você pode:

• Ajustar o fluxo pedindo alterações à IA até atingir o resultado desejado.

• Copiar o fluxo para usar em outro lugar.

• Inserir o fluxo diretamente no Canvas do seu pipeline.

Veja abaixo um guia para criar prompts eficazes.

Criar spec JOLT com exemplos

Envie o JSON de entrada para a IA. Se necessário, você pode editar o input. Depois que ele for processado, envie a saída esperada. A IA então retornará a especificação JOLT correspondente.

Após receber a especificação JOLT, você pode:

• Copiá-la e colá-la no conector Transformer (JOLT).

Se a resposta não for o que você esperava, forneça mais contexto para a IA até que o resultado esteja de acordo com sua necessidade.

Gerar documentação

Gere documentação em tempo real para seu pipeline. A IA analisa o pipeline e cria um documento com:

• Descrição do fluxo: Um resumo do que o pipeline faz.

• Sistemas externos envolvidos: Os sistemas envolvidos na integração.

• Eventos: O evento disparado pelo pipeline.

• Globals: As variáveis globais usadas nos conectores.

• Contas: As contas usadas nos conectores, com exceção do conector Object Store, no qual a identificação da conta é desabilitada devido à sua configuração padrão na Digibee Integration Platform.

Após receber o documento, você pode:

• Exportar o documento como PDF.

Obter ajuda

Faça perguntas sobre a Digibee e receba respostas com base no nosso Portal de Documentação. Isso permite acesso rápido às informações necessárias para criar, configurar e solucionar problemas nas suas integrações.

Como escrever prompts eficazes para geração de pipelines com IA

Ao usar a IA para gerar um pipeline, a forma como você descreve sua solicitação faz diferença. Fornecer detalhes claros ajuda a IA a entender suas necessidades e gerar uma estrutura precisa. Veja exemplos de bons e maus prompts abaixo.

A documentação da OpenAI oferece um guia completo sobre criação de prompts mais precisos com engenharia de prompt. Acesse a documentação para saber mais.

Prompts com conectores específicos

Se você já sabe quais conectores sua integração deve usar, mencione-os no prompt. Isso ajuda a IA a criar um pipeline mais assertivo.

Faça: Forneça detalhes claros e passo a passo.

✅ Quero criar um pipeline que comece usando o conector REST V2 para fazer uma requisição. Em seguida, use o conector Choice para avaliar a resposta da API, seguido do conector Log para registrar o resultado. Se a requisição for bem-sucedida, o pipeline deve usar o JSON Generator para criar a mensagem de saída. Se houver erro, o conector Email V2 será usado para enviar uma notificação e encerrar o fluxo.

Não faça: Seja vago ou genérico. Sem nomes de conectores, a IA pode não gerar o fluxo correto.

❌ Quero criar um pipeline que faz uma requisição para uma API, verifica a resposta e envia um e-mail se algo der errado.

Por que está vago? Não especifica quais conectores usar, qual tipo de requisição, nem o que significa “algo deu errado”.

Prompts com tipos de endpoints

Se você não sabe os conectores exatos, mas sabe os tipos de sistemas envolvidos, descreva a integração de forma geral e deixe a IA selecionar os conectores.

Faça: Mencione claramente os sistemas ou tipos de endpoints.

✅ Conecte meu sistema SAP ERP a um banco de dados e a uma API REST.

Não faça: Seja genérico demais. Se você disser apenas “sistema ERP”, a IA não saberá qual deles.

❌ Conecte meu sistema ERP a um banco de dados e a uma API REST.

Por que está vago? Sistemas ERP diferentes podem exigir conectores diferentes. Indicar o nome do sistema ajuda a IA a escolher melhor.

Prompts sem mencionar conectores

Se você não souber quais conectores usar, ainda assim pode escrever um prompt detalhado com seus objetivos. A IA determinará a melhor abordagem.

Faça: Descreva claramente as etapas do processo.

✅ Preciso criar um pipeline que leia dados de um banco de dados de streaming, publique um evento e grave os dados em outro banco. Ele começa conectando ao banco de dados de streaming para ler os dados necessários. Em seguida, os dados são publicados como evento para notificar outros sistemas ou serviços. Por fim, os dados são gravados em outro banco para armazenamento ou processamento adicional.

Não faça: Deixe de fora detalhes importantes. Um pedido vago pode gerar um pipeline incompleto ou incorreto.

❌ Preciso de um pipeline que leia dados, publique e grave em outro lugar.

Por que está vago? Não especifica que tipo de dados, de onde vêm, qual evento precisa ser publicado ou qual banco está envolvido.

Dicas adicionais

Tenha em mente ao formular seu prompt:

• Seja o mais específico possível sobre a estrutura do fluxo que deseja gerar.

• Escreva instruções claras e diretas sobre a parte ou o pipeline completo que deseja que a IA gere.

• Mencione conectores específicos, se já souber quais utilizar.

• Se o prompt for complexo, divida em partes e peça à IA que faça ajustes, se necessário.

Perguntas frequentes

Posso criar pipelines grandes com a IA?

Sim, mas a IA pode gerar alucinações ao lidar com pipelines excessivamente grandes.

A IA entende o pipeline existente no Canvas?

Não, a IA não reconhece o contexto do pipeline atual no Canvas. Ela gera conteúdo novo, sem relação com o que já existe.

A IA configura os parâmetros dos conectores?

Não, a IA não define os parâmetros dos conectores. O foco está na estrutura lógica e nas conexões entre os conectores.

Posso gerar documentação ilimitada para meu pipeline?

Não. A OpenAI processa texto com base em tokens, que são unidades de texto limitadas pela capacidade do modelo. Quando o limite é atingido, a geração de saída é interrompida.

Nosso gerador de documentação suporta até 128.000 tokens por requisição, o que cobre cerca de 500 a 600 conectores. Se esse limite for ultrapassado, a documentação não será gerada e uma mensagem de erro será exibida.

Importante:

• Os tokens são compartilhados entre todas as contas da Digibee e são reiniciados diariamente.

• Como a documentação é gerada por IA, podem ocorrer alucinações. Pipelines vazios não geram documentação nem alucinações.

Posso usar o Assistente de IA para pipelines e cápsulas?

Não. Por enquanto, o Assistente de IA está disponível apenas para pipelines. No entanto, alguns recursos com IA estão disponíveis para cápsulas. Saiba mais sobre o Assistente de IA para geração de documentação de cápsulas.

O histórico do chat é salvo no Assistente de IA?

Sim. O histórico do chat é salvo por pipeline e por usuário. Sempre que você acessar um pipeline onde já interagiu com o Assistente de IA, poderá recuperar o histórico de conversas para aquele pipeline.