SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场sap-hana

sap-hana

办公与效率

查看项目

更新于 10-15 09:13

技能介绍

SAP S4 HANA 技能用于与 SAP S/4HANA 系统集成。SAP S4 HANA 是一套用于实时管理业务流程的 ERP 系统，企业用它处理财务、供应链、制造等核心运营。官方文档：https://help.sap.com/viewer/product/SAP_S4HANA_ON-PREMISE/latest/en-US

用途 该技能面向需要与 SAP S4 HANA 数据交互的场景，例如管理业务伙伴（Business Partner）、供应商（Supplier）、物料（Material）、销售订单（Sales Order）等。当用户希望读取或操作 SAP S4 HANA 数据时使用。

主要能力 技能通过 Membrane CLI 与 SAP S4 HANA 通信，Membrane 自动处理认证与凭证刷新，使集成逻辑无需关注认证细节。可用的预置动作包括：列出销售订单行项目、列出公司代码、获取/列出开票凭证（发票）、创建/获取/列出采购订单、列出入库交货、获取/列出出库交货、获取/列出产品（物料）、创建/列出/获取业务伙伴、创建/更新/获取/列出销售订单等。每个动作包含 id、name、description、inputSchema（接受的参数）与 outputSchema（返回内容）。

使用方式

  1. 安装 CLI：npm install -g @membranehq/cli@latest
  2. 认证：membrane login --tenant --clientName=<agentType>。该命令会打开浏览器认证，或在控制台打印授权 URL（无头环境）。无头环境下请用户打开 URL，完成登录后看到代码，再执行 membrane login complete <code>。任意命令加 --json 可获得机器可读的 JSON 输出。agentType 可选 claude、openclaw、codex、warp、windsurf 等，用于适配不同运行环境。
  3. 连接 SAP S4 HANA：使用 membrane connection ensure 按应用 URL 或域名查找或创建连接，例如 membrane connection ensure "https://sap.com/products/erp/s4hana.html" --json。用户在浏览器完成认证，输出包含新的 connection id。若返回的连接 state 为 READY，可直接进入下一步；若为 BUILDING，则轮询 npx @membranehq/cli connection get <id> --wait --json 直到状态不再是 BUILDING。状态说明：READY 表示连接已就绪；CLIENT_ACTION_REQUIRED 表示用户或代理需要执行操作，clientAction.type 为 "connect"（需认证）或 "provide-input"（需补充信息），clientAction.description 为说明，clientAction.uiUrl（可选）为可完成操作的预建 UI，clientAction.agentInstructions（可选）为程序化处理指引；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，可查看 error 字段。
  4. 搜索动作：membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。建议始终在特定连接上下文中搜索动作。
  5. 运行动作：membrane action run <actionId> --connectionId=CONNECTION_ID --json；传 JSON 参数：membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。结果位于响应的 output 字段。
  6. 代理请求：当现有动作无法覆盖用例时，可通过 Membrane 代理直接向 SAP S4 HANA API 发送请求：membrane request CONNECTION_ID /path/to/endpoint。Membrane 会自动拼接基础 URL 并注入正确的认证头，凭证过期时透明刷新。常用选项包括 -X/--method（HTTP 方法，默认 GET）、-H/--header（可重复添加请求头）、-d/--data（请求体字符串）、--json（发送 JSON 体并设置 Content-Type: application/json）、--rawData（原样发送请求体）、--query（可重复的查询参数）、--pathParam（可重复的路径参数）。

适用场景 适用于企业 ERP 数据集成，如查询销售订单、采购订单、交货单、开票凭证、公司代码、产品与业务伙伴，或创建采购订单、销售订单、业务伙伴，更新销售订单等。

限制与注意事项 资料未提供该技能的具体收费、价格、平台支持范围或性能效果等信息。使用前需完成 Membrane 认证与连接建立。建议优先使用 Membrane 预置动作而非直接调用 API，因为预置动作内置认证、分页与错误处理，可减少 token 消耗并提升安全性；在编写自定义 API 调用前，先通过 membrane action list --intent=QUERY 查找已有动作。不要向用户索要 API 密钥或令牌，应通过创建连接由 Membrane 在服务端管理完整认证生命周期，不在本地保存密钥。