SuperAPI AI 工具集

celonis-ems

数据与分析

查看项目

更新于 10-16 01:59

技能介绍

用途

Celonis EMS(执行管理系统)用于帮助企业识别并消除业务流程中的低效环节。它主要面向流程改进专业人员、业务分析师和运营经理,用于优化工作流并改善绩效。此技能适用于用户希望与 Celonis EMS 数据交互的场景。

官方文档地址:https://community.celonis.com/spaces/9209430

主要能力

该技能通过 Membrane CLI 与 Celonis EMS 交互。Membrane 自动处理认证和凭证刷新,因此可将精力集中在集成逻辑上,而非认证管道。

Celonis EMS 涉及的对象与领域包括:Analysis(分析)、Variant(变体)、Data Pool(数据池)、Data Job(数据作业)、Model(模型)、Package(包)、User(用户)、Team(团队)、Task Force(任务组)、Notification(通知)。

提供的常见动作包括:

  • Query Record Data(query-record-data):从知识模型中的特定记录检索数据,支持可选筛选、字段选择和排序。
  • Query Knowledge Model Data(query-knowledge-model-data):从知识模型检索数据,支持可选筛选、字段选择、排序和 KPI 计算。
  • List Knowledge Model KPIs(list-knowledge-model-kpis):检索知识模型中定义的 KPI(关键绩效指标)列表。
  • Get Record Details(get-record-details):检索知识模型中特定记录的详细模式信息,包括所有可用字段。
  • List Knowledge Model Records(list-knowledge-model-records):检索知识模型中可用的记录模式列表。
  • List Knowledge Model Filters(list-knowledge-model-filters):检索特定知识模型的预定义筛选器列表。
  • Get Knowledge Model Details(get-knowledge-model-details):检索特定知识模型的顶层详情。
  • List Knowledge Models(list-knowledge-models):检索 Celonis EMS 团队中所有可用知识模型的列表。

使用方式

安装 CLI:

npm install -g @membranehq/cli@latest

认证:

membrane login --tenant --clientName=<agentType>

该命令会打开浏览器进行认证,或在控制台打印授权 URL(取决于是否可用交互模式)。无头环境下会打印授权 URL,请用户用浏览器打开;登录后看到代码时,执行:membrane login complete <code>。任何命令添加 --json 可获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等,用于针对运行环境调整工具。

连接 Celonis EMS:

membrane connection ensure "https://www.celonis.com/ems/platform/" --json

用户在浏览器中完成认证,输出包含新的连接 id。若返回的连接状态为 READY,可直接进入下一步。若为 BUILDING 状态,则轮询等待:

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会进行长轮询(最长至 --timeout 秒,默认 30),直到状态变化。状态含义:READY 表示连接已完全建立;CLIENT_ACTION_REQUIRED 表示用户或 agent 需要执行操作,clientAction.type 为 connect(需要认证)或 provide-input(需要更多信息),description 为人类可读说明,uiUrl 为可选的预构建 UI 链接,agentInstructions 为可选的程序化指导;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,需查看 error 字段。

搜索动作:

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

应始终在特定连接的上下文中搜索动作。每个结果包含 id、name、description、inputSchema(接受的参数)和 outputSchema(返回内容)。

运行动作:

membrane action run <actionId> --connectionId=CONNECTION_ID --json

传入 JSON 参数:

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

代理请求:当可用动作无法覆盖用例时,可通过 Membrane 代理直接向 Celonis EMS API 发送请求。Membrane 会自动在提供的路径前追加基础 URL,并注入正确的认证头(包括过期时的透明凭证刷新):

membrane request CONNECTION_ID /path/to/endpoint

常用选项:-X/--method(HTTP 方法,默认 GET)、-H/--header(添加请求头,可重复)、-d/--data(请求体字符串)、--json(发送 JSON 体并设置 Content-Type: application/json 的简写)、--rawData(原样发送体)、--query(查询字符串参数,可重复)、--pathParam(路径参数,可重复)。

适用场景

适用于流程改进、业务分析与运营管理场景,例如检索知识模型数据、查看 KPI、检查记录模式与预定义筛选器,或以自然语言方式查询 Celonis EMS 数据并运行预构建动作。

限制

资料未提供 Celonis EMS 技能的具体收费、价格、平台限制或使用配额等信息。认证与凭证由 Membrane 服务端管理,不应向用户索取 API 密钥或令牌。具体可用动作与字段取决于连接后的环境。