How sap-samples/ai-enabled-integrations-codejam works
This repository is a hands-on CodeJam, not a single deployed application: its exercises guide participants through an AI-enabled customer-support integration. A customer submits a request on the Altura website; the event is processed in Integration Suite with an AI Core prompt, then sent to the customer-service system. The workflow also covers service-center lookup, exposing APIs through MCP, and using those tools from an agent/chat interface. The README documents several platform-level stages whose implementation is external or exercise-configured; paths below identify the closest supporting material. Sampled source confirms website event publishing, CAP service access, and agent MCP/event handling.
Main entry points: README.md Integration flow · customer-requests-service.cds Customer service API · agent_executor.py Agent executor · event_consumer.py Event consumer
Components 22
Request intake
- Support website
apps/altura-coffee-website/src/main.js - Request publisher
apps/altura-coffee-website/server.js - Event mesh
AI integration
- Integration flow
exercises/02-generate-iflow/README.md - Prompt handling
exercises/01-sap-ai-core-prompt-template/README.md - SAP AI Core
- Flow scripts
files/PrepareLLMRequest.groovy
Support systems
- Customer service API
apps/altura-customer-service/srv/customer-requests-service.cds - Support agent API
apps/altura-customer-service/srv/support-agent-service.cds - Request data
apps/altura-customer-service/db/schema.cds - Service locator
apps/altura-service-locator/assets/service-locator-cap/srv/service-locator-service.cds - Center data
apps/altura-service-locator/assets/service-locator-cap/db/schema.cds
MCP access
- Customer API MCP
exercises/04-customer-service-api-mcp-server/README.md - MCP Gateway
exercises/05-expose-api-mcp-gateway/README.md - Locator MCP
apps/customer-request-agent/app/mcp_tools.py
Agent experience
- Chat interface
apps/customer-request-agent/app/ui.py - A2A agent server
apps/customer-request-agent/app/main.py - Agent executor
apps/customer-request-agent/app/agent_executor.py - Request agent
apps/customer-request-agent/app/agent.py - Event consumer
apps/customer-request-agent/app/event_consumer.py
Other components
- Customer
- Agent user
Connections 24
- Customer → Support website: submits request
- Support website → Request publisher: posts request
- Request publisher → Event mesh: publishes event
- Event mesh → Integration flow: delivers event
- Integration flow → Prompt handling: prepares prompt
- Prompt handling → SAP AI Core: invokes model
- Integration flow → Flow scripts: uses scripts
- Integration flow → Customer service API: sends request
- Integration flow → Service locator: looks up center
- Customer service API → Request data: reads and writes
- Service locator → Center data: reads centers
- Customer service API → Support agent API: exposes operations
- Customer service API → Customer API MCP: exposes API
- MCP Gateway → Service locator: exposes API
- Agent user → Chat interface: asks question
- Chat interface → A2A agent server: sends chat
- A2A agent server → Agent executor: dispatches task
- Agent executor → Request agent: runs agent
- Agent executor → Customer API MCP: loads and calls tools
- Agent executor → Locator MCP: loads and calls tools
- A2A agent server → Event consumer: starts optionally
- Event mesh → Event consumer: delivers request events
- Event consumer → Request agent: invokes agent
- Event consumer → Event mesh: publishes reply