Caution

Access to test systems are considered temporary. However, in all cases you can still use the sample code and tutorial available in this repository.

If you are part of a workshop session (e.g., TechEd or TechEd on Tour), the speakers should share the test system credentials with the participants.

Warning

Disclaimer

While using the test system, please note the following terms:

1. System Duration: The test system will be available only during the workshop session.
2. Testing/Learning Purposes Only: The test system is intended solely for testing or learning purposes and must not be used for any productive or commercial activities.
3. Malicious Usage: Any detection of malicious usage will result in immediate termination of your test system access. Depending on the severity of the abuse, legal action may be pursued.
4. Feature Changes: Do not make any business decisions on the contents of this exercise. SAP reserves the right to change or deprecate any feature of the Orchestration Service in the future, without any prior notification.

AI160 - Build Your Own AI Agent-Based Solution with the Generative AI Hub

Description

This repository contains material for multiple sessions:

• SAP TechEd 2025 "AI160 - Build Your Own AI Agent-Based Solution with the Generative AI Hub".

Overview

This session introduces attendees on building AI agent-based solutions using the SAP Cloud SDK for AI and the Generative AI Hub in AI Foundation.

This session offers two parallel tracks:

• SAP Cloud SDK for AI (JavaScript)
• SAP Cloud SDK for AI (Java)

Both tracks cover identical core concepts and practical applications, differing only in the programming language and SDK utilized. You may choose the track that best aligns with your technology stack. You may also opt to experience multiple tracks to broaden your understanding.

Getting Started

0. Software requirements:

• TechEd Berlin: The provided laptops already meet all requirements.
• Other Sessions:
  • General
    • Git
  • JS
    • IDE: VS Code or WebStrom
    • Node 20+
  • Java
    • IDE: Eclipse or IntelliJ
    • Java 21
    • Maven 3

1. Clone the Repository:

   Clone the repository using your preferred Git client. If you’re using the Git command line interface, run the following command:

   git clone https://github.com/SAP-samples/teched2025-AI160.git

2. Select Your Programming Language:

   • Choose between JavaScript or Java by clicking the respective links.

Please note:

• If you have your own AI Core instances for consuming Generative AI Hub capabilities, you can follow this tutorial using those instances. Please make the following adjustments:
  • You need to create a deployment for orchestration by referring the documentation.
  • Before beginning the exercises, you’ll need to provide system information. Instead of using the hands-on test system provided for this tutorial, use your own AI Core instance details, such as the AI Core client ID, secret, and authentication URL.
  • If you’re running your application on BTP rather than locally, the SDKs will automatically retrieve your AI Core instance information from the VCAP_SERVICES environment variable.

Demo Application

An AI-powered Purchase Order (PO) Management Agent that identifies overdue PO items and automates escalation workflows.

Architecture

The application demonstrates an AI agent workflow that orchestrates multiple specialized tools to process natural language queries about purchase order items. Available in both JavaScript (LangGraph) and Java (Spring AI) implementations.

Core Integration Points

• SAP S/4HANA: Purchase Order API for real-time PO data retrieval and note creation
• SAP AI Core Orchestration Service: Handles LLM invocation, content filtering, and data masking
• Agent Framework: LangGraph (JS) or Spring AI (Java) for workflow orchestration and tool routing

Users interact through a React frontend, submitting natural language queries like "Show overdue PO items for plant DE01". The agent intelligently routes through specialized tools — fetching PO data, calculating overdue status, formatting responses, and creating escalation notes.

Related SDKs & Resources

This tutorial is built using the SAP Cloud SDK for AI. If you’d like to learn more or integrate it into your own projects, check out the following resources:

• 📚 SDK Documentation Portal: https://sap.github.io/ai-sdk/
• 🚀 JavaScript SDK GitHub Repository: https://github.com/SAP/ai-sdk-js
• ☕️ Java SDK GitHub Repository: https://github.com/SAP/ai-sdk-java

Contributing

Please read the CONTRIBUTING.md to understand the contribution guidelines.

Code of Conduct

Please read the SAP Open Source Code of Conduct.

How to obtain support

Support for the content in this repository is available during the actual time of the online session for which this content has been designed. Otherwise, you may request support via the Issues tab.

License

Copyright (c) 2025 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.