O Bluesoft AI pode auxiliar o usuário a consultar a documentação das APIs do ERP, entender quais dados são necessários para executar uma operação e, quando permitido, realizar chamadas de API diretamente pelo chat.

Com isso, é possível pedir ajuda para tarefas como consultar rotas disponíveis, identificar campos obrigatórios, montar exemplos de requisições, cadastrar informações em lote com base em uma planilha e executar alterações no ERP usando APIs.

Como funciona

Ao receber uma solicitação relacionada a APIs, o Bluesoft AI pode consultar a documentação disponível do ERP e identificar:

  • Qual API deve ser utilizada
  • Qual método será executado, como consulta, inclusão ou alteração
  • Quais campos são obrigatórios
  • Qual formato de dados deve ser enviado
  • Quais permissões são necessárias
  • Se a rota pode ou não ser chamada pelo Bluesoft AI

Para chamadas que alteram dados, como inclusão, alteração ou exclusão, o Bluesoft AI solicita confirmação do usuário antes de executar a API. Dessa forma, o usuário consegue revisar a rota, o método, os parâmetros e o corpo da requisição antes de aprovar.

Permissões de Usuário:

3717 - Utilizar Bluesoft AI
4259 - Permitir Chamadas de API pelo BlueAI

Além dessas permissões, o usuário também precisa ter as permissões específicas da API que será consultada ou executada. Por exemplo, para alterar preço de venda via API, é necessário possuir a permissão correspondente de alteração de preço por API.

Exemplo 1: Perguntar quais dados são necessários para cadastrar um item via API

No Bluesoft AI, pergunte:

Quais dados são necessários para cadastrar um produto via API no Bluesoft ERP?

O Bluesoft AI poderá consultar a documentação da API e retornar os campos necessários, explicando quais informações são obrigatórias e como o envio deve ser estruturado.

Exemplo de variação:

Quero cadastrar um novo item via API. Consulte a documentação e me diga quais campos preciso informar para o cadastro, incluindo dados de compra, logística e e-commerce, se existirem.

Exemplo 2: Cadastrar etapas/setores de produção com base em uma planilha

Você pode enviar uma planilha com as informações que deseja cadastrar e pedir para o Bluesoft AI analisar os dados.

Exemplo de solicitação:

Enviei uma planilha com etapas de produção. Verifique quais APIs podem ser usadas para cadastrar essas etapas no ERP e me mostre um resumo do que será enviado antes de executar.

A planilha pode conter colunas como:

  • Descrição
  • Status
  • Ordem de execução
  • Observações
  • Responsável ou setor relacionado, quando aplicável

Após analisar a planilha, o Bluesoft AI pode identificar a API correspondente, validar os dados e preparar as chamadas necessárias.

Antes de executar inclusões ou alterações, o Bluesoft AI exibirá uma solicitação de confirmação. O usuário deve conferir as informações e aprovar somente se estiverem corretas.

Exemplo 3: Alterar preço de venda via API

Também é possível pedir ao Bluesoft AI para alterar preços, desde que o usuário tenha permissão para isso.

Exemplo de solicitação:

Altere o preço de venda do produto 742115 na loja 1 para R$ 2,99 usando a API do Bluesoft ERP.

O Bluesoft AI irá verificar a rota adequada, os campos necessários e solicitar confirmação antes da execução.

Exemplo de pedido mais seguro:

Antes de alterar, consulte a API de preço de venda e me mostre quais dados serão enviados para alterar o produto 742115 na loja 1 para R$ 2,99.

Após a confirmação, o Bluesoft AI poderá executar a chamada e informar se a alteração foi realizada com sucesso ou se houve alguma inconsistência retornada pela API.

Exemplo 4: Consultar documentação antes de executar uma ação

Quando o usuário não sabe exatamente qual API utilizar, pode pedir ao Bluesoft AI para investigar primeiro.

Exemplo:

Preciso cadastrar uma ordem de produção via API. Consulte a documentação do ERP e me diga qual rota devo usar, quais campos são obrigatórios e me dê um exemplo de JSON.

Outro exemplo:

Quero alterar dados de um produto via API, mas não sei qual rota usar. Consulte as APIs disponíveis e me mostre as opções.

Boas práticas

  • Sempre peça para o Bluesoft AI mostrar um resumo antes de executar alterações.
  • Para operações em lote, revise os dados da planilha antes de aprovar.
  • Use exemplos claros, informando códigos de produto, lojas, valores, datas e demais dados necessários.
  • Garanta que o usuário tenha as permissões da API que será executada.
  • Em caso de dúvida, peça primeiro para o Bluesoft AI apenas consultar a documentação e montar a requisição, sem executar.

Exemplo de prompt recomendado

Consulte a documentação da API do Bluesoft ERP para cadastrar etapas de produção.
Use os dados da planilha enviada.
Antes de executar, me mostre:
1. A rota que será utilizada
2. O método da API
3. Os registros que serão enviados
4. Os campos obrigatórios encontrados
5. Possíveis inconsistências nos dados
Depois aguarde minha confirmação para executar.

Considerações finais

O uso de APIs com o Bluesoft AI ajuda a transformar instruções em linguagem natural em ações práticas dentro do ERP. A ferramenta pode consultar a documentação, explicar os campos necessários, preparar requisições e apoiar integrações de forma mais simples.

Mesmo assim, operações que alteram dados devem ser revisadas com atenção antes da aprovação, principalmente em ações de preço, cadastro de produtos, produção, estoque e integrações em lote.