# sap-samples/agent-interoperability architecture

> Architecture diagram of the GitHub repository sap-samples/agent-interoperability, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sap-samples/agent-interoperability
- Repository: https://github.com/sap-samples/agent-interoperability

## Overview

This repository is a set of implementation cookbooks, not one deployed application: each platform recipe connects an external agent to SAP agents through the SAP Agent Gateway, with identity propagation as a central concern. The main workflows are AWS MCP-to-SAP delegation, a GCP proxy-agent bridge, and Microsoft custom-connector token exchange; common setup documents shared SAP-side onboarding. Source excerpts show several AWS and GCP calls, while the Microsoft and common-setup links are based on the README. Unexcerpted subsystem details are represented only at documented boundaries.

Main entry points: [`01-aws-integration/code/runtime/agent.py`](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/agent.py) (Agent Router), [`02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py`](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py) (Bridge API), [`02-gcp-integration/code/gcp-agent-bridge/app/agent.py`](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/agent.py) (Proxy Agent), [`01-aws-integration/code/mcp_server.py`](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/mcp_server.py) (MCP Front Door)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared Onboarding"]
  node_common["SAP Setup<br/>[README.md]"]
end

subgraph group_aws["AWS Integration"]
  node_mcp["MCP Front Door<br/>[mcp_server.py]"]
  node_router["Agent Router<br/>[agent.py]"]
  node_config["Live Configuration<br/>[config.py]"]
  node_dynamic["Config Store<br/>[dynamic_config.py]"]
  node_identity["CIS Token Exchange<br/>[cis.py]"]
  node_limits["Rate Limiting<br/>[rate_limit.py]"]
  node_resume["Task Resume Tokens<br/>[resume_token.py]"]
  node_gateway["SAP A2A Gateway Client<br/>[sap_gateway.py]"]
end

subgraph group_gcp["GCP Integration"]
  node_api["Bridge API<br/>[fast_api_app.py]"]
  node_gcpagent["Proxy Agent<br/>[agent.py]"]
  node_a2a["A2A Routes<br/>[a2a.py]"]
  node_reasoning["Reasoning Adapter"]
  node_services[("Session Services<br/>[services.py]")]
  node_jwt["JWT Assertion Minter<br/>[jwt_bearer.py]"]
end

subgraph group_microsoft["Microsoft Integration"]
  node_entra["Entra Connector"]
  node_iasconnector["IAS OAuth Connector"]
end

node_user(("Business User"))
node_quick(("Amazon Quick"))
node_bedrock{{"Amazon Bedrock"}}
node_agentcore{{"AgentCore Identity"}}
node_sap{{"SAP Agent Gateway"}}
node_gemini(("Gemini Enterprise"))
node_ias{{"SAP Identity Services"}}
node_downstream{{"Downstream Agent"}}
node_copilot(("Copilot Studio"))

node_user -->|"submits request"| node_quick
node_user -->|"submits request"| node_gemini
node_user -->|"submits request"| node_copilot
node_common -->|"onboards consumer"| node_sap
node_quick -->|"invokes MCP"| node_mcp
node_mcp -->|"delegates request"| node_router
node_mcp -->|"loads configuration"| node_dynamic
node_router -->|"runs tool loop"| node_bedrock
node_router -->|"requests user token"| node_identity
node_router -->|"checks calls"| node_limits
node_router -->|"calls SAP A2A"| node_gateway
node_router -->|"encodes continuation"| node_resume
node_router -->|"uses settings"| node_config
node_identity -->|"exchanges token"| node_agentcore
node_gateway -->|"sends A2A calls"| node_sap
node_gemini -.->|"calls bridge"| node_api
node_api -->|"attaches routes"| node_a2a
node_api -->|"attaches routes"| node_reasoning
node_api -->|"configures services"| node_services
node_api -->|"loads agent"| node_gcpagent
node_reasoning -->|"dispatches methods"| node_gcpagent
node_reasoning -->|"uses services"| node_services
node_gcpagent -->|"mints assertion"| node_jwt
node_gcpagent -->|"exchanges user token"| node_ias
node_gcpagent -->|"forwards request"| node_downstream
node_copilot -->|"uses connector"| node_entra
node_copilot -->|"uses connector"| node_iasconnector
node_entra -.->|"routes to SAP"| node_sap
node_iasconnector -.->|"routes to SAP"| node_sap

