SuperAPI AI 工具集

fusion-core-services

编程与开发

查看项目

更新于 10-16 08:22

技能介绍

用途

Fusion Core Services 是一个可安装的技能,用于在涉及一个或多个 Fusion Core 服务 API 的任务中,帮助智能体识别正确的服务指引,而无需分别安装独立技能。

典型触发场景:

  • 实现 Fusion API 客户端
  • 接入 Fusion 后端服务集成
  • 判断某个工作流归属哪个 Fusion Core 服务
  • 处理跨服务任务,例如 context 加 people、roles 加 notifications,或 apps 加 service messages

不适用场景:

  • 修改 fusion-core-services 内部的代码
  • 非 Fusion API,或没有 Fusion 服务层的通用 Microsoft Graph / Power BI 工作
  • 已由 Fusion Core 服务之外的其他专用技能覆盖的独立产品工作流

主要能力

该技能提供服务目录,涵盖以下服务(每个服务包含 reference、endpoint catalog、models):

  • Apps
  • Bookmarks
  • Context
  • Contract Personnel
  • Mail
  • Notification
  • People
  • Portal Config
  • Reports
  • RolesV2
  • Service Messages
  • Tasks

技能强调以实时 OpenAPI 文档为准确来源。每个 Fusion Core 服务都公开发布其当前 OpenAPI 文档,无需 JWT: https://{service}.api.fusion.equinor.com/openapi/api-v{version}.json 例如: https://people.api.fusion.equinor.com/openapi/api-v3.json https://context.api.fusion.equinor.com/openapi/api-v1.json

捆绑的参考文件是服务/控制器存在情况及其处理方式的精选索引,而非精确 schema/类型名称的权威来源,这些名称会随服务变化而漂移。应获取目标服务的实时文档并阅读 components.schemas 以获取真实类型名称。响应通常为 Api{Entity},请求体为普通的 {Verb}{Entity}Request 名称,但实时文档中的确切名称始终优先于任何模式;切勿臆造 components.schemas 中实际不存在的 Dto 后缀名称。

如果无法获取实时 OpenAPI 文档(没有 web-fetch 工具或网络访问),应明确说明该限制,将捆绑的参考/资产视为尽力而为,并避免断言确切的 schema/类型名称或必填字段。

如果子域名尚未从服务目录中得知,应通过 Fusion 服务发现来解析,而不是猜测,遵循平台范围内绝不硬编码服务地址的规则。

使用方式

所需输入:

  • 目标工作流或用户目标
  • 目标消费方形态(react、typescript 客户端、csharp httpclient、后端服务或其他)
  • 已知的服务线索(如有)
  • 相关的版本控制或授权预期

操作步骤:

  1. 先界定请求范围。判断工作流涉及一个服务还是多个服务。如果服务不明确,使用 agents/service-router.md 将工作流映射到可能的服务,然后再生成实现指引。
  2. 只阅读相关的服务参考。从 Combined API surface 开始,然后打开匹配的每服务参考文件。仅拉入对答案有实质影响的服务的端点目录和模型资产。
  3. 在信任确切名称或形状之前,先获取实时 OpenAPI 文档。
  4. 保留有来源依据的指引。当实时 OpenAPI 文档与捆绑参考自身的“建议模型”列表不一致时,优先采用实时文档。
  5. 明确处理能力探测。如果服务暴露 OPTIONS 或其他访问探测路由,使用它们来驱动能力感知的 UI 或变更逻辑。如果服务未暴露稳定探测,记录保守的客户端行为,并将 403 Forbidden 视为回退能力信号。
  6. 除非参考另有说明,将订阅视为仅后端。 /subscriptions/... 路由用于应用令牌事件注册和 CloudEvent 风格的变更处理,而非普通前端 CRUD 流程。
  7. 返回消费方可用的指引。对于前端消费方,返回 TypeScript 友好的模型(以真实 schema 命名,而非 Dto 后缀)和最小客户端/hook 模式。对于 .NET 消费方,返回类型化 HttpClient 计划,直接反序列化为实时文档中的真实 schema 类型。对于跨服务任务,解释服务顺序和服务间的数据交接。

预期输出标题顺序:

  1. Scope check
  2. Service selection
  3. Endpoint mapping
  4. Model mapping
  5. Consumer implementation plan
  6. Integration code sketch
  7. Validation and test notes
  8. Risks and assumptions

适用场景

适用于需要跨 Fusion Core 服务 API 进行集成的开发任务,尤其是涉及多个服务协作、需要判断服务归属、或需要生成消费方实现计划的场景。

限制

安全与约束:

  • 绝不臆造服务归属、路由或模型字段
  • 绝不臆造 Dto 后缀类型名,或实时 OpenAPI 文档 components.schemas 中实际不存在的任何名称
  • 当捆绑的 Fusion 参考具体明确时,不要基于通用 SaaS/API 假设作答
  • 不要将后端订阅路由视为普通前端交互流程
  • 始终在命名类型前获取目标服务的实时 OpenAPI 文档
  • 当涉及多个服务时,保持跨服务推理明确
  • 当服务暴露 OPTIONS 时,说明能力探测行为
  • 优先使用用户工作流所需的最窄服务参考集

关于收费、价格、平台支持范围等具体信息,资料中暂未提供。