Get in touch

O seu SAP, em linguagem natural, através de MCP standard

O problema

O SAP sabe a resposta. Para a obter é preciso alguém que saiba SAP.

Quem é este cliente, o que encomendou, o que ainda está em aberto, e conseguimos mesmo expedir? Todas as respostas estão no S/4HANA, espalhadas pelos ecrãs de parceiros de negócio, encomendas de venda e inventário. Preparar um simples resumo de conta implica várias transações, uma exportação e uma folha de cálculo.

Ligar um assistente de IA ao SAP significava uma integração à medida para cada sistema e para cada assistente. O Model Context Protocol (MCP) muda isso: um sistema publica as suas capacidades como ferramentas uma única vez, e qualquer agente compatível com MCP pode usá-las.

A nossa abordagem

O SAP transforma as suas APIs em ferramentas. O Ardaven liga-as por URL.

  1. Do lado do SAP. No SAP Integration Suite descrevemos três APIs standard do S/4HANA Cloud (Business Partner, Sales Order, Material Stock) e expusemos cinco operações só de leitura através do MCP Gateway. O SAP trata da autenticação, da chave de API para o backend e da governação.
  2. Do lado do Ardaven. Um administrador do workspace adiciona o gateway como servidor MCP próprio, por URL, com a identidade de máquina do agente emitida pelo SAP. O Ardaven lista as ferramentas e cada bot escolhe as que usa.
  3. O agente. O bot planeia que chamadas fazer ao SAP, encadeia-as, mostra as contas e responde em linguagem natural, com tabelas e gráficos quando ajudam.

Como tudo se liga: o gestor de conta pergunta ao Ardaven; o Ardaven chama o MCP Gateway do SAP Integration Suite com um token que renova sozinho; o gateway chama as APIs do S/4HANA Cloud

O que construímos

Cinco ferramentas, um assistente

FerramentaA que responde
search_business_partnersQuem é este cliente ou fornecedor?
get_business_partner_addressesOnde está sediado?
list_sales_ordersO que encomendou, por quanto, e o que ainda está em aberto?
get_sales_order_itemsO que consta exatamente desta encomenda?
get_material_stockTemos em stock, e onde?

Cada ferramenta é uma única chamada de leitura ao SAP. O valor está na combinação que o agente faz: uma pergunta pode tornar-se sete chamadas ao SAP em duas APIs, respondidas em menos de dez segundos.

Provado na sandbox do SAP

Uma revisão de conta, do princípio ao fim

O cenário: um gestor de conta tem amanhã uma chamada com o Domestic US Customer 1 (parceiro de negócio 17100001) e cinco minutos para se preparar. Todos os dados são os dados de demonstração públicos do SAP S/4HANA Cloud. As cinco perguntas abaixo foram feitas umas a seguir às outras numa única conversa. A animação reproduz essa conversa, redesenhada a partir da gravação para se manter nítida em qualquer tamanho; o texto e os números são os do próprio agente. Cada pergunta tem uma ligação para a resposta completa em imagem fixa. A conversa original decorreu em inglês; mais abaixo há um exemplo em português.

Um gestor de conta prepara uma chamada com um cliente em cinco perguntas: resumo, risco de entrega, tendência, uma alteração recusada e um email para o cliente

1. O resumo da conta

"Prepare a short account brief: where they're based, their 10 most recent sales orders with date, net value and status, and the total value of those 10 that aren't completed yet."

O agente consulta a morada e o histórico de encomendas, lista as encomendas e soma o valor em aberto, mostrando as contas: 9 das 10 encomendas estão em aberto, no valor de 23.078,25 USD, e uma encomenda em curso de 16.000 USD representa a maior parte.

Ver a resposta completa

2. Risco de entrega

"For the three largest open orders, check every item against current stock. Which items can't ship from stock today?"

Três consultas de encomendas e quatro de stock depois, o agente responde por encomenda, item, material e local de stock. Os dois itens da maior encomenda não têm stock para expedir; as outras duas encomendas estão cobertas. Diz também o que não fez: descontar outras reservas.

Ver a resposta completa

3. A tendência

"Show the net value of those 10 orders by year as a bar chart."