click node_common "https://github.com/sap-samples/agent-interoperability/blob/main/00-common-setup/README.md"
click node_mcp "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/mcp_server.py"
click node_router "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/agent.py"
click node_config "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/config.py"
click node_dynamic "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/dynamic_config.py"
click node_identity "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/cis.py"
click node_limits "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/rate_limit.py"
click node_resume "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/resume_token.py"
click node_gateway "https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/sap_gateway.py"
click node_api "https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py"
click node_gcpagent "https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/agent.py"
click node_a2a "https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/app_utils/a2a.py"
click node_reasoning "https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/app_utils/reasoning_engine_adapter.py"
click node_services "https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/app_utils/services.py"
click node_jwt "https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/jwt_bearer.py"
click node_entra "https://github.com/sap-samples/agent-interoperability/blob/main/03-microsoft-azure-integration/code/agw-connector-entra.csx"
click node_iasconnector "https://github.com/sap-samples/agent-interoperability/blob/main/03-microsoft-azure-integration/code/agw-connector-ias-oauth.csx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_common,node_user toneBlue
class node_mcp,node_router,node_config,node_dynamic,node_identity,node_limits,node_resume,node_gateway toneAmber
class node_api,node_gcpagent,node_a2a,node_reasoning,node_services,node_jwt toneMint
class node_entra,node_iasconnector toneRose
class node_quick,node_bedrock,node_agentcore,node_sap,node_gemini,node_ias,node_downstream,node_copilot toneIndigo
```

## Components

### Shared Onboarding

- [SAP Setup](https://github.com/sap-samples/agent-interoperability/blob/main/00-common-setup/README.md): `00-common-setup/README.md`

### AWS Integration

- [MCP Front Door](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/mcp_server.py): `01-aws-integration/code/mcp_server.py`
- [Agent Router](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/agent.py): `01-aws-integration/code/runtime/agent.py`
- [Live Configuration](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/config.py): `01-aws-integration/code/runtime/config.py`
- [Config Store](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/dynamic_config.py): `01-aws-integration/code/runtime/dynamic_config.py`
- [CIS Token Exchange](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/cis.py): `01-aws-integration/code/runtime/cis.py`
- [Rate Limiting](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/rate_limit.py): `01-aws-integration/code/runtime/rate_limit.py`
- [Task Resume Tokens](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/resume_token.py): `01-aws-integration/code/runtime/resume_token.py`
- [SAP A2A Gateway Client](https://github.com/sap-samples/agent-interoperability/blob/main/01-aws-integration/code/runtime/sap_gateway.py): `01-aws-integration/code/runtime/sap_gateway.py`

### GCP Integration

- [Bridge API](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py): `02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py`
- [Proxy Agent](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/agent.py): `02-gcp-integration/code/gcp-agent-bridge/app/agent.py`
- [A2A Routes](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/app_utils/a2a.py): `02-gcp-integration/code/gcp-agent-bridge/app/app_utils/a2a.py`
- [Reasoning Adapter](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/app_utils/reasoning_engine_adapter.py): `02-gcp-integration/code/gcp-agent-bridge/app/app_utils/reasoning_engine_adapter.py`
- [Session Services](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/app_utils/services.py): `02-gcp-integration/code/gcp-agent-bridge/app/app_utils/services.py`
- [JWT Assertion Minter](https://github.com/sap-samples/agent-interoperability/blob/main/02-gcp-integration/code/gcp-agent-bridge/app/jwt_bearer.py): `02-gcp-integration/code/gcp-agent-bridge/app/jwt_bearer.py`

### Microsoft Integration

- [Entra Connector](https://github.com/sap-samples/agent-interoperability/blob/main/03-microsoft-azure-integration/code/agw-connector-entra.csx): `03-microsoft-azure-integration/code/agw-connector-entra.csx`
- [IAS OAuth Connector](https://github.com/sap-samples/agent-interoperability/blob/main/03-microsoft-azure-integration/code/agw-connector-ias-oauth.csx): `03-microsoft-azure-integration/code/agw-connector-ias-oauth.csx`

### Other components

- **Business User**
- **Amazon Quick**
- **Amazon Bedrock**
- **AgentCore Identity**
- **SAP Agent Gateway**
- **Gemini Enterprise**
- **SAP Identity Services**
- **Downstream Agent**
- **Copilot Studio**

## Connections

- Business User → Amazon Quick: submits request (evidence: `README.md`)
- Business User → Gemini Enterprise: submits request (evidence: `README.md`)
- Business User → Copilot Studio: submits request (evidence: `README.md`)
- SAP Setup → SAP Agent Gateway: onboards consumer (evidence: `README.md`)
- Amazon Quick → MCP Front Door: invokes MCP (evidence: `01-aws-integration/code/mcp_server.py`)
- MCP Front Door → Agent Router: delegates request (evidence: `01-aws-integration/code/mcp_server.py`)
- MCP Front Door → Config Store: loads configuration (evidence: `01-aws-integration/code/mcp_server.py`)
- Agent Router → Amazon Bedrock: runs tool loop (evidence: `01-aws-integration/code/runtime/agent.py`)
- Agent Router → CIS Token Exchange: requests user token (evidence: `01-aws-integration/code/runtime/agent.py`)
- Agent Router → Rate Limiting: checks calls (evidence: `01-aws-integration/code/runtime/agent.py`)
- Agent Router → SAP A2A Gateway Client: calls SAP A2A (evidence: `01-aws-integration/code/runtime/agent.py`)
- Agent Router → Task Resume Tokens: encodes continuation (evidence: `01-aws-integration/code/runtime/agent.py`)
- Agent Router → Live Configuration: uses settings (evidence: `01-aws-integration/code/runtime/agent.py`)
- CIS Token Exchange → AgentCore Identity: exchanges token (evidence: `01-aws-integration/code/runtime/cis.py`)
- SAP A2A Gateway Client → SAP Agent Gateway: sends A2A calls (evidence: `01-aws-integration/code/runtime/sap_gateway.py`)
- Gemini Enterprise → Bridge API: calls bridge
- Bridge API → A2A Routes: attaches routes (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py`)
- Bridge API → Reasoning Adapter: attaches routes (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py`)
- Bridge API → Session Services: configures services (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py`)
- Bridge API → Proxy Agent: loads agent (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/fast_api_app.py`)
- Reasoning Adapter → Proxy Agent: dispatches methods (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/app_utils/reasoning_engine_adapter.py`)
- Reasoning Adapter → Session Services: uses services (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/app_utils/reasoning_engine_adapter.py`)
- Proxy Agent → JWT Assertion Minter: mints assertion (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/agent.py`)
- Proxy Agent → SAP Identity Services: exchanges user token (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/agent.py`)
- Proxy Agent → Downstream Agent: forwards request (evidence: `02-gcp-integration/code/gcp-agent-bridge/app/agent.py`)
- Copilot Studio → Entra Connector: uses connector (evidence: `README.md`)
- Copilot Studio → IAS OAuth Connector: uses connector (evidence: `README.md`)
- Entra Connector → SAP Agent Gateway: routes to SAP (evidence: `README.md`)
- IAS OAuth Connector → SAP Agent Gateway: routes to SAP (evidence: `README.md`)
