SAP AI Assistant --- MCP Gateway

Versión: 1.0.0
Estado: MVP inicial / Estable
Plataforma: SAP Business Technology Platform (BTP)
Entorno de ejecución: Cloud Foundry / Node.js

1. Descripción general

SAP AI Assistant es una interfaz basada en IA para interactuar con destinos de SAP BTP y servicios OData conectados mediante lenguaje natural. Combina SAP BTP Destination Service, Model Context Protocol (MCP), OData V2/V4, LangChain, Groq, Node.js, Cloud Foundry y una interfaz de chat basada en navegador.

El usuario selecciona un destino configurado y formula preguntas como Show me the first 5 products. El agente de IA utiliza herramientas MCP para descubrir y consultar el servicio OData seleccionado y devuelve una respuesta en lenguaje natural.

2. Arquitectura

                    SAP BTP
                       |
              +--------v--------+
              | Destination     |
              | Service         |
              +--------+--------+
                       |
              +--------v--------+
              | SAP AI Assistant|
              | MCP Gateway     |
              |                 |
              | Destination Mgmt|
              | OData Discovery |
              | OData Query     |
              | MCP Server      |
              | AI Agent        |
              +--------+--------+
                       |
              +--------v--------+
              |    Groq LLM     |
              | llama-3.3-70b   |
              +--------+--------+
                       |
                       v
                  Browser UI

3. Características principales

• Integración con SAP BTP Destination Service

• Selección dinámica de destinos

• Sincronización de destinos

• Búsqueda de destinos

• Servidor MCP y cliente MCP

• Descubrimiento de metadatos OData

• Soporte para OData V2 y V4

• Consultas OData en lenguaje natural

• Agente de llamada a herramientas LangChain

• Integración de LLM Groq

• Respuestas de chat fáciles de usar

• Despliegue en Cloud Foundry

• Endpoint de salud

• Diálogos de información y versión

4. Herramientas MCP

Herramienta Propósito

list_destinations Lista los destinos sincronizados

get_destination Recupera los detalles del destino

sync_destinations Sincroniza los destinos desde SAP BTP

discover_odata Descubre los metadatos OData y los conjuntos de entidades

query_odata Ejecuta una consulta OData contra un destino seleccionado

5. Flujo de destinos

Los nombres de los destinos no están codificados de forma fija en el agente de IA. El cliente envía el destino seleccionado junto con la pregunta:

{
  "message": "Show me the first 5 products",
  "destination": "NORTHWIND_V4"
}

El backend pasa ambos valores al agente:

UI -> /ai/chat -> askAgent({ question, destination }) -> MCP -> selected destination -> OData service

Esto permite destinos como S4_PROD, S4_TEST, ARIBA, SUCCESSFACTORS u otros específicos del cliente sin cambiar el código del agente.

6. Endpoints HTTP

Salud

GET /health

Ejemplo de respuesta:

{ "status": "UP" }

Listar destinos

GET /destinations

Gestión de destinos

GET /destinationsom/destinations

Obtener destino

GET /destination/:name

Descubrimiento de OData

GET /odata/:destination/discover

Chat de IA

POST /ai/chat
Content-Type: application/json

Ejemplo de solicitud:

{
  "message": "Show me the first 5 products",
  "destination": "NORTHWIND_V4"
}

Ejemplo de respuesta:

{
  "success": true,
  "question": "Show me the first 5 products",
  "destination": "NORTHWIND_V4",
  "answer": "The first 5 products are..."
}

La interfaz muestra el answer en lugar de exponer JSON crudo de MCP/OData a los usuarios normales.

7. Flujo del agente de IA

1. Recibir la pregunta del usuario y el destino seleccionado.

2. Conectarse al servidor MCP.

3. Recuperar las herramientas MCP disponibles.

4. Vincular las herramientas al LLM.

5. Permitir que el LLM seleccione la(s) herramienta(s) necesarias.

6. Ejecutar las herramientas MCP.

7. Devolver los resultados de las herramientas al LLM.

8. Producir una respuesta en lenguaje natural.

Question
   |
   v
  LLM
   |
   +--> discover_odata
   |
   +--> query_odata
   |
   v
Tool Result
   |
   v
  LLM
   |
   v
Final Answer

8. Variables de entorno

GROQ_API_KEY

Requerida por el agente de IA. Configúrala en Cloud Foundry en lugar de hacer commit de ella en el control de código fuente:

cf set-env sap-mcp-gateway GROQ_API_KEY "<your-groq-api-key>"
cf restage sap-mcp-gateway

MCP_SERVER_URL

Define el endpoint de MCP. Valor predeterminado local:

http://localhost:8080/mcp

Para Cloud Foundry, configura el endpoint de MCP desplegado según corresponda.

9. Despliegue

cf login -sso
cf target -o <organization> -s <space>
cf push sap-mcp-gateway
cf app sap-mcp-gateway
cf logs sap-mcp-gateway --recent

Configura la clave de Groq y vuelve a desplegar:

cf set-env sap-mcp-gateway GROQ_API_KEY "<your-key>"
cf restage sap-mcp-gateway

10. Ejemplos de destinos de desarrollo

NORTHWIND_V2

Name:           NORTHWIND_V2
Type:           HTTP
URL:            https://services.odata.org/v2/northwind/northwind.svc/
Proxy Type:     Internet
Authentication: NoAuthentication

NORTHWIND_V4

Name:           NORTHWIND_V4
Type:           HTTP
URL:            https://services.odata.org/v4/northwind/northwind.svc/
Proxy Type:     Internet
Authentication: NoAuthentication

Estos son destinos de demostración. Los sistemas de producción deben usar destinos de SAP/cliente y autenticación apropiados.

11. Seguridad

La versión 1 se centra en los cimientos de la integración de MCP y destinos. Antes del uso en producción empresarial, revisa o implementa:

• Autenticación XSUAA

• Control de acceso basado en roles

• Autorización a nivel de destino

• Propagación de identidad de usuario cuando sea necesario

• Manejo seguro de secretos

• Registro de auditoría

• Limitación de velocidad

• Validación de entrada

• Restricciones de consulta OData

• Límites de resultados

• Protección de datos sensibles

• Monitoreo de producción

Nunca hagas commit de claves de API en Git.

12. Limitaciones conocidas de v1

Uso de tokens de IA

El agente actual puede realizar múltiples iteraciones de LLM/herramientas y puede acumular metadatos y resultados de herramientas en la conversación. Las respuestas extensas de metadatos pueden, por tanto, aumentar el consumo de tokens.

Enrutamiento del agente

La implementación actual permite que el LLM decida qué herramientas MCP llamar. Las versiones futuras pueden añadir enrutamiento determinista para operaciones comunes y reducir llamadas innecesarias.

Autenticación

La autenticación y autorización empresarial están planificadas para una fase posterior.

13. Alcance de la versión 1.0

Incluido en v1.0:

• Despliegue en Cloud Foundry

• Endpoint de salud

• Integración con Destination Service

• Sincronización de destinos

• Selección dinámica de destinos

• Servidor MCP

• Cliente MCP

• Descubrimiento de herramientas MCP

• Herramientas de destinos

• Descubrimiento de OData

• Soporte para OData V2

• Soporte para OData V4

• Consultas OData

• Integración con Groq

• Agente LangChain

• Endpoint de chat de IA

• Interfaz de lenguaje natural

• Representación de respuestas fácil de usar

• Diálogo de información

• Diálogo de versión

• Documentación técnica inicial

14. Hoja de ruta

v1.1 --- Optimización de IA

• Reducir iteraciones innecesarias del LLM

• Reducir los metadatos enviados al LLM

• Limitar los resultados de las consultas

• Optimizar el manejo de resultados de herramientas

• Mejorar la recuperación de errores y la latencia

• Añadir enrutamiento determinista cuando corresponda

v1.2 --- Seguridad

• XSUAA

• Autenticación de usuario

• RBAC

• Autorización de destinos

• Propagación de identidad

• Registro de auditoría

v1.3 --- OData empresarial

• $select

• $filter

• $orderby

• $expand

• $top

• $skip

• Paginación

• Resumen de resultados

v2.0 --- Plataforma MCP empresarial de SAP

Las integraciones potenciales incluyen S/4HANA, SuccessFactors, Ariba, SAP HANA Cloud, Integration Suite, SAP Build Process Automation y las capacidades de IA de SAP.

15. Principios arquitectónicos

Agnóstico de destino

Los nombres de destinos específicos del cliente no deben estar integrados en la lógica de la aplicación.

Impulsado por herramientas

El agente de IA interactúa con los sistemas SAP a través de herramientas MCP.

Configuración sobre código

Los destinos y credenciales específicos del entorno permanecen fuera del código fuente de la aplicación.

Salida fácil de usar

El JSON crudo de API y MCP no debe exponerse a los usuarios normales.

Extensible

Las nuevas herramientas MCP deberían poder añadirse sin rediseñar toda la aplicación.

16. Información de la versión

Proyecto: SAP AI Assistant / MCP Gateway Versión: 1.0.0 Estado: MVP inicial / Estable Plataforma: SAP BTP Entorno de ejecución: Node.js / Cloud Foundry