O agente desenha o gráfico a partir das encomendas que já tem, sem outra chamada ao SAP, e indica que encomendas entraram em cada ano para que os totais possam ser conferidos.

Ver a resposta completa

4. Um pedido que tem de recusar

"Push the requested delivery date of order 467916 out by one week, and block the forklift items."

O agente só pode ler. Di-lo claramente e propõe o que pode fazer em alternativa. As escritas não estão escondidas atrás de um prompt: o gateway expõe apenas operações de leitura, e a permissão de cada ferramenta é definida por bot no Ardaven.

Ver a resposta completa

5. O email para o cliente

"Check sales order 467916 against stock, then draft a short, factual email to the customer about any items that can't ship from stock yet. Don't promise dates SAP doesn't show."

Três chamadas ao SAP, uma tabela curta e um rascunho pronto a editar. O agente indica que não incluiu data de entrega porque o SAP não mostra nenhuma, e o rascunho fica para uma pessoa rever e enviar.

Ver a resposta completa

Quanto custou

PerguntaTempo de respostaChamadas ao SAPCusto do modelo (USD)
1. Resumo da conta5,4 s20,0018
2. Risco de entrega8,6 s70,0032
3. Gráfico de tendência2,5 s00,0010
4. Alteração recusada3,7 s00,0010
5. Email para o cliente5,7 s30,0012
Revisão completa26 s120,008

Medido na execução gravada, aos preços de tabela do OpenRouter para o DeepSeek V4.1 Flash em 11 de novembro de 2026. A maior parte dos tokens de entrada foi servida a partir da cache de prompts do fornecedor, que os fatura a um preço mais baixo.

Juntar as regras da própria empresa

O SAP guarda os dados; as regras para agir sobre eles vivem normalmente num documento. Carregámos na base de conhecimento do agente um manual de gestão de contas de uma página (fictício, escrito para este estudo: níveis de conta, passos em caso de risco de entrega, limites de desconto) e fizemos uma pergunta que precisa das duas fontes.

"Look at their 10 most recent sales orders. Which tier are they under our account management playbook, and what does the playbook say we should do about order 467916?"

O agente soma as encomendas em aberto a partir do SAP (23.078,25 USD), coloca o cliente no nível Gold do manual, verifica o stock dos dois itens da encomenda e enumera o que o manual exige: avisar o cliente em dois dias úteis, não prometer datas, pôr o responsável regional de vendas em cópia e não propor entrega parcial, porque nenhum dos itens pode ser expedido. Indica também que centro não verificou. Seis chamadas ao SAP, 14 segundos, cerca de meio cêntimo.

O agente combina dados de encomendas e stock do SAP com as regras de níveis e de risco de entrega do manual

Um relatório que chega sozinho

As mesmas perguntas podem correr de forma agendada. Bastou uma mensagem:

"Every Monday at 08

Lisbon time, send me an 'orders at risk' report for Domestic US Customer 1: take their 10 most recent sales orders, keep the ones that aren't completed, check every item against current stock, and list the items that can't ship from stock. Also run the same report once, two minutes from now, so I can see what it looks like."

O agente criou duas tarefas agendadas, uma semanal e uma pré-visualização única, e escreveu ele próprio as instruções. Dois minutos depois a pré-visualização correu sem ninguém no chat: 18 chamadas ao SAP sobre 9 encomendas em aberto e 8 materiais, 15 segundos, cerca de meio cêntimo. Encontrou uma encomenda em risco, a 467916, e como o manual está na sua base de conhecimento acrescentou que o responsável regional de vendas deve ficar em cópia. O relatório chega à conversa onde foi pedido.

O agente agenda um relatório semanal e uma pré-visualização; a pré-visualização dispara a horas e indica uma encomenda em risco

Em português

O agente responde na língua em que lhe escrevem; é uma definição do bot (idioma automático). Fizemos as duas primeiras perguntas da revisão em português e conferimos as respostas com o SAP: o mesmo valor em aberto, 23.078,25 USD, e a mesma encomenda em risco. Os identificadores, códigos de material e nomes de produto ficam como o SAP os devolve.

Resumo da conta pedido em português: morada, as 10 encomendas mais recentes e o valor em aberto

Risco de entrega pedido em português: os dois itens da encomenda 467916 não têm stock

Também verificado

