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

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

Скилл aicore-sdk-js для Claude Code генерирует рабочий TypeScript и JavaScript код для интеграции с SAP GenAI Hub. Включается при запросах на вызовы моделей через пакеты @sap-ai-sdk.

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

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

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

Скилл создаёт шаблоны кода на TypeScript или JavaScript под экосистему @sap-ai-sdk версии 2. Он формирует сценарии для чата и стриминга через @sap-ai-sdk/orchestration, вызовы через нативный клиент @sap-ai-sdk/openai, цепочки LangChain, выборку данных для RAG через @sap-ai-sdk/document-grounding и пакетные задачи llm-batch.

Для работы требуются Node.js 22+ с поддержкой нативного ESM и пакетный менеджер npm или bun. Управление жизненным циклом деплоев через скилл недоступно: создавать и удалять деплои нужно в консоли SAP AI Core. Сервер Context7 MCP опционален и используется для подгрузки свежей документации, если зарегистрирован в сессии.

Скилл работает строго с JavaScript и TypeScript. Если нужен код на Java, разработчики перенаправляют на скилл aicore-sdk-java, а для Python предлагают документацию на сайте проекта.

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

  • сгенерировать вызов GenAI Hub через @sap-ai-sdk/orchestration
  • подключить LangChain к SAP AI Core на TypeScript
  • настроить RAG и связывание документов через @sap-ai-sdk/document-grounding
  • подготовить код для пакетной обработки запросов в @sap-ai-sdk/llm-batch
  • создать скрипт табличных предсказаний с помощью @sap-ai-sdk/rpt

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

  • Создай TypeScript-скрипт для стриминга ответов из SAP GenAI Hub через @sap-ai-sdk/orchestration
  • Покажи пример подключения LangChain к модели на SAP AI Core с пакетом @sap-ai-sdk/langchain
  • Напиши код на Node.js для поиска документов с RAG через @sap-ai-sdk/document-grounding

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

Выполните команду npx skills add SAP/ai-skills-library --skill aicore-sdk-js -a claude-code.

Что делает скилл aicore-sdk-js?

Генерирует готовые шаблоны и примеры кода на TypeScript или JavaScript для работы с SAP GenAI Hub и библиотеками линейки @sap-ai-sdk версии 2.

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

Требуются Node.js версии 22 или новее с нативной поддержкой ESM, npm либо bun, а также настроенные учётные данные через aicore configure.

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

SKILL.md · Apache-2.0
---
name: aicore-sdk-js
metadata:
  version: "2.0"
description: >
  Generate working TypeScript/JavaScript boilerplate for SAP GenAI Hub using @sap-ai-sdk/orchestration,
  @sap-ai-sdk/foundation-models, @sap-ai-sdk/openai (native OpenAI SDK), @sap-ai-sdk/langchain (LangChain),
  @sap-ai-sdk/document-grounding (RAG), @sap-ai-sdk/prompt-registry, @sap-ai-sdk/llm-batch (batch jobs),
  @sap-ai-sdk/rpt (tabular prediction), or @sap-ai-sdk/context-registry (data destinations, tabular artifacts,
  scenario configurations).
  WHEN: user asks for TypeScript, JavaScript, Node.js, or JS/TS code that calls a GenAI Hub
  model, wants a TypeScript starter project, asks how to use @sap-ai-sdk in their app, asks
  how to use LangChain (JS/TS) with SAP AI Core, or wants JS/TS for RAG/document-grounding,
  prompt templates, batch LLM jobs, tabular (RPT) prediction, or managing data destinations /
  tabular artifacts / scenario configurations via the Context Registry.
  DO NOT USE FOR: Java code — use `aicore-sdk-java`. 
compatibility: Requires Node.js 22+ with native ESM support, and npm or bun. Context7 MCP is optional (see Sources & Fallback).
---

## Rules

1. If no deployment URL is known, check the SAP AI Core console or contact your admin to list or create one before generating code.
2. Always include `aicore configure` credential guidance in generated code comments; link to [Connecting to AI Core](https://sap.github.io/ai-sdk/docs/js/connecting-to-ai-core) for setup details.
3. JS/TS lifecycle management (create/list/delete deployments) is not available in this skill — use the SAP AI Core console or contact your admin for deployment management.
4. Target `@sap-ai-sdk` **v2** (orchestration `2.14+`). The preferred invocation pattern is passing `messages` directly to `chatCompletion()` / `stream()`. Only use `promptTemplating.prompt.template` with `{{?placeholder}}` values when the user explicitly wants a server-side reusable template. Never emit the v1 shape `llm: { model_name }` / `templating: { template }` — it does not compile against v2.
5. Never emit Python code snippets — this skill is JS/TS only. If the user asks for Python, inform them that no Python skill is available in this repo and point them to https://sap.github.io/ai-sdk/ for Python SDK guidance.
6. Gather these details before generating code — ask only for what the user hasn't provided:
   - **Framework**: `@sap-ai-sdk/*` (recommended) / `@sap-ai-sdk/langchain` (LangChain) / OpenAI npm package via LiteLLM proxy?
   - **Use case**: chat / streaming / embeddings?
   - **Runtime**: Node.js / Bun / browser?
   - **Model + Deployment ID**: check the SAP AI Core console for existing deployments
   - **Model-switching intent** (ask only when the user specifies an OpenAI model like gpt-4o, gpt-4.1, etc.): do they plan to switch models later (e.g. to Claude or Gemini)? If yes → recommend `@sap-ai-sdk/orchestration` for portability. If they want to stay on OpenAI → use `@sap-ai-sdk/openai` (`SapOpenAi.createClient`) as the simpler native OpenAI SDK alternative; no LiteLLM proxy needed.

---

## Sources & Fallback

Use the best source available, in this order. Never block on a source that isn't present.

1. **Baked-in reference (always available).** `references/SDK_JS.md` and `assets/*.ts` are the
   compile-checked v2 floor. They are correct for the common paths (chat, streaming, LangChain,
   embeddings, proxy) and require no network or MCP. Use them by default.
2. **Context7 MCP (use if available).** _If_ the `context7` `query-docs` tool is registered in
   this session, prefer it for the freshest API, version-specific details, or any feature the
   baked-in reference marks as fast-moving (tool calling, data masking, document grounding,
   prompt registry). Library ID: `/websites/sap_github_io_ai-sdk_js`. If the tool is **not**
   available, silently fall back to the baked-in reference — do not ask the user to install it.
3. **Web docs (last resort).** For anything neither source covers, point to
   [llms.txt](https://sap.github.io/ai-sdk/llms.txt) or fetch the online docs.

Do not fabricate API shapes from memory — this SDK's v1 and v2 APIs differ, and guessing
reproduces stale v1 code. When unsure, use source 2 if present, else source 3.

---

## Asset Map

| Use case                                           | Template                            | Install                                                                              |
| -------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------ |
| Chat via `@sap-ai-sdk/orchestration` (recommended) | `assets/chat_sap_sdk.ts`            | `npm install @sap-ai-sdk/orchestration`                                              |
| Streaming via `@sap-ai-sdk/orchestration`          | `assets/streaming.ts`               | `npm install @sap-ai-sdk/orchestration`                                              |
| Native OpenAI SDK (chat/stream/embeds/Responses)   | `assets/openai_native.ts`           | `npm install @sap-ai-sdk/openai openai zod`                                          |
| LangChain via `AzureOpenAiChatClient`              | `assets/langchain_openai.ts`        | `npm install @sap-ai-sdk/langchain @langchain/core`                                  |
| LangChain via `OrchestrationClient`                | `assets/langchain_orchestration.ts` | `npm install @sap-ai-sdk/langchain @langchain/core`                                  |
| RAG / document grounding                           | `assets/document_grounding.ts`      | `npm install @sap-ai-sdk/document-grounding`                                         |
| Managed prompt templates                           | `assets/prompt_registry.ts`         | `npm install @sap-ai-sdk/prompt-registry`                                            |
| Batch LLM jobs                                     | `assets/llm_batch.ts`               | `npm install @sap-ai-sdk/llm-batch @sap-ai-sdk/ai-api @sap-ai-sdk/foundation-models` |
| Tabular prediction (SAP-RPT-1, not chat)           | `assets/rpt.ts`                     | `npm install @sap-ai-sdk/rpt`                                                        |
| Context Registry (data destinations, tabular artifacts, scenario configs) | `assets/context_registry.ts` | `npm install @sap-ai-sdk/context-registry` |
| Tabular Orchestration (RPT predict via Scenario Config or inline context) | `assets/tabular_orchestration.ts` | `npm install @sap-ai-sdk/tabular-orchestration` |
| Real-time speech/text via WebSocket (`gpt-realtime`)                      | `assets/realtime.ts`              | `npm install @sap-ai-sdk/openai openai ws`      |
| Chat via OpenAI npm package (LiteLLM proxy)        | `assets/chat_openai_proxy.ts`       | `npm install openai`                                                                 |

---

## Install Options

```bash
# @sap-ai-sdk (recommended — native SAP SDK)
npm install @sap-ai-sdk/orchestration @sap-ai-sdk/foundation-models

# Native OpenAI SDK surface on AI Core (no LiteLLM proxy needed)
npm install @sap-ai-sdk/openai openai zod

# LangChain integration (no LiteLLM proxy needed)
npm install @sap-ai-sdk/langchain @langchain/core

# RAG, prompt templates, batch jobs, tabular prediction
npm install @sap-ai-sdk/document-grounding
npm install @sap-ai-sdk/prompt-registry
npm install @sap-ai-sdk/llm-batch @sap-ai-sdk/ai-api @sap-ai-sdk/foundation-models
npm install @sap-ai-sdk/rpt

# With bun
bun add @sap-ai-sdk/orchestration @sap-ai-sdk/foundation-models

# OpenAI npm package via LiteLLM proxy (only if you need a running proxy; prefer @sap-ai-sdk/openai)
npm install openai
```

---

## Quick Start (@sap-ai-sdk/orchestration)

Pass `messages` directly — this is the default pattern. Only use `promptTemplating.prompt.template` with `{{?placeholder}}` values when the user explicitly wants a reusable server-side template.

```typescript
import { OrchestrationClient } from "@sap-ai-sdk/orchestration";

const client = new OrchestrationClient({
  promptTemplating: {
    model: {
      name: "anthropic--claude-4.5-haiku",
      params: { temperature: 0.7 },
    },
  },
});

const response = await client.chatCompletion({
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Hello!" },
  ],
});
console.log(response.getContent());
```

Run with: `npx tsx index.ts` or `bun run index.ts`

---

## Handoffs

- **Want Java code instead?** → invoke `aicore-sdk-java`

---

## When to Load Reference Files

| Trigger                                                     | Load                                                 |
| ----------------------------------------------------------- | ---------------------------------------------------- |
| `@sap-ai-sdk/*` API, OrchestrationClient, streaming         | `references/SDK_JS.md`                               |
| LangChain, `AzureOpenAiChatClient`, `@sap-ai-sdk/langchain` | `references/SDK_JS.md`                               |
| Native OpenAI SDK, `SapOpenAi`, Responses API               | `references/SDK_JS.md`                               |
| RAG, document grounding, prompt registry, batch, RPT        | `references/SDK_JS.md`                               |
| Tool calling, data masking, grounding config internals      | Context7 (if available), else `references/SDK_JS.md` |

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

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

Все скиллы по теме «ИИ и ML» →
sap-cloud-sdk-ai-python secondsky Скилл sap-cloud-sdk-ai-python подключает пакет sap-ai-sdk-gen к проектам на Python. Помогает обращаться к языковым моделям через SAP AI Core и настраивать оркестрацию запросов. CX Codex +1 727установок ai-sdk-5 gentleman-programming Помогает писать код на Vercel AI SDK 5 с учётом ломающих изменений после четвёртой версии. CX Codex +1 138установок ns-langgraph-agents nextstage-brasil Скилл ns-langgraph-agents для Claude Code, Codex, Cursor и других платформ, который ведёт разработку LangGraph.js agent-api от начального развёртывания до синхронизации graph-spec. CX Codex +1 171установок javascript-sdk 101-skills Скилл javascript-sdk учит агента работать с @inferencesh/sdk: запускать приложения inference.sh, стримить прогресс и собирать агентов прямо в JS/TS-коде. CX Codex +1 239установок deepagents-typescript-quickstart langchain-ai Скилл deepagents-typescript-quickstart собирает минимального Deep Agent на TypeScript по официальному квикстарту, с встроенным веб-поиском провайдера вместо Tavily. CX Codex +1 5 900установок langchain-typescript-quickstart langchain-ai Скилл langchain-typescript-quickstart для Claude Code создаёт в проекте минимального агента LangChain на TypeScript. Требует Node 22+ и запускает проверку с выбранной моделью. CX Codex +1 5 900установок

Из того же набора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установок 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установок aicore-sdk-java Скилл aicore-sdk-java для Claude Code генерирует код на Java и Kotlin под SAP GenAI Hub через SAP AI SDK. Задействуется при запросе на интеграцию AI Core в проект на Java или Spring Boot. CX Codex +1 180установок

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

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