К основному содержанию
скилл CX Codex

aicore-sdk-java — скилл для Claude Code: что делает и как установить

Скилл aicore-sdk-java для Claude Code генерирует код на Java и Kotlin под SAP GenAI Hub через SAP AI SDK. Задействуется при запросе на интеграцию AI Core в проект на Java или Spring Boot.

Apache-2.0 180 установок ★ 153 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add SAP/ai-skills-library --skill aicore-sdk-java -a claude-code
Открыть на GitHub

Что делает aicore-sdk-java

Ассистент собирает стартовые шаблоны чата, потоковой передачи, вложений, фильтрации контента и маскировки данных. Требуются Java 17 и Maven или Gradle.

Пакет опирается на встроенные ассеты, Context7 MCP и локальные справочные материалы. При генерации контроллеров со стримингом задействуются ResponseBodyEmitter и специализированные исполнители потоков.

Учётные данные подтягиваются из переменной среды AICORE_SERVICE_KEY или через VCAP_SERVICES.

Какие задачи решает

  • сгенерировать шаблон чата для SAP AI Core
  • настроить потоковую передачу ответов в Spring Boot
  • подключить эмбеддинги и векторный поиск
  • применить фильтрацию контента и маскировку данных

Примеры запросов агенту

  • Сгенерируй код чата на Java с использованием SAP AI SDK
  • Создай проект на Spring Boot для подключения к GenAI Hub
  • Настрой потоковую передачу через OrchestrationClient

Как установить aicore-sdk-java

1Через Skills CLI (Vercel)

npx skills add SAP/ai-skills-library --skill aicore-sdk-java -a claude-code

2Вручную: положить файлы

~/.claude/skills/aicore-sdk-java/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/aicore-sdk-java/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об aicore-sdk-java

Как установить aicore-sdk-java в Claude Code?

Выполните команду npx skills add SAP/ai-skills-library --skill aicore-sdk-java -a claude-code и проверьте файл ~/.claude/skills/aicore-sdk-java/SKILL.md.

Что делает aicore-sdk-java?

Генерирует рабочий шаблонный код на Java и Kotlin для работы с моделями SAP GenAI Hub через официальный SDK.

Что нужно для работы aicore-sdk-java?

Для работы необходимы Java 17 и система сборки Maven или Gradle, а также настроенные учётные данные AI Core.

Исходный текст

SKILL.md · Apache-2.0
---
name: aicore-sdk-java
description: >
  Generate working Java boilerplate for SAP GenAI Hub using the SAP AI SDK for Java
  (com.sap.ai.sdk). Covers chat completion, streaming, multi-turn conversations,
  prompt templates, content filtering, data masking, embeddings, RAG/grounding,
  prompt registry, and Spring Boot streaming.
  WHEN: user asks for Java or Kotlin code that calls a GenAI Hub model, wants a Java
  starter project, asks how to use com.sap.ai.sdk in their app, or asks how to
  integrate AI Core into a Spring Boot or plain Java application.
  DO NOT USE FOR: JavaScript/TypeScript code — use `aicore-sdk-js`.
compatibility: Requires Java 17+ and Maven or Gradle. Context7 MCP is optional (see Sources & Fallback).
---

## Sources & Fallback

Resolve answers in this priority order:

1. **Assets** (`assets/` directory) — check for a matching template first and serve it
   directly. Assets are always available offline and contain runnable, tested code.
2. **Context7 MCP** — if no asset matches, fetch live docs via Context7:
   `resolve-library-id: SAP/ai-sdk-java`, then `get-library-docs`.
   Context7 returns the most up-to-date API shapes straight from the repo.
   Silently fall back to step 3 if Context7 is not installed.
3. **`references/SDK_JAVA.md`** — offline reference when Context7 is unavailable.
   Use this rather than guessing.

**Do not fabricate class names, method signatures, or config shapes.** If none of the
three sources cover the question, say so and point the user to
https://sap.github.io/ai-sdk/docs/java/ directly.

---

## Rules

