SuperAPI AI 工具集

aicore-sdk-java

编程与开发

查看项目

更新于 10-22 20:49

技能介绍

用途:该技能用于为 SAP AI Core / SAP GenAI Hub 生成可直接运行的 Java 示例代码,避免手写类名、方法签名或配置结构时出错。

主要能力:技能内置资源模板(assets/),按使用场景提供已测试代码,包括通过 OrchestrationClient 进行聊天、流式输出、多轮对话、文本嵌入、RAG/向量库 grounding、Prompt Registry 模板;Spring AI + Orchestration、Spring AI + OpenAI 客户端;LLM 批量处理;原生 OpenAI Responses API;SAP RPT 模型表格补全;内容过滤(Azure + LlamaGuard);数据脱敏(DPI 匿名化)。

使用方式:生成代码前需确认使用场景、可用模型、构建工具(Maven/Gradle)与框架(纯 Java/Spring Boot),只询问用户尚未提供的信息。资料解析优先级为:先用 assets 中匹配模板;若无匹配,通过 Context7 MCP 获取 SAP/ai-sdk-java 最新文档;再回退到 references/SDK_JAVA.md;均未覆盖时如实说明并指向官方文档 https://sap.github.io/ai-sdk/docs/java/ 。生成代码须使用 OrchestrationClient 作为聊天、流式、嵌入、grounding 与过滤的主客户端,OpenAiClient 仅用于直接 OpenAI 代理场景;模型须使用 OrchestrationAiModel 常量(如 OrchestrationAiModel.GPT_4O_MINI),不得使用原始模型名字符串;流式需区分两种 API:Spring Boot 控制器中的 OrchestrationClient.streamChatCompletion() 须使用 ResponseBodyEmitter + ThreadContextExecutors.getExecutor().execute() 转发增量,不用 SseEmitter、Thread.ofVirtual() 或直接暴露 Flux;Spring AI ChatModel.stream() 返回 Flux<ChatResponse>,可直接组合使用。生成代码注释需包含凭证指引,并链接 Connecting to AI Core。

安装依赖示例:Maven 添加 com.sap.ai.sdk:orchestration:1.22.0,若使用 AiCoreService(自定义资源组)再加 core:1.22.0;Gradle 使用 implementation 'com.sap.ai.sdk:orchestration:1.22.0' 及可选的 core。版本以 Maven Central 最新为准。凭证可通过 AICORE_SERVICE_KEY 环境变量或 VCAP_SERVICES 自动加载,也可用 aicore configure(Python CLI)写入 ~/.aicore/config.json。

适用场景:需要快速搭建 SAP AI Core Java 集成、从模板生成聊天/流式/嵌入/RAG/过滤/脱敏等代码的开发者;需 Spring AI 或 Spring Boot 集成的项目。

限制:若没有部署,需先在 SAP AI Core 控制台查询或联系管理员创建;不编造类名、方法签名或配置结构;SDK 缺陷或异常行为仅提供已验证的变通方案,并引导至 https://github.com/SAP/ai-sdk-java/issues;不推测 SDK 内部实现。