SAP AI Assistant --- MCP Gateway

バージョン: 1.0.0
ステータス: 初期MVP / 安定版
プラットフォーム: SAP Business Technology Platform (BTP)
ランタイム: Cloud Foundry / Node.js

1. 概要

SAP AI Assistant は、自然言語を使用して SAP BTP の宛先および接続された OData サービスと対話するための AI 搭載インターフェースです。SAP BTP Destination Service、Model Context Protocol (MCP)、OData V2/V4、LangChain、Groq、Node.js、Cloud Foundry、およびブラウザベースのチャット UI を組み合わせています。

ユーザーは設定済みの宛先を選択し、Show me the first 5 products のような質問をします。AI エージェントは 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 LLM 統合

• ユーザーフレンドリーなチャット応答

• Cloud Foundry デプロイメント

• ヘルスエンドポイント

• 情報およびバージョンダイアログ

4. MCP ツール

ツール 目的

list_destinations 同期された宛先を一覧表示します

get_destination 宛先の詳細を取得します

sync_destinations SAP BTP から宛先を同期します

discover_odata OData メタデータとエンティティ セットを検出します

query_odata 選択した宛先に対して OData クエリを実行します

5. 宛先フロー

宛先名は AI エージェントにハードコードされていません。クライアントは選択した宛先を質問とともに送信します:

{
  "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

AI チャット

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..."
}

UI は通常のユーザーに生の MCP/OData JSON を公開せず、answer を表示します。

7. AI エージェントフロー

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

AI エージェントに必要です。ソース管理にコミットせず、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 キーを設定して再ステージングしてください:

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 制限

AI トークン使用量

現在のエージェントは複数の LLM/ツールの反復を実行でき、会話内にメタデータやツール結果が蓄積される場合があります。そのため、大きなメタデータレスポンスはトークン消費を増加させる可能性があります。

エージェントルーティング

現在の実装では、LLM がどの MCP ツールを呼び出すかを決定します。将来のバージョンでは、一般的な操作に対する決定的ルーティングを追加して、不要な呼び出しを削減できます。

認証

エンタープライズ認証と認可は、次のフェーズで計画されています。

13. バージョン 1.0 の範囲

v1.0 に含まれるもの:

• Cloud Foundry デプロイメント

• ヘルスエンドポイント

• Destination Service 統合

• 宛先同期

• 動的な宛先選択

• MCP サーバー

• MCP クライアント

• MCP ツール検出

• 宛先ツール

• OData ディスカバリ

• OData V2 サポート

• OData V4 サポート

• OData クエリ

• Groq 統合

• LangChain エージェント

• AI チャットエンドポイント

• 自然言語 UI

• ユーザーフレンドリーなレスポンス表示

• 情報ダイアログ

• バージョンダイアログ

• 初期技術ドキュメント

14. ロードマップ

v1.1 --- AI 最適化

• 不要な LLM の反復を削減

• LLM に送信するメタデータを削減

• クエリ結果を制限

• ツール結果の処理を最適化

• エラー回復とレイテンシを改善

• 適切な場所に決定的ルーティングを追加

v1.2 --- セキュリティ

• XSUAA

• ユーザー認証

• RBAC

• 宛先認可

• アイデンティティ伝播

• 監査ログ

v1.3 --- エンタープライズ OData

• $select

• $filter

• $orderby

• $expand

• $top

• $skip

• ページネーション

• 結果の要約

v2.0 --- SAP Enterprise MCP Platform

統合の可能性には、S/4HANA、SuccessFactors、Ariba、SAP HANA Cloud、Integration Suite、SAP Build Process Automation、および SAP AI 機能が含まれます。

15. アーキテクチャ原則

宛先非依存

顧客固有の宛先名をアプリケーションロジックに埋め込むべきではありません。

ツール駆動

AI エージェントは MCP ツールを通じて SAP システムと対話します。

コードよりも設定

環境固有の宛先と資格情報は、アプリケーションのソースコードの外部に置かれます。

ユーザーフレンドリーな出力

生の API および MCP JSON を通常のユーザーに公開すべきではありません。

拡張可能

アプリケーション全体を再設計することなく、新しい MCP ツールを追加できる必要があります。

16. リリース情報

プロジェクト: SAP AI Assistant / MCP Gateway
バージョン: 1.0.0
ステータス: 初期MVP / 安定版
プラットフォーム: SAP BTP
ランタイム: Node.js / Cloud Foundry