1. If no deployment exists, check the SAP AI Core console or contact your admin to list or create one before generating code.
2. Always include credential guidance in generated code comments; link to [Connecting to AI Core](https://sap.github.io/ai-sdk/docs/java/connecting-to-ai-core) for setup details.
3. Use `OrchestrationAiModel` constants (e.g. `OrchestrationAiModel.GPT_4O_MINI`) — never raw model name strings.
4. Always use `OrchestrationClient` as the primary client for chat, streaming, embeddings, grounding, and filtering. `OpenAiClient` (`openai` artifact) is only for direct OpenAI proxy use cases — do not recommend it for general chat.
5. Streaming has two distinct APIs — use each correctly:
   - **`OrchestrationClient.streamChatCompletion()` in a Spring Boot controller**: always use `ResponseBodyEmitter` + `ThreadContextExecutors.getExecutor().execute()` to forward deltas. Never use `SseEmitter`, `Thread.ofVirtual()`, or expose a raw `Flux` from the controller.
   - **Spring AI `ChatModel.stream()` (`OrchestrationChatModel` / `OpenAiChatModel`)**: this method is part of the Spring AI `ChatModel` interface and legitimately returns `Flux<ChatResponse>`. Composing the `Flux` directly (e.g. `.doOnNext(…).blockLast()`) is correct — do not replace it with `ResponseBodyEmitter`.
6. Gather these details before generating code — ask only for what the user hasn't provided:
   - **Use case**: chat / streaming / multi-turn / embeddings / grounding / filtering?
   - **Model**: check the SAP AI Core console or the [SAP GenAI Hub documentation](https://help.sap.com/docs/sap-ai-core) for available models
   - **Build tool**: Maven or Gradle?
   - **Framework**: plain Java / Spring Boot?
7. For SDK bugs or unexpected runtime behavior: acknowledge the issue, share only verified workarounds from the assets or reference docs, and direct the user to https://github.com/SAP/ai-sdk-java/issues. Do not speculate about SDK internals or diagnose bugs not covered by a source above.

---

## Asset Map

| Use case                               | Template                                  | Dependency                                 |
| -------------------------------------- | ----------------------------------------- | ------------------------------------------ |
| Chat via `OrchestrationClient`         | `assets/ChatOrchestration.java`           | `com.sap.ai.sdk:orchestration`             |
| Streaming via `OrchestrationClient`    | `assets/StreamingOrchestration.java`      | `com.sap.ai.sdk:orchestration`             |
| Multi-turn conversation                | `assets/MultiTurnOrchestration.java`      | `com.sap.ai.sdk:orchestration`             |
| Text embeddings                        | `assets/EmbeddingsOrchestration.java`     | `com.sap.ai.sdk:orchestration`             |
| RAG / vector store grounding           | `assets/GroundingOrchestration.java`      | `com.sap.ai.sdk:orchestration`             |
| Prompt Registry templates              | `assets/PromptRegistryOrchestration.java` | `com.sap.ai.sdk:orchestration`             |
| Spring AI + Orchestration              | `assets/SpringAiOrchestration.java`       | `com.sap.ai.sdk:orchestration`             |
| Spring AI + OpenAI client              | `assets/SpringAiOpenAi.java`              | `com.sap.ai.sdk:openai`                    |
| LLM batch processing                   | `assets/BatchOrchestration.java`          | `com.sap.ai.sdk:batch` + `openai` + `core` |
| Native OpenAI Responses API            | `assets/OpenAiNative.java`                | `com.sap.ai.sdk:openai`                    |
| RPT table completion (SAP RPT model)   | `assets/RptOrchestration.java`            | `com.sap.ai.sdk:sap-rpt`                   |
| Content filtering (Azure + LlamaGuard) | `assets/FilteringOrchestration.java`      | `com.sap.ai.sdk:orchestration`             |
| Data masking (DPI anonymization)       | `assets/MaskingOrchestration.java`        | `com.sap.ai.sdk:orchestration`             |

---

## Install Options

```xml
<!-- Maven — orchestration only (default resource group) -->
<dependency>
    <groupId>com.sap.ai.sdk</groupId>
    <artifactId>orchestration</artifactId>
    <version>1.22.0</version>
</dependency>

<!-- Add core if using AiCoreService (custom resource groups) -->
<dependency>
    <groupId>com.sap.ai.sdk</groupId>
    <artifactId>core</artifactId>
    <version>1.22.0</version>
</dependency>
```

```groovy
// Gradle
implementation 'com.sap.ai.sdk:orchestration:1.22.0'
// Add core if using AiCoreService (custom resource groups):
implementation 'com.sap.ai.sdk:core:1.22.0'
```

Check [Maven Central](https://central.sonatype.com/artifact/com.sap.ai.sdk/orchestration) for the latest version.

---

## Quick Start (OrchestrationClient)

```java
import com.sap.ai.sdk.orchestration.OrchestrationClient;
import com.sap.ai.sdk.orchestration.OrchestrationModuleConfig;
import com.sap.ai.sdk.orchestration.OrchestrationPrompt;
import com.sap.ai.sdk.orchestration.OrchestrationAiModel;

// Credentials auto-loaded from AICORE_SERVICE_KEY env var or VCAP_SERVICES
var client = new OrchestrationClient();

var config = new OrchestrationModuleConfig()
    .withLlmConfig(OrchestrationAiModel.GPT_4O_MINI);

var response = client.chatCompletion(
    new OrchestrationPrompt("What is SAP AI Core?"), config);

System.out.println(response.getContent());
```

---

## Credential Setup

Set the `AICORE_SERVICE_KEY` environment variable to the JSON service key from SAP AI Core:

```bash
export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}'
```

Or run `aicore configure` (Python CLI) to store credentials in `~/.aicore/config.json`.
See: https://sap.github.io/ai-sdk/docs/java/connecting-to-ai-core

---

## Handoffs

- **Want JS/TS code instead?** → invoke `aicore-sdk-js`
- **SDK bug or unexpected behavior?** → https://github.com/SAP/ai-sdk-java/issues

---

## When to Load Reference Files

| Trigger                                                                                                                        | Action                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Use case matches an asset (chat, streaming, multi-turn, embeddings, grounding, prompt registry, Spring AI, filtering, masking) | Serve the matching asset from `assets/`                                                             |
| Use case not covered by an asset (reasoning, structured output, Spring Boot streaming)                                         | Use Context7 (`SAP/ai-sdk-java`) for API usage patterns if available, else `references/SDK_JAVA.md` |
| Any code generation                                                                                                            | Always verify class names and method signatures against a source above                              |

© SAP · Apache-2.0 · SAP/ai-skills-library

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
java-mcp-server-generator официальный github Скилл java-mcp-server-generator для GitHub Copilot и Claude Code создаёт Java MCP-сервер или Spring Boot-проект для подключения кода, API и баз данных к AI-агентам. В проект входят тесты. CX Codex +1 8 800установок openapi-to-application-java-spring-boot официальный github Скилл openapi-to-application-java-spring-boot для GitHub Copilot превращает спецификацию OpenAPI в основу приложения на Spring Boot. Он включается, когда нужно создать или доработать Java API по файлу OpenAPI или Swagger. CX Codex +1 ★ 41 430звёзд репо devkit.java.upgrade-dependencies Giuseppe Trisciuoglio Команда devkit.java.upgrade-dependencies планирует и выполняет пошаговое обновление зависимостей в проектах на Java, Maven и Gradle. Находит несовместимости и составляет инструкции по миграции. CX Codex +1 ★ 372звёзд репо devkit.java.generate-docs Giuseppe Trisciuoglio Команда devkit.java.generate-docs генерирует документацию для проектов на Java и Spring Boot: спецификации OpenAPI, архитектурные схемы, Javadoc и файлы README. CX Codex +1 ★ 372звёзд репо deploying-java-sdk-bundles astronomer Скилл deploying-java-sdk-bundles собирает и развёртывает скомпилированные Java SDK пакеты Airflow так, чтобы воркеры могли их запускать. CX Codex +1 200установок java-migration decebals Скилл java-migration для Claude Code ведёт проект по цепочке LTS-версий Java: от оценки текущего состояния до правки сборки и тестов. Переводит легаси на Java 21 или 25. CX Codex +1 372установок

Из того же набора9

sap-fiori-guidelines Скилл sap-fiori-guidelines подкладывает агенту официальные правила дизайн-системы SAP Fiori: кнопки, формы, таблицы, страницы, цвета, доступность и паттерны Joule. CX Codex +1 1 500установок genai-hub-foundation-models Скилл genai-hub-foundation-models для Claude Code показывает модели SAP AI Core GenAI Hub и их параметры. Запускается, когда нужно найти имя модели или executable ID для развёртывания. CX Codex +1 256установок aicore-admin-resources Скилл aicore-admin-resources для Claude Code проверяет подключение к SAP AI Core и управляет группами ресурсов. Включается при начальной настройке доступов или сбоях аутентификации. CX Codex +1 255установок genai-hub-tabular-orchestration Скилл genai-hub-tabular-orchestration для Claude Code управляет реестром контекста SAP AI Core Context Registry. Регистрирует подключения HDL, табличные файлы CSV или Parquet и запускает предсказания через sap-rpt. CX Codex +1 254установок aicore-lifecycle-management Скилл aicore-lifecycle-management для Claude Code управляет жизненным циклом ресурсов в SAP AI Core. Запускает сценарии, создаёт конфигурации, развёртывает модели и читает логи инференса. CX Codex +1 251установок aicore-sdk-js Скилл aicore-sdk-js для Claude Code генерирует рабочий TypeScript и JavaScript код для интеграции с SAP GenAI Hub. Включается при запросах на вызовы моделей через пакеты @sap-ai-sdk. CX Codex +1 192установок genai-hub-orchestration Скилл genai-hub-orchestration для Claude Code настраивает пайплайны сервиса SAP AI Core Orchestration с шаблонами промптов, фильтрацией контента и RAG-заземлением документов. Запросы идут через Harmonized API. CX Codex +1 188установок genai-hub-prompt-evaluation Скилл genai-hub-prompt-evaluation для Claude Code и других платформ оценивает генеративные модели и промпты на SAP AI Core. Запускается при обращении к бенчмаркам LLM, метрикам и конфигурациям оркестрации. CX Codex +1 185установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой