SAP AI Assistant --- MCP Gateway

Версия: 1.0.0
Статус: Initial MVP / Stable
Платформа: SAP Business Technology Platform (BTP)
Среда выполнения: Cloud Foundry / Node.js

1. Обзор

SAP AI Assistant — это интерфейс на основе ИИ для взаимодействия с назначениями SAP BTP и подключенными OData-сервисами с использованием естественного языка. Он объединяет SAP BTP Destination Service, Model Context Protocol (MCP), OData V2/V4, LangChain, Groq, Node.js, Cloud Foundry и браузерный чат-интерфейс.

Пользователь выбирает настроенное назначение и задает вопросы, например Show me the first 5 products. ИИ-агент использует инструменты MCP для обнаружения и запроса выбранного OData-сервиса и возвращает ответ на естественном языке.

2. Архитектура

                    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. Основные возможности

• Интеграция с SAP BTP Destination Service

• Динамический выбор назначения

• Синхронизация назначений

• Поиск назначений

• MCP-сервер и MCP-клиент

• Обнаружение метаданных OData

• Поддержка OData V2 и V4

• Запросы к OData на естественном языке

• ИИ-агент LangChain с вызовом инструментов

• Интеграция с языковой моделью Groq

• Понятные ответы в чате

• Развертывание в Cloud Foundry

• Эндпоинт проверки состояния

• Диалоги информации и версии

4. Инструменты MCP

Инструмент Описание

list_destinations Перечисляет синхронизированные назначения

get_destination Получает сведения о назначении

sync_destinations Синхронизирует назначения из SAP BTP

discover_odata Обнаруживает метаданные OData и наборы сущностей

query_odata Выполняет запрос OData к выбранному назначению

5. Поток назначений

Имена назначений не зашиты в ИИ-агент. Клиент отправляет выбранное назначение вместе с вопросом:

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

Бэкенд передаёт оба значения агенту:

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

Это позволяет использовать назначения, такие как S4_PROD, S4_TEST, ARIBA, SUCCESSFACTORS или специфические для заказчика, без изменения кода агента.

6. HTTP-эндпоинты

Состояние

GET /health

Пример ответа:

{ "status": "UP" }

Список назначений

GET /destinations

Управление назначениями

GET /destinationsom/destinations

Получение назначения

GET /destination/:name

Обнаружение OData

GET /odata/:destination/discover

ИИ-чат

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

Пример запроса:

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

Пример ответа:

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

Пользовательский интерфейс отображает answer, а не раскрывает обычным пользователям необработанный JSON MCP/OData.

7. Поток ИИ-агента

1. Получить вопрос пользователя и выбранное назначение.

2. Подключиться к MCP-серверу.

3. Получить доступные инструменты MCP.

4. Привязать инструменты к языковой модели (LLM).

5. Позволить LLM выбрать необходимые инструменты.

6. Выполнить инструменты MCP.

7. Вернуть результаты инструментов в LLM.

8. Сформировать ответ на естественном языке.

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

8. Переменные окружения

GROQ_API_KEY

Требуется ИИ-агенту. Настройте его в Cloud Foundry, а не сохраняйте в системе контроля версий:

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

MCP_SERVER_URL

Определяет MCP-эндпоинт. Локальное значение по умолчанию:

http://localhost:8080/mcp

Для Cloud Foundry настройте развернутый MCP-эндпоинт соответствующим образом.

9. Развертывание

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

Настройте ключ Groq и выполните restage:

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

10. Примеры разработочных назначений

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

Это демонстрационные назначения. В производственных системах следует использовать соответствующие назначения SAP/заказчика и аутентификацию.

11. Безопасность

Версия 1 сосредоточена на фундаменте интеграции MCP и назначений. Перед использованием в корпоративной производственной среде проверьте или внедрите:

• Аутентификация XSUAA

• Управление доступом на основе ролей

• Авторизация на уровне назначений

• Распространение пользовательской идентичности при необходимости

• Безопасное обращение с секретами

• Аудиторское журналирование

• Ограничение скорости запросов

• Проверка входных данных

• Ограничения запросов OData

• Лимиты результатов

• Защита конфиденциальных данных

• Мониторинг в производственной среде

Никогда не сохраняйте API-ключи в Git.

12. Известные ограничения v1

Использование токенов ИИ

Текущий агент может выполнять несколько итераций LLM/инструментов и накапливать метаданные и результаты инструментов в разговоре. Большие ответы с метаданными могут увеличить потребление токенов.

Маршрутизация агента

Текущая реализация позволяет LLM решать, какие инструменты MCP вызывать. Будущие версии могут добавить детерминированную маршрутизацию для типовых операций, чтобы сократить ненужные вызовы.

Аутентификация

Корпоративные аутентификация и авторизация запланированы на последующий этап.

13. Объем версии 1.0

Включено в v1.0:

• Развертывание в Cloud Foundry

• Эндпоинт проверки состояния

• Интеграция с Destination Service

• Синхронизация назначений

• Динамический выбор назначения

• MCP-сервер

• MCP-клиент

• Обнаружение инструментов MCP

• Инструменты назначений

• Обнаружение OData

• Поддержка OData V2

• Поддержка OData V4

• Запросы к OData

• Интеграция с Groq

• Агент LangChain

• Эндпоинт ИИ-чата

• Интерфейс на естественном языке

• Понятное отображение ответов

• Информационный диалог

• Диалог версии

• Первоначальная техническая документация

14. Дорожная карта

v1.1 --- Оптимизация ИИ

• Сократить ненужные итерации LLM

• Сократить метаданные, отправляемые в LLM

• Ограничить результаты запросов

• Оптимизировать обработку результатов инструментов

• Улучшить восстановление после ошибок и задержку

• Добавить детерминированную маршрутизацию, где это уместно

v1.2 --- Безопасность

• XSUAA

• Аутентификация пользователей

• RBAC

• Авторизация назначений

• Распространение идентичности

• Аудиторское журналирование

v1.3 --- Корпоративный OData

• $select

• $filter

• $orderby

• $expand

• $top

• $skip

• Пагинация

• Суммирование результатов

v2.0 --- Корпоративная MCP-платформа SAP

Потенциальные интеграции включают S/4HANA, SuccessFactors, Ariba, SAP HANA Cloud, Integration Suite, SAP Build Process Automation и возможности SAP AI.

15. Архитектурные принципы

Независимость от назначений

Имена назначений, специфичные для заказчика, не должны быть встроены в логику приложения.

Управляемость через инструменты

ИИ-агент взаимодействует с системами SAP через инструменты MCP.

Конфигурация вместо кода

Специфичные для среды назначения и учетные данные остаются вне исходного кода приложения.

Понятный вывод

Необработанные JSON API и MCP не должны быть доступны обычным пользователям.

Расширяемость

Новые инструменты MCP должны добавляться без перепроектирования всего приложения.

16. Информация о выпуске

Проект: SAP AI Assistant / MCP Gateway
Версия: 1.0.0
Статус: Initial MVP / Stable
Платформа: SAP BTP
Среда выполнения: Node.js / Cloud Foundry