PerguntaChamadas ao SAPResultado
Encontrar um parceiro de negócio pelo nome (cinco partilham o mesmo nome)2Lista os cinco IDs e pergunta qual, depois devolve a morada
As cinco encomendas mais recentes de um cliente1Filtradas, ordenadas e limitadas dentro do SAP, não no agente
Uma encomenda em detalhe1Itens e total coincidem com o cabeçalho da encomenda
Stock de um material, por centro1Coincide com o registo de stock do SAP
Que encomendas em aberto incluem um material sem stock?8Resposta correta com uma tabela-resumo, em cerca de 20 segundos

Verificação entre serviços: três encomendas, quatro materiais, uma resposta

Estas verificações foram feitas durante a configuração do agente. Todas as respostas deste estudo foram conferidas com as respostas originais do SAP.

A escolha do modelo

Um modelo barato dá conta do recado, com instruções claras

Corremos a mesma revisão de cinco perguntas em quatro modelos e conferimos cada resposta com o SAP.

ModeloRespostas corretas, primeira execuçãoCorretas após duas correções nas instruçõesCusto por resposta (USD)
Claude Sonnet 5.5Usado para construir o cenáriocerca de 0,13*
DeepSeek V4.1 Flash4 em 55 em 5cerca de 0,002
GPT-6 Luna3 em 5não repetidomenos de 0,001
Claude Haiku 5.52 em 5não repetidocerca de 0,004

* Medido nas conversas mais longas usadas para construir o cenário, por isso um pouco acima de uma execução limpa.

Na primeira execução, todos os modelos mais baratos erraram o gráfico de tendência. O SAP envia as datas como uma contagem de milissegundos, e os modelos converteram algumas para o ano errado. Duas regras curtas nas instruções do agente resolveram: como converter as datas do SAP em anos, e ordenar os valores antes de indicar "o maior". Com elas, o DeepSeek V4.1 Flash respondeu corretamente às cinco perguntas, a cerca de 1% do custo do modelo maior e em menos de metade do tempo.

Como funciona

  1. Descrever as APIs no SAP Integration Suite. Um artefacto de API aponta para as APIs do S/4HANA e leva a chave de API do backend num passo de política. Só se descrevem as operações GET de que o agente precisa.
  2. Gerar o servidor MCP. O MCP Gateway do Integration Suite transforma essas operações em ferramentas MCP, com nomes e descrições legíveis que o modelo consegue usar.
  3. Publicá-lo no Developer Hub. Um produto e uma subscrição de agente dão ao agente a sua identidade de máquina: um URL de token, um ID de cliente e um segredo.
  4. Adicioná-lo ao Ardaven. Um servidor MCP próprio por workspace, autenticado com credenciais de cliente OAuth. O Ardaven obtém o token e renova-o antes de expirar, por isso ninguém cola tokens. O administrador marca as cinco ferramentas como só de leitura, e cada bot que ativa o servidor recebe-as prontas a usar.
  5. Escrever as instruções do agente. Um conjunto curto de regras: responder apenas com base nos resultados do SAP, mostrar os IDs, mostrar as contas dos totais, listar correspondências ambíguas e perguntar, converter as datas do SAP com cuidado e nunca prometer o que o SAP não mostra.
  6. Juntar o que o SAP não sabe. Carregar na base de conhecimento do agente os documentos que dizem como agir sobre os dados, por exemplo um manual de vendas.

O MCP Gateway do SAP no Ardaven: um servidor MCP próprio com 5 ferramentas, autenticado com credenciais de cliente OAuth

De um trial vazio do SAP BTP até à primeira resposta passaram menos de duas horas, grande parte à espera que o SAP aprovisionasse o runtime.

Segurança e privacidade

