onedevatlasBeta
Browse the atlas
AllBTPCAPUI5ABAP
SampleSampletypeA worked example you read or clone. Evidence: it demonstrates, it never provides.See every one →What this type is →by SAPby SAPoriginPublished by SAP itself. A visible facet, never an input to a reading — a dormant official plugin reads exactly like a dormant independent one.See every one →Reference

teched2025-AI163

An SAP TechEd 2025 lab that builds a custom Joule Agent in Joule Studio to manage shipments in the SAP Business Networks Global Track and Trace (GTT) system.

The agent combines several Joule Skills with document grounding through SAP AI Core, so that a logistics coordinator can create a shipment, get the details of delayed shipments and track an existing one in plain language. To create one it reads a shipment rate card document and determines the most economically viable carrier from rates, source and destination locations. The exercises build each Joule Skill in Joule Studio's Agent Builder against pre-built SAP Build Action projects and BTP destinations that reach the GTT system, create a private environment to test in, and then release, deploy and test the finished agent in a shared environment. The README marks the Agent Builder a pre-release version for educational use rather than production, whose interface and terminology may differ from the generally available product.

GitHub10 ★

Facts

Last pushLicenceApache-2.0

Where it sits

Lives in
BTP/BAIP
Demonstrates
Agent toolingBTPAgent toolingcapabilityBuilding an agent into your own application — the tools it may call, the state it keeps between turns, and the framework it runs in. Distinct from MCP servers, which expose an application to somebody else's agent, and from agent guidance, which is knowledge handed to a coding agent.
Requires
Joule StudioJoule Studioartifactwhere the Joule Skills and the agent are built; the Agent Builder inside it has to be enabled.SAP AI CoreSAP AI Coreartifactthe document grounding the create-shipment skill reads the rate card through; a resource group and a grounding pipeline have to be running.SAP Destination serviceSAP Destination serviceartifacthow the pre-built Build actions reach the GTT system; the session provides two destinations by name.

Who is behind it

SAP SamplesSAP SamplesOrganisationMaintains this
In the atlas: maintains 222@SAP-samplesmaintainerAjayNayak01PersonContributes to this
In the atlas: contributes to 1@AjayNayak01Ajay SorengPersonContributes to this
In the atlas: contributes to 36@ajaysorengMiguel Angel Meza MartinezPersonContributes to this
In the atlas: contributes to 1@miguelmezamartinezstevenjacobson1PersonContributes to this
In the atlas: contributes to 1@stevenjacobson1Daniel WroblewskiPersonContributes to this
In the atlas: contributes to 3@thecodester5 contributors

What it declares

Every artifact

Type
Sample
Origin
By SAP
Use as
A reference

As a sample

Form
Workshop or CodeJam material

Connections4

Download
teched2025-AI163 connectionsteched2025-AI163PROVIDES→ demonstrates1demonstrates authoredAgent toolingNEEDS→ needs3needs stated where the Joule Skills and the agent are built; the Agent Builder inside it has to be enabled. SAP-samples/teched2025-AI163 — README, Description: https://github.com/SAP-samples/teched2025-AI163 SAP-samples/teched2025-AI163 — README, Requirements & Prerequisites, Joule Studio in SAP Build: https://github.com/SAP-samples/teched2025-AI163Joule Studioneeds stated the document grounding the create-shipment skill reads the rate card through; a resource group and a grounding pipeline have to be running. SAP-samples/teched2025-AI163 — README, Description: https://github.com/SAP-samples/teched2025-AI163 SAP-samples/teched2025-AI163 — README, Requirements & Prerequisites, SAP AI Core for document grounding: https://github.com/SAP-samples/teched2025-AI163SAP AI Coreneeds stated how the pre-built Build actions reach the GTT system; the session provides two destinations by name. SAP-samples/teched2025-AI163 — README, Requirements & Prerequisites, Actions & Destinations: https://github.com/SAP-samples/teched2025-AI163SAP Destination service

README

quoted from SAP-samples/teched2025-AI163 under Apache-2.0, read
SAP-samples/teched2025-AI163/README.mdOn GitHub

Important

Welcome to the Agent Builder Lab Preview!

You are working with a pre-release version of the Agent Builder in Joule Studio. This gives you an early look at our upcoming capabilities. Please keep the following in mind:

  • Features Are Subject to Change: The user interface (UI), terminology, and functionalities you see in this lab may differ from the final, generally available (GA) product.
  • For Educational Use Only: This environment is designed for learning and experimentation, not for production use.
  • Potential Instability: As a preview version, you may encounter occasional instability or minor bugs. The exercises are designed to work with the current state of the platform. If you get stuck, please notify a session instructor.

AI163 - Get hands-on to extend Joule and build AI Agents

Description

This exercise shows how to build a simple custom Joule Agent in Joule Studio that uses multiple Joule Skills along with Document Grounding via AI Core to manage shipments in the SAP Business Networks Global Track and Trace (GTT) system. The agent can create shipments, get delayed shipment details, and even track details of existing shipments. It uses Document Grounding to read a shipment rate card document and determine the most economically viable shipment carrier based on their rates, source, and destination locations while creating a shipment.

Overview

Business problem and persona

Before diving into the use case, let's take a moment to get acquainted with our business user. It's really important to understand the business user as thoroughly as possible before building your custom Joule Agent.

Meet George, a Logistics Coordinator at a global manufacturing company. Every day, George is responsible for creating, tracking, and managing shipments across multiple transportation partners using SAP Business Networks Global Track and Trace — or GTT for short. His job is to ensure that every delivery — from raw materials to finished goods — reaches the customer on time and in full.

Persona — Logistics Coordinator
image
Pain Points — Logistics Coordinator
image
Agent for Logistics
image
You will build a goal-driven Joule Agent in Joule Studio that:
  • Understands natural-language requests on Shipment-related activities.
  • Can create, track, and get a list of delayed shipments.
  • Empowers George to do his job more efficiently.

Requirements & Prerequisites - already in place

All required backend systems and configurations have been pre-provisioned for this session. This includes:

  1. Joule Studio in SAP Build:

    • Agent Builder is enabled and accessible.

  2. Actions & Destinations:

    • SAP Build Action projects (GTTReadService & GTTShipment) are pre-built to access the SAP Business Networks GTT System.
    • BTP Destinations (gttwriteservice & gttGetService) are available in SAP Build.

  3. SAP AI Core for document grounding:

    • A resource group and document grounding pipeline are set up and running.

Begin Your Hands-On Session

Please follow the exercises in order. Each exercise page will link to the next one.

➡️ Start Here: Ex. 0 - Getting Started

Table of Contents (Click to expand for full exercise list)

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

REUSE

REUSE status

Apache-2.0, read

Details

Sources3
Added by handdiscovered herechecked
github.com/SAP-samples/teched2025-AI163tree, pushes, contributors, CIchecked
README.mdquoted, and what the entry declareschecked

Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.

Compatibility and provenance
discovered viaAdded by hand
first seen in the atlas
ecosystem and domainbtp, ai-and-agents
Contributors5
AjayNayak01Ajay SorengMiguel Angel Meza Martinezstevenjacobson1Daniel Wroblewski

From the repository’s contributor list, .

History in the atlas1
  1. First seen.
For your agent
Ref
artifact:sap-samples-teched2025-ai163
JSON
/artifacts/sap-samples-teched2025-ai163.json
MCP
Connecting an agent