SAP Cloud Application Programming Model - AI Plugins for Java

About this project

This repository contains a collection of AI plugins for CAP Java applications, leveraging SAP AI Core and the SAP-RPT-1 foundation model.

Plugins

Module	Description
cds-feature-ai-core	Bridges CAP Java to SAP AI Core - resource group management, deployment lifecycle, configuration CRUD, and prediction API
cds-feature-recommendations	AI-powered field recommendations for Fiori UIs in draft-enabled entities
cds-feature-sap-document-ai	SAP Document AI integration for asynchronous document information extraction via the DIE service

Starter

For the simplest setup, add the cds-starter-ai dependency which bundles both plugins:

<dependency>
    <groupId>com.sap.cds</groupId>
    <artifactId>cds-starter-ai</artifactId>
    <version>${cds-ai.version}</version>
</dependency>

"dependencies": {
    "@cap-js/ai": "^1"
}

Note: cds-feature-sap-document-ai is not part of cds-starter-ai yet - it will be added once the plugin supports multi-tenancy. Add it as an explicit dependency in your application if you need it today.

Prerequisites

• Java 17+
• CAP Java 4.9+
• Node.js 20+ with @sap/cds-dk 9+ (for CDS build tooling)
• An SAP AI Core service binding (for production use)

Without an AI Core binding the plugins fall back to mock implementations for local development.

Samples

A runnable CAP Java bookshop demonstrating all plugins together lives in samples/bookshop. It provides an AdminService showcasing recommendations on draft-enabled Books, and a SupplierInvoicesService showcasing document extraction from supplier invoices. See the sample's own instructions for how to run it.

Local Development

mvn clean install     # build all modules
mvn test              # run unit tests

For per-plugin details (configuration, programmatic API, multi-tenancy behaviour) see the individual module READMEs. For integration tests against a real AI Core instance see integration-tests/spring.

Support, Feedback, Contributing

This project is open to feature requests/suggestions, bug reports etc. via GitHub issues. Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.

Security / Disclosure

If you find any bug that may be a security problem, please follow our instructions at in our security policy on how to report it. Please do not create GitHub issues for security-related doubts or problems.

Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.

Licensing

Copyright 2026 SAP SE or an SAP affiliate company and cds-ai contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.