From b8efccac0ed3f46d3382f37634829a6f40a1ab2f Mon Sep 17 00:00:00 2001
From: Matthias Schur <107557548+MattSchur@users.noreply.github.com>
Date: Wed, 16 Sep 2026 16:12:02 +0200
Subject: [PATCH 1/2] Fix Java AI agents

---
 java/ai.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/java/ai.md b/java/ai.md
index 28147473f..6f0552d55 100644
--- a/java/ai.md
+++ b/java/ai.md
@@ -82,10 +82,15 @@ Without further configuration, the agent derives a system prompt and its adverti
 from the CDS model. To customize both, add resources under `<ServiceName>-agent/` on the
 classpath (for example `srv/src/main/resources/TravelService-agent/`):
 
+```txt
+TravelService-agent/
+├── AGENTS.md                     # system prompt + agent card metadata
+└── skills/
+    ├── browse-travels/SKILL.md
+    └── create-travel/SKILL.md
 ```
 
-`AGENTS.md` holds the system prompt as its body, with optional YAML frontmatter for the
-agent card:
+`AGENTS.md` holds the system prompt as its body, with optional YAML frontmatter for the agent card:
 
 ```md
 ---

From 1b4adb535d07ce9be0d8a5b24281ba98d6254365 Mon Sep 17 00:00:00 2001
From: Matthias Schur <107557548+MattSchur@users.noreply.github.com>
Date: Wed, 16 Sep 2026 16:17:32 +0200
Subject: [PATCH 2/2] Update ai.md

---
 java/ai.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/java/ai.md b/java/ai.md
index 6f0552d55..572737a45 100644
--- a/java/ai.md
+++ b/java/ai.md
@@ -76,6 +76,7 @@ During development, a built-in chat UI lets you try out your agents in the brows
 disabled by default in the [production profile](./developing-applications/configuring#production-profile).
 
 ![A chat interaction with the TravelService agent showing it's reply for the question "Show me the next two flights from Frankfurt to JFK"](./assets/travel-agent-chat.png){style="width: 80%"}
+
 ### Customizing an Agent
 
 Without further configuration, the agent derives a system prompt and its advertised skills