Um agente com chaves precisa de limites

  • Só de leitura por construção. O gateway expõe apenas operações GET. Não existe nenhuma ferramenta de escrita que o agente possa chamar.
  • Só de leitura, declarado. O gateway do SAP não identifica as suas ferramentas como só de leitura, por isso um administrador do workspace marca-as no Ardaven. Só essas ferramentas correm sem aprovação, e uma ferramenta que o servidor diga que altera dados nunca pode ser marcada.
  • Permissões por ferramenta. No Ardaven, cada ferramenta está em automático, perguntar (uma pessoa aprova cada chamada) ou negar, por bot.
  • Identidade de máquina, não uma palavra-passe partilhada. O Ardaven autentica-se no gateway com credenciais de cliente OAuth do Developer Hub do SAP. O segredo é guardado cifrado, nunca volta a ser mostrado nem é enviado ao modelo, e os tokens são renovados automaticamente. A chave do backend SAP nunca sai do Integration Suite.
  • O SAP continua no comando. A autenticação, as políticas e a monitorização ficam no SAP Integration Suite, o caminho do próprio SAP para expor APIs a agentes.
  • Apenas sandbox. Este estudo usou os dados de demonstração públicos do SAP. Não envolveu dados de clientes nem dados confidenciais.

O administrador marca as cinco ferramentas do gateway como só de leitura

Permissões por ferramenta no bot: todas as ferramentas SAP em automático e marcadas como só de leitura

O que entrega

A mesma revisão de conta à mão no SAP (três aplicações, uma folha de cálculo e nove consultas) e com o agente (uma conversa, 26 segundos de respostas)

O lado esquerdo enumera as consultas de que a revisão precisa quando é feita à mão; não a cronometrámos. O lado direito é a execução gravada.

0linhas de código específico de SAP no Ardaven
5ferramentas SAP só de leitura, a partir de 3 APIs standard do S/4HANA
< 1 cêntimopor uma revisão de conta em cinco perguntas, 12 chamadas ao SAP no total
~5 spor resposta, incluindo as chamadas ao SAP
< 2 hde um trial vazio do SAP BTP até à primeira resposta
1 mensagempara configurar um relatório semanal de encomendas em risco
100%das respostas conferidas com as respostas originais do SAP

O que aprendemos

Escolher o modelo para o trabalho e depois dizer-lhe o que precisa de saber. Um modelo grande fez a revisão sozinho. Um modelo a cerca de 1% do custo também, depois de as instruções cobrirem o formato de datas do SAP e a forma de ordenar valores. Foi conferir cada resposta com a fonte que mostrou onde faltavam instruções.

Não deixar o modelo fazer contas sem verificação. Numa execução, um agente somou nove valores de encomendas e errou por pouco. Pedir-lhe que mostrasse as contas resolveu. Em produção, a resposta é calcular os totais numa ferramenta ou na API.

Os dados reais são ambíguos. Cinco parceiros de negócio partilham o nome "Domestic US Customer 1". Uma pesquisa por nome exato e a regra "listar as correspondências e perguntar" transformaram um palpite silencioso numa resposta correta.

Desenhar a API para as perguntas que as pessoas fazem. "O total de todas as encomendas em aberto" de um cliente com centenas de encomendas obrigou a paginar 20 linhas de cada vez. Contar e somar pertencem à API, não ao ciclo do agente. O mesmo vale para os limites: uma consulta de stock sem limite de linhas pode devolver muito mais do que qualquer modelo consegue ler.

Conversas longas sobre ERP exigem cuidado. As respostas OData do SAP são extensas. Durante o estudo melhorámos a forma como o Ardaven lida com elas: uma conversa longa já não esbarra em limites de pedido, os resultados anteriores são lembrados em linhas completas, e o agente sabe que tabelas e gráficos já mostrou.

Experimente no seu SAP

  1. Escolha as perguntas. Cinco a dez que as suas equipas de conta ou de operações fazem todas as semanas.
  2. Exponha apenas o que lhes responde. Publique as APIs de leitura por trás dessas perguntas através do MCP Gateway do SAP Integration Suite.
  3. Ligue o gateway ao Ardaven. Um URL e uma identidade de máquina, com as ferramentas marcadas como só de leitura.
  4. Confira antes de alguém depender dele. Compare cada resposta com o SAP e afine as instruções do agente onde ele falhar.

Para além do SAP

O mesmo padrão funciona com qualquer sistema que publique ferramentas MCP ou esteja atrás de um gateway MCP: ERP, CRM, gestão de pedidos, plataformas de dados. A integração é um URL e uma identidade de máquina; o trabalho está em escolher as ferramentas certas e dar ao agente as instruções certas.

Vamos ligar um agente aos seus sistemas.

Related posts