Step 1 of 8 Beginner 10 min

Your BTP Toolbox: What You Need Before You Write a Line

Lesson 1 — The single most common reason an agent tutorial stalls isn't a bug in the code. It's a missing entitlement discovered forty minutes in. Here's the ten-minute checklist that means you never hit that wall.

S
s4ready.ai Team

Here’s a failure mode nobody warns you about: you follow a tutorial step by step, the code is correct, and forty minutes in you hit a wall that has nothing to do with your code — a Communication Arrangement that was never activated, a BTP destination nobody set up. The tutorial didn’t fail. The prerequisites did, quietly, before you’d even started.

This journey turns everything you learned conceptually in SAP AI Foundations into a real, running agent — the first journey here where “I read it” and “I built it” are genuinely different achievements. Ten minutes on this checklist now saves an entire afternoon of confused debugging later.

Your toolbox, two sides

Your BTP toolbox: SAP side and developer sideSAP side: an S/4HANA system, a Communication Arrangement, a BTP Cloud Foundry subaccount with a destination, and Joule Studio access. Developer side: Node.js 20+, Business Application Studio or VS Code with SAP extensions, and the Cloud Foundry CLI logged in.SAP SIDE✓ S/4HANA system (Cloud or on-prem)✓ Communication Arrangement activeSAP_COM_0008 / SAP_COM_0109…✓ BTP Cloud Foundry subaccount✓ Destination → your S/4HANA system✓ Joule Studio access (if wiring in)the part people forget until it failsDEVELOPER SIDE✓ Node.js 20+ and npm✓ Business Application Studioor VS Code + SAP extensions✓ Cloud Foundry CLI, logged inthe easy half — you already have this
Every item on the SAP side has caused a real stalled tutorial. Check all of them before you open an IDE.

Reading vs. running

You can read every lesson in this journey without any of the above in place — the design decisions stand on their own. But to actually run an agent against a live system, the SAP side has to be real. No shortcut. No S/4HANA system yet? The BTP free tier or trial is the usual start — verify current terms before you commit, the same discipline from every SAP claim in the last journey.

The one rule that saves you hours

An agent that acts is only as safe as the released APIs beneath it. Build against released OData APIs, never custom Z-objects, and your agent stays upgrade-safe by construction — not luck. That’s not a bonus practice. It’s why Clean Core and AI belong in the same sentence, and you’ll see exactly why by this journey’s final checklist.

When every box above is genuinely green — not “probably fine” — move to Lesson 2, where you decide what your agent is actually for, before writing a